vertex_format_add_custom(type, usage);
| Argument | Description |
|---|---|
| type | The data type that this custom vertex data will hold (see the type constants listed below). |
| usage | The use that the data will get(see the usage constants listed below). |
Returns: N/A
Tell GameMaker: Studio to accept a custom value (or
values) as part of the new vertex format being created. The
available values to use are defined by the data type constant that
you choose, listed below:
| Constant | Description |
|---|---|
| vertex_type_float1 | A single floating point value |
| vertex_type_float2 | Two floating point values |
| vertex_type_float3 | Three floating point values |
| vertex_type_float4 | Four floating point values |
| vertex_type_colour | Four component values (r, g, b, a) |
| vertex_type_ubyte4 | Four component unsigned byte values (from 0 to 255) |
The use that these constants will be put too also needs to be
defined so that the values can be "bound" properly within the
shader being created. This is necessary due to the fact that DX and
OpenGL have different requirements so if you don't bind them
properly, they won't come through right in the shader. The
available usage constants that you can choose are listed below and
those you use will depend on the specifics of the shader being
created:
| Constant | Description |
|---|---|
| vertex_usage_position | position values (x, y, z) |
| vertex_usage_colour | colour values (r, g, b, a) |
| vertex_usage_normal | vertex normal values (nx, ny, nz) |
| vertex_usage_textcoord | UV coordinates (u, v) |
| vertex_usage_blendweight | the blendweight of the input matrix (for skeletal animation, for example) |
| vertex_usage_blendindices | the indices of the matrices to use (for skeletal animation, for example) |
| vertex_usage_depth | vertex depth buffer value |
| vertex_usage_tangent | tangent values |
| vertex_usage_binormal | binormal values |
| vertex_usage_fog | fog values |
| vertex_usage_sample | sampler index |
vertex_format_begin();
vertex_format_add_textcoord();
vertex_format_add_custom(vertex_type_float3,
vertex_usage_position);
my_format = vertex_format_end();
The above code will create a new vertex format with just texture and 3 custom floating point values for position. It is then stores the format id in the variable "my_format".