WebGL2RenderingContext: compressedTexSubImage3D() метод

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

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

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

Метод WebGL2RenderingContext.compressedTexSubImage3D() API WebGL указывает трехмерную подпрямоугольную область для текстурного изображения в сжатом формате.

Синтаксис

compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, imageSize, offset)

compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, srcData)
compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, srcData, srcOffset)
compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, srcData, srcOffset, srcLengthOverride)

Параметры

target

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

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

level

Тип GLint, определяющий уровень детализации. Уровень 0 — это базовое изображение, а уровень n — n-й уровень уменьшения мип-мапы.

xoffset

Тип GLint, определяющий смещение по оси x внутри сжатого текстурного изображения.

yoffset

Тип GLint, определяющий смещение по оси y внутри сжатого текстурного изображения.

zoffset

Тип GLint, определяющий смещение по оси z внутри сжатого текстурного изображения.

width

Тип GLsizei, определяющий ширину текстуры.

height

Тип GLsizei, определяющий высоту текстуры.

depth

Тип GLsizei, определяющий глубину текстуры.

format

Тип GLenum, определяющий формат сжатого изображения. Возможные значения:

gl.COMPRESSED_R11_EAC
gl.COMPRESSED_SIGNED_R11_EAC
gl.COMPRESSED_RG11_EAC
gl.COMPRESSED_SIGNED_RG11_EAC
gl.COMPRESSED_RGB8_ETC2
gl.COMPRESSED_RGBA8_ETC2_EAC
gl.COMPRESSED_SRGB8_ETC2
gl.COMPRESSED_SRGB8_ALPHA8_ETC2_EAC
gl.COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2
gl.COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2

imageSize

Тип GLint, определяющий количество байтов для чтения из буфера, привязанного к gl.PIXEL_UNPACK_BUFFER.

offset

Тип GLint, определяющий смещение в байтах для чтения из буфера, привязанного к gl.PIXEL_UNPACK_BUFFER.

srcData

Объект TypedArray или DataView, который будет использоваться как хранилище данных сжатого изображения в памяти.

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

None (undefined).

Примеры

gl.compressedTexSubImage3D(
  gl.TEXTURE_3D,
  0,
  0,
  0,
  512,
  512,
  512,
  gl.COMPRESSED_R11_EAC,
  textureData,
);

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

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

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`compressedTexSubImage3D`	56	79	51	43	15	58	51	43	15	7.0	58

См. также

© 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/WebGL2RenderingContext/compressedTexSubImage3D