vertex_format_add_custom

此函数为特定顶点格式属性添加自定义数据类型，作为创建的新顶点格式的一部分。

要使用的可用值由您选择的数据类型常量定义，如下所示：

还需要定义这些常量的用途，以便可以在所创建的着色器中正确 " 绑定 " 这些值。这是必要的，因为 DirectX 和 OpenGL 有不同的要求，因此如果您没有正确绑定它们，它们将无法在着色器中正确通过。下面列出了您可以选择的可用使用常量，您使用的常量取决于所创建的着色器的具体情况：

在使用这些自定义格式时，需要注意一些重要事项：

• 使用 GLSL 着色器时，vertex_format_add_custom() 函数仅支持 vertex_usage_position、vertex_usage_colour、vertex_usage_normal 和 vertex_usage_textcoord。这些将分别映射到着色器属性 in_Position、in_Colour[0 - ...]、in_Normal( 任何不是这三个属性之一的属性 - 例如：纹理坐标 - 都可以是映射到您定义的任何属性)。
• 通常，应尽可能对所有额外参数使用vertex_usage_textcoord，因为在大多数着色器语言中，类型(如vertex_usage_blendweight和vertex_usage_tangent)接近不推荐使用的类型，并且可能无法正确转换。而是使用向量、vec 2、vec 3或vec 4类型vertex_usage_textcoord，一切都应该正常。
• GLSL ES 不支持整数属性，因此传入ivec 4不起作用(通常在传入vertex_usage_blendindices时使用此类型)。需要做的是传入纹理坐标，然后在着色器中，将它们转换为ivec 4，如下所示：

attribute vec3 in_Position;
attribute vec4 in_BlendIndices;
attribute vec4 in_BlendWeights;

varying vec4 v_vColour;
varying mat4 v_mat;

void main()
{
    gl_Position = gm_Matrices[MATRIX_WORLD_VIEW_PROJECTION] * vec4( in_Position.xyz, 1.0);
    v_vColour = in_BlendWeights;
     ivec4 t = ivec4(in_BlendIndices);
     v_mat = gm_Matrices[ t.x ];
}

• 混合权重通常存储在数组中，然后使用混合索引进行访问，但您可以在此看到，它不是将in_BlendIndices定义为ivec 4属性，而是将其转换为代码中的ivec 4。然后，这将用于为使用gm_Matrix创建的数组编制索引(您只能使用Int值而不能使用浮点数访问数组)。

语法:

vertex_format_add_custom(type, usage);

返回:

N/A

例子:

vertex_format_begin();
vertex_format_add_texcoord();
vertex_format_add_custom(vertex_type_float3, vertex_usage_position);
my_format = vertex_format_end();

上面的代码创建了一个新的顶点格式，仅包含纹理和 3 个自定义浮点值的位置。然后，它将格式存储在变量 my_format 中。