WebGLRenderingContext: метод getParameter()

Базовая поддержка Широко доступен

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Примечание: Данная функция доступна в Web Workers.

Метод WebGLRenderingContext.getParameter() API WebGL возвращает значение для переданного имени параметра.

Синтаксис

getParameter(pname)

Параметры

pname: A GLenum определяющий, какое значение параметра вернуть. Возможные значения указаны ниже.

Возвращаемое значение

Зависит от параметра.

Имена параметров

WebGL 1

При использовании WebGLRenderingContext вы можете запросить следующие pname параметры.

Константа	Тип возвращаемого значения	Описание

`gl.ACTIVE_TEXTURE`	`GLenum`
`gl.ALIASED_LINE_WIDTH_RANGE`	`Float32Array` (с 2 элементами)
`gl.ALIASED_POINT_SIZE_RANGE`	`Float32Array` (с 2 элементами)
`gl.ALPHA_BITS`	`GLint`
`gl.ARRAY_BUFFER_BINDING`	`WebGLBuffer`
`gl.BLEND`	`GLboolean`
`gl.BLEND_COLOR`	`Float32Array` (со 4 значениями)
`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`
`gl.BLEND_SRC_RGB`	`GLenum`
`gl.BLUE_BITS`	`GLint`
`gl.COLOR_CLEAR_VALUE`	`Float32Array` (со 4 значениями)
`gl.COLOR_WRITEMASK`	sequence<`GLboolean`> (со 4 значениями)
`gl.COMPRESSED_TEXTURE_FORMATS`	`Uint32Array`	Возвращает сжатые форматы текстур. При использовании расширения `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` При использовании расширения `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` При использовании расширения `WEBGL_compressed_texture_etc`: `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` При использовании расширения `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` При использовании расширения `WEBGL_compressed_texture_etc1`: `ext.COMPRESSED_RGB_ETC1_WEBGL` При использовании расширения `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`	`GLboolean`
`gl.CULL_FACE_MODE`	`GLenum`	`gl.FRONT`, `gl.BACK` или `gl.FRONT_AND_BACK`. См. также `cullFace`
`gl.CURRENT_PROGRAM`	`WebGLProgram` или `null`	См. `useProgram`.
`gl.DEPTH_BITS`	`GLint`
`gl.DEPTH_CLEAR_VALUE`	`GLfloat`
`gl.DEPTH_FUNC`	`GLenum`
`gl.DEPTH_RANGE`	`Float32Array` (с 2 элементами)
`gl.DEPTH_TEST`	`GLboolean`
`gl.DEPTH_WRITEMASK`	`GLboolean`
`gl.DITHER`	`GLboolean`
`gl.ELEMENT_ARRAY_BUFFER_BINDING`	`WebGLBuffer`
`gl.FRAMEBUFFER_BINDING`	`WebGLFramebuffer` или `null`	`null` соответствует привязке к буферу по умолчанию. См. также `bindFramebuffer`.
`gl.FRONT_FACE`	`GLenum`	`gl.CW` или `gl.CCW`. См. также `frontFace`.
`gl.GENERATE_MIPMAP_HINT`	`GLenum`	`gl.FASTEST`, `gl.NICEST` или `gl.DONT_CARE`. См. также `hint`.
`gl.GREEN_BITS`	`GLint`
`gl.IMPLEMENTATION_COLOR_READ_FORMAT`	`GLenum`
`gl.IMPLEMENTATION_COLOR_READ_TYPE`	`GLenum`
`gl.LINE_WIDTH`	`GLfloat`
`gl.MAX_COMBINED_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` (с 2 элементами)
`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` или `null`	См. `bindRenderbuffer`.
`gl.RENDERER`	строка
`gl.SAMPLE_BUFFERS`	`GLint`
`gl.SAMPLE_COVERAGE_INVERT`	`GLboolean`
`gl.SAMPLE_COVERAGE_VALUE`	`GLfloat`
`gl.SAMPLES`	`GLint`
`gl.SCISSOR_BOX`	`Int32Array` (со 4 элементами)
`gl.SCISSOR_TEST`	`GLboolean`
`gl.SHADING_LANGUAGE_VERSION`	строка
`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`	`GLint`
`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` или `null`
`gl.TEXTURE_BINDING_CUBE_MAP`	`WebGLTexture` или `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`	строка
`gl.VERSION`	строка
`gl.VIEWPORT`	`Int32Array` (со 4 элементами)

WebGL 2

При использовании WebGL2RenderingContext можно запросить следующие pname параметры.

Постоянная	Тип возвращаемого значения	Описание
`gl.COPY_READ_BUFFER_BINDING`	`WebGLBuffer` или `null`	См. `bindBuffer`.
`gl.COPY_WRITE_BUFFER_BINDING`	`WebGLBuffer` или `null`	См. `bindBuffer`.
`gl.DRAW_BUFFERi`	`GLenum`	`gl.BACK`, `gl.NONE` или `gl.COLOR_ATTACHMENT{0-15}`. См. также `drawBuffers`.
`gl.DRAW_FRAMEBUFFER_BINDING`	`WebGLFramebuffer` или `null`	`null` соответствует привязке к буферу по умолчанию. См. также `bindFramebuffer`.
`gl.FRAGMENT_SHADER_DERIVATIVE_HINT`	`GLenum`	`gl.FASTEST`, `gl.NICEST` или `gl.DONT_CARE`. См. также `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_COMBINED_UNIFORM_BLOCKS`	`GLint`
`gl.MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS`	`GLint64`
`gl.MAX_DRAW_BUFFERS`	`GLint`
`gl.MAX_ELEMENT_INDEX`	`GLint64`
`gl.MAX_ELEMENTS_INDICES`	`GLint`
`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`	См. `pixelStorei`.
`gl.PACK_SKIP_PIXELS`	`GLint`	См. `pixelStorei`.
`gl.PACK_SKIP_ROWS`	`GLint`	См. `pixelStorei`.
`gl.PIXEL_PACK_BUFFER_BINDING`	`WebGLBuffer` или `null`	См. `bindBuffer`.
`gl.PIXEL_UNPACK_BUFFER_BINDING`	`WebGLBuffer` или `null`	См. `bindBuffer`.
`gl.RASTERIZER_DISCARD`	`GLboolean`
`gl.READ_BUFFER`	`GLenum`
`gl.READ_FRAMEBUFFER_BINDING`	`WebGLFramebuffer` или `null`	`null` соответствует привязке к буферу по умолчанию. См. также `bindFramebuffer`.
`gl.SAMPLE_ALPHA_TO_COVERAGE`	`GLboolean`
`gl.SAMPLE_COVERAGE`	`GLboolean`
`gl.SAMPLER_BINDING`	`WebGLSampler` или `null`	См. `bindSampler`.
`gl.TEXTURE_BINDING_2D_ARRAY`	`WebGLTexture` или `null`	См. `bindTexture`.
`gl.TEXTURE_BINDING_3D`	`WebGLTexture` или `null`	См. `bindTexture`.
`gl.TRANSFORM_FEEDBACK_ACTIVE`	`GLboolean`
`gl.TRANSFORM_FEEDBACK_BINDING`	`WebGLTransformFeedback` или `null`	См. `bindTransformFeedback`.
`gl.TRANSFORM_FEEDBACK_BUFFER_BINDING`	`WebGLBuffer` или `null`	См. `bindBuffer`.
`gl.TRANSFORM_FEEDBACK_PAUSED`	`GLboolean`
`gl.UNIFORM_BUFFER_BINDING`	`WebGLBuffer` или `null`	См. `bindBuffer`.
`gl.UNIFORM_BUFFER_OFFSET_ALIGNMENT`	`GLint`	См. `pixelStorei`.
`gl.UNPACK_IMAGE_HEIGHT`	`GLint`	См. `pixelStorei`.
`gl.UNPACK_ROW_LENGTH`	`GLint`	См. `pixelStorei`.
`gl.UNPACK_SKIP_IMAGES`	`GLint`	См. `pixelStorei`.
`gl.UNPACK_SKIP_PIXELS`	`GLint`	См. `pixelStorei`.
`gl.UNPACK_SKIP_ROWS`	`GLint`	См. `pixelStorei`.
`gl.VERTEX_ARRAY_BINDING`	`WebGLVertexArrayObject` или `null`	См. `bindVertexArray`.

Расширения WebGL

Вы можете запросить следующие pname параметры при использовании расширений WebGL:

Константа	Тип возвращаемого значения	Расширение	Описание
`ext.MAX_TEXTURE_MAX_ANISOTROPY_EXT`	`GLfloat`	`EXT_texture_filter_anisotropic`	Максимальная доступная анизотропия.
`ext.FRAGMENT_SHADER_DERIVATIVE_HINT_OES`	`GLenum`	`OES_standard_derivatives`	Точность вычисления производной для встроенных функций GLSL: `dFdx`, `dFdy`, и `fwidth`.
`ext.MAX_COLOR_ATTACHMENTS_WEBGL`	`GLint`	`WEBGL_draw_buffers`	Максимальное количество точек прикрепления цвета фреймбуфера.
`ext.MAX_DRAW_BUFFERS_WEBGL`	`GLint`	`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`	`GLenum`	`WEBGL_draw_buffers`	Буферы отрисовки.
`ext.VERTEX_ARRAY_BINDING_OES`	`WebGLVertexArrayObjectOES`	`OES_vertex_array_object`	Связанный объект массива вершин (VAO).
`ext.TIMESTAMP_EXT`	`GLuint64EXT`	`EXT_disjoint_timer_query`	Текущее время.
`ext.GPU_DISJOINT_EXT`	`GLboolean`	`EXT_disjoint_timer_query`	Возвращает, выполнила ли графическая карта какую-либо операцию разбиения.
`ext.MAX_VIEWS_OVR`	`GLint`	`OVR_multiview2`	Максимальное количество представлений.

Примеры

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

Спецификации

Спецификация
Спецификация WebGL # 5.14.3
Спецификация WebGL 2.0 # 3.7.2

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`getParameter`	9	12	4	12	5.1	25	4	12	8	1.5	4.4.3

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/getParameter