Retrieves the pen's current status.
Defined in <SDL3/SDL_pen.h>
float *x, float *y, float *axes, size_t num_axes); Uint32 SDL_GetPenStatus(SDL_PenID instance_id,
SDL_PenID | instance_id | the pen to query. |
float * | x | out-mode parameter for pen x coordinate. May be NULL. |
float * | y | out-mode parameter for pen y coordinate. May be NULL. |
float * | axes | out-mode parameter for axis information. May be null. The axes are in the same order as SDL_PenAxis. |
size_t | num_axes | maximum number of axes to write to "axes". |
(Uint32) Returns a bit mask with the current pen button states (SDL_BUTTON_LMASK etc.), possibly SDL_PEN_DOWN_MASK, and exactly one of SDL_PEN_INK_MASK or SDL_PEN_ERASER_MASK , or 0 on error (see SDL_GetError()).
If the pen is detached (cf. SDL_PenConnected), this operation may return default values.
This function is available since SDL 3.0.0.