SDL_RendererInfo
A structure that contains information on the capabilities of a render driver or the current render context.
Contents
Data Fields
const char* |
name |
the name of the renderer |
Uint32 |
flags |
a mask of supported renderer flags; see Remarks for details |
Uint32 |
mod_modes |
a mask of supported channel modulation; see Remarks for details |
Uint32 |
blend_modes |
a mask of supported blend modes; see Remarks for details |
Uint32 |
scale_modes |
a mask of supported scale modes; see Remarks for details |
Uint32 |
num_texture_formats |
the number of available texture formats |
Uint32[50] |
texture_formats |
the available texture formats; see Remarks for details |
int |
max_texture_width |
the maximimum texture width |
int |
max_texture_height |
the maximimum texture height |
Code Examples
You can add your code example here
Remarks
flags may be 0 or a mask of any of the following SDL_RendererFlags values OR'd together:
SDL_RENDERER_SOFTWARE |
the renderer is a software fallback |
SDL_RENDERER_ACCELERATED |
the renderer uses hardware acceleration |
SDL_RENDERER_PRESENTVSYNC |
present is synchronized with the refresh rate |
SDL_RENDERER_TARGETTEXTURE |
the renderer supports rendering to texture |
Note that providing no flags gives priority to available SDL_RENDERER_ACCELERATED renderers.
mod_modes may be SDL_TEXTUREMODULATE_NONE or a mask of any of the other SDL_TextureModulate values OR'd together:
SDL_TEXTUREMODULATE_NONE |
no modulation |
SDL_TEXTUREMODULATE_COLOR |
srcC = srcC * color |
SDL_TEXTUREMODULATE_ALPHA |
srcA = srcA * alpha |
blend_modes may be SDL_BLENDMODE_NONE or a mask of any of the other SDL_BlendMode values OR'd together:
SDL_BLENDMODE_NONE |
no blending |
|
dstRGBA = srcRGBA |
SDL_BLENDMODE_BLEND |
alpha blending |
|
dstRGB = (srcRGB * srcA) + (dstRGB * (1-srcA)) |
|
dstA = srcA + (dstA * (1-srcA)) |
SDL_BLENDMODE_ADD |
additive blending |
|
dstRGB = (srcRGB * srcA) + dstRGB |
|
dstA = dstA |
SDL_BLENDMODE_MOD |
color modulate |
|
dstRGB = srcRGB * dstRGB |
|
dstA = dstA |
scale_modes may be SDL_TEXTURESCALEMODE_NONE or a mask of any of the other SDL_TextureScaleMode values OR'd together:
texture_formats is an array of SDL_PixelFormatEnum values representing the available texture formats for the renderer
Pixel Format Macros
SDL_PIXELTYPE(format) |
the type of the pixel format; see Remarks for details |
SDL_PIXELORDER(format) |
the ordering of channels or bits in the pixel format; see Remarks for details |
SDL_PIXELLAYOUT(format) |
the channel bit pattern of the pixel format; see Remarks for details |
SDL_BITSPERPIXEL(format) |
the number of bits of color information in the pixel format |
SDL_BYTESPERPIXEL(format) |
the number of bytes used to represent a pixel |
SDL_ISPIXELFORMAT_INDEXED(format) |
true for pixel formats that have a palette |
SDL_ISPIXELFORMAT_ALPHA(format) |
true for pixel formats that have an alpha channel |
SDL_ISPIXELFORMAT_FOURCC(format) |
true for pixel formats representing unique formats, for example YUV formats |
Pixel Format Values
SDL_PIXELFORMAT_UNKNOWN |
|
SDL_PIXELFORMAT_INDEX1LSB |
|
SDL_PIXELFORMAT_INDEX1MSB |
|
SDL_PIXELFORMAT_INDEX4LSB |
|
SDL_PIXELFORMAT_INDEX4MSB |
|
SDL_PIXELFORMAT_INDEX8 |
|
SDL_PIXELFORMAT_RGB332 |
|
SDL_PIXELFORMAT_RGB444 |
|
SDL_PIXELFORMAT_RGB555 |
|
SDL_PIXELFORMAT_BGR555 |
|
SDL_PIXELFORMAT_ARGB4444 |
|
SDL_PIXELFORMAT_RGBA4444 |
|
SDL_PIXELFORMAT_ABGR4444 |
|
SDL_PIXELFORMAT_BGRA4444 |
|
SDL_PIXELFORMAT_ARGB1555 |
|
SDL_PIXELFORMAT_RGBA5551 |
|
SDL_PIXELFORMAT_ABGR1555 |
|
SDL_PIXELFORMAT_BGRA5551 |
|
SDL_PIXELFORMAT_RGB565 |
|
SDL_PIXELFORMAT_BGR565 |
|
SDL_PIXELFORMAT_RGB24 |
|
SDL_PIXELFORMAT_BGR24 |
|
SDL_PIXELFORMAT_RGB888 |
|
SDL_PIXELFORMAT_RGBX8888 |
|
SDL_PIXELFORMAT_BGR888 |
|
SDL_PIXELFORMAT_BGRX8888 |
|
SDL_PIXELFORMAT_ARGB8888 |
|
SDL_PIXELFORMAT_RGBA8888 |
|
SDL_PIXELFORMAT_ABGR8888 |
|
SDL_PIXELFORMAT_BGRA8888 |
|
SDL_PIXELFORMAT_ARGB2101010 |
|
SDL_PIXELFORMAT_RGBA32 |
alias for RGBA byte array of color data, for the current platform (>= SDL 2.0.5) |
SDL_PIXELFORMAT_ARGB32 |
alias for ARGB byte array of color data, for the current platform (>= SDL 2.0.5) |
SDL_PIXELFORMAT_BGRA32 |
alias for BGRA byte array of color data, for the current platform (>= SDL 2.0.5) |
SDL_PIXELFORMAT_ABGR32 |
alias for ABGR byte array of color data, for the current platform (>= SDL 2.0.5) |
SDL_PIXELFORMAT_YV12 |
planar mode: Y + V + U (3 planes) |
SDL_PIXELFORMAT_IYUV |
planar mode: Y + U + V (3 planes) |
SDL_PIXELFORMAT_YUY2 |
packed mode: Y0+U0+Y1+V0 (1 plane) |
SDL_PIXELFORMAT_UYVY |
packed mode: U0+Y0+V0+Y1 (1 plane) |
SDL_PIXELFORMAT_YVYU |
packed mode: Y0+V0+Y1+U0 (1 plane) |
SDL_PIXELFORMAT_NV12 |
planar mode: Y + U/V interleaved (2 planes) (>= SDL 2.0.4) |
SDL_PIXELFORMAT_NV21 |
planar mode: Y + V/U interleaved (2 planes) (>= SDL 2.0.4) |
Related Enumerations
