GLTFAccessor

继承： Resource < RefCounted < Object

代表 glTF 访问器。

描述

GLTFAccessor 是一种表示 glTF 访问器 "accessors" 的数据结构，可以在 "accessors" 数组中找到。缓冲区是二进制数据块。缓冲区视图是缓冲区的切片。访问器是对缓冲区视图中数据的类型化解释。

大多数存储在 glTF 中的自定义数据不需要访问器，只需要缓冲区视图（见 GLTFBufferView）。访问器适用于更高级的用例，例如为 GPU 编码的交错网格数据。

教程

属性

GLTFAccessorType

accessor_type

0

int

buffer_view

-1

int

byte_offset

0

GLTFComponentType

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

GLTFComponentType

sparse_indices_component_type

0

int

sparse_values_buffer_view

0

int

sparse_values_byte_offset

0

int

type

方法

GLTFAccessor

from_dictionary(dictionary: Dictionary) static

Dictionary

to_dictionary() const

枚举

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 🔗

glTF 访问器类型枚举。

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()

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

GLTFComponentType component_type = 0 🔗

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

int count = 0 🔗

  • void set_count(value: int)

  • int get_count()

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

PackedFloat64Array max = PackedFloat64Array() 🔗

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

Note: The returned array is copied and any changes to it will not update the original property value. See PackedFloat64Array for more details.

PackedFloat64Array min = PackedFloat64Array() 🔗

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

Note: The returned array is copied and any changes to it will not update the original property value. See PackedFloat64Array for more details.

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()

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

GLTFComponentType sparse_indices_component_type = 0 🔗

索引组件数据类型枚举。取值 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()

已弃用： Use accessor_type instead.

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

方法说明

GLTFAccessor from_dictionary(dictionary: Dictionary) static 🔗

Creates a new GLTFAccessor instance by parsing the given Dictionary.

Dictionary to_dictionary() const 🔗

Serializes this GLTFAccessor instance into a Dictionary.