GLES2.0中文API-glGet
名稱
glGet - 返回所選引數的值
C規範
void glGetBooleanv( GLenum pname,
GLboolean * params);
void glGetFloatv( GLenum pname,
GLfloat * params);
void glGetIntegerv( GLenum pname,
GLint * params
引數
pname
指定要返回的引數值。接受下面列表中的符號常量。
params
返回指定引數的值。
描述
這些命令返回GL中簡單狀態變數的值。 pname是一個符號常量,表示要返回的狀態變數,params是一個指向指定型別陣列的指標,用於放置返回的資料。
如果params的型別與請求的狀態變數值不同,則執行型別轉換。如果呼叫glGetBooleanv,當且僅當它是0.0(或0)時,浮點(或整數)值才會轉換為GL_FALSE。否則,它將轉換為GL_TRUE。如果呼叫glGetIntegerv,則布林值將返回GL_TRUE或GL_FALSE,並且大多數浮點值將四捨五入為最接近的整數值。但是,浮點顏色和法線將返回一個線性對映,該對映將1.0對映到最正可表示的整數值,將-1.0對映到最負可表示的整數值。如果呼叫glGetFloatv,則布林值將作為GL_TRUE
GL_ACTIVE_TEXTURE
params返回一個表示活動多重紋理單元的值。初始值為GL_TEXTURE0。請參閱glActiveTexture。
GL_ALIASED_LINE_WIDTH_RANGE
params返回兩個值,即別名行的最小和最大支援寬度。範圍必須包括寬度1。
GL_ALIASED_POINT_SIZE_RANGE
params返回兩個值,即別名點支援的最小和最大尺寸。範圍必須包括1號。
GL_ALPHA_BITS
params返回一個值,即當前繫結的幀緩衝區的顏色緩衝區中的alpha位平面的數量。
GL_ARRAY_BUFFER_BINDING
params返回單個值,即當前繫結到目標GL_ARRAY_BUFFER的緩衝區物件的名稱。如果沒有緩衝區物件繫結到此目標,則返回0。初始值為0.請參閱glBindBuffer。
GL_BLEND
params返回一個布林值,指示是否啟用了混合。初始值為GL_FALSE。請參閱glBlendFunc。
GL_BLEND_COLOR
params返回四個值,紅色,綠色,藍色和alpha值,它們是混合顏色的組成部分。請參閱glBlendColor。
GL_BLEND_DST_ALPHA
params返回一個值,該符號常量標識alpha目標混合函式。初始值為GL_ZERO。請參閱glBlendFunc和glBlendFuncSeparate。
GL_BLEND_DST_RGB
params返回一個值,該符號常量標識RGB目標混合函式。初始值為GL_ZERO。請參閱glBlendFunc和glBlendFuncSeparate。
GL_BLEND_EQUATION_ALPHA
params返回一個值,一個符號常量,指示Alpha混合方程是GL_FUNC_ADD,GL_FUNC_SUBTRACT還是GL_FUNC_REVERSE_SUBTRACT。請參閱glBlendEquationSeparate。
GL_BLEND_EQUATION_RGB
params返回一個值,一個符號常量,指示RGB混合方程是GL_FUNC_ADD,GL_FUNC_SUBTRACT還是GL_FUNC_REVERSE_SUBTRACT。請參閱glBlendEquationSeparate。
GL_BLEND_SRC_ALPHA
params返回一個值,這是一個標識alpha源混合函式的符號常量。初始值為GL_ONE。請參閱glBlendFunc和glBlendFuncSeparate。
GL_BLEND_SRC_RGB
params返回一個值,這個符號常量標識RGB源混合函式。初始值為GL_ONE。請參閱glBlendFunc和glBlendFuncSeparate。
GL_BLUE_BITS
params返回一個值,即當前繫結的幀緩衝區的顏色緩衝區中的藍色位平面的數量。
GL_COLOR_CLEAR_VALUE
params返回四個值:用於清除顏色緩衝區的紅色,綠色,藍色和alpha值。如果請求,整數值從內部浮點表示線性對映,使得1.0返回最正可表示的整數值,-1.0返回最負可表示的整數值。初始值為(0,0,0,0)。請參閱glClearColor。
GL_COLOR_WRITEMASK
params返回四個布林值:紅色,綠色,藍色和alpha寫入啟用顏色緩衝區。初始值為(GL_TRUE,GL_TRUE,GL_TRUE,GL_TRUE)。請參閱glColorMask。
GL_COMPRESSED_TEXTURE_FORMATS
params返回長度為GL_NUM_COMPRESSED_TEXTURE_FORMATS的符號常量列表,指示哪些壓縮紋理格式可用。請參閱glCompressedTexImage2D。
GL_CULL_FACE
params返回一個布林值,指示是否啟用了多邊形剔除。初始值為GL_FALSE。請參閱glCullFace。
GL_CULL_FACE_MODE
params返回一個值,一個符號常量,指示要剔除哪些多邊形面。初始值為GL_BACK。請參閱glCullFace。
GL_CURRENT_PROGRAM
params返回一個值,即當前活動的程式物件的名稱,如果沒有程式物件處於活動狀態,則返回0。請參閱glUseProgram。
GL_DEPTH_BITS
params返回一個值,即當前繫結的幀緩衝區的深度緩衝區中的位平面數。
GL_DEPTH_CLEAR_VALUE
params返回一個值,該值用於清除深度緩衝區。如果請求,整數值從內部浮點表示線性對映,使得1.0返回最正可表示的整數值,-1.0返回最負可表示的整數值。初始值為1.請參閱glDepthRangef。
GL_DEPTH_FUNC
params返回一個值,表示深度比較函式的符號常量。初始值為GL_LESS。請參閱glDepthFunc。
GL_DEPTH_RANGE
params返回兩個值:深度緩衝區的近和遠對映限制。如果請求,整數值從內部浮點表示線性對映,使得1.0返回最正可表示的整數值,-1.0返回最負可表示的整數值。初始值為(0,1)。請參閱glDepthRangef。
GL_DEPTH_TEST
params返回一個布林值,指示是否啟用了片段的深度測試。初始值為GL_FALSE。請參閱glDepthFunc和glDepthRangef。
GL_DEPTH_WRITEMASK
params返回一個布林值,指示深度緩衝區是否已啟用寫入。初始值為GL_TRUE。請參閱glDepthMask。
GL_DITHER
params返回一個布林值,指示是否啟用了片段顏色和索引的抖動。初始值為GL_TRUE。
GL_ELEMENT_ARRAY_BUFFER_BINDING
params返回單個值,即當前繫結到目標GL_ELEMENT_ARRAY_BUFFER的緩衝區物件的名稱。如果沒有緩衝區物件繫結到此目標,則返回0。初始值為0.請參閱glBindBuffer。
GL_FRAMEBUFFER_BINDING
params返回單個值,即當前繫結的幀緩衝區的名稱。初始值為0,表示預設的幀緩衝區。請參閱glBindFramebuffer。
GL_FRONT_FACE
params返回一個值,一個符號常數,表示順時針或逆時針多邊形繞組是否被視為正面。初始值為GL_CCW。請參閱glFrontFace。
GL_GENERATE_MIPMAP_HINT
params返回一個值,一個符號常量,指示mipmap生成過濾提示的模式。初始值為GL_DONT_CARE。見glHint。
GL_GREEN_BITS
params返回一個值,即當前繫結的幀緩衝區的顏色緩衝區中的綠色位平面的數量。
GL_IMPLEMENTATION_COLOR_READ_FORMAT
params返回一個值,即實現選擇的格式,其中可以從當前繫結的幀緩衝區的顏色緩衝區中讀取畫素,並結合GL_IMPLEMENTATION_COLOR_READ_TYPE。除了這種依賴於實現的格式/型別對之外,每個實現始終允許格式GL_RGBA和型別GL_UNSIGNED_BYTE,而不管當前繫結的渲染表面如何。請參閱glReadPixels。
GL_IMPLEMENTATION_COLOR_READ_TYPE
params返回一個值,該實現選擇的型別可以從當前繫結的幀緩衝區的顏色緩衝區中讀取畫素,並結合GL_IMPLEMENTATION_COLOR_READ_FORMAT。除了這種依賴於實現的格式/型別對之外,每個實現始終允許格式GL_RGBA和型別GL_UNSIGNED_BYTE,而不管當前繫結的渲染表面如何。請參閱glReadPixels。
GL_LINE_WIDTH
params返回一個值,即glLineWidth指定的行寬。初始值為1。
GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS
params返回一個值,最大支援的紋理影象單元數,可用於從頂點著色器和片段處理器組合訪問紋理貼圖。如果頂點著色器和片段處理階段都訪問相同的紋理影象單元,則計數為使用兩個紋理影象單元來抵抗此限制。該值必須至少為8.請參閱glActiveTexture。
GL_MAX_CUBE_MAP_TEXTURE_SIZE
params返回一個值。該值粗略估計了GL可以處理的最大立方體貼圖紋理。該值必須至少為16.請參閱glTexImage2D。
GL_MAX_FRAGMENT_UNIFORM_VECTORS
params返回一個值,可以儲存在片段著色器的統一變數儲存中的四元素浮點數,整數或布林向量的最大數量。該值必須至少為16.請參閱glUniform。
GL_MAX_RENDERBUFFER_SIZE
params返回一個值。該值表示GL可以處理的最大渲染緩衝區寬度和高度。該值必須至少為1.請參閱glRenderbufferStorage。
GL_MAX_TEXTURE_IMAGE_UNITS
params返回一個值,這是支援的最大紋理影象單元,可用於從片段著色器訪問紋理貼圖。該值必須至少為8.請參閱glActiveTexture。
GL_MAX_TEXTURE_SIZE
params返回一個值。該值粗略估計了GL可以處理的最大紋理。該值必須至少為64.請參閱glTexImage2D。
GL_MAX_VARYING_VECTORS
params返回一個值,最大數量的四元素浮點向量可用於插入頂點和片段著色器使用的變數變數。宣告為矩陣或陣列的變數變數將使用多個插值器。該值必須至少為8。
GL_MAX_VERTEX_ATTRIBS
params返回一個值,即頂點著色器可訪問的4分量通用頂點屬性的最大數量。該值必須至少為8.請參閱glVertexAttrib。
GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS
params返回一個值,最大支援的紋理影象單元,可用於從頂點著色器訪問紋理貼圖。值可能為0.請參閱glActiveTexture。
GL_MAX_VERTEX_UNIFORM_VECTORS
params返回一個值,可以儲存在頂點著色器的統一變數儲存中的四元素浮點數,整數或布林向量的最大數量。該值必須至少為128.請參閱glUniform。
GL_MAX_VIEWPORT_DIMS
params返回兩個值:視口的最大支援寬度和高度。這些必須至少與要渲染的顯示器的可見尺寸一樣大。請參閱glViewport。
GL_NUM_COMPRESSED_TEXTURE_FORMATS
params返回一個整數值,表示可用的壓縮紋理格式的數量。最小值為0.請參閱glCompressedTexImage2D。
GL_NUM_SHADER_BINARY_FORMATS
params返回一個整數值,表示可用著色器二進位制格式的數量。最小值為0.請參閱glShaderBinary。
GL_PACK_ALIGNMENT
params返回一個值,用於將畫素資料寫入記憶體的位元組對齊。初始值為4.請參閱glReadPixels。
GL_POLYGON_OFFSET_FACTOR
params返回一個值,縮放因子用於確定新增到多邊形光柵化時生成的每個片段的深度值的變數偏移量。初始值為0.請參閱glPolygonOffset。
GL_POLYGON_OFFSET_FILL
params返回一個布林值,指示在填充模式下是否為多邊形啟用了多邊形偏移。初始值為GL_FALSE。請參閱glPolygonOffset。
GL_POLYGON_OFFSET_UNITS
params返回一個值。此值乘以特定於實現的值,然後新增到柵格化多邊形時生成的每個片段的深度值。初始值為0.請參閱glPolygonOffset。
GL_RED_BITS
params返回一個值,即當前繫結的幀緩衝區的顏色緩衝區中的紅色位平面的數量。
GL_RENDERBUFFER_BINDING
params返回單個值,即當前繫結的renderbuffer的名稱。初始值為0,表示沒有繫結渲染緩衝區。請參閱glBindRenderbuffer。
GL_SAMPLE_ALPHA_TO_COVERAGE
params返回一個布林值,指示片段覆蓋值是否應與基於片段的alpha值的臨時覆蓋值進行AND運算。初始值為GL_FALSE。請參閱glSampleCoverage。
GL_SAMPLE_BUFFERS
params返回一個整數值,表示與當前繫結的幀緩衝區關聯的樣本緩衝區的數量。請參閱glSampleCoverage。
GL_SAMPLE_COVERAGE
params返回一個布林值,指示片段覆蓋值是否應與基於當前樣本覆蓋值的臨時覆蓋值進行AND運算。初始值為GL_FALSE。請參閱glSampleCoverage。
GL_SAMPLE_COVERAGE_INVERT
params返回一個布林值,指示是否應該反轉臨時覆蓋值。請參閱glSampleCoverage。
GL_SAMPLE_COVERAGE_VALUE
params返回單個正浮點值,表示當前樣本覆蓋值。請參閱glSampleCoverage。
GL_SAMPLES
params返回一個整數值,表示當前繫結的幀緩衝區的coverage掩碼大小。請參閱glSampleCoverage。
GL_SCISSOR_BOX
params返回四個值:裁剪框的x和y視窗座標,後跟寬度和高度。最初,x和y視窗座標均為0,寬度和高度設定為視窗大小。見glScissor。
GL_SCISSOR_TEST
params返回一個布林值,指示是否啟用裁剪。初始值為GL_FALSE。見glScissor。
GL_SHADER_BINARY_FORMATS
params返回長度為GL_NUM_SHADER_BINARY_FORMATS的符號常量列表,指示哪些著色器二進位制格式可用。請參閱glShaderBinary。
GL_SHADER_COMPILER
params返回一個布林值,指示是否支援著色器編譯器。 GL_FALSE表示對glShaderSource,glCompileShader或glReleaseShaderCompiler的任何呼叫都將導致生成GL_INVALID_OPERATION錯誤。
GL_STENCIL_BACK_FAIL
params返回一個值,一個符號常量,指示當模板測試失敗時對後向多邊形採取的操作。初始值為GL_KEEP。請參閱glStencilOpSeparate。
GL_STENCIL_BACK_FUNC
params返回一個值,一個符號常量,指示用於後向多邊形的函式,以將模板參考值與模板緩衝區值進行比較。初始值為GL_ALWAYS。請參閱glStencilFuncSeparate。
GL_STENCIL_BACK_PASS_DEPTH_FAIL
params返回一個值,一個符號常量,表示當模板測試通過時對背面多邊形採取的操作,但深度測試失敗。初始值為GL_KEEP。請參閱glStencilOpSeparate。
GL_STENCIL_BACK_PASS_DEPTH_PASS
params返回一個值,一個符號常量,表示當模板測試通過並且深度測試通過時,對於背面多邊形採取的操作。初始值為GL_KEEP。請參閱glStencilOpSeparate。
GL_STENCIL_BACK_REF
params返回一個值,該值與背面多邊形的模板緩衝區內容進行比較。初始值為0.請參閱glStencilFuncSeparate。
GL_STENCIL_BACK_VALUE_MASK
params返回一個值,用於背面多邊形的掩碼在比較之前遮蔽模板參考值和模板緩衝區值。初始值全是1。請參閱glStencilFuncSeparate。
GL_STENCIL_BACK_WRITEMASK
params返回一個值,該值控制用於背面多邊形的模板位平面的寫入。初始值全是1。請參閱glStencilMask。
GL_STENCIL_BITS
params返回一個值,即當前繫結的幀緩衝區的模板緩衝區中的位平面數。
GL_STENCIL_CLEAR_VALUE
params返回一個值,即模板位平面被清除的索引。初始值為0.請參閱glClearStencil。
GL_STENCIL_FAIL
params返回一個值,一個符號常量,表示當前面的多邊形和非多邊形的模板測試失敗時採取的操作。初始值為GL_KEEP。請參閱glStencilOp和glStencilOpSeparate。
GL_STENCIL_FUNC
params返回一個值,一個符號常量,指示用於將模板參考值與前面多邊形和非多邊形的模板緩衝區值進行比較的函式。初始值為GL_ALWAYS。請參閱glStencilFunc和glStencilFuncSeparate。
GL_STENCIL_PASS_DEPTH_FAIL
params返回一個值,一個符號常量,表示模板測試通過時採取的操作,但前向多邊形和非多邊形的深度測試失敗。初始值為GL_KEEP。請參閱glStencilOp和glStencilOpSeparate。
GL_STENCIL_PASS_DEPTH_PASS
params返回一個值,一個符號常量,表示模板測試通過時採取的操作,深度測試通過前面的多邊形和非多邊形。初始值為GL_KEEP。請參閱glStencilOp和glStencilOpSeparate。
GL_STENCIL_REF
params返回一個值,該值與前面的多邊形和非多邊形的模板緩衝區的內容進行比較。初始值為0.請參閱glStencilFunc和glStencilFuncSeparate。
GL_STENCIL_TEST
params返回一個布林值,指示是否啟用了片段的模板測試。初始值為GL_FALSE。請參閱glStencilFunc和glStencilOp。
GL_STENCIL_VALUE_MASK
params返回一個值,該掩碼用於在比較前面的多邊形和非多邊形之前遮蔽模板參考值和模板緩衝區值。初始值全是1。請參閱glStencilFunc和glStencilFuncSeparate。
GL_STENCIL_WRITEMASK
params返回一個值,該控制元件用於控制前面的多邊形和非多邊形的模板位平面的寫入。初始值全是1。請參閱glStencilMask和glStencilMaskSeparate。
GL_SUBPIXEL_BITS
params返回一個值,即用於在視窗座標中定位柵格化幾何的子畫素解析度的位數估計值。該值必須至少為4。
GL_TEXTURE_BINDING_2D
params返回單個值,即當前繫結到活動多紋理單元的目標GL_TEXTURE_2D的紋理的名稱。初始值為0.請參閱glBindTexture。
GL_TEXTURE_BINDING_CUBE_MAP
params返回單個值,當前繫結到活動多紋理單元的目標GL_TEXTURE_CUBE_MAP的紋理的名稱。初始值為0.請參閱glBindTexture。
GL_UNPACK_ALIGNMENT
params返回一個值,用於從記憶體中讀取畫素資料的位元組對齊。初始值為4.請參閱glPixelStorei。
GL_VIEWPORT
params返回四個值:視口的x和y視窗座標,後跟其寬度和高度。最初,x和y視窗座標都設定為0,寬度和高度設定為GL將進行渲染的視窗的寬度和高度。請參閱glViewport。
使用glIsEnabled也可以更輕鬆地查詢許多布林引數。
錯誤
GL_INVALID_ENUM:pname不是前面列出的值之一
另見
glGetActiveAttrib,glGetActiveUniform,glGetAttachedShaders,glGetAttribLocation,glGetBufferParameteriv,glGetError,glGetFramebufferAttachmentParameteriv,glGetProgramiv,glGetProgramInfoLog,glGetRenderbufferParameteriv,glGetShaderiv,glGetShaderInfoLog,glGetShaderInfoLog,glGetString,glGetTexParameter,glGetUniform,glGetUniformLocation,glGetVertexAttrib,glGetVertexAttribPointerv,glIsEnabled
版權
https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glGet.xml
https://blog.csdn.net/flycatdeng
Copyright © 1991-2006 Silicon Graphics, Inc.本文件的許可是根據SGI Free Software B License.詳見http://oss.sgi.com/projects/FreeB/.