PLGraphicsIn: PLplot Graphics Input structure
Prev | Chapter 18. The Specialized C/C++ API for PLplot | Next

#### PLGraphicsIn: PLplot Graphics Input structure

The PLGraphicsIn structure is used by `plGetCursor` and `plTranslateCursor` to return information on the current cursor position and key / button state. The structure contains the following fields:

`type` (`int`)

  Type of event (currently unused?).

`state` (`unsigned int`)

  Key or button mask. Consists of a combination of the following masks: `PL_MASK_SHIFT, PL_MASK_CAPS, PL_MASK_CONTROL, PL_MASK_ALT, PL_MASK_NUM PL_MASK_ALTGR, PL_MASK_WIN, PL_MASK_SCROLL, PL_MASK_BUTTON1, PL_MASK_BUTTON2, PL_MASK_BUTTON3, PL_MASK_BUTTON4, PL_MASK_BUTTON5`. The button values indicate mouse buttons. Caps, num and scroll indicate that the appropriate lock is on.

`keysym` (`unsigned int`)

  Key selected.

`button` (`unsigned int`)

  Mouse button selected.

`subwindow` (`PLINT`)

  Subwindow (or subpage / subplot) number.

`string` (`char [PL_MAXKEY]`)

  Translated ascii character string.

`pX, pY` (`int`)

  Absolute device coordinates of mouse pointer.

`dX, dY` (`PLFLT`)

  Relative device coordinates of mouse pointer.

`wX, wY` (`PLFLT`)

  World coordinates of mouse pointer.

Prev | Up | Next
`plTranslateCursor`: Convert device to world coordinates | Home | PLOptionTable: PLplot command line options table structure