--- title: WebGLRenderingContext.getParameter() slug: Web/API/WebGLRenderingContext/getParameter tags: - WebGL translation_of: Web/API/WebGLRenderingContext/getParameter ---
{{APIRef("WebGL")}}

WebGL APIWebGLRenderingContext.getParameter() 方法为传入的参数名称返回一个值。

语法

any gl.getParameter(pname);

参数

pname
一个指定要返回哪个参数值的 {{domxref("GLenum")}}。请参阅下文的可能值。

返回值

取决于参数。

参数名称

WebGL 1

使用 {{domxref("WebGLRenderingContext")}} 时,您可以查询以下 pname 参数。

常量 返回类型 描述
gl.ACTIVE_TEXTURE {{domxref("GLenum")}}  
gl.ALIASED_LINE_WIDTH_RANGE {{jsxref("Float32Array")}} (with 2 elements)  
gl.ALIASED_POINT_SIZE_RANGE {{jsxref("Float32Array")}} (with 2 elements)  
gl.ALPHA_BITS {{domxref("GLint")}}  
gl.ARRAY_BUFFER_BINDING {{domxref("WebGLBuffer")}}  
gl.BLEND {{domxref("GLboolean")}}  
gl.BLEND_COLOR {{jsxref("Float32Array")}} (with 4 values)  
gl.BLEND_DST_ALPHA {{domxref("GLenum")}}  
gl.BLEND_DST_RGB {{domxref("GLenum")}}  
gl.BLEND_EQUATION {{domxref("GLenum")}}  
gl.BLEND_EQUATION_ALPHA {{domxref("GLenum")}}  
gl.BLEND_EQUATION_RGB {{domxref("GLenum")}}  
gl.BLEND_SRC_ALPHA {{domxref("GLenum")}}  
gl.BLEND_SRC_RGB {{domxref("GLenum")}}  
gl.BLUE_BITS {{domxref("GLint")}}  
gl.COLOR_CLEAR_VALUE {{jsxref("Float32Array")}} (with 4 values)  
gl.COLOR_WRITEMASK sequence<{{domxref("GLboolean")}}> (with 4 values)  
gl.COMPRESSED_TEXTURE_FORMATS {{jsxref("Uint32Array")}} 返回压缩的纹理格式。

当使用 {{domxref("WEBGL_compressed_texture_s3tc")}} 扩展时:
  • ext.COMPRESSED_RGB_S3TC_DXT1_EXT
  • ext.COMPRESSED_RGBA_S3TC_DXT1_EXT
  • ext.COMPRESSED_RGBA_S3TC_DXT3_EXT
  • ext.COMPRESSED_RGBA_S3TC_DXT5_EXT

当使用 {{domxref("WEBGL_compressed_texture_s3tc_srgb")}} 扩展时:

  • ext.COMPRESSED_SRGB_S3TC_DXT1_EXT
  • ext.COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
  • ext.COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
  • ext.COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
当使用 {{domxref("WEBGL_compressed_texture_es3")}} 扩展时:
  • ext.COMPRESSED_R11_EAC
  • ext.COMPRESSED_SIGNED_R11_EAC
  • ext.COMPRESSED_RG11_EAC
  • ext.COMPRESSED_SIGNED_RG11_EAC
  • ext.COMPRESSED_RGB8_ETC2
  • ext.COMPRESSED_RGBA8_ETC2_EAC
  • ext.COMPRESSED_SRGB8_ETC2
  • ext.COMPRESSED_SRGB8_ALPHA8_ETC2_EAC
  • ext.COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2
  • ext.COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2
当使用 {{domxref("WEBGL_compressed_texture_pvrtc")}} 扩展时:
  • ext.COMPRESSED_RGB_PVRTC_4BPPV1_IMG
  • ext.COMPRESSED_RGBA_PVRTC_4BPPV1_IMG
  • ext.COMPRESSED_RGB_PVRTC_2BPPV1_IMG
  • ext.COMPRESSED_RGBA_PVRTC_2BPPV1_IMG
当使用 {{domxref("WEBGL_compressed_texture_etc1")}} 扩展时:
  • ext.COMPRESSED_RGB_ETC1_WEBGL
当使用 {{domxref("WEBGL_compressed_texture_atc")}} 扩展时:
  • ext.COMPRESSED_RGB_ATC_WEBGL
  • ext.COMPRESSED_RGBA_ATC_EXPLICIT_ALPHA_WEBGL
  • ext.COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL
当使用 {{domxref("WEBGL_compressed_texture_astc")}} 扩展时:
  • ext.COMPRESSED_RGBA_ASTC_4x4_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR
  • ext.COMPRESSED_RGBA_ASTC_5x4_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR
  • ext.COMPRESSED_RGBA_ASTC_5x5_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR
  • ext.COMPRESSED_RGBA_ASTC_6x5_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR
  • ext.COMPRESSED_RGBA_ASTC_6x6_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR
  • ext.COMPRESSED_RGBA_ASTC_8x5_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR
  • ext.COMPRESSED_RGBA_ASTC_8x6_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR
  • ext.COMPRESSED_RGBA_ASTC_8x8_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR
  • ext.COMPRESSED_RGBA_ASTC_10x5_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR
  • ext.COMPRESSED_RGBA_ASTC_10x6_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR
  • ext.COMPRESSED_RGBA_ASTC_10x6_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR
  • ext.COMPRESSED_RGBA_ASTC_10x10_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR
  • ext.COMPRESSED_RGBA_ASTC_12x10_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR
  • ext.COMPRESSED_RGBA_ASTC_12x12_KHR
    ext.COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR
gl.CULL_FACE {{domxref("GLboolean")}}  
gl.CULL_FACE_MODE {{domxref("GLenum")}}  
gl.CURRENT_PROGRAM {{domxref("WebGLProgram")}}  
gl.DEPTH_BITS {{domxref("GLint")}}  
gl.DEPTH_CLEAR_VALUE {{domxref("GLfloat")}}  
gl.DEPTH_FUNC {{domxref("GLenum")}}  
gl.DEPTH_RANGE {{jsxref("Float32Array")}} (with 2 elements)  
gl.DEPTH_TEST {{domxref("GLboolean")}}  
gl.DEPTH_WRITEMASK {{domxref("GLboolean")}}  
gl.DITHER {{domxref("GLboolean")}}  
gl.ELEMENT_ARRAY_BUFFER_BINDING {{domxref("WebGLBuffer")}}  
gl.FRAMEBUFFER_BINDING {{domxref("WebGLFramebuffer")}}  
gl.FRONT_FACE {{domxref("GLenum")}}  
gl.GENERATE_MIPMAP_HINT {{domxref("GLenum")}}  
gl.GREEN_BITS {{domxref("GLint")}}  
gl.IMPLEMENTATION_COLOR_READ_FORMAT {{domxref("GLenum")}}  
gl.IMPLEMENTATION_COLOR_READ_TYPE {{domxref("GLenum")}}  
gl.LINE_WIDTH {{domxref("GLfloat")}}  
gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS {{domxref("GLint")}}  
gl.MAX_CUBE_MAP_TEXTURE_SIZE {{domxref("GLint")}}  
gl.MAX_FRAGMENT_UNIFORM_VECTORS {{domxref("GLint")}}  
gl.MAX_RENDERBUFFER_SIZE {{domxref("GLint")}}  
gl.MAX_TEXTURE_IMAGE_UNITS {{domxref("GLint")}}  
gl.MAX_TEXTURE_SIZE {{domxref("GLint")}}  
gl.MAX_VARYING_VECTORS {{domxref("GLint")}}  
gl.MAX_VERTEX_ATTRIBS {{domxref("GLint")}}  
gl.MAX_VERTEX_TEXTURE_IMAGE_UNITS {{domxref("GLint")}}  
gl.MAX_VERTEX_UNIFORM_VECTORS {{domxref("GLint")}}  
gl.MAX_VIEWPORT_DIMS {{jsxref("Int32Array")}} (with 2 elements)  
gl.PACK_ALIGNMENT {{domxref("GLint")}}  
gl.POLYGON_OFFSET_FACTOR {{domxref("GLfloat")}}  
gl.POLYGON_OFFSET_FILL {{domxref("GLboolean")}}  
gl.POLYGON_OFFSET_UNITS {{domxref("GLfloat")}}  
gl.RED_BITS {{domxref("GLint")}}  
gl.RENDERBUFFER_BINDING {{domxref("WebGLRenderbuffer")}}  
gl.RENDERER {{domxref("DOMString")}}  
gl.SAMPLE_BUFFERS {{domxref("GLint")}}  
gl.SAMPLE_COVERAGE_INVERT {{domxref("GLboolean")}}  
gl.SAMPLE_COVERAGE_VALUE {{domxref("GLfloat")}}  
gl.SAMPLES {{domxref("GLint")}}  
gl.SCISSOR_BOX {{jsxref("Int32Array")}} (with 4 elements)  
gl.SCISSOR_TEST {{domxref("GLboolean")}}  
gl.SHADING_LANGUAGE_VERSION {{domxref("DOMString")}}  
gl.STENCIL_BACK_FAIL {{domxref("GLenum")}}  
gl.STENCIL_BACK_FUNC {{domxref("GLenum")}}  
gl.STENCIL_BACK_PASS_DEPTH_FAIL {{domxref("GLenum")}}  
gl.STENCIL_BACK_PASS_DEPTH_PASS {{domxref("GLenum")}}  
gl.STENCIL_BACK_REF {{domxref("GLint")}}  
gl.STENCIL_BACK_VALUE_MASK {{domxref("GLuint")}}  
gl.STENCIL_BACK_WRITEMASK {{domxref("GLuint")}}  
gl.STENCIL_BITS {{domxref("GLint")}}  
gl.STENCIL_CLEAR_VALUE {{domxref("GLint")}}  
gl.STENCIL_FAIL {{domxref("GLenum")}}  
gl.STENCIL_FUNC {{domxref("GLenum")}}  
gl.STENCIL_PASS_DEPTH_FAIL {{domxref("GLenum")}}  
gl.STENCIL_PASS_DEPTH_PASS {{domxref("GLenum")}}  
gl.STENCIL_REF {{domxref("GLint")}}  
gl.STENCIL_TEST {{domxref("GLboolean")}}  
gl.STENCIL_VALUE_MASK {{domxref("GLuint")}}  
gl.STENCIL_WRITEMASK {{domxref("GLuint")}}  
gl.SUBPIXEL_BITS {{domxref("GLint")}}  
gl.TEXTURE_BINDING_2D {{domxref("WebGLTexture")}}  
gl.TEXTURE_BINDING_CUBE_MAP {{domxref("WebGLTexture")}}  
gl.UNPACK_ALIGNMENT {{domxref("GLint")}}  
gl.UNPACK_COLORSPACE_CONVERSION_WEBGL {{domxref("GLenum")}}  
gl.UNPACK_FLIP_Y_WEBGL {{domxref("GLboolean")}}  
gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL {{domxref("GLboolean")}}  
gl.VENDOR {{domxref("DOMString")}}  
gl.VERSION {{domxref("DOMString")}}  
gl.VIEWPORT {{jsxref("Int32Array")}} (with 4 elements)  

WebGL 2

使用 {{domxref("WebGL2RenderingContext")}} 时,您可以查询以下 pname 参数。

常量 返回类型 描述
gl.COPY_READ_BUFFER_BINDING {{domxref("WebGLBuffer")}}  
gl.COPY_WRITE_BUFFER_BINDING {{domxref("WebGLBuffer")}}  
gl.DRAW_BUFFERi {{domxref("GLenum")}}  
gl.DRAW_FRAMEBUFFER_BINDING {{domxref("WebGLFramebuffer")}}  
gl.FRAGMENT_SHADER_DERIVATIVE_HINT {{domxref("GLenum")}}  
gl.MAX_3D_TEXTURE_SIZE {{domxref("GLint")}}  
gl.MAX_ARRAY_TEXTURE_LAYERS {{domxref("GLint")}}  
gl.MAX_CLIENT_WAIT_TIMEOUT_WEBGL {{domxref("GLint64")}}  
gl.MAX_COLOR_ATTACHMENTS {{domxref("GLint")}}  
gl.MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS {{domxref("GLint64")}}  
gl.MAX_COMBINED_UNIFORM_BLOCKS {{domxref("GLint")}}  
gl.MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS {{domxref("GLint64")}}  
gl.MAX_DRAW_BUFFERS {{domxref("GLint")}}  
gl.MAX_ELEMENT_INDEX {{domxref("GLint64")}}  
gl.MAX_ELEMENTS_INDICES {{domxref("GLint")}}  
gl.MAX_ELEMENTS_VERTICES {{domxref("GLint")}}  
gl.MAX_FRAGMENT_INPUT_COMPONENTS {{domxref("GLint")}}  
gl.MAX_FRAGMENT_UNIFORM_BLOCKS {{domxref("GLint")}}  
gl.MAX_FRAGMENT_UNIFORM_COMPONENTS {{domxref("GLint")}}  
gl.MAX_PROGRAM_TEXEL_OFFSET {{domxref("GLint")}}  
gl.MAX_SAMPLES {{domxref("GLint")}}  
gl.MAX_SERVER_WAIT_TIMEOUT {{domxref("GLint64")}}  
gl.MAX_TEXTURE_LOD_BIAS {{domxref("GLfloat")}}  
gl.MAX_TRANSFORM_FEEDBACK_INTERLEAVED_COMPONENTS {{domxref("GLint")}}  
gl.MAX_TRANSFORM_FEEDBACK_SEPARATE_ATTRIBS {{domxref("GLint")}}  
gl.MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS {{domxref("GLint")}}  
gl.MAX_UNIFORM_BLOCK_SIZE {{domxref("GLint64")}}  
gl.MAX_UNIFORM_BUFFER_BINDINGS {{domxref("GLint")}}  
gl.MAX_VARYING_COMPONENTS {{domxref("GLint")}}  
gl.MAX_VERTEX_OUTPUT_COMPONENTS {{domxref("GLint")}}  
gl.MAX_VERTEX_UNIFORM_BLOCKS {{domxref("GLint")}}  
gl.MAX_VERTEX_UNIFORM_COMPONENTS {{domxref("GLint")}}  
gl.MIN_PROGRAM_TEXEL_OFFSET {{domxref("GLint")}}  
gl.PACK_ROW_LENGTH {{domxref("GLint")}}  
gl.PACK_SKIP_PIXELS {{domxref("GLint")}}  
gl.PACK_SKIP_ROWS {{domxref("GLint")}}  
gl.PIXEL_PACK_BUFFER_BINDING {{domxref("WebGLBuffer")}}  
gl.PIXEL_UNPACK_BUFFER_BINDING {{domxref("WebGLBuffer")}}  
gl.RASTERIZER_DISCARD {{domxref("GLboolean")}}  
gl.READ_BUFFER {{domxref("GLenum")}}  
gl.READ_FRAMEBUFFER_BINDING {{domxref("WebGLFramebuffer")}}  
gl.SAMPLE_ALPHA_TO_COVERAGE {{domxref("GLboolean")}}  
gl.SAMPLE_COVERAGE {{domxref("GLboolean")}}  
gl.SAMPLER_BINDING {{domxref("WebGLSampler")}}  
gl.TEXTURE_BINDING_2D_ARRAY {{domxref("WebGLTexture")}}  
gl.TEXTURE_BINDING_3D {{domxref("WebGLTexture")}}  
gl.TRANSFORM_FEEDBACK_ACTIVE {{domxref("GLboolean")}}  
gl.TRANSFORM_FEEDBACK_BINDING {{domxref("WebGLTransformFeedback")}}  
gl.TRANSFORM_FEEDBACK_BUFFER_BINDING {{domxref("WebGLBuffer")}}  
gl.TRANSFORM_FEEDBACK_PAUSED {{domxref("GLboolean")}}  
gl.UNIFORM_BUFFER_BINDING {{domxref("WebGLBuffer")}}  
gl.UNIFORM_BUFFER_OFFSET_ALIGNMENT {{domxref("GLint")}}  
gl.UNPACK_IMAGE_HEIGHT {{domxref("GLint")}}  
gl.UNPACK_ROW_LENGTH {{domxref("GLint")}}  
gl.UNPACK_SKIP_IMAGES {{domxref("GLint")}}  
gl.UNPACK_SKIP_PIXELS {{domxref("GLint")}}  
gl.UNPACK_SKIP_ROWS {{domxref("GLint")}}  
gl.VERTEX_ARRAY_BINDING {{domxref("WebGLVertexArrayObject")}}  

WebGL 扩展

当使用 WebGL 扩展 时,您可以查询以下 pname 参数:

常量 返回类型 扩展 描述
ext.MAX_TEXTURE_MAX_ANISOTROPY_EXT {{domxref("GLfloat")}} {{domxref("EXT_texture_filter_anisotropic")}} 最大可用各向异性。
ext.FRAGMENT_SHADER_DERIVATIVE_HINT_OES {{domxref("GLenum")}} {{domxref("OES_standard_derivatives")}} GLSL 内置函数的导数计算精度:dFdx、 dFdy 和 fwidth
ext.MAX_COLOR_ATTACHMENTS_WEBGL {{domxref("GLint")}} {{domxref("WEBGL_draw_buffers")}} 帧缓冲区颜色附着点的最大数量。
ext.MAX_DRAW_BUFFERS_WEBGL {{domxref("GLint")}} {{domxref("WEBGL_draw_buffers")}} 绘图缓冲区的最大数量。
ext.DRAW_BUFFER0_WEBGL
ext.DRAW_BUFFER1_WEBGL
ext.DRAW_BUFFER2_WEBGL
ext.DRAW_BUFFER3_WEBGL
ext.DRAW_BUFFER4_WEBGL
ext.DRAW_BUFFER5_WEBGL
ext.DRAW_BUFFER6_WEBGL
ext.DRAW_BUFFER7_WEBGL
ext.DRAW_BUFFER8_WEBGL
ext.DRAW_BUFFER9_WEBGL
ext.DRAW_BUFFER10_WEBGL
ext.DRAW_BUFFER11_WEBGL
ext.DRAW_BUFFER12_WEBGL
ext.DRAW_BUFFER13_WEBGL
ext.DRAW_BUFFER14_WEBGL
ext.DRAW_BUFFER15_WEBGL
{{domxref("GLenum")}} {{domxref("WEBGL_draw_buffers")}} 绘图缓冲区。
ext.VERTEX_ARRAY_BINDING_OES {{domxref("WebGLVertexArrayObjectOES")}} {{domxref("OES_vertex_array_object")}} 绑定的顶点数组对象(VAO)。
ext.TIMESTAMP_EXT {{domxref("GLuint64EXT")}}

{{domxref("EXT_disjoint_timer_query")}}

当前时间。
ext.GPU_DISJOINT_EXT {{domxref("GLboolean")}} {{domxref("EXT_disjoint_timer_query")}}

返回 GPU 是否执行了任何不相交的操作。

示例

gl.getParameter(gl.DITHER);
gl.getParameter(gl.VERSION);
gl.getParameter(gl.VIEWPORT);

规范

规范 状态 注释
{{SpecName('WebGL', "#5.14.3", "getParameter")}} {{Spec2('WebGL')}} 初始定义。
{{SpecName('WebGL2', "#3.7.2", "getParameter")}} {{Spec2('WebGL2')}} 添加额外的参数名称。
{{SpecName('OpenGL ES 2.0', "glGet.xml", "glGet")}} {{Spec2('OpenGL ES 2.0')}} (类似的)OpenGL API的手册页。

浏览器兼容性

{{Compat("api.WebGLRenderingContext.getParameter")}}

另请参阅