User Tools

Site Tools


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]. 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 ]
    ]	
}