## Cursor Channel

Cursor Channel — update cursor shape and position

## Stability Level

Stable, unless otherwise indicated

## Synopsis

    #include <channel-cursor.h>

    struct              SpiceCursorChannel;
    struct              SpiceCursorChannelClass;

## Object Hierarchy

      GObject
       +----SpiceChannel
             +----SpiceCursorChannel

## Signals

      "cursor-hide"                                    : Run First
      "cursor-move"                                    : Run First
      "cursor-reset"                                   : Run First
      "cursor-set"                                     : Run First

## Description

The Spice protocol defines a set of messages for controlling cursor shape and position on the remote display area. The cursor changes that should be reflected on the display are notified by signals. See for example "cursor-set" "cursor-move" signals.

## Details

### struct SpiceCursorChannel

    struct SpiceCursorChannel;

The SpiceCursorChannel struct is opaque and should not be accessed directly.

### struct SpiceCursorChannelClass

    struct SpiceCursorChannelClass {
        SpiceChannelClass parent_class;

        /* signals */
        void (*cursor_set)(SpiceCursorChannel *channel, gint width, gint height,
                           gint hot_x, gint hot_y, gpointer rgba);
        void (*cursor_move)(SpiceCursorChannel *channel, gint x, gint y);
        void (*cursor_hide)(SpiceCursorChannel *channel);
        void (*cursor_reset)(SpiceCursorChannel *channel);
    };

Class structure for SpiceCursorChannel.

SpiceChannelClass `parent_class`; | Parent class.
`cursor_set` () | Signal class handler for the "cursor-set" signal.
`cursor_move` () | Signal class handler for the "cursor-move" signal.
`cursor_hide` () | Signal class handler for the "cursor-hide" signal.
`cursor_reset` () | Signal class handler for the "cursor-reset" signal.

## Signal Details

### The `"cursor-hide"` signal

    void                user_function                      (SpiceCursorChannel *cursor,
                                                            gpointer            user_data)      : Run First

The "cursor-hide" signal is emitted to hide the cursor/pointer on the display area.

`cursor` : | the SpiceCursorChannel that emitted the signal
`user_data` : | user data set when the signal handler was connected.

### The `"cursor-move"` signal

    void                user_function                      (SpiceCursorChannel *cursor,
                                                            gint                x,
                                                            gint                y,
                                                            gpointer            user_data)      : Run First

The "cursor-move" signal is emitted to update the cursor position on the display area.

`cursor` : | the SpiceCursorChannel that emitted the signal
`x` : | x position
`y` : | y position
`user_data` : | user data set when the signal handler was connected.

### The `"cursor-reset"` signal

    void                user_function                      (SpiceCursorChannel *cursor,
                                                            gpointer            user_data)      : Run First

The "cursor-reset" signal is emitted to reset the cursor to its default context.

`cursor` : | the SpiceCursorChannel that emitted the signal
`user_data` : | user data set when the signal handler was connected.

### The `"cursor-set"` signal

    void                user_function                      (SpiceCursorChannel *cursor,
                                                            gint                width,
                                                            gint                height,
                                                            gint                hot_x,
                                                            gint                hot_y,
                                                            gpointer            rgba,
                                                            gpointer            user_data)      : Run First

The "cursor-set" signal is emitted to modify cursor aspect and position on the display area.

`cursor` : | the SpiceCursorChannel that emitted the signal
`width` : | width of the shape
`height` : | height of the shape
`hot_x` : | horizontal offset of the 'hotspot' of the cursor
`hot_y` : | vertical offset of the 'hotspot' of the cursor
`rgba` : | 32bits shape data, or `NULL` if default cursor. It might be freed after the signal is emitted, so make sure to copy it if you need it later!
`user_data` : | user data set when the signal handler was connected.

## See Also

SpiceChannel, and the GTK widget SpiceDisplay