User Tools
Site Tools
Sidebar
uv_set
Description
The definition of a single UV coordinate set asset.
Parent Objects
Properties
| Name | Description | Default | Required |
|---|---|---|---|
| id | A string representing a unique ID for this asset within the current file scope. | None | yes |
| name | A string representing the “internal” name for this UV set. Generally unique within any sibling uv sets. | “” | no |
| label | A string representing the user facing label for this UV set. | “” | no |
| source | A string representing the URI of the uv_set asset that this uv_set was derived from, if any. | “” | no |
| vertex_count | An int representing the number of vertices expected to be in the geometry that the UV set applies to. | None | yes |
| uvs | A float2_array of all UV's, both those that are shared by all polygons attached to a vertex, and those that may be unique to a particular polygon attached to a vertex. | None | yes |
| polygon_vertex_indices | An array representing the polygons that use a UV index for a given vertex that is different than the default index defined in “uvs”. Polygon-specific vertex-indexed UV indices. Each entry is [polygon_index, polygon_vertex_index, uv_index], where polygon_vertex_index refers to the index of a vertex in the geometry that is used by the polygon at polygon_index. | None | no |
Details
The uvs array is assumed to be given in the same order as the vertices in any associated geometry. Any vertices that have more than one UV coordinate associated with them (e.g. along a UV boundary) should appear in the polygon_vertex_indices array. For vertices that appear in the polygon_vertex_indices array, their entry in the uvs array should correspond to a “primary” value for the UV's for that vertex. The “primary” value may be arbitrary for most applications.
Example
For a geometry with unique UV's at each vertex, the uvs array size will match the vertex array size of the corresponding geometry. If the geometry has vertices with more than one UV associated with them, there will be an entry in the polygon_vertex_indices array for each additional UV associated with each vertex.
{
"id" : "default",
"name" : "default",
"label" : "Default UVs",
"vertex_count" : 266,
"uvs" : [
[ 0.02083333, 0 ],
[ 0.02083333, 1 ],
[ 0, 0.08333334 ],
[ 0, 0.1666667 ],
[ 0, 0.25 ],
[ 0, 0.3333333 ],
[ 0, 0.4166667 ],
[ 0, 0.5 ],
[ 0, 0.5833333 ],
[ 0, 0.6666667 ],
[ 0, 0.75 ],
[ 0, 0.8333333 ],
[ 0, 0.9166667 ]
],
"polygon_vertex_indices" : [
[ 12, 0, 266 ],
[ 24, 0, 4 ],
[ 36, 0, 7 ],
[ 48, 0, 9 ],
[ 60, 0, 2 ]
]
}
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution 3.0 Unported
