1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 5 <meta http-equiv="Content-Style-Type" content="text/css" /> 6 <link rel="stylesheet" href="../css/manpage.css" type="text/css" /> 7 <title>glGetTexLevelParameteriv</title> 8 </head> 9 <body> 10 <h1><CODE>glGetTexLevelParameteriv</CODE> Function</h1> 11 <h2>Syntax</h2> 12 <div class="section"> 13 <pre class="definition"> 14GL_APICALL void GL_APIENTRY glGetTexLevelParameteriv( 15 GLenum target, 16 GLint level, 17 GLenum pname, 18 GLint * params 19); 20</pre> 21 </div> 22 <h2>Parameters</h2> 23 <div class="section"> 24 <table class="arguments"> 25 <thead> 26 <tr> 27 <td width="15" /> 28 <th>Name</th> 29 <td>Description</td> 30 </tr> 31 </thead> 32 <tr> 33 <td>in</td> 34 <th>target</th> 35 <td>Texture target to get</td> 36 </tr> 37 <tr> 38 <td>in</td> 39 <th>level</th> 40 <td>Mipmap level of parameter to get</td> 41 </tr> 42 <tr> 43 <td>in</td> 44 <th>pname</th> 45 <td>Parameter to get</td> 46 </tr> 47 <tr> 48 <td>out</td> 49 <th>params</th> 50 <td>Pointer to the location where the acquired parameter is stored.</td> 51 </tr> </table> 52 </div> 53 <h2>Return Values</h2> 54 <div class="section">No values are returned. </div> 55 <h2>Description</h2> 56 <div class="section"> 57 <p>Gets the texture level parameter.</p><P> 58 Set <span class="argument">target</span> to one the following values. Procedural textures are not supported. 59 <TABLE><TR><TH>GL_TEXTURE_2D</TH><TD>2D texture.</TD></TR><TR><TH><CODE>GL_TEXTURE_CUBE_MAP_NEGATIVE_X</CODE></TH><TD>Face of a cube-map texture in the negative x direction. </TD></TR><TR><TH><CODE>GL_TEXTURE_CUBE_MAP_POSITIVE_X</CODE></TH><TD>Face of a cube-map texture in the positive x direction. </TD></TR><TR><TH><CODE>GL_TEXTURE_CUBE_MAP_NEGATIVE_Y</CODE></TH><TD>Face of a cube-map texture in the negative y direction.</TD></TR><TR><TH><CODE>GL_TEXTURE_CUBE_MAP_POSITIVE_Y</CODE></TH><TD>Face of a cube-map texture in the positive y direction.</TD></TR><TR><TH><CODE>GL_TEXTURE_CUBE_MAP_NEGATIVE_Z</CODE></TH><TD>Face of a cube-map texture in the negative z direction.</TD></TR><TR><TH><CODE>GL_TEXTURE_CUBE_MAP_POSITIVE_Z</CODE></TH><TD>Face of a cube-map texture in the positive z direction.</TD></TR></TABLE></P><P> 60 The values that can be specified in <SPAN class="argument">pname</SPAN> and the paramter that can be retrieved in <SPAN class="argument">params</SPAN> are shown in the table below. 61 <TABLE><TR><TH><CODE>GL_TEXTURE_WIDTH</CODE></TH><TD>Width of texture (in pixels).</TD></TR><TR><TH><CODE>GL_TEXTURE_HEIGHT</CODE></TH><TD>Height of texture (in pixels).</TD></TR><!-- <TR> <TH>GL_TEXTURE_DEPTH</TH> <TD>テクスチャの奥行きのピクセル数(未対応のため必ず 0 が返ります)</TD> </TR> <TR> <TH>GL_TEXTURE_BORDER</TH> <TD>テクスチャボーダー幅のピクセル数(未対応のため必ず 0 が返ります)</TD> </TR> --><TR><TH><CODE>GL_TEXTURE_INTERNAL_FORMAT</CODE></TH><TD>Internal format of texture.</TD></TR><TR><TH><CODE>GL_TEXTURE_RED_SIZE</CODE></TH><TD>Red component of each pixel (in bits).</TD></TR><TR><TH><CODE>GL_TEXTURE_GREEN_SIZE</CODE></TH><TD>Green component of each pixel (in bits).</TD></TR><TR><TH><CODE>GL_TEXTURE_BLUE_SIZE</CODE></TH><TD>Blue component of each pixel (in bits).</TD></TR><TR><TH><CODE>GL_TEXTURE_ALPHA</CODE></TH><TD>Alpha component of each pixel (in bits).</TD></TR><TR><TH><CODE>GL_TEXTURE_LUMINANCE_SIZE</CODE></TH><TD>Luminance component of each pixel (in bits).</TD></TR><TR><TH><CODE>GL_TEXTURE_INTENSITY_SIZE</CODE></TH><TD>Intensity component of each pixel (in bits). Only valid with <CODE>GL_SHADOW_DMP</CODE> format.</TD></TR><TR><TH><CODE>GL_TEXTURE_DEPTH_SIZE</CODE></TH><TD>Depth component of each pixel (in bits). Only valid with <CODE>GL_SHADOW_DMP</CODE> format.</TD></TR><TR><TH><CODE>GL_TEXTURE_DENSITY1_SIZE_DMP</CODE></TH><TD>Density info 1 of each pixel (only valid with <CODE>GL_GAS_DMP</CODE> format; density information that does not take into account intersection with gas texture density information).</TD></TR><TR><TH><CODE>GL_TEXTURE_DENSITY2_SIZE_DMP</CODE></TH><TD>Density info 2 of each pixel (only valid with <CODE>GL_GAS_DMP</CODE> format; density information that takes into account intersection with gas texture density information).</TD></TR><TR><TH><CODE>GL_TEXTURE_COMPRESSED</CODE></TH><TD><CODE>TRUE</CODE> if the texture is a compressed format; <CODE>FALSE</CODE> if not compressed.</TD></TR><TR><TH><CODE>GL_TEXTURE_COMPRESSED_IMAGE_SIZE</CODE></TH><TD>If the texture is a compressed format, the byte size of the mipmap level specified by <SPAN class="argument">level</SPAN>.</TD></TR></TABLE></P><P> 62 The internal-format values obtained by <CODE>GL_TEXTURE_INTERNAL_FORMAT</CODE> and the corresponding bit counts of the component pixels are as follows. 63 <TABLE><TR><TH>Internal Formats</TH><TH>Red (255/0/0)</TH><TH>Green (0/255/0)</TH><TH>Blue (0/0/255)</TH><TH>Alpha</TH><TH>Brightness</TH><TH>Intensity</TH><TH>Depth</TH><TH>Density 1</TH><TH>Density 2</TH></TR><TR><TD><CODE>GL_RGBA4</CODE></TD><TD>4</TD><TD>4</TD><TD>4</TD><TD>4</TD><TD /><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_RGB5_A1</CODE></TD><TD>5</TD><TD>5</TD><TD>5</TD><TD>1</TD><TD /><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_RGBA</CODE></TD><TD>8</TD><TD>8</TD><TD>8</TD><TD>8</TD><TD /><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_RGB565</CODE></TD><TD>5</TD><TD>6</TD><TD>5</TD><TD /><TD /><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_RGB</CODE></TD><TD>8</TD><TD>8</TD><TD>8</TD><TD /><TD /><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_ALPHA</CODE></TD><TD /><TD /><TD /><TD>8</TD><TD /><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_ALPHA4_EXT</CODE></TD><TD /><TD /><TD /><TD>4</TD><TD /><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_LUMINANCE</CODE></TD><TD /><TD /><TD /><TD /><TD>8</TD><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_LUMINANCE4_EXT</CODE></TD><TD /><TD /><TD /><TD /><TD>4</TD><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_LUMINANCE_ALPHA</CODE></TD><TD /><TD /><TD /><TD>8</TD><TD>8</TD><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_LUMINANCE4_ALPHA4_EXT</CODE></TD><TD /><TD /><TD /><TD>4</TD><TD>4</TD><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_SHADOW_DMP</CODE></TD><TD /><TD /><TD /><TD /><TD /><TD>8</TD><TD>24</TD><TD /><TD /></TR><TR><TD><CODE>GL_GAS_DMP</CODE></TD><TD /><TD /><TD /><TD /><TD /><TD /><TD /><TD>16</TD><TD>16</TD></TR><TR><TD><CODE>GL_HILO8_DMP</CODE></TD><TD>8</TD><TD>8</TD><TD /><TD /><TD /><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_ETC1_RGB8_NATIVE_DMP</CODE></TD><TD>8</TD><TD>8</TD><TD>8</TD><TD /><TD /><TD /><TD /><TD /><TD /></TR><TR><TD><CODE>GL_ETC1_ALPHA_RGB8_A4_NATIVE_DMP</CODE></TD><TD>8</TD><TD>8</TD><TD>8</TD><TD>4</TD><TD /><TD /><TD /><TD /><TD /></TR></TABLE></P><P> 64 This function generates the following errors. 65 <TABLE><TR><TH><CODE>GL_INVALID_OPERATION</CODE></TH><TD>If <CODE>TEXTURE_COMPRESSED_IMAGE_SIZE</CODE> is specified for an uncompressed texture.</TD></TR><TR><TH><CODE>GL_INVALID_ENUM</CODE></TH><TD>The <span class="argument">target</span> or <span class="argument">pname</span> argument was set to an invalid value.</TD></TR><TR><TH><CODE>GL_INVALID_VALUE</CODE></TH><TD>If an unloaded mipmap level is specified in <SPAN class="argument">level</SPAN>.</TD></TR></TABLE></P></div> 66 <h2>Revision History</h2> 67 <div class="section"> 68 <dl class="history"> 69 <dt>2011/03/18</dt> 70 <dd>Initial version.<br /> 71 </dd> 72 </dl> 73 </div> 74 <hr><p>CONFIDENTIAL</p></body> 75</html> 76