Inputs Channel

Inputs Channel — control the server mouse and keyboard

Stability Level

Stable, unless otherwise indicated

Functions

void spice_inputs_motion ()
void spice_inputs_position ()
void spice_inputs_button_press ()
void spice_inputs_button_release ()
void spice_inputs_key_press ()
void spice_inputs_key_press_and_release ()
void spice_inputs_key_release ()
void spice_inputs_set_key_locks ()

Properties

gint key-modifiers Read

Signals

void inputs-modifiers Run First

Types and Values

struct SpiceInputsChannel
struct SpiceInputsChannelClass
enum SpiceInputsLock

Object Hierarchy

    GFlags
    ╰── SpiceInputsLock
    GObject
    ╰── SpiceChannel
        ╰── SpiceInputsChannel

Includes

#include <spice-client.h>

Description

Spice supports sending keyboard key events and keyboard leds synchronization. The key events are sent using spice_inputs_key_press() and spice_inputs_key_release() using a modified variant of PC XT scancodes.

Guest keyboard leds state can be manipulated with spice_inputs_set_key_locks(). When key lock change, a notification is emitted with “inputs-modifiers” signal.

Functions

spice_inputs_motion ()

void
spice_inputs_motion (SpiceInputsChannel *channel,
                     gint dx,
                     gint dy,
                     gint button_state);

Change mouse position (used in SPICE_MOUSE_MODE_CLIENT).

Parameters

channel

a SpiceInputsChannel

  

dx

delta X mouse coordinates

  

dy

delta Y mouse coordinates

  

button_state

SPICE_MOUSE_BUTTON_MASK flags

  

spice_inputs_position ()

void
spice_inputs_position (SpiceInputsChannel *channel,
                       gint x,
                       gint y,
                       gint display,
                       gint button_state);

Change mouse position (used in SPICE_MOUSE_MODE_CLIENT).

Parameters

channel

a SpiceInputsChannel

  

x

X mouse coordinates

  

y

Y mouse coordinates

  

display

display channel id

  

button_state

SPICE_MOUSE_BUTTON_MASK flags

  

spice_inputs_button_press ()

void
spice_inputs_button_press (SpiceInputsChannel *channel,
                           gint button,
                           gint button_state);

Press a mouse button.

Parameters

channel

a SpiceInputsChannel

  

button

a SPICE_MOUSE_BUTTON

  

button_state

SPICE_MOUSE_BUTTON_MASK flags

  

spice_inputs_button_release ()

void
spice_inputs_button_release (SpiceInputsChannel *channel,
                             gint button,
                             gint button_state);

Release a button.

Parameters

channel

a SpiceInputsChannel

  

button

a SPICE_MOUSE_BUTTON

  

button_state

SPICE_MOUSE_BUTTON_MASK flags

  

spice_inputs_key_press ()

void
spice_inputs_key_press (SpiceInputsChannel *channel,
                        guint scancode);

Press a key.

Parameters

channel

a SpiceInputsChannel

  

scancode

a PC XT (set 1) key scancode. For scancodes with an 0xe0 prefix, drop the prefix and OR the scancode with 0x100.

  

spice_inputs_key_press_and_release ()

void
spice_inputs_key_press_and_release (SpiceInputsChannel *channel,
                                    guint scancode);

Press and release a key event atomically (in the same message).

Parameters

channel

a SpiceInputsChannel

  

scancode

a PC XT (set 1) key scancode. For scancodes with an 0xe0 prefix, drop the prefix and OR the scancode with 0x100.

  

Since: 0.13

spice_inputs_key_release ()

void
spice_inputs_key_release (SpiceInputsChannel *channel,
                          guint scancode);

Release a key.

Parameters

channel

a SpiceInputsChannel

  

scancode

a PC XT (set 1) key scancode. For scancodes with an 0xe0 prefix, drop the prefix and OR the scancode with 0x100.

  

spice_inputs_set_key_locks ()

void
spice_inputs_set_key_locks (SpiceInputsChannel *channel,
                            guint locks);

Set the keyboard locks on the guest (Caps, Num, Scroll..)

Parameters

channel

a SpiceInputsChannel

  

locks

SpiceInputsLock modifiers flags

  

Types and Values

struct SpiceInputsChannel

struct SpiceInputsChannel;

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

struct SpiceInputsChannelClass

struct SpiceInputsChannelClass {
    SpiceChannelClass parent_class;

    /* signals */
    void (*inputs_modifiers)(SpiceChannel *channel);
};

Class structure for SpiceInputsChannel.

Members

inputs_modifiers ()

Signal class handler for the “inputs-modifiers” signal.

  

enum SpiceInputsLock

Constants used to synchronize modifiers between a client and a guest.

Members

SPICE_INPUTS_SCROLL_LOCK

Scroll Lock

  

SPICE_INPUTS_NUM_LOCK

Num Lock

  

SPICE_INPUTS_CAPS_LOCK

Caps Lock

  

Property Details

The “key-modifiers” property

  “key-modifiers”            gint

Guest keyboard lock/led state.

Flags: Read

Allowed values: >= 0

Default value: 0

Signal Details

The “inputs-modifiers” signal

void
user_function (SpiceInputsChannel *display,
               gpointer            user_data)

The “inputs-modifiers” signal is emitted when the guest keyboard locks are changed. You can read the current state from “key-modifiers” property.

Parameters

display

the SpiceInputsChannel that emitted the signal

  

user_data

user data set when the signal handler was connected.

  

Flags: Run First

See Also

SpiceChannel, and the GTK widget SpiceDisplay

Generated by GTK-Doc V1.25