WebGLRenderingContext: getTexParameter() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

注意:此功能在 Web Workers 中可用。

WebGLRenderingContext.getTexParameter() 方法是 WebGL API 的一部分,用於獲取給定紋理的資訊。

語法

js
getTexParameter(target, pname)

引數

目標

一個 GLenum,指定繫結點(目標)。可能的值

  • 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

示例

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

規範

規範
WebGL 規範
# 5.14.8
WebGL 2.0 規範
# 3.7.6

瀏覽器相容性

另見