WebGLRenderingContext: getParameter() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Note: This feature is available in Web Workers.
Phương thức WebGLRenderingContext.getParameter() của WebGL API trả về một giá trị cho tên tham số đã truyền.
Cú pháp
js
getParameter(pname)
Thông số
Giá trị trả về
Phụ thuộc vào tham số.
Tên tham số
WebGL 1
Bạn có thể truy vấn các tham số pname sau đây khi sử dụng WebGLRenderingContext.
| Không đổi | Loại trả về | Mô tả |
|---|---|---|
gl.ACTIVE_TEXTURE | GLenum | |
gl.ALIASED_LINE_WIDTH_RANGE | Float32Array (với 2 phần tử) | |
gl.ALIASED_POINT_SIZE_RANGE | Float32Array (có 2 phần tử) | |
gl.ALPHA_BITS | GLint | |
gl.ARRAY_BUFFER_BINDING | WebGLBuffer | |
gl.BLEND | GLboolean | |
gl.BLEND_COLOR | Float32Array (với 4 giá trị) | |
gl.BLEND_DST_ALPHA | GLenum | |
gl.BLEND_DST_RGB | GLenum | |
gl.BLEND_EQUATION | GLenum | |
gl.BLEND_EQUATION_ALPHA | GLenum | |
gl.BLEND_EQUATION_RGB | GLenum | |
gl.BLEND_SRC_ALPHA | GLenum | TOK236�� |
gl.BLEND_SRC_RGB | GLenum | |
gl.BLUE_BITS | GLint | |
gl.COLOR_CLEAR_VALUE | Float32Array (với 4 giá trị) | |
gl.COLOR_WRITEMASK | chuỗi<GLboolean> (với 4 giá trị) | |
gl.COMPRESSED_TEXTURE_FORMATS | Uint32Array | Trả về kết cấu đã nén định dạng. Khi sử dụng phần mở rộng WEBGL_compressed_texture_s3tc:
Khi sử dụng tiện ích mở rộng
WEBGL_compressed_texture_etc:
WEBGL_compressed_texture_pvrtc:
WEBGL_compressed_texture_etc1:
WEBGL_compressed_texture_astc:
|
gl.CULL_FACE | GLboolean | |
gl.CULL_FACE_MODE | GLenum | gl.FRONT, gl.BACK hoặc gl.FRONT_AND_BACK. Xem thêm cullFace |
gl.CURRENT_PROGRAM | WebGLProgram hoặc null | Xem useProgram. |
gl.DEPTH_BITS | GLint | |
gl.DEPTH_CLEAR_VALUE | GLfloat | |
gl.DEPTH_FUNC | GLenum | |
gl.DEPTH_RANGE | Float32Array (có 2 phần tử) | |
gl.DEPTH_TEST | GLboolean | |
gl.DEPTH_WRITEMASK | GLboolean | |
gl.DITHER | GLboolean | |
gl.ELEMENT_ARRAY_BUFFER_BINDING | WebGLBuffer | |
gl.FRAMEBUFFER_BINDING | WebGLFramebuffer hoặc null | null tương ứng với việc liên kết với bộ đệm khung mặc định. Xem thêm bindFramebuffer. |
gl.FRONT_FACE | GLenum | gl.CW hoặc gl.CCW. Xem thêm frontFace. |
gl.GENERATE_MIPMAP_HINT | GLenum | gl.FASTEST, gl.NICEST hoặc gl.DONT_CARE. Xem thêm hint. |
gl.GREEN_BITS | GLint | |
gl.IMPLEMENTATION_COLOR_READ_FORMAT | GLenum | |
gl.IMPLEMENTATION_COLOR_READ_TYPE | GLenum | |
gl.LINE_WIDTH | GLfloat | |
gl.MAX_COMBIND_TEXTURE_IMAGE_UNITS | GLint | |
gl.MAX_CUBE_MAP_TEXTURE_SIZE | GLint | |
gl.MAX_FRAGMENT_UNIFORM_VECTORS | GLint | |
gl.MAX_RENDERBUFFER_SIZE | GLint | |
gl.MAX_TEXTURE_IMAGE_UNITS | GLint | |
gl.MAX_TEXTURE_SIZE | GLint | |
gl.MAX_VARYING_VECTORS | GLint | |
gl.MAX_VERTEX_ATTRIBS | GLint | |
gl.MAX_VERTEX_TEXTURE_IMAGE_UNITS | GLint | |
gl.MAX_VERTEX_UNIFORM_VECTORS | GLint | |
gl.MAX_VIEWPORT_DIMS | Int32Array (với 2 phần tử) | |
gl.PACK_ALIGNMENT | GLint | |
gl.POLYGON_OFFSET_FACTOR | GLfloat | |
gl.POLYGON_OFFSET_FILL | GLboolean | |
gl.POLYGON_OFFSET_UNITS | GLfloat | |
gl.RED_BITS | GLint | |
gl.RENDERBUFFER_BINDING | WebGLRenderbuffer hoặc null | Xem bindRenderbuffer. |
gl.RENDERER | string | |
gl.SAMPLE_BUFFERS | GLint | |
gl.SAMPLE_COVERAGE_INVERT | GLboolean | |
gl.SAMPLE_COVERAGE_VALUE | GLfloat | |
gl.SAMPLES | GLint | |
gl.SCISSOR_BOX | Int32Array (có 4 phần tử) | |
gl.SCISSOR_TEST | GLboolean | |
gl.SHADING_LANGUAGE_VERSION | chuỗi | |
gl.STENCIL_BACK_FAIL | GLenum | |
gl.STENCIL_BACK_FUNC | GLenum | |
gl.STENCIL_BACK_PASS_DEPTH_FAIL | GLenum | |
gl.STENCIL_BACK_PASS_DEPTH_PASS | GLenum | |
gl.STENCIL_BACK_REF | GLint | |
gl.STENCIL_BACK_VALUE_MASK | GLuint | |
gl.STENCIL_BACK_WRITEMASK | GLuint | |
gl.STENCIL_BITS | GLint | |
gl.STENCIL_CLEAR_VALUE | ��TOK79 | |
gl.STENCIL_FAIL | GLenum | |
gl.STENCIL_FUNC | GLenum | |
gl.STENCIL_PASS_DEPTH_FAIL | GLenum | |
gl.STENCIL_PASS_DEPTH_PASS | GLenum | |
gl.STENCIL_REF | GLint | |
gl.STENCIL_TEST | GLboolean | |
gl.STENCIL_VALUE_MASK | GLuint | |
gl.STENCIL_WRITEMASK | GLuint | |
gl.SUBPIXEL_BITS | GLint | |
gl.TEXTURE_BINDING_2D | WebGLTexture hoặc null | |
gl.TEXTURE_BINDING_CUBE_MAP | WebGLTexture hoặc null | |
gl.UNPACK_ALIGNMENT | GLint | |
gl.UNPACK_COLORSPACE_CONVERSION_WEBGL | GLenum | |
gl.UNPACK_FLIP_Y_WEBGL | GLboolean | |
gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL | GLboolean | |
gl.VENDOR | chuỗi | |
gl.VERSION | string | |
gl.VIEWPORT | Int32Array (với 4 phần tử) |
WebGL 2
Bạn có thể truy vấn các tham số pname sau đây khi sử dụng WebGL2RenderingContext.
���TOK544 ��TOK663 Xem
pixelStorei. | Không đổi | Loại trả về | Mô tả | |
|---|---|---|---|
gl.COPY_READ_BUFFER_BINDING | WebGLBuffer hoặc null | Xem bindBuffer. | |
gl.COPY_WRITE_BUFFER_BINDING | WebGLBuffer hoặc null | Xem bindBuffer. | |
gl.DRAW_BUFFERi | GLenum | gl.BACK, gl.NONE hoặc gl.COLOR_ATTACHMENT{0-15}. Xem thêm drawBuffers. | |
gl.DRAW_FRAMEBUFFER_BINDING | WebGLFramebuffer hoặc null | null tương ứng với việc liên kết với bộ đệm khung mặc định. Xem thêm bindFramebuffer. | |
gl.FRAGMENT_SHADER_DERIVATIVE_HINT | GLenum | gl.FASTEST, gl.NICEST hoặc gl.DONT_CARE. Xem thêm hint. | |
gl.MAX_3D_TEXTURE_SIZE | GLint | ||
gl.MAX_ARRAY_TEXTURE_LAYERS | GLint | ||
gl.MAX_CLIENT_WAIT_TIMEOUT_WEBGL | GLint64 | ||
gl.MAX_COLOR_ATTACHMENTS | GLint | ||
gl.MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS | GLint64 | ||
gl.MAX_COMBIND_UNIFORM_BLOCKS | GLint | ||
gl.MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS | GLint64 | ||
gl.MAX_DRAW_BUFFERS | GLint | ||
gl.MAX_ELEMENT_INDEX | GLint64 | ||
gl.MAX_ELEMENTS_INDICES | ��TOK19 | ||
gl.MAX_ELEMENTS_VERTICES | GLint | ||
gl.MAX_FRAGMENT_INPUT_COMPONENTS | GLint | ||
gl.MAX_FRAGMENT_UNIFORM_BLOCKS | GLint | ||
gl.MAX_FRAGMENT_UNIFORM_COMPONENTS | GLint | ||
gl.MAX_PROGRAM_TEXEL_OFFSET | GLint | ||
gl.MAX_SAMPLES | GLint | ||
gl.MAX_SERVER_WAIT_TIMEOUT | GLint64 | ||
gl.MAX_TEXTURE_LOD_BIAS | GLfloat | ||
gl.MAX_TRANSFORM_FEEDBACK_INTERLEAVED_COMPONENTS | GLint | ||
gl.MAX_TRANSFORM_FEEDBACK_SEPARATE_ATTRIBS | GLint | ||
gl.MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS | GLint | ||
gl.MAX_UNIFORM_BLOCK_SIZE | GLint64 | ||
gl.MAX_UNIFORM_BUFFER_BINDINGS | GLint | ||
gl.MAX_VARYING_COMPONENTS | GLint | ||
gl.MAX_VERTEX_OUTPUT_COMPONENTS | GLint | ||
gl.MAX_VERTEX_UNIFORM_BLOCKS | GLint | ||
gl.MAX_VERTEX_UNIFORM_COMPONENTS | GLint | ||
gl.MIN_PROGRAM_TEXEL_OFFSET | GLint | ||
gl.PACK_ROW_LENGTH | GLint | Xem pixelStorei. | |
gl.PACK_SKIP_PIXELS | GLint | Xem pixelStorei. | |
gl.PACK_SKIP_ROWS | GLint | Xem pixelStorei. | |
gl.PIXEL_PACK_BUFFER_BINDING | WebGLBuffer hoặc null | Xem bindBuffer. | |
gl.PIXEL_UNPACK_BUFFER_BINDING | WebGLBuffer hoặc null | Xem bindBuffer. | |
gl.RASTERIZER_DISCARD | GLboolean | ||
gl.READ_BUFFER | GLenum | ||
gl.READ_FRAMEBUFFER_BINDING | WebGLFramebuffer hoặc null | null tương ứng với việc liên kết với bộ đệm khung mặc định. Xem thêm bindFramebuffer. | |
gl.SAMPLE_ALPHA_TO_COVERAGE | GLboolean | ||
gl.SAMPLE_COVERAGE | GLboolean | ||
gl.SAMPLER_BINDING | WebGLSampler hoặc null | Xem bindSampler. | |
gl.TEXTURE_BINDING_2D_ARRAY | WebGLTexture hoặc null | Xem bindTexture. hoặc null | Xem bindTexture. |
gl.TRANSFORM_FEEDBACK_ACTIVE | GLboolean | ||
gl.TRANSFORM_FEEDBACK_BINDING | WebGLTransformFeedback hoặc null | Xem bindTransformFeedback. | |
gl.TRANSFORM_FEEDBACK_BUFFER_BINDING | WebGLBuffer hoặc null | Xem bindBuffer. | |
gl.TRANSFORM_FEEDBACK_PAUSED | GLboolean | ||
gl.UNIFORM_BUFFER_BINDING | WebGLBuffer hoặc null | Xem bindBuffer. | |
gl.UNIFORM_BUFFER_OFFSET_ALIGNMENT | GLint | Xem pixelStorei. | |
gl.UNPACK_IMAGE_HEIGHT | GLint | ||
gl.UNPACK_ROW_LENGTH | GLint | Xem pixelStorei. | |
gl.UNPACK_SKIP_IMAGES | GLint | Xem pixelStorei. | |
gl.UNPACK_SKIP_PIXELS | GLint | Xem pixelStorei. | |
gl.UNPACK_SKIP_ROWS | GLint | Xem pixelStorei. | |
gl.VERTEX_ARRAY_BINDING | WebGLVertexArrayObject hoặc null | Xem bindVertexArray. |
phần mở rộng WebGL
Bạn có thể truy vấn các tham số pname sau khi sử dụng phần mở rộng WebGL:
| Không đổi | Loại trả về | Extension | Mô tả |
|---|---|---|---|
ext.MAX_TEXTURE_MAX_ANISOTROPY_EXT | GLfloat | EXT_texture_filter_anisotropic | Tính bất đẳng hướng tối đa có sẵn. |
ext.FRAGMENT_SHADER_DERIVATIVE_HINT_OES | GLenum | OES_standard_derivatives | Độ chính xác của phép tính đạo hàm cho các hàm dựng sẵn GLSL: dFdx, dFdy, và băng thông. |
ext.MAX_COLOR_ATTACHMENTS_WEBGL | GLint | WEBGL_draw_buffers | Số điểm gắn màu bộ đệm khung tối đa. |
ext.MAX_DRAW_BUFFERS_WEBGL | GLint | WEBGL_draw_buffersTOK72�� | Số lượng bộ đệm vẽ tối đa. |
ext.DRAW_BUFFER0_WEBGL
| GLenum | WEBGL_draw_buffers | Bộ đệm vẽ. |
ext.VERTEX_ARRAY_BINDING_OES | WebGLVertexArrayObjectOES | OES_vertex_array_object | Đối tượng mảng đỉnh giới hạn (VAO). |
ext.TIMESTAMP_EXT | GLuint64EXT | EXT_disjoint_timer_query | Thời gian hiện tại. |
ext.GPU_DISJOINT_EXT | GLboolean | EXT_disjoint_timer_query | Trả về liệu GPU có thực hiện bất kỳ hoạt động rời rạc nào hay không. |
ext.MAX_VIEWS_OVR | GLint | OVR_multiview2 | Số lượt xem tối đa. |
Ví dụ
js
gl.getParameter(gl.DITHER);
gl.getParameter(gl.VERSION);
gl.getParameter(gl.VIEWPORT);
Thông số kỹ thuật
| Specification |
|---|
| WebGL Specification # 5.14.3 |
| WebGL 2.0 Specification # 3.7.2 |