在缓冲区之间传输数据

本页概述了如何在缓冲区和顶点缓冲区之间传输数据。

在最低级别，缓冲区是内存中由字节组成的连续区域。使用函数 buffer_read 和 buffer_write( 以及 buffer_peek、buffer_poke 和 buffer_fill) 基本数据类型可以写入缓冲区。除此之外，可以组合这些基本数据类型来创建数据结构，其中结构中的每个条目都遵循给定的格式。

Stride

以这种结构化方式存储在缓冲区中的项目都占用相同数量的字节。这是从一个项目移动到下一个项目所需的字节数，称为步幅。

缓冲区到缓冲区

以下函数允许将部分数据从一个缓冲区复制到另一个缓冲区：

• buffer_copy：复制连续的字节块一次
• buffer_copy_stride：多次复制连续的字节块。您可以使用它来复制例如所有位置、所有颜色、所有 UV 等。

缓冲区到顶点缓冲区

顶点缓冲区是一种特殊类型的缓冲区。顶点格式决定将哪些数据写入缓冲区以及以何种顺序写入。您不必直接写入值，但可以调用 vertex_position_3d、vertex_colour、vertex_texcoord 等函数。

有一些特定于顶点缓冲区的事情：

• 在这种情况下，步幅是顶点格式 (以及顶点的大小) 的大小。
• 顶点属性的大多数组件都存储为 32 位浮点 (buffer_f32)。
• 颜色属性的每个组成部分 (R、G、B、A) 均存储为无符号字节 (buffer_u8)。

下图显示了顶点缓冲区中的数据如何映射到缓冲区中的数据，以及相反的方式：

提示 您可以使用函数 vertex_format_get_info 获取有关给定格式的顶点数据如何在缓冲区中布局的信息。

以下函数可用于在缓冲区和顶点缓冲区之间传输数据，反之亦然：

• buffer_create_from_vertex_buffer
• buffer_create_from_vertex_buffer_ext
• buffer_copy_from_vertex_buffer
• vertex_create_buffer_from_buffer
• vertex_create_buffer_from_buffer_ext
• vertex_update_buffer_from_buffer