WebGLRenderingContext: getTexParameter() 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.getTexParameter() của WebGL API trả về thông tin về kết cấu đã cho.
Cú pháp
js
getTexParameter(target, pname)
Thông số
target-
A
GLenumchỉ định điểm liên kết (đích). Các giá trị có thể:gl.TEXTURE_2D: Một kết cấu hai chiều.gl.TEXTURE_CUBE_MAP: Một kết cấu được ánh xạ hình khối.
Khi sử dụng WebGL 2 context, các giá trị sau đây có sẵn bổ sung:
- gl.TEXTURE_3D: Một kết cấu ba chiều.
- gl.TEXTURE_2D_ARRAY: Một kết cấu mảng hai chiều.
| tên | Loại trả về | Mô tả | Có thể trả về các giá trị |
|---|---|---|---|
| Có sẵn trong bối cảnh WebGL 1 | |||
gl.TEXTURE_MAG_FILTER | GLenum | Bộ lọc phóng đại kết cấu | gl.LINEART (giá trị mặc định), gl.NEAREST. |
gl.TEXTURE_MIN_FILTER | GLenum | Bộ lọc thu nhỏ kết cấu | gl.LINEART, gl.NEAREST, gl.NEAREST_MIPMAP_NEAREST, gl.LINEAR_MIPMAP_NEAREST, gl.NEAREST_MIPMAP_LINEART (giá trị mặc định), gl.LINEAR_MIPMAP_LINEART. |
gl.TEXTURE_WRAP_S | GLenum | Chức năng bao bọc cho tọa độ kết cấu s | gl.REPEAT (giá trị mặc định), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT. |
gl.TEXTURE_WRAP_T | GLenum | Chức năng bao bọc cho tọa độ kết cấu t | gl.REPEAT (giá trị mặc định), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT. |
Ngoài ra còn có sẵn khi sử dụng phần mở rộng EXT_texture_filter_anisotropic | |||
ext.TEXTURE_MAX_ANISOTROPY_EXT | GLfloat | Tính bất đẳng hướng tối đa cho a kết cấu | Bất kỳ giá trị float nào. |
| Có sẵn thêm khi sử dụng ngữ cảnh WebGL 2 | |||
gl.TEXTURE_BASE_LEVEL | GLint | Kết cấu mipmap Level | Bất kỳ giá trị int nào. |
gl.TEXTURE_COMPARE_FUNC | GLenum | Hàm so sánh | gl.LEQUAL (giá trị mặc định), gl.GEQUAL, gl.LESS, gl.GREATER, gl.EQUAL, gl.NOTEQUAL, gl.ALWAYS, gl.NEVER. |
gl.TEXTURE_COMPARE_MODE | GLenum | Chế độ so sánh kết cấu | gl.NONE (giá trị mặc định), gl.COMPARE_REF_TO_TEXTURE. |
gl.TEXTURE_IMMUTABLE_FORMAT | GLboolean | Tính bất biến của định dạng và kích thước kết cấu | đúng hay sai. |
gl.TEXTURE_IMMUTABLE_LEVELS | GLuint | ? | Bất kỳ giá trị uint nào. |
gl.TEXTURE_MAX_LEVEL | GLint | Mức mảng mipmap kết cấu tối đa | Bất kỳ giá trị int nào. |
gl.TEXTURE_MAX_LOD | GLfloat | Kết cấu mức độ chi tiết tối đa value | Bất kỳ giá trị float nào. |
gl.TEXTURE_MIN_LOD | GLfloat | Giá trị mức độ chi tiết tối thiểu của kết cấu | Bất kỳ giá trị float nào. |
gl.TEXTURE_WRAP_R | GLenum | Chức năng bao bọc tọa độ kết cấu r | gl.REPEAT (giá trị mặc định), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT. |
Giá trị trả về
Trả về thông tin kết cấu được yêu cầu (như được chỉ định với pname). Nếu xảy ra lỗi, null sẽ được trả về.
Ví dụ
js
gl.getTexParameter(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER);
Thông số kỹ thuật
| Specification |
|---|
| WebGL Specification # 5.14.8 |
| WebGL 2.0 Specification # 3.7.6 |