| Spice-GTK Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | Signals | ||||
"height" guint : Read "monitors" GArray* : Read "monitors-max" guint : Read "width" guint : Read
"display-invalidate" :Run First"display-mark" :Run First"display-primary-create" :Run First"display-primary-destroy" :Run First
A class that handles the rendering of the remote display and inform of its updates.
The creation of the main graphic buffer is signaled with "display-primary-create".
The update of regions is notified by "display-invalidate" signals.
struct SpiceDisplayChannel;
The SpiceDisplayChannel struct is opaque and should not be accessed directly.
struct SpiceDisplayChannelClass {
SpiceChannelClass parent_class;
/* signals */
void (*display_primary_create)(SpiceChannel *channel, gint format,
gint width, gint height, gint stride,
gint shmid, gpointer data);
void (*display_primary_destroy)(SpiceChannel *channel);
void (*display_invalidate)(SpiceChannel *channel,
gint x, gint y, gint w, gint h);
void (*display_mark)(SpiceChannel *channel,
gboolean mark);
};
Class structure for SpiceDisplayChannel.
SpiceChannelClass |
Parent class. |
| Signal class handler for the "display-primary-create" signal. | |
| Signal class handler for the "display-primary-destroy" signal. | |
| Signal class handler for the "display-invalidate" signal. | |
| Signal class handler for the "display-mark" signal. |
"monitors-max" property "monitors-max" guint : Read
The maximum number of monitors the server or guest supports. May change during client lifetime, for instance guest may reboot or dynamically adjust this.
Allowed values: [1,256]
Default value: 1
Since 0.13
"display-invalidate" signalvoid user_function (SpiceDisplayChannel *display,
gint x,
gint y,
gint width,
gint height,
gpointer user_data) : Run First
The "display-invalidate" signal is emitted when the rectangular region x/y/w/h of the primary buffer is updated.
|
the SpiceDisplayChannel that emitted the signal |
|
x position |
|
y position |
|
width |
|
height |
|
user data set when the signal handler was connected. |
"display-mark" signalvoid user_function (SpiceDisplayChannel *display,
gint arg1,
gpointer user_data) : Run First
The "display-mark" signal is emitted when
the RED_DISPLAY_MARK command is received, and the display
should be exposed.
|
the SpiceDisplayChannel that emitted the signal |
|
user data set when the signal handler was connected. |
"display-primary-create" signalvoid user_function (SpiceDisplayChannel *display,
gint format,
gint width,
gint height,
gint stride,
gint shmid,
gpointer imgdata,
gpointer user_data) : Run First
The "display-primary-create" signal provides main display buffer data.
|
the SpiceDisplayChannel that emitted the signal |
|
SPICE_SURFACE_FMT_32_xRGB or SPICE_SURFACE_FMT_16_555; |
|
width resolution |
|
height resolution |
|
the buffer stride ("width" padding) |
|
identifier of the shared memory segment associated with
the imgdata, or -1 if not shm |
|
pointer to surface buffer |
|
user data set when the signal handler was connected. |
"display-primary-destroy" signalvoid user_function (SpiceDisplayChannel *display,
gpointer user_data) : Run First
The "display-primary-destroy" signal is emitted when the primary surface is freed and should not be accessed anymore.
|
the SpiceDisplayChannel that emitted the signal |
|
user data set when the signal handler was connected. |