class Geo::AtlasMesh

The AtlasMesh implementation used for the packer and anything else that needs not to know whether we have one mesh or several.

Functions

Name	Description
AreChartsIndependent()	Report on the independence of the charts, that is whether no vertex belongs to more than one chart.
Create(const AtlasMeshVertices , const AtlasMeshTriangles )	Create a new instance of an AtlasMesh, instantiating it with a copy of the vertex and triangle list.
DeepCopy(const AtlasMesh *)	Create a clone of an AtlasMesh.
DetectCharts(const AtlasMeshChartingFlags &)	Chart Dependency.
GetCharacteristicVertex(s32)	A mesh can have a number of vertices which whilst topologically distinct have exactly the same 3D and UV coordinates.
GetChart(s32)	Obtain access to one of the mesh charts.
GetChartCount()	The number of charts that the mesh is composed of.
GetChartingFlags()	Return the flags used to chart this mesh.
GetEdgeToEdgeAdjacencyMap()	The adjacency data is a list of edges that map to their neighbours.
GetTriangle(s32)	Obtain a mesh triangle.
GetTriangleCount()	Obtain the number of triangles in the mesh.
GetTrianglePartitioning()	Return an array that specifies which triangle is in which chart.
GetTriangles()	Obtain the list of triangles.
GetVertex(s32)	Obtain a vertex.
GetVertexCount()	Obtain the number of vertices in the mesh.
GetVertices()	Obtain a copy of the vertices in the mesh.
IsChartTriangleDegenerate(Geo::s32, Geo::s32)	Degeneracy testing.
MakeChartsIndependent(GeoArray< AtlasMeshVertexSplitResult > *)	Make the charts independent by duplicating vertices which are shared by more than one chart, and relinking any triangles to the new vertices as necessary.
Release()	Release the mesh after it is finished with.
RepackCharts(const AtlasMeshPackingFlags &, IGeoProgressProxy *)	Pack the charts into the single square in UV space spanned by (0,0) - (1,1).
SerializeFromFile(FILE *)	Serialize this mesh from file - note that this does not include any of the charting information.
SetVertexUV(s32, float, float)	Update the UV coordinate of a vertex.

bool Geo::AtlasMesh::AreChartsIndependent

public: bool AreChartsIndependent() const

Report on the independence of the charts, that is whether no vertex belongs to more than one chart.

Outputs problem cases to LOG_INFO.

Returns

True if the charts are independent, or false otherwise.

static AtlasMesh* Geo::AtlasMesh::Create

public: AtlasMesh * Create
(
const AtlasMeshVertices * vertices,
const AtlasMeshTriangles * triangles
)

Create a new instance of an AtlasMesh, instantiating it with a copy of the vertex and triangle list.

static AtlasMesh* Geo::AtlasMesh::DeepCopy

public: AtlasMesh * DeepCopy
(
const AtlasMesh * other
)

Create a clone of an AtlasMesh.

bool Geo::AtlasMesh::DetectCharts

public: bool DetectCharts
(
const AtlasMeshChartingFlags & chartingFlags
)

Chart Dependency.

All charts need to be independent of each other in UV space, so that they can be individually parametrised and packed. In order to do this some vertices might need to be duplicated, and the triangles that use them might have to have their corners relinked to the new copy. Parse the mesh structure and populate the charts.

s32 Geo::AtlasMesh::GetCharacteristicVertex

public: s32 GetCharacteristicVertex
(
s32 vertexIndex
) const

A mesh can have a number of vertices which whilst topologically distinct have exactly the same 3D and UV coordinates.

A map of these characteristically identical vertices is maintained internally, which identifies them all with one of them through its vertex index. XXX Should this be in the private interface. It's only used XXX internally, and by the parametriser as far as I know.

Returns

The index of the vertex which representative of this one.

Parameters

[in]

vertexIndex

The index of the vertex to find the characteristic of.

AtlasMeshChart* Geo::AtlasMesh::GetChart

public: AtlasMeshChart * GetChart
(
s32 chartIndex
) const

Obtain access to one of the mesh charts.

Returns

A chart belonging to the mesh.

Parameters

[in]

chartIndex

The index of the chart that is required.

s32 Geo::AtlasMesh::GetChartCount

public: s32 GetChartCount() const

The number of charts that the mesh is composed of.

Returns

The number of charts.

AtlasMeshChartingFlags Geo::AtlasMesh::GetChartingFlags

public: AtlasMeshChartingFlags GetChartingFlags() const

Return the flags used to chart this mesh.

const s32* Geo::AtlasMesh::GetEdgeToEdgeAdjacencyMap

public: const s32 * GetEdgeToEdgeAdjacencyMap() const

The adjacency data is a list of edges that map to their neighbours.

If they don't map to a neighbouring edge, it stores -1, otherwise it stores the neighbour's's index.

const AtlasMeshTriangle* Geo::AtlasMesh::GetTriangle

public: const AtlasMeshTriangle * GetTriangle
(
s32 triangleIndex
) const

Obtain a mesh triangle.

Returns

Returns the specified triangle.

Parameters

[in]

triangleIndex

The index of the triangle to obtain.

s32 Geo::AtlasMesh::GetTriangleCount

public: s32 GetTriangleCount() const

Obtain the number of triangles in the mesh.

Returns

The number of triangles in the mesh.

const s32* Geo::AtlasMesh::GetTrianglePartitioning

public: const s32 * GetTrianglePartitioning() const

Return an array that specifies which triangle is in which chart.

The array is number of triangles long, but may be null. It is non-null after DetectCharts() has been successfully called. Each element is the index of the charts this tri is in, or a negative number for "not in any chart".

Note

Triangles can not be in a chart (ie. topological degenerates when using edge-connected chart detection)

Returns

An array of memory with one entry for each triangle in the mesh, describing which chart it is part of.

const AtlasMeshTriangles* Geo::AtlasMesh::GetTriangles

public: const AtlasMeshTriangles * GetTriangles() const

Obtain the list of triangles.

const AtlasMeshVertex* Geo::AtlasMesh::GetVertex

public: const AtlasMeshVertex * GetVertex
(
s32 vertexIndex
) const

Obtain a vertex.

Returns

Returns the specified vertex.

Parameters

[in]

vertexIndex

The index of the vertex in the mesh.

s32 Geo::AtlasMesh::GetVertexCount

public: s32 GetVertexCount() const

Obtain the number of vertices in the mesh.

Returns

The number of vertices in the mesh.

const AtlasMeshVertices* Geo::AtlasMesh::GetVertices

public: const AtlasMeshVertices * GetVertices() const

Obtain a copy of the vertices in the mesh.

Returns

A copy of the vertex list.

bool Geo::AtlasMesh::IsChartTriangleDegenerate

public: bool IsChartTriangleDegenerate
(
Geo::s32 chart,
Geo::s32 tri
) const

Degeneracy testing.

(In AtlasMesh interface only)

AtlasMesh* Geo::AtlasMesh::MakeChartsIndependent

public: AtlasMesh * MakeChartsIndependent
(
GeoArray< AtlasMeshVertexSplitResult > * vertexSplitSpec
) const

Make the charts independent by duplicating vertices which are shared by more than one chart, and relinking any triangles to the new vertices as necessary.

Returns

A new mesh that has been fixed in this regard.

Parameters

[inout]

vertexSplitSpec

- An array of changes to the original mesh.

void Geo::AtlasMesh::Release

public: void Release()

Release the mesh after it is finished with.

bool Geo::AtlasMesh::RepackCharts

public: bool RepackCharts
(
const AtlasMeshPackingFlags & params,
IGeoProgressProxy * progress
)

Pack the charts into the single square in UV space spanned by (0,0) - (1,1).

static AtlasMesh* Geo::AtlasMesh::SerializeFromFile

public: AtlasMesh * SerializeFromFile
(
FILE * f
)

Serialize this mesh from file - note that this does not include any of the charting information.

It will be in the same state as if you had called Create(...) with the vertices and triangles of this mesh.

void Geo::AtlasMesh::SetVertexUV

public: void SetVertexUV
(
s32 vertexIndex,
float u,
float v
)

Update the UV coordinate of a vertex.

Parameters

[in]	vertexIndex	The index of the vertex which is to be modified.
[in]	u	The new UV coordinates.