|
Size: 1245
Comment: add categories
|
Size: 1263
Comment: insert anchor
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 16: | Line 16: |
| ||'''format'''||one of the enumerated values in [[SDL_PixelFormatEnum]], or 0 to pick an appropriate format; see [[#Remarks|Remarks]] for details|| | ||'''format'''||one of the enumerated values in [[SDL_PixelFormatEnum]], or 0 to pick an appropriate format; see [[#format|Remarks]] for details|| |
| Line 30: | Line 30: |
| '''format''' can have any one of these values: | <<Anchor(format)>> '''format''' can have any one of these values: |
SDL_CreateTextureFromSurface
Use this function to create a texture from an existing surface.
Contents
Syntax
SDL_TextureID SDL_CreateTextureFromSurface(Uint32 format,
SDL_Surface* surface)
Function Parameters
format |
one of the enumerated values in SDL_PixelFormatEnum, or 0 to pick an appropriate format; see Remarks for details |
surface |
the surface containing pixel data used to fill the texture |
Return Value
The created texture is returned, or 0 if no rendering context was active, the format was unsupported, or the surface width or height were out of range; call SDL_GetError() for more information.
Code Examples
You can add your code example here
Remarks
The surface is not modified or freed by this function.
format can have any one of these values:
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) |
