GLTFAccessor

继承： Resource < RefCounted < Object

代表 glTF 访问器。

描述

GLTFAccessor 是一种用于表示glTF 中的会出现在 "accessors" 数组中的 accessor 元素的数据结构。缓冲区是一段二进制数据的集合。缓冲区视图是缓冲区的一部分。访问器是对缓冲区视图中的数据进行类型化解释的手段。

在 glTF 中存储的大多数自定义数据无需使用访问器，只需使用缓冲区视图（请参阅 GLTFBufferView ）即可。访问器则用于更高级的用例，例如为 GPU 编码的交错网格数据。 .. rst-class:: classref-introduction-group

属性

GLTFAccessorType	accessor_type	0
int	buffer_view	-1
int	byte_offset	0
int	component_type	0
int	count	0
PackedFloat64Array	max	PackedFloat64Array()
PackedFloat64Array	min	PackedFloat64Array()
bool	normalized	false
int	sparse_count	0
int	sparse_indices_buffer_view	0
int	sparse_indices_byte_offset	0
int	sparse_indices_component_type	0
int	sparse_values_buffer_view	0
int	sparse_values_byte_offset	0
int	type

---

枚举

enum GLTFAccessorType: 🔗

GLTFAccessorType TYPE_SCALAR = 0

“SCALAR”访问器类型。在 glTF 对象模型中可映射为单个 float、int、bool 值或单个 float 数组。

GLTFAccessorType TYPE_VEC2 = 1

“VEC2”访问器类型。在 glTF 对象模型中可映射为“float2”，在 glTF JSON 中表示为包含两个 float 的数组。

GLTFAccessorType TYPE_VEC3 = 2

“VEC3”访问器类型。在 glTF 对象模型中可映射为“float3”，在 glTF JSON 中表示为包含三个 float 的数组。

GLTFAccessorType TYPE_VEC4 = 3

“VEC4”访问器类型。在 glTF 对象模型中可映射为“float4”，在 glTF JSON 中表示为包含四个 float 的数组。

GLTFAccessorType TYPE_MAT2 = 4

“MAT2”访问器类型。在 glTF 对象模型中可映射为“float2x2”，在 glTF JSON 中表示为包含四个 float 的数组。

GLTFAccessorType TYPE_MAT3 = 5

“MAT3”访问器类型。在 glTF 对象模型中可映射为“float3x3”，在 glTF JSON 中表示为包含九个 float 的数组。

GLTFAccessorType TYPE_MAT4 = 6

“MAT4”访问器类型。在 glTF 对象模型中可映射为“float4x4”，在 glTF JSON 中表示为包含十六个 float 的数组。

---

enum GLTFComponentType: 🔗

GLTFComponentType COMPONENT_TYPE_NONE = 0

组件类型“NONE”。这不是有效的组件类型，用于表示组件类型未设置。

GLTFComponentType COMPONENT_TYPE_SIGNED_BYTE = 5120

组件类型“BYTE”。取值 0x1400 来源于 OpenGL。表示数据的存储形式为 1 字节即 8 位有符号整数。这是 glTF 规范的核心部分。

GLTFComponentType COMPONENT_TYPE_UNSIGNED_BYTE = 5121

组件类型“UNSIGNED_BYTE”。取值 0x1401 来源于 OpenGL。表示数据的存储形式为 1 字节即 8 位无符号整数。这是 glTF 规范的核心部分。

GLTFComponentType COMPONENT_TYPE_SIGNED_SHORT = 5122

组件类型“SHORT”。取值 0x1402 来源于 OpenGL。表示数据的存储形式为 2 字节即 16 位有符号整数。这是 glTF 规范的核心部分。

GLTFComponentType COMPONENT_TYPE_UNSIGNED_SHORT = 5123

组件类型“UNSIGNED_SHORT”。取值 0x1403 来源于 OpenGL。表示数据的存储形式为 2 字节即 16 位无符号整数。这是 glTF 规范的核心部分。

GLTFComponentType COMPONENT_TYPE_SIGNED_INT = 5124

组件类型“INT”。取值 0x1404 来源于 OpenGL。表示数据的存储形式为 4 字节即 32 位有符号整数。这不是 glTF 规范的核心部分，可能并不是所有 glTF 导入器都支持。KHR_interactivity 等扩展可能支持。

GLTFComponentType COMPONENT_TYPE_UNSIGNED_INT = 5125

组件类型“UNSIGNED_INT”。取值 0x1405 来源于 OpenGL。表示数据的存储形式为 4 字节即 32 位无符号整数。这是 glTF 规范的核心部分。

GLTFComponentType COMPONENT_TYPE_SINGLE_FLOAT = 5126

组件类型“FLOAT”。取值 0x1406 来源于 OpenGL。表示数据的存储形式为 4 字节即 32 位浮点数。这是 glTF 规范的核心部分。

GLTFComponentType COMPONENT_TYPE_DOUBLE_FLOAT = 5130

组件类型“DOUBLE”。取值 0x140A 来源于 OpenGL。表示数据的存储形式为 8 字节即 64 位浮点数。这不是 glTF 规范的核心部分，可能并不是所有 glTF 导入器都支持。KHR_interactivity 等扩展可能支持。

GLTFComponentType COMPONENT_TYPE_HALF_FLOAT = 5131

组件类型“HALF_FLOAT”。取值 0x140B 来源于 OpenGL。表示数据的存储形式为 2 字节即 16 位浮点数。这不是 glTF 规范的核心部分，可能并不是所有 glTF 导入器都支持。KHR_interactivity 等扩展可能支持。

GLTFComponentType COMPONENT_TYPE_SIGNED_LONG = 5134

组件类型“LONG”。取值 0x140E 来源于 OpenGL。表示数据的存储形式为 8 字节即 64 位有符号整数。这不是 glTF 规范的核心部分，可能并不是所有 glTF 导入器都支持。KHR_interactivity 等扩展可能支持。

GLTFComponentType COMPONENT_TYPE_UNSIGNED_LONG = 5135

组件类型“UNSIGNED_LONG”。取值 0x140F 来源于 OpenGL。表示数据的存储形式为 8 字节即 64 位无符号整数。这不是 glTF 规范的核心部分，可能并不是所有 glTF 导入器都支持。KHR_interactivity 等扩展可能支持。

---

属性说明

GLTFAccessorType accessor_type = 0 🔗

• void set_accessor_type(value: GLTFAccessorType)

• GLTFAccessorType get_accessor_type()

glTF 访问器类型枚举。取值为 0 表示“SCALAR”、1 表示“VEC2”、2 表示“VEC3”、3 表示“VEC4”、4 表示“MAT2”、5 表示“MAT3”、6 表示“MAT4”。

---

int buffer_view = -1 🔗

• void set_buffer_view(value: int)

• int get_buffer_view()

该访问器正在引用的缓冲区视图的索引。如果为 -1，则该访问器未引用任何缓冲区视图。

---

int byte_offset = 0 🔗

• void set_byte_offset(value: int)

• int get_byte_offset()

相对于缓冲视图起点的偏移量，单位为字节。

---

int component_type = 0 🔗

• void set_component_type(value: int)

• int get_component_type()

glTF 组件类型枚举。可能的取值见 GLTFComponentType。核心 glTF 规格中，未通过 mesh.primitive.indices 引用的访问器不能使用 5125 或“UNSIGNED_INT”。

---

int count = 0 🔗

• void set_count(value: int)

• int get_count()

该访问器引用的元素数量。

---

PackedFloat64Array max = PackedFloat64Array() 🔗

• void set_max(value: PackedFloat64Array)

• PackedFloat64Array get_max()

该访问器中每个组件的最大值。

注意: 返回的数组是被 复制 的，对它的任何修改都不会更新原始属性的值。有关更多详细信息，请参阅 PackedFloat64Array 。

---

PackedFloat64Array min = PackedFloat64Array() 🔗

• void set_min(value: PackedFloat64Array)

• PackedFloat64Array get_min()

该访问器中每个组件的最小值。

注意: 返回的数组是被 复制 的，对它的任何修改都不会更新原始属性的值。有关更多详细信息，请参阅 PackedFloat64Array 。

---

bool normalized = false 🔗

• void set_normalized(value: bool)

• bool get_normalized()

指定整数数据值在使用前是否进行了归一化。

---

int sparse_count = 0 🔗

• void set_sparse_count(value: int)

• int get_sparse_count()

存储在稀疏数组中的偏差访问器值的数量。

---

int sparse_indices_buffer_view = 0 🔗

• void set_sparse_indices_buffer_view(value: int)

• int get_sparse_indices_buffer_view()

具有稀疏索引的缓冲视图的索引。引用的缓冲视图不得定义其 target 或 byteStride 属性。缓冲视图和可选的 byteOffset 必须与 componentType 字节长度对齐。

---

int sparse_indices_byte_offset = 0 🔗

• void set_sparse_indices_byte_offset(value: int)

• int get_sparse_indices_byte_offset()

相对于缓冲视图起点的偏移量，单位为字节。

---

int sparse_indices_component_type = 0 🔗

• void set_sparse_indices_component_type(value: int)

• int get_sparse_indices_component_type()

索引组件数据类型枚举。取值 5121 为“UNSIGNED_BYTE”、5123 为“UNSIGNED_SHORT”、5125 为“UNSIGNED_INT”。

---

int sparse_values_buffer_view = 0 🔗

• void set_sparse_values_buffer_view(value: int)

• int get_sparse_values_buffer_view()

具有稀疏值的 bufferView 的索引。引用的缓冲视图不得定义其 target 或 byteStride 属性。

---

int sparse_values_byte_offset = 0 🔗

• void set_sparse_values_byte_offset(value: int)

• int get_sparse_values_byte_offset()

相对于 bufferView 起始位置的偏移量，单位为字节。

---

int type 🔗

• void set_type(value: int)

• int get_type()

已弃用： 请改用 accessor_type。

glTF 访问器类型枚举。请改用 accessor_type。