====== (This is the legacy documentation for stable SDL2, the current stable version; [https://wiki.libsdl.org/SDL3/ SDL3] is the current development version.) ====== = SDL_CreateTexture = Create a texture for a rendering context. == Syntax == SDL_Texture * SDL_CreateTexture(SDL_Renderer * renderer, Uint32 format, int access, int w, int h); == Function Parameters == {| |'''renderer''' |the rendering context |- |'''format''' |one of the enumerated values in [[SDL_PixelFormatEnum]] |- |'''access''' |one of the enumerated values in [[SDL_TextureAccess]] |- |'''w''' |the width of the texture in pixels |- |'''h''' |the height of the texture in pixels |} == Return Value == Returns a pointer to the created texture or NULL if no rendering context was active, the format was unsupported, or the width or height were out of range; call [[SDL_GetError]]() for more information. == Remarks == You can set the texture scaling method by setting [[SDL_HINT_RENDER_SCALE_QUALITY]] before creating the texture. == Version == This function is available since SDL 2.0.0. == Related Functions == :[[SDL_CreateTextureFromSurface]] :[[SDL_DestroyTexture]] :[[SDL_QueryTexture]] :[[SDL_UpdateTexture]] ---- [[CategoryAPI]]