#pragma section-numbers off
#pragma disable-camelcase

= SDL_QueryTexture =
Use this function to query the attributes of a texture.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
int SDL_QueryTexture(SDL_Texture* texture,
                     Uint32*      format,
                     int*         access,
                     int*         w,
                     int*         h)
}}}

== Function Parameters ==

||'''texture'''||the texture to query||
||'''format'''||a pointer filled in with the raw format of the texture; the actual format may differ, but pixel transfers will use this format; see [[#format|Remarks]] for details||
||'''access'''||a pointer filled in with the actual access to the texture (one of the [[SDL_TextureAccess]] values)||
||'''w'''||a pointer filled in with the width of the texture in pixels||
||'''h'''||a pointer filled in with the height of the texture in pixels||

== Return Value ==
Returns 0 on success or a negative error code on failure; call [[SDL_GetError]]() for more information.

== Code Examples ==
{{{#!highlight cpp
SDL_Texture* source;

// loading etc ...

int w, h;
SDL_QueryTexture(source, NULL, NULL, &w, &h);

}}}

== Remarks ==
<<Anchor(format)>> '''format''' may be one of the following:
<<Include(SDL_PixelFormatEnum, , , from="=== Pixel Format Values ===", to="== Code Examples ==")>>

== Related Functions ==
 .[[SDL_CreateTexture]]

----
[[CategoryAPI]], [[CategoryRender]]