Mesh Re-Numbering

< Previous | Contents | Manuals Home | Boris FX | Next >

Mesh Re-Numbering

The original vertex, normal, and texture indices for each resulting vertex can be stored and used to reconstruct the original numbering, by suitable importers and exporters.

Note: Only the Filmbox and OBJ importers currently store this information; only the OBJ and Filmbox exporters currently export it (though the resulting FBX files are widely usable).

It is common for there to be multiple vertices at a single XYZ position, with different UV coordinates or normals. To get unique XYZ vertices, use the ToUniqueVertexMap, FromUniqueVertexMap, etc functions to generate/emulate that on the fly, especially for constructed, primitive, or modified meshes. The Filmbox and OBJ exporters can do this, for example code consult the OBJ exporter (mshobj.szl).

The following functions are all for Mesh objects:


.ClearOriginalNormalNumbers() Removes any existing original normal number

data.

.ClearOriginalNumbers() Removes any existing original number data

(vertex, normal, and texture).

.ClearOriginalTextureNumbers() Removes any existing original texture number

data.

.ClearOriginalVertexNumbers() Removes any existing original vertex number

data.

.FromOriginalNormalMap() Returns a read-only list with one element for

each original normal. That element is the number of any of the vertices created from the original normal. See also ToOriginalNormalMap, nOriginalNormal, OriginalNormal, etc.

.FromOriginalTextureMap() Returns a read-only list with one element for

each original texture coordinate. That element is the number of any of the vertices created from the original texture coordinate. See also ToOriginalTextureMap, nOriginalTexture, OriginalTexture, etc.

.FromOriginalVertexMap() Returns a read-only list with one element for

each original vertex. That element is the number of any of the vertices created from the original vertex. See also ToOriginalVertexMap, nOriginalVertex, OriginalVertex, etc.

.FromUniqueNormalMap() Returns a read-only list with one element for

each unique normal. That element is the number of any of the vertices with the same normal. See also ToUniqueNormalMap, nUniqueNormal, etc.

.FromUniqueTextureMap() Returns a read-only list with one element for

each unique texture coordinate. That element is the number of any of the vertices with the same texture coordinate. See also ToUniqueTextureMap, nUniqueTexture, etc.

.FromUniqueVertexMap() Returns a read-only list with one element for

each unique vertex. That element is the number of any of the vertices with the same position. See also ToUniqueVertexMap, nUniqueVertex, etc.

.hasOriginalNormalNumbers() Has stored original normal index numbers

from import; the number matches the number of vertices present.

.hasOriginalTextureNumbers() Has stored original texture index numbers

from import; the number matches the number of vertices present.

.hasOriginalVertexNumbers() Has stored original vertex numbers from

import; the number matches the number of vertices present.

.nOriginalNormal The number of stored original normal indices from the importer. Read-only. (This number

must match the number of current vertices for that information to be usable.)

.nOriginalTexture The number of stored original texture indices from the importer. Read-only. (This number must match the number of current vertices for that information to be usable.)

.nOriginalVertex The number of stored original vertex numbers from the importer. Read-only. (This number must match the number of current vertices for that information to be usable.)

.nUniqueNormal The number of unique normals, ie discarding redundant normals. Read-only. See ToUniqueNormalMap(), FromUniqueNormalMap().

.nUniqueTexture The number of unique texture coordinates, ie discarding redundant texture coordinates.

Read-only. See also ToUniqueTextureMap(), FromUniqueTextureMap().

.nUniqueVertex The number of unique vertices, ie discarding redundant vertices that occupy the same location. Read-only. See also RepeatedVertexLoops(), ToUniqueVertexMap(), FromUniqueVertexMap(), and UpdateVertexMaps().

.OriginalNormal(v) Returns the original normal index for the given vertex, as stored by the importer. See also HasOriginalVertexNumbers, OriginalVertexMap and SetOriginalVertex.

.OriginalTexture(v) Returns the original texture index for the given vertex, as stored by the importer. See also HasOriginalVertexNumbers, OriginalVertexMap and SetOriginalVertex.

.OriginalVertex(v) Returns the original vertex index for the given vertex, as stored by the importer. See also HasOriginalVertexNumbers, OriginalVertexMap and SetOriginalVertex.

.RepeatedVertexLoops() Returns a read-only list that has a vertex

number for each vertex. If list[v] is 0 (illegal), the vertex v is not repeated. If list[v] is nonzero, it is another vertex number at the exact same xyz location. The vertex number can be chased from one to another until arriving back at the original location, at which chasing should be stopped! See also

NUniqueVertex(), ToUniqueVertexMap(), and FromUniqueVertexMap().

.SetOriginalNormal(v, v0) Sets the original normal index for the given

vertex v to v0. Call UpdateOriginalMaps after making changes.

.SetOriginalTexture(v, v0) Sets the original texture index for the given

vertex v to v0. Call UpdateOriginalMaps after making changes.

.SetOriginalVertex(v, v0) Sets the original vertex number for the given

vertex v to v0. Call UpdateOriginalMaps after making changes.


.ToOriginalNormalMap() Returns a read-only list of the original normal

indices for each vertex, as stored by the importer. See also SetOriginalNormal(), FromOriginalNormalMap().

.ToOriginalTextureMap() Returns a read-only list of the original vertex

numbers for each vertex, as stored by the importer. See also SetOriginalTexture(), FromOriginalTextureMap().

.ToOriginalVertexMap() Returns a read-only list of the original vertex

numbers for each vertex, as stored by the importer. See also SetOriginalVertex(), FromOriginalVertexMap().

.ToUniqueVertexMap() Returns a read-only list with an element for

each vertex, giving a unique vertex number. There will be fewer unique vertex numbers, see NUniqueVertex(), FromUniqueVertexMap(), RepeatedVertexLoops(), and UpdateVertexMaps().

.ToUniqueNormalMap() Returns a read-only list of a unique normal

index for each vertex. See also FromUniqueNormalMap().

.ToUniqueTextureMap() Returns a read-only list of a unique texture

vertex index for each vertex. See also FromUniqueTextureMap().

.ToUniqueVertexMap() Returns a read-only list of a unique vertex

index for each vertex. See also FromUniqueVertexMap().

.UpdateOriginalMaps() Causes the original-vertex/normal/texture-

index maps information to be updated after it has been changed, ie via SetOriginalNormal/Texture/Vertex().

.UpdateVertexMaps() Forces the unique and repeated-vertex

information to be recalculated after vertices have been changed, added, or removed, ie for RepeatedVertexLoops(), ToUniqueVertexMap(), FromUniqueVertexMap(), nUniqueVertex, etc.

©2023 Boris FX, Inc. — UNOFFICIAL — Converted from original PDF.