SDL_GPUTextureCreateInfo.3type - Man Page

A structure specifying the parameters of a texture.

Header File

Defined in SDL3/SDL_gpu.h

Synopsis

#include "SDL3/SDL.h"

typedef struct SDL_GPUTextureCreateInfo
{
    SDL_GPUTextureType type;          /**< The base dimensionality of the texture. */
    SDL_GPUTextureFormat format;      /**< The pixel format of the texture. */
    SDL_GPUTextureUsageFlags usage;   /**< How the texture is intended to be used by the client. */
    Uint32 width;                     /**< The width of the texture. */
    Uint32 height;                    /**< The height of the texture. */
    Uint32 layer_count_or_depth;      /**< The layer count or depth of the texture. This value is treated as a layer count on 2D array textures, and as a depth value on 3D textures. */
    Uint32 num_levels;                /**< The number of mip levels in the texture. */
    SDL_GPUSampleCount sample_count;  /**< The number of samples per texel. Only applies if the texture is used as a render target. */

    SDL_PropertiesID props;           /**< A properties ID for extensions. Should be 0 if no extensions are needed. */
} SDL_GPUTextureCreateInfo;

Description

Usage flags can be bitwise OR'd together for combinations of usages. Note that certain usage combinations are invalid, for example SAMPLER and GRAPHICS_STORAGE.

Availability

This struct is available since SDL 3.2.0.

See Also

·(3), SDL_CreateGPUTexture(3), ·(3), SDL_GPUTextureType(3type), ·(3), SDL_GPUTextureFormat(3type), ·(3), SDL_GPUTextureUsageFlags(3type), ·(3), SDL_GPUSampleCount(3type)

Info

SDL 3.2.2 Simple Directmedia Layer SDL3 DATATYPES