table of contents
SDL_CreateRenderer(3) | SDL3 FUNCTIONS | SDL_CreateRenderer(3) |
NAME¶
SDL_CreateRenderer - Create a 2D rendering context for a window.
HEADER FILE¶
Defined in SDL3/SDL_render.h
SYNOPSIS¶
#include "SDL3/SDL.h"
SDL_Renderer * SDL_CreateRenderer(SDL_Window *window, const char *name, Uint32 flags);
DESCRIPTION¶
If you want a specific renderer, you can specify its name here. A list of available renderers can be obtained by calling
SDL_GetRenderDriver
multiple times, with indices from 0 to SDL_GetNumRenderDrivers ()-1.
If you don't need a specific renderer, specify NULL and SDL will attempt to
choose the best option for you, based on what is available on the user's
system.
By default the rendering size matches the window size in pixels, but you can call
SDL_SetRenderLogicalPresentation () to change the content size and scaling options.
FUNCTION PARAMETERS¶
RETURN VALUE¶
Returns a valid rendering context or NULL if there was an error; call
SDL_GetError () for more information.
AVAILABILITY¶
This function is available since SDL 3.0.0.
SEE ALSO¶
SDL_CreateRendererWithProperties(3), SDL_CreateSoftwareRenderer(3), SDL_DestroyRenderer(3), SDL_GetNumRenderDrivers(3), SDL_GetRenderDriver(3), SDL_GetRendererInfo(3)
SDL 3.1.2 | Simple Directmedia Layer |