WebGLRenderingContext: метод getTexParameter()

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

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

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

Метод WebGLRenderingContext.getTexParameter() API WebGL возвращает информацию о заданной текстуре.

Синтаксис

getTexParameter(target, pname)

Параметры

target

Значение GLenum, определяющее точку привязки (target). Возможные значения:

gl.TEXTURE_2D: Двумерная текстура.
gl.TEXTURE_CUBE_MAP: Текстура с кубической проекцией.

При использовании контекста WebGL 2, доступны следующие дополнительные значения:

gl.TEXTURE_3D: Трехмерная текстура.
gl.TEXTURE_2D_ARRAY: Текстура двумерного массива.

pname

Значение GLenum, определяющее запрашиваемую информацию. Возможные значения:

pname	Тип возвращаемого значения	Описание	Возможные возвращаемые значения
Доступно в контексте WebGL 1
`gl.TEXTURE_MAG_FILTER`	`GLenum`	Фильтр увеличения текстуры	`gl.LINEAR` (значение по умолчанию), `gl.NEAREST`.
`gl.TEXTURE_MIN_FILTER`	`GLenum`	Фильтр уменьшения текстуры	`gl.LINEAR`, `gl.NEAREST`, `gl.NEAREST_MIPMAP_NEAREST`, `gl.LINEAR_MIPMAP_NEAREST`, `gl.NEAREST_MIPMAP_LINEAR` (значение по умолчанию), `gl.LINEAR_MIPMAP_LINEAR`.
`gl.TEXTURE_WRAP_S`	`GLenum`	Функция обёртывания для текстурной координаты `s`	`gl.REPEAT` (значение по умолчанию), `gl.CLAMP_TO_EDGE`, `gl.MIRRORED_REPEAT`.
`gl.TEXTURE_WRAP_T`	`GLenum`	Функция обёртывания для текстурной координаты `t`	`gl.REPEAT` (значение по умолчанию), `gl.CLAMP_TO_EDGE`, `gl.MIRRORED_REPEAT`.
Дополнительно доступно при использовании расширения `EXT_texture_filter_anisotropic`
`ext.TEXTURE_MAX_ANISOTROPY_EXT`	`GLfloat`	Максимальная анизотропия для текстуры	Любые значения с плавающей запятой.
Дополнительно доступно при использовании контекста WebGL 2
`gl.TEXTURE_BASE_LEVEL`	`GLint`	Уровень детализации текстуры (mipmap)	Любые целочисленные значения.
`gl.TEXTURE_COMPARE_FUNC`	`GLenum`	Функция сравнения	`gl.LEQUAL` (значение по умолчанию), `gl.GEQUAL`, `gl.LESS`, `gl.GREATER`, `gl.EQUAL`, `gl.NOTEQUAL`, `gl.ALWAYS`, `gl.NEVER`.
`gl.TEXTURE_COMPARE_MODE`	`GLenum`	Режим сравнения текстуры	`gl.NONE` (значение по умолчанию), `gl.COMPARE_REF_TO_TEXTURE`.
`gl.TEXTURE_IMMUTABLE_FORMAT`	`GLboolean`	Неизменность формата и размера текстуры	true или false.
`gl.TEXTURE_IMMUTABLE_LEVELS`	`GLuint`	?	Любые целочисленные значения без знака.
`gl.TEXTURE_MAX_LEVEL`	`GLint`	Максимальный уровень детализации текстуры массива mipmap	Любые целочисленные значения.
`gl.TEXTURE_MAX_LOD`	`GLfloat`	Максимальное значение детализации текстуры	Любые значения с плавающей запятой.
`gl.TEXTURE_MIN_LOD`	`GLfloat`	Минимальное значение детализации текстуры	Любые значения с плавающей запятой.
`gl.TEXTURE_WRAP_R`	`GLenum`	Функция обёртывания для текстурной координаты `r`	`gl.REPEAT` (значение по умолчанию), `gl.CLAMP_TO_EDGE`, `gl.MIRRORED_REPEAT`.

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

Возвращает запрошенную информацию о текстуре (как указано с pname). В случае ошибки возвращается null.

Примеры

gl.getTexParameter(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER);

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

Спецификация
Спецификация WebGL # 5.14.8
Спецификация WebGL 2.0 # 3.7.6

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`getTexParameter`	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/getTexParameter