SDL_GetTextureProperties

テクスチャに関連付けられたプロパティを得る

ヘッダ

SDL_PropertiesID SDL_GetTextureProperties(SDL_Texture *texture);

texture

問い合わせるテクスチャ

(SDL_PropertiesID) 成功のときプロパティグループID, 失敗のとき0を戻す. SDL_GetError()を呼んで詳細を知ることができる.

SDLから次の読取専用プロパティが提供されている:

SDL_PROP_TEXTURE_COLORSPACE_NUMBER: テクスチャの色空間を表すSDL_Colorspaceの値
SDL_PROP_TEXTURE_FORMAT_NUMBER: SDL_PixelFormat列挙体の値の1つ
SDL_PROP_TEXTURE_ACCESS_NUMBER: SDL_TextureAccess列挙体の値の1つ
SDL_PROP_TEXTURE_WIDTH_NUMBER: テクスチャの幅ピクセル数
SDL_PROP_TEXTURE_HEIGHT_NUMBER: テクスチャの高さピクセル数
SDL_PROP_TEXTURE_SDR_WHITE_POINT_FLOAT: HDR10および浮動小数点テクスチャ用. この値は100% diffuse white(拡散反射の白)の値で, それ以上の値はHDR(ハイダイナミックレンジ)ヘッドルームとして表示される. デフォルトはHDR10テクスチャの場合は100で, 他のテクスチャの場合は1.0である.
SDL_PROP_TEXTURE_HDR_HEADROOM_FLOAT: HDR10および浮動小数点テクスチャ用. SDR(スタンダードダイナミックレンジ)ホワイトポイントの基準で, 表示で使用される最大ダイナミックレンジの値. これが定義されているとき, ディスプレイの対応外の値は有効なHDRヘッドルーム内にスケーリングされる. 定義されていない場合は切り捨てられるデフォルトは, SDRテクスチャの場合は1.0, HDR10テクスチャの場合は4.0, 浮動小数点テクスチャの場合はデフォルトはない

direct3d11レンダラの場合:

direct3d12レンダラの場合:

vulkanレンダラの場合:

openglレンダラの場合:

SDL_PROP_TEXTURE_OPENGL_TEXTURE_NUMBER: テクスチャのGLuintテクスチャ
SDL_PROP_TEXTURE_OPENGL_TEXTURE_UV_NUMBER: NV12テクスチャのUVプレーンのGLuintテクスチャ
SDL_PROP_TEXTURE_OPENGL_TEXTURE_U_NUMBER: YUVテクスチャのUプレーンのGLuint
SDL_PROP_TEXTURE_OPENGL_TEXTURE_V_NUMBER: YUVテクスチャのVプレーンのGLuint
SDL_PROP_TEXTURE_OPENGL_TEXTURE_TARGET_NUMBER: テクスチャターゲット(GL_TEXTURE_2D, GL_TEXTURE_RECTANGLE_ARBなど)のGLenum
SDL_PROP_TEXTURE_OPENGL_TEX_W_FLOAT: テクスチャ座標系のテクスチャ幅 (0.0 - 1.0)
SDL_PROP_TEXTURE_OPENGL_TEX_H_FLOAT: テクスチャ座標系のテクスチャ高さ (0.0 - 1.0)

opengles2レンダラの場合:

SDL_PROP_TEXTURE_OPENGLES2_TEXTURE_NUMBER: テクスチャのGLuintテクスチャ
SDL_PROP_TEXTURE_OPENGLES2_TEXTURE_UV_NUMBER: テクスチャのUVプレーンのGLuintテクスチャ
SDL_PROP_TEXTURE_OPENGLES2_TEXTURE_U_NUMBER: YUVテクスチャのUプレーンのGLuint
SDL_PROP_TEXTURE_OPENGLES2_TEXTURE_V_NUMBER: YUVテクスチャのVプレーンのGLuint
SDL_PROP_TEXTURE_OPENGLES2_TEXTURE_TARGET_NUMBER: テクスチャターゲット(GL_TEXTURE_2D, GL_TEXTURE_RECTANGLE_ARBなど)のGLenum

gpuレンダラの場合:

この関数を呼べるのはメインスレッドのみである.

SDL 3.2.0以降