Man page - sdl_converteventtorendercoordinates(3)

Packages contains this manual

Package: libsdl3-doc
apt-get install libsdl3-doc

Documentations in package:

SDL_ConvertEventToRenderCoordinates - Convert the coordinates in an event to render coordinates.

Defined in SDL3/SDL_render.h

#include "SDL3/SDL.h"

bool SDL_ConvertEventToRenderCoordinates(SDL_Renderer *renderer, SDL_Event *event);

This takes into account several states:

• The window dimensions.

• The logical presentation settings
( SDL_SetRenderLogicalPresentation )

• The scale ( SDL_SetRenderScale )

• The viewport ( SDL_SetRenderViewport )

Various event types are converted with this function: mouse, touch, pen, etc.

Touch coordinates are converted from normalized coordinates in the window to non-normalized rendering coordinates.

Relative mouse coordinates (xrel and yrel event fields) are _also_ converted. Applications that do not want these fields converted should use

SDL_RenderCoordinatesFromWindow () on the specific event fields instead of converting the entire event structure.

Once converted, coordinates may be outside the rendering area.

renderer

the rendering context.

event

the event to modify.

Returns true on success or false on failure; call

SDL_GetError () for more information.

This function should only be called on the main thread.

This function is available since SDL 3.2.0.