|  |  |  | 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                 mark,
                                                        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 | 
| 
 | TRUEwhen the display mark has been received | 
| 
 | 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_xRGBorSPICE_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. |