title | short-title | slug | page-type | browser-compat |
---|---|---|---|---|
WebGLRenderingContext: getParameter() method |
getParameter() |
Web/API/WebGLRenderingContext/getParameter |
web-api-instance-method |
api.WebGLRenderingContext.getParameter |
{{APIRef("WebGL")}}
The WebGLRenderingContext.getParameter()
method of the WebGL API returns a value for the passed
parameter name.
getParameter(pname)
pname
- : A {{domxref("WebGL_API/Types", "GLenum")}} specifying which parameter value to return. See below for possible values.
Depends on the parameter.
You can query the following pname
parameters when using a
{{domxref("WebGLRenderingContext")}}.
Constant | Returned type | Description |
---|---|---|
gl.ACTIVE_TEXTURE |
{{domxref("WebGL_API/Types", "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("WebGL_API/Types", "GLint")}} | |
gl.ARRAY_BUFFER_BINDING |
{{domxref("WebGLBuffer")}} | |
gl.BLEND |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.BLEND_COLOR |
{{jsxref("Float32Array")}} (with 4 values) | |
gl.BLEND_DST_ALPHA |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.BLEND_DST_RGB |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.BLEND_EQUATION |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.BLEND_EQUATION_ALPHA |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.BLEND_EQUATION_RGB |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.BLEND_SRC_ALPHA |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.BLEND_SRC_RGB |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.BLUE_BITS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.COLOR_CLEAR_VALUE |
{{jsxref("Float32Array")}} (with 4 values) | |
gl.COLOR_WRITEMASK |
sequence<{{domxref("WebGL_API/Types", "GLboolean")}}> (with 4 values) | |
gl.COMPRESSED_TEXTURE_FORMATS |
{{jsxref("Uint32Array")}} |
Returns the compressed texture formats. When using the {{domxref("WEBGL_compressed_texture_s3tc")}} extension:
When using the {{domxref("WEBGL_compressed_texture_s3tc_srgb")}} extension:
|
gl.CULL_FACE |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.CULL_FACE_MODE |
{{domxref("WebGL_API/Types", "GLenum")}} |
gl.FRONT , gl.BACK or
gl.FRONT_AND_BACK . See also
{{domxref("WebGLRenderingContext/cullFace", "cullFace")}}
|
gl.CURRENT_PROGRAM |
{{domxref("WebGLProgram")}} or null |
See {{domxref("WebGLRenderingContext/useProgram", "useProgram")}}. |
gl.DEPTH_BITS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.DEPTH_CLEAR_VALUE |
{{domxref("WebGL_API/Types", "GLfloat")}} | |
gl.DEPTH_FUNC |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.DEPTH_RANGE |
{{jsxref("Float32Array")}} (with 2 elements) | |
gl.DEPTH_TEST |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.DEPTH_WRITEMASK |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.DITHER |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.ELEMENT_ARRAY_BUFFER_BINDING |
{{domxref("WebGLBuffer")}} | |
gl.FRAMEBUFFER_BINDING |
{{domxref("WebGLFramebuffer")}} or null |
null corresponds to a binding to the default framebuffer.
See also
{{domxref("WebGLRenderingContext/bindFramebuffer", "bindFramebuffer")}}.
|
gl.FRONT_FACE |
{{domxref("WebGL_API/Types", "GLenum")}} |
gl.CW or gl.CCW . See also
{{domxref("WebGLRenderingContext/frontFace", "frontFace")}}.
|
gl.GENERATE_MIPMAP_HINT |
{{domxref("WebGL_API/Types", "GLenum")}} |
gl.FASTEST , gl.NICEST or
gl.DONT_CARE . See also
{{domxref("WebGLRenderingContext/hint", "hint")}}.
|
gl.GREEN_BITS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.IMPLEMENTATION_COLOR_READ_FORMAT |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.IMPLEMENTATION_COLOR_READ_TYPE |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.LINE_WIDTH |
{{domxref("WebGL_API/Types", "GLfloat")}} | |
gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_CUBE_MAP_TEXTURE_SIZE |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_FRAGMENT_UNIFORM_VECTORS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_RENDERBUFFER_SIZE |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_TEXTURE_IMAGE_UNITS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_TEXTURE_SIZE |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_VARYING_VECTORS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_VERTEX_ATTRIBS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_VERTEX_TEXTURE_IMAGE_UNITS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_VERTEX_UNIFORM_VECTORS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_VIEWPORT_DIMS |
{{jsxref("Int32Array")}} (with 2 elements) | |
gl.PACK_ALIGNMENT |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.POLYGON_OFFSET_FACTOR |
{{domxref("WebGL_API/Types", "GLfloat")}} | |
gl.POLYGON_OFFSET_FILL |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.POLYGON_OFFSET_UNITS |
{{domxref("WebGL_API/Types", "GLfloat")}} | |
gl.RED_BITS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.RENDERBUFFER_BINDING |
{{domxref("WebGLRenderbuffer")}} or null |
See {{domxref("WebGLRenderingContext/bindRenderbuffer", "bindRenderbuffer")}}. |
gl.RENDERER |
string | |
gl.SAMPLE_BUFFERS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.SAMPLE_COVERAGE_INVERT |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.SAMPLE_COVERAGE_VALUE |
{{domxref("WebGL_API/Types", "GLfloat")}} | |
gl.SAMPLES |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.SCISSOR_BOX |
{{jsxref("Int32Array")}} (with 4 elements) | |
gl.SCISSOR_TEST |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.SHADING_LANGUAGE_VERSION |
string | |
gl.STENCIL_BACK_FAIL |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.STENCIL_BACK_FUNC |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.STENCIL_BACK_PASS_DEPTH_FAIL |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.STENCIL_BACK_PASS_DEPTH_PASS |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.STENCIL_BACK_REF |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.STENCIL_BACK_VALUE_MASK |
{{domxref("WebGL_API/Types", "GLuint")}} | |
gl.STENCIL_BACK_WRITEMASK |
{{domxref("WebGL_API/Types", "GLuint")}} | |
gl.STENCIL_BITS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.STENCIL_CLEAR_VALUE |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.STENCIL_FAIL |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.STENCIL_FUNC |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.STENCIL_PASS_DEPTH_FAIL |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.STENCIL_PASS_DEPTH_PASS |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.STENCIL_REF |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.STENCIL_TEST |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.STENCIL_VALUE_MASK |
{{domxref("WebGL_API/Types", "GLuint")}} | |
gl.STENCIL_WRITEMASK |
{{domxref("WebGL_API/Types", "GLuint")}} | |
gl.SUBPIXEL_BITS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.TEXTURE_BINDING_2D |
{{domxref("WebGLTexture")}} or null |
|
gl.TEXTURE_BINDING_CUBE_MAP |
{{domxref("WebGLTexture")}} or null |
|
gl.UNPACK_ALIGNMENT |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.UNPACK_COLORSPACE_CONVERSION_WEBGL |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.UNPACK_FLIP_Y_WEBGL |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.VENDOR |
string | |
gl.VERSION |
string | |
gl.VIEWPORT |
{{jsxref("Int32Array")}} (with 4 elements) |
You can query the following pname
parameters when using a
{{domxref("WebGL2RenderingContext")}}.
Constant | Returned type | Description |
---|---|---|
gl.COPY_READ_BUFFER_BINDING |
{{domxref("WebGLBuffer")}} or null |
See {{domxref("WebGLRenderingContext/bindBuffer", "bindBuffer")}}. |
gl.COPY_WRITE_BUFFER_BINDING |
{{domxref("WebGLBuffer")}} or null |
See {{domxref("WebGLRenderingContext/bindBuffer", "bindBuffer")}}. |
gl.DRAW_BUFFERi
|
{{domxref("WebGL_API/Types", "GLenum")}} |
gl.BACK , gl.NONE or
gl.COLOR_ATTACHMENT{0-15} . See also
{{domxref("WebGL2RenderingContext/drawBuffers", "drawBuffers")}}.
|
gl.DRAW_FRAMEBUFFER_BINDING |
{{domxref("WebGLFramebuffer")}} or null |
null corresponds to a binding to the default framebuffer.
See also
{{domxref("WebGLRenderingContext/bindFramebuffer", "bindFramebuffer")}}.
|
gl.FRAGMENT_SHADER_DERIVATIVE_HINT |
{{domxref("WebGL_API/Types", "GLenum")}} |
gl.FASTEST , gl.NICEST or
gl.DONT_CARE . See also
{{domxref("WebGLRenderingContext/hint", "hint")}}.
|
gl.MAX_3D_TEXTURE_SIZE |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_ARRAY_TEXTURE_LAYERS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_CLIENT_WAIT_TIMEOUT_WEBGL |
{{domxref("WebGL_API/Types", "GLint64")}} | |
gl.MAX_COLOR_ATTACHMENTS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS |
{{domxref("WebGL_API/Types", "GLint64")}} | |
gl.MAX_COMBINED_UNIFORM_BLOCKS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS |
{{domxref("WebGL_API/Types", "GLint64")}} | |
gl.MAX_DRAW_BUFFERS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_ELEMENT_INDEX |
{{domxref("WebGL_API/Types", "GLint64")}} | |
gl.MAX_ELEMENTS_INDICES |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_ELEMENTS_VERTICES |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_FRAGMENT_INPUT_COMPONENTS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_FRAGMENT_UNIFORM_BLOCKS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_FRAGMENT_UNIFORM_COMPONENTS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_PROGRAM_TEXEL_OFFSET |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_SAMPLES |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_SERVER_WAIT_TIMEOUT |
{{domxref("WebGL_API/Types", "GLint64")}} | |
gl.MAX_TEXTURE_LOD_BIAS |
{{domxref("WebGL_API/Types", "GLfloat")}} | |
gl.MAX_TRANSFORM_FEEDBACK_INTERLEAVED_COMPONENTS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_TRANSFORM_FEEDBACK_SEPARATE_ATTRIBS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_UNIFORM_BLOCK_SIZE |
{{domxref("WebGL_API/Types", "GLint64")}} | |
gl.MAX_UNIFORM_BUFFER_BINDINGS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_VARYING_COMPONENTS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_VERTEX_OUTPUT_COMPONENTS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_VERTEX_UNIFORM_BLOCKS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MAX_VERTEX_UNIFORM_COMPONENTS |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.MIN_PROGRAM_TEXEL_OFFSET |
{{domxref("WebGL_API/Types", "GLint")}} | |
gl.PACK_ROW_LENGTH |
{{domxref("WebGL_API/Types", "GLint")}} | See {{domxref("WebGLRenderingContext/pixelStorei", "pixelStorei")}}. |
gl.PACK_SKIP_PIXELS |
{{domxref("WebGL_API/Types", "GLint")}} | See {{domxref("WebGLRenderingContext/pixelStorei", "pixelStorei")}}. |
gl.PACK_SKIP_ROWS |
{{domxref("WebGL_API/Types", "GLint")}} | See {{domxref("WebGLRenderingContext/pixelStorei", "pixelStorei")}}. |
gl.PIXEL_PACK_BUFFER_BINDING |
{{domxref("WebGLBuffer")}} or null |
See {{domxref("WebGLRenderingContext/bindBuffer", "bindBuffer")}}. |
gl.PIXEL_UNPACK_BUFFER_BINDING |
{{domxref("WebGLBuffer")}} or null |
See {{domxref("WebGLRenderingContext/bindBuffer", "bindBuffer")}}. |
gl.RASTERIZER_DISCARD |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.READ_BUFFER |
{{domxref("WebGL_API/Types", "GLenum")}} | |
gl.READ_FRAMEBUFFER_BINDING |
{{domxref("WebGLFramebuffer")}} or null |
null corresponds to a binding to the default framebuffer.
See also
{{domxref("WebGLRenderingContext/bindFramebuffer", "bindFramebuffer")}}.
|
gl.SAMPLE_ALPHA_TO_COVERAGE |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.SAMPLE_COVERAGE |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.SAMPLER_BINDING |
{{domxref("WebGLSampler")}} or null |
See {{domxref("WebGL2RenderingContext/bindSampler", "bindSampler")}}. |
gl.TEXTURE_BINDING_2D_ARRAY |
{{domxref("WebGLTexture")}} or null |
See {{domxref("WebGLRenderingContext/bindTexture", "bindTexture")}}. |
gl.TEXTURE_BINDING_3D |
{{domxref("WebGLTexture")}} or null |
See {{domxref("WebGLRenderingContext/bindTexture", "bindTexture")}}. |
gl.TRANSFORM_FEEDBACK_ACTIVE |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.TRANSFORM_FEEDBACK_BINDING |
{{domxref("WebGLTransformFeedback")}} or null
|
See {{domxref("WebGL2RenderingContext/bindTransformFeedback", "bindTransformFeedback")}}. |
gl.TRANSFORM_FEEDBACK_BUFFER_BINDING |
{{domxref("WebGLBuffer")}} or null |
See {{domxref("WebGLRenderingContext/bindBuffer", "bindBuffer")}}. |
gl.TRANSFORM_FEEDBACK_PAUSED |
{{domxref("WebGL_API/Types", "GLboolean")}} | |
gl.UNIFORM_BUFFER_BINDING |
{{domxref("WebGLBuffer")}} or null |
See {{domxref("WebGLRenderingContext/bindBuffer", "bindBuffer")}}. |
gl.UNIFORM_BUFFER_OFFSET_ALIGNMENT |
{{domxref("WebGL_API/Types", "GLint")}} | See {{domxref("WebGLRenderingContext/pixelStorei", "pixelStorei")}}. |
gl.UNPACK_IMAGE_HEIGHT |
{{domxref("WebGL_API/Types", "GLint")}} | See {{domxref("WebGLRenderingContext/pixelStorei", "pixelStorei")}}. |
gl.UNPACK_ROW_LENGTH |
{{domxref("WebGL_API/Types", "GLint")}} | See {{domxref("WebGLRenderingContext/pixelStorei", "pixelStorei")}}. |
gl.UNPACK_SKIP_IMAGES |
{{domxref("WebGL_API/Types", "GLint")}} | See {{domxref("WebGLRenderingContext/pixelStorei", "pixelStorei")}}. |
gl.UNPACK_SKIP_PIXELS |
{{domxref("WebGL_API/Types", "GLint")}} | See {{domxref("WebGLRenderingContext/pixelStorei", "pixelStorei")}}. |
gl.UNPACK_SKIP_ROWS |
{{domxref("WebGL_API/Types", "GLint")}} | See {{domxref("WebGLRenderingContext/pixelStorei", "pixelStorei")}}. |
gl.VERTEX_ARRAY_BINDING |
{{domxref("WebGLVertexArrayObject")}} or null
|
See {{domxref("WebGL2RenderingContext/bindVertexArray", "bindVertexArray")}}. |
You can query the following pname
parameters when using WebGL extensions:
Constant | Returned type | Extension | Description |
---|---|---|---|
ext.MAX_TEXTURE_MAX_ANISOTROPY_EXT |
{{domxref("WebGL_API/Types", "GLfloat")}} | {{domxref("EXT_texture_filter_anisotropic")}} | Maximum available anisotropy. |
ext.FRAGMENT_SHADER_DERIVATIVE_HINT_OES |
{{domxref("WebGL_API/Types", "GLenum")}} | {{domxref("OES_standard_derivatives")}} |
Accuracy of the derivative calculation for the GLSL built-in functions:
dFdx , dFdy , and fwidth .
|
ext.MAX_COLOR_ATTACHMENTS_WEBGL |
{{domxref("WebGL_API/Types", "GLint")}} | {{domxref("WEBGL_draw_buffers")}} | The maximum number of framebuffer color attachment points. |
ext.MAX_DRAW_BUFFERS_WEBGL |
{{domxref("WebGL_API/Types", "GLint")}} | {{domxref("WEBGL_draw_buffers")}} | The maximum number of draw buffers. |
ext.DRAW_BUFFER0_WEBGL
|
{{domxref("WebGL_API/Types", "GLenum")}} | {{domxref("WEBGL_draw_buffers")}} | Drawing buffers. |
ext.VERTEX_ARRAY_BINDING_OES |
{{domxref("WebGLVertexArrayObject", "WebGLVertexArrayObjectOES")}} | {{domxref("OES_vertex_array_object")}} | Bound vertex array object (VAO). |
ext.TIMESTAMP_EXT |
{{domxref("WebGL_API/Types", "GLuint64EXT")}} | {{domxref("EXT_disjoint_timer_query")}} |
The current time. |
ext.GPU_DISJOINT_EXT |
{{domxref("WebGL_API/Types", "GLboolean")}} | {{domxref("EXT_disjoint_timer_query")}} |
Returns whether or not the GPU performed any disjoint operation. |
ext.MAX_VIEWS_OVR |
{{domxref("WebGL_API/Types", "GLint")}} | {{domxref("OVR_multiview2")}} | Maximum number of views. |
gl.getParameter(gl.DITHER);
gl.getParameter(gl.VERSION);
gl.getParameter(gl.VIEWPORT);
{{Specifications}}
{{Compat}}
- {{domxref("WebGLRenderingContext.enable()")}}
- {{domxref("WebGLRenderingContext.disable()")}}
- {{domxref("EXT_texture_filter_anisotropic")}}
- {{domxref("OES_standard_derivatives")}}
- {{domxref("WEBGL_draw_buffers")}}
- {{domxref("EXT_disjoint_timer_query")}}