General class for work with mesh. More...

Classes
struct	PlaneArgs
	See `GenPlane`. More...

Public Types
typedef cList< cVec3 >	figure_t

typedef cList< int >	figureI_t

typedef cList< figure_t >	figures_t

typedef cList< figureI_t >	figuresI_t

typedef DWORDS2	edgeI_t

typedef void	MeshOpHook (cMeshContainer mc, const char filename)

Public Member Functions
	cMeshContainer ()

	cMeshContainer (const figures_t &, float fusionDistance)
	Build a correct mesh by set of figures. More...

	cMeshContainer (const cMeshContainer &)

cMeshContainer &	operator= (const cMeshContainer &)

bool	operator== (const cMeshContainer &) const

bool	IsValid (const bool ShowWarning=false) const

bool	IsValidRawSequence () const
	Verify the error (from Blender by import OBJ): "the same vertex of face used multiple times". More...

void	Clear ()

void	Copy (const cMeshContainer &src)

const cStr &	GetName () const

void	SetName (const char *Name)

const cList< cVec3 > &	GetPositions () const

cList< cVec3 > &	GetPositions ()

const cVec3 &	GetPosition (int vertex) const

void	SetPosition (int vertex, const cVec3 &)

int	GetVertex (const cVec3 &) const

const cList< DWORD > &	GetVertexColor () const

cList< DWORD > &	GetVertexColor ()

const cList< DWORD > &	GetVertexSpecular () const

cList< DWORD > &	GetVertexSpecular ()

const cList< DWORD > &	GetVertexEmissive () const

cList< DWORD > &	GetVertexEmissive ()

const cList< cVec2 > &	GetTexCoords () const

cList< cVec2 > &	GetTexCoords ()

const cList< cVec3 > &	GetNormals () const

cList< cVec3 > &	GetNormals ()

const cVec3 &	GetNormal (int vertex) const

void	SetNormal (int vertex, const cVec3 &)

const cList< cVec< cVec3, 2 > > &	GetTangents () const

cList< cVec< cVec3, 2 > > &	GetTangents ()

const cList< cVec3i > &	GetRaw () const

cList< cVec3i > &	GetRaw ()

const cList< cSurface > &	GetMaterials () const

cList< cSurface > &	GetMaterials ()

const cList< PtexQuad > &	GetPtex () const

cList< PtexQuad > &	GetPtex ()

const cList< cUVSet > &	GetUVSets () const

cList< cUVSet > &	GetUVSets ()

const cList< cObject > &	GetObjects () const

cList< cObject > &	GetObjects ()

const cList< cVMapElm > &	GetVMaps () const

cList< cVMapElm > &	GetVMaps ()

const cList< cVMapType > &	GetVMTypes () const

cList< cVMapType > &	GetVMTypes ()

int	GetPolyCount () const

int	GetTrisCount () const

cList< int >	GetNeighboursForFace (int beginRawFigure, cVec3 avgNormal=NULL, cVec3 avgCenter=NULL) const

bool	Contains (const cVec3 &) const

bool	Contains (int a) const

bool	Contains (const cVec3 &a, const cVec3 &b) const

bool	Contains (int a, int b) const

bool	Contains (const cList< cVec3 > &figure) const

bool	Contains (const cList< int > &figure) const

bool	IsTriangulated () const

void	Triangulate (cList< cVec3i > &TriRaw) const

void	Triangulate ()

void	CalcNormals ()

void	CalcSplitNormals (cList< int > &SeamsList)

void	InvertRaw ()

void	ConcateWith (const cMeshContainer *mc)

void	Textures2VColor ()

void	RemoveUnusedObjMtl ()

void	RemoveUnusedVerts (cList< int > *encoding=NULL)

template<bool withErase>
::std::pair< cVec3, cVec3 >	Divide (int a, int b, float tAB, int c, int d, float tCD, int beginRemovedRawBlock=NULL, int sizeRemovedRawBlock=NULL,::std::pair< int, int > *changedBeginRawBlock=NULL)
	Divide a figure on two parts with declared line. More...

template<bool withErase>
void	Divide (int a, int b, const cVec3 &m, int c, int d, const cVec3 &n, int beginRemovedRawBlock=NULL, int sizeRemovedRawBlock=NULL,::std::pair< int, int > *changedBeginRawBlock=NULL)

void	Erase (int beginRawFigure, bool withOptimize=false)
	Remove a point / line / polygon (represent as raw-block) from this mesh. More...

void	Erase (const cList< int > &beginRawFigures, bool withOptimize=false)

void	EraseByCount (int n)
	Remove raw-blocks which a count of vertices is equal `n`.

void	EraseByCount (int a, int b)
	Remove raw-blocks which a count of vertices in the diapason [a; b].

void	EraseClearConfluent (float tolerance)
	Remove figures which all vertices are confluent to line. More...

void	EraseClearConfluentByIndexOnly ()
	Verify only indices of vertices.

void	Invert (int beginRawFigure)
	Invert a figure. More...

cList< int >	Find (const cVec3 &nodeCoord) const

cList< int >	Find (int nodeIndex) const

cList< int >	Find (const cVec3 &edgeCoordA, const cVec3 &edgeCoordB) const

cList< int >	Find (int ai, int bi) const

cList< int >	Find (const edgeI_t &) const

cList< int >	Find (const edgeI_t &, const edgeI_t &) const

int	Find (const cList< cVec3 > &figure) const

int	Find (const cList< int > &figure) const

cList< int >	FindClearConfluent (float tolerance) const

void	CorrectFaces (int beginRawBlockEtalon, uni_hash< bool, int > *fixed=NULL)
	Fixed a direction for every face by neighbours. More...

void	CorrectRawSequence ()
	Fixed the error (from Blender by import OBJ): "the same vertex of face used multiple times". More...

void	MergeFaces (float fusionDistance)
	Merge faces of mesh which side by side. More...

int	Insert (int a, int b, float t, cList< int > beginRawFigures=NULL, cList< int > beginRawForRemoved=NULL)
	Insert vertext on the line 'ab' (as verticies). More...

int	Insert (int a, int b, const cVec3 &m, cList< int > beginRawFigures=NULL, cList< int > beginRawForRemoved=NULL)

void	Insert (const figureI_t &, int *beginRawFigure=NULL)
	Insert a figure (index of verticies) into the mesh.

figureI_t	Insert (int a, int *beginRawFigure=NULL)
	Insert a point.

figureI_t	Insert (int a, int b, int *beginRawFigure=NULL)
	Insert a line.

figureI_t	Insert (int a, int b, int c, int *beginRawFigure=NULL)
	Insert a triangle.

figureI_t	Insert (int a, int b, int c, int d, int *beginRawFigure=NULL)
	Insert a polygon with 4 vertices.

void	Insert (const figures_t &, float fusionDistance=-FLT_MAX)
	Insert a set of figures (positions of verticies) into the mesh. More...

void	Insert (const figure_t &, figureI_t *=NULL)
	Insert a figure (positions of verticies) into the mesh. More...

figure_t	Insert (const cVec3 &a, int *ai=NULL)
	Insert a point.

figure_t	Insert (const cVec3 &a, const cVec3 &b, int ai=NULL, int bi=NULL)
	Insert a line.

figure_t	Insert (const cVec3 &a, const cVec3 &b, const cVec3 &c, int ai=NULL, int bi=NULL, int *ci=NULL)
	Insert a triangle.

figure_t	Insert (const cVec3 &a, const cVec3 &b, const cVec3 &c, const cVec3 &d, int ai=NULL, int bi=NULL, int ci=NULL, int di=NULL)
	Insert a polygon with 4 vertices.

void	Insert (const cMeshContainer &)
	Insert a mesh to this mesh. More...

bool	IsClearConfluent (const figure_t &, float tolerance) const

bool	IsClearConfluent (int beginRawFigure, float tolerance) const

bool	IsClearConfluentByIndexOnly (int beginRawFigure) const
	Verify only indices of vertices. More...

bool	IsClockwiseOrder (int beginRawFigure, const cVec3 &observer) const

bool	PerformBooleanOp (cMeshContainer &src1, cMeshContainer &src2, int operation, cList< ::std::pair< comms::cVec3, comms::cVec3 > > *dividers=NULL)
	Build mesh from 'src1' and 'src2' to 'this'. More...

void	CreateCube (const cVec3 &Sides)

void	CreateQuadCylinder (const cMat4 &M, float quant, float rtop=1.0, float rbottom=1.0, float Height=2.0)

void	CreateQuadCylinder (float quant, cVec3 PTop, cVec3 PBottom, float rTop, float rBottom)

void	MakeShell (float Out, float In, float OutEdge, float InEdge, int ndiv=1, cList< cVec2 > *EdgeShape=NULL)

void	MakeShellDir (float Out, float In, cVec3 Dir)

void	LeaveBiggestPiece ()

void	QuadQuantSubd (const cMat4 &M, float quant, float dotp)
	Try to divide all quads in approx equal sub-quads.

void	TriSubd (int N, SubdSnapEdgeCallback dive=NULL, SubdSnapMiddlePointCallback divm=NULL, void *context=NULL)
	Divide triangular mesh on N^2 triangles.

void	Transform (const cMat4 &M)

void	SetDefaultObjMtl ()

void	Symmetry (cVec3 pos, cVec3 n, bool Quads, bool RemoveOpp, float ToleranceCoef=0.0)

void	WeldedSymmetry (cVec3 pos, cVec3 n, bool RemoveOpp, float ToleranceCoef=0.0, float WeldCoef=0.0)

void	Smooth (float degree, bool tangent, int count=1, float sharpdot=0.3, UnlimitedBitset *pins=NULL, bool smoothedges=false)

void	RelaxNormals (cList< cVec3 > &ResultNormals, int Count)

void	SmoothFast (float degree, int count, UnlimitedBitset *pins, bool tangent)

void	GetSharpEdges (cList< DWORDS2 > &List, float dotp)

void	GetOpenEdges (cList< DWORDS2 > &List)

StaticMesh *	CreateStaticMesh ()
	Creation for rendering. More...

StaticMesh *	CreateStaticMeshMC ()
	Create mesh with smoothed normals and mcubes - like shader.

StaticMesh *	CreateHardsurfaceStaticMesh ()
	Create faceted mesh. Shader `mpreview1` used.

StaticMesh *	CreateStaticMeshUV ()
	Create mstatic mesh with UV, skypreview shader used.

cVec3	GetFaceCoord (int pos) const

cVec3	GetFaceNormal (int pos) const

void	SplitHardsurface (float angcos)

void	SplitDisconnected (cList< cMeshContainer * > &res)

void	CreateFone () const

void	ClearFone () const

void	CreateVnv (uni_hash< int, int > &vnv)

void	FindCorners (cList< int > &corners)

void	DrawDbg (const cMat4 &T, DWORD Color, DWORD FillColor=0, DWORD DetailColor=0)

void	DbgDrawMeshWithUVGrid ()
	use this function within __thumbnail(...) section to visualuse mesh with UV, seek "__thumbnail(test1)" as example.

DWORD	CalcGUID ()

float	CalcVolume ()

float	CalcSquare ()

cBounds	CalcBoundBox ()

float	CalcSquareMC ()

void	CloseHoles (int MaxHoleSize, bool SkipMaximalHole)

void	RemoveRedundantUV ()

void	Weld (float distance, UnlimitedBitset *Selected=NULL)

void	AutoWeldOpenEdges ()

void	CutMesh (MeshCutter &mcut)

void	CutByPlane (const cPlane &pl, cList< cVec3 > *cutverts=NULL)

void	PlainSubdiv ()

float	PickObject (cSeg &Ray, const cMat4 &M)

cVec3	CalcMeshProjSquare ()

cVec3	CalcMeshProjSquare (const cMat4 &M)

void	ConvertPicToPolygones (cImage &Img, float Thickness, bool Normalize)

void	ConvertPicToGridPolygones (cImage &Img, float Thickness, int nDiv, bool Normalize, bool DefAlign)

void	ConvertPicToGridPolygonesWithTapering (cImage &ImgT, cImage &ImgB, float Thickness, int nDiv, bool Normalize, float Angle, float Weight)

void	DivideMesh (MeshDivider< int > &) const
	Divide the mesh on two meshes (harvest vertices).

bool	FlipEdge (int V1, int V2, int *valence=NULL)
	flip edge, requires fone, requires 2 faces over the edge.

bool	OptimizeTriangularMesh ()
	tries to set valence 6 whenever possible unsing edge-flip

void	PutOnGround (cMat4 &M, cVec3 &p, cVec3 &c)

void	PutOnGround (cMat4 &M)

void	LayOnGround (cMat4 &M)

void	SeparateObject (int ObjectIndex, cMeshContainer *dest)

void	ImproveQuadsTopology ()

Static Public Member Functions
static void	SetLoadMeshHook (MeshOpHook *h)

static void	SetSaveMeshHook (MeshOpHook *h)

static cMeshContainer *	GenPlane (PlaneArgs=PlaneArgs())

static cMeshContainer *	GenPlaneHexagonal (const float Lx, const float Ly, const float Cell, const bool Noisy)

Public Attributes
cList< OneMorph * >	Morphs

uni_hash< int, DWORDS2 >	fone

Static Public Attributes
static MeshOpHook *	ImportHook

static MeshOpHook *	ExportHook

Protected Attributes
cStr	m_Name

cList< cVec3 >	m_Positions

cList< cVec2 >	m_TexCoords

cList< cVec3 >	m_Normals

cList< cUVSet >	m_UVSets

cList< cVec< cVec3, 2 > >	m_Tangents
	Tangent and BiTangent.

cList< cVec3i >	m_Raw

cList< cSurface >	m_Materials

cList< cObject >	m_Objects

cList< cVMapElm >	m_VMaps

cList< cVMapType >	m_VmTypes

cList< PtexQuad >	m_Ptex

cList< DWORD >	m_VertexColor

cList< DWORD >	m_VertexSpecular
	RGB - specular color, A - glossness.

cList< DWORD >	m_VertexEmissive

Detailed Description

General class for work with mesh.

Constructor & Destructor Documentation

comms::cMeshContainer::cMeshContainer ( )

Warning: Call CreateDefaultObjMtl() manually for create a defaul object and material.

comms::cMeshContainer::cMeshContainer	(	const figures_t &	,
		float	fusionDistance
	)

Build a correct mesh by set of figures.

Parameters

fusionDistance See MergeFaces() for details.

See Also: Insert( figures_t )Edge

Member Function Documentation

bool comms::cMeshContainer::IsValid ( const bool ShowWarning = false ) const

Returns: true when mesh is correct.

Todo:: fine Move ShowWarning to configure of project or set always true when a debug-mode.

bool comms::cMeshContainer::IsValidRawSequence ( ) const

Verify the error (from Blender by import OBJ): "the same vertex of face used multiple times".

See Also: cMeshContainerTest::CorrectRawSequence*(); CorrectRawSequence()

const cVec3& comms::cMeshContainer::GetPosition ( int vertex ) const

Returns: Coord (position) by vertex (index of position).

First vertex of mesh is 0.

See Also: GetVertex()

int comms::cMeshContainer::GetVertex ( const cVec3 & ) const

Returns: Vertex (index of position) by coord (position).

See Also: GetPosition()

const cList<cVec3>& comms::cMeshContainer::GetNormals ( ) const

inline

See Also: GetNormal(), GetFaceNormal(), GetFaceCoord()

const cVec3& comms::cMeshContainer::GetNormal ( int vertex ) const

Returns: Normal by vertex (index of normal).

Warning: Use CalcNormals() for correct result.

See Also: GetFaceNormal(), GetFaceCoord()

cList< int > comms::cMeshContainer::GetNeighboursForFace	(	int	beginRawFigure,
		cVec3 *	avgNormal = `NULL`,
		cVec3 *	avgCenter = `NULL`
	)		const

Returns: List of 'begin raw block' which blocks be adjacent to 'beginRawFigure'.
Also returns average normal and coord of center of neighbours of face.

See Also: Find()

bool comms::cMeshContainer::Contains ( const cVec3 & ) const

Returns: Point has in the mesh.

bool comms::cMeshContainer::Contains	(	const cVec3 &	a,
		const cVec3 &	b
	)		const

Returns: Edge ab has in the mesh.

bool comms::cMeshContainer::Contains ( const cList< cVec3 > & figure ) const

Returns: Figure has in the mesh. Verify by one direction only.

void comms::cMeshContainer::InvertRaw ( )

See Also: Invert()

template<bool withErase>

::std::pair< cVec3, cVec3 > comms::cMeshContainer::Divide	(	int	a,
		int	b,
		float	tAB,
		int	c,
		int	d,
		float	tCD,
		int *	beginRemovedRawBlock = `NULL`,
		int *	sizeRemovedRawBlock = `NULL`,
		::std::pair< int, int > *	changedBeginRawBlock = `NULL`
	)

Divide a figure on two parts with declared line.

Returns: Coords for found points.

Template Parameters

withErase True, when need delete a figure which divided.

Parameters

a,b,c,d	Vertices of figure.
tAB,tCD	Neppers of new vertices on the edges `ab` and `cd`.

When ab, cd are not of part of 1 (one!) figure, exception is throw.

template<bool withErase>

void comms::cMeshContainer::Divide	(	int	a,
		int	b,
		const cVec3 &	m,
		int	c,
		int	d,
		const cVec3 &	n,
		int *	beginRemovedRawBlock = `NULL`,
		int *	sizeRemovedRawBlock = `NULL`,
		::std::pair< int, int > *	changedBeginRawBlock = `NULL`
	)

Parameters

m	Point for insert between points `ab`.
n	Point for insert between points `cd`.

void comms::cMeshContainer::Erase	(	int	beginRawFigure,
		bool	withOptimize = `false`
	)

Remove a point / line / polygon (represent as raw-block) from this mesh.

Parameters

beginRawFigure	Start position of block in the GetRaw().
withOptimize	Unused coords of the mesh removed from the GetPositions().

See Also: Find() For example
Erase( Find( a, b ).GetFirst() );

void comms::cMeshContainer::EraseClearConfluent ( float tolerance )

Remove figures which all vertices are confluent to line.

See Also: FindClearConfluent()

void comms::cMeshContainer::Invert ( int beginRawFigure )

Invert a figure.

See Also: Find()

cList< int > comms::cMeshContainer::Find ( const cVec3 & nodeCoord ) const

Returns: Shifts in the GetRaw() of this mesh. This pointer consist of declared node or edge.
If node or edge is not found, when return an empty list.

See Also: GetNeighboursForFace(), Erase()

cList< int > comms::cMeshContainer::Find	(	const edgeI_t &	,
		const edgeI_t &
	)		const

Warning: All defined edges must be parts of figure.

int comms::cMeshContainer::Find ( const cList< cVec3 > & figure ) const

Returns: See cList< int > Find(). If node or edge is not found, when return -1.

cList< int > comms::cMeshContainer::FindClearConfluent ( float tolerance ) const

Returns: List of raw-blocks which contains all fantom-figures (all vertices are confluent to line).

Parameters

tolerance Value at angle for include a figure.

Warning: All lines and points are confluent figure.

See Also: EraseClearConfluent()

void comms::cMeshContainer::CorrectFaces	(	int	beginRawBlockEtalon,
		uni_hash< bool, int > *	fixed = `NULL`
	)

Fixed a direction for every face by neighbours.

Returns: True, when any faces was corrected.

Parameters

beginRawBlockEtalon	Start of block for faces which was as etalon for "direction of all other face".
fixed	List of 'beginRawFigure' when already fixed.

void comms::cMeshContainer::CorrectRawSequence ( )

Fixed the error (from Blender by import OBJ): "the same vertex of face used multiple times".

See Also: cMeshContainerTest::CorrectRawSequence*(); IsValidRawSequence()

void comms::cMeshContainer::MergeFaces ( float fusionDistance )

Merge faces of mesh which side by side.

Parameters

fusionDistance Distance between vertex and edge when initiate a merge.

See Also: cMeshContainerTest.jpg, "K" or "H"

int comms::cMeshContainer::Insert	(	int	a,
		int	b,
		float	t,
		cList< int > *	beginRawFigures = `NULL`,
		cList< int > *	beginRawForRemoved = `NULL`
	)

Insert vertext on the line 'ab' (as verticies).

Returns: Added vertex.

Parameters

t	Distance on the line as a nepper. [ 0.0 (a) .. 0.5 (half of length 'ab') .. 1.0 (b) ]
beginRawFigure	Starts of blocks when point or figure was inserted.
beginRawForRemoved	Starts of blocks which clear confluented.

Todo:: fine Change 'int' to 'typedef int vertex_t'.

int comms::cMeshContainer::Insert	(	int	a,
		int	b,
		const cVec3 &	m,
		cList< int > *	beginRawFigures = `NULL`,
		cList< int > *	beginRawForRemoved = `NULL`
	)

Parameters

m	Point for insert between points `ab`.

void comms::cMeshContainer::Insert	(	const figures_t &	,
		float	fusionDistance = `-FLT_MAX`
	)

Insert a set of figures (positions of verticies) into the mesh.

Parameters

fusionDistance Call MergeFaces() when this param is positive or zero.

See Also: construct( figures_t )

void comms::cMeshContainer::Insert	(	const figure_t &	,
		figureI_t *	= `NULL`
	)

Insert a figure (positions of verticies) into the mesh.

Added coords are not containes dublicates.
Use MergeFaces() for fixed faces after insert positions.

Parameters

figureI_t	Accumulte indices of vertices when defined.
ai,bi,...	By analogy of 'figureI_t'.

void comms::cMeshContainer::Insert ( const cMeshContainer & )

Insert a mesh to this mesh.

Vertices are not dublicate.

See Also: ConcateWith()

bool comms::cMeshContainer::IsClearConfluent	(	const figure_t &	,
		float	tolerance
	)		const

Returns: True when 'beginRawFigure' contains a figure which all vertices are confluent to line.

Parameters

tolerance Value at angle for detect figure as confluent to line.

Warning: All lines and points are confluent figure.

See Also: FindClearConfluent(), EraseClearConfluent()

bool comms::cMeshContainer::IsClearConfluentByIndexOnly ( int beginRawFigure ) const

Verify only indices of vertices.

See Also: IsClearConfluent()

bool comms::cMeshContainer::IsClockwiseOrder	(	int	beginRawFigure,
		const cVec3 &	observer
	)		const

Returns: true when line / face is clockwise order.
false when 'beginRawFigure' aim to point.

bool comms::cMeshContainer::PerformBooleanOp	(	cMeshContainer &	src1,
		cMeshContainer &	src2,
		int	operation,
		cList< ::std::pair< comms::cVec3, comms::cVec3 > > *	dividers = `NULL`
	)

Build mesh from 'src1' and 'src2' to 'this'.

Parameters

operation

Variants:

0 - add
1 - subtract src1 - src2
2 - intersect src1 & src2

StaticMesh* comms::cMeshContainer::CreateStaticMesh ( )

Creation for rendering.

Create mesh with smoothed normals. Shader mpreview1 used.

cVec3 comms::cMeshContainer::GetFaceCoord ( int pos ) const

See Also: GetNormal()

void comms::cMeshContainer::DrawDbg	(	const cMat4 &	T,
		DWORD	Color,
		DWORD	FillColor = `0`,
		DWORD	DetailColor = `0`
	)

Warning: If mesh is not triangulated when DrawDbg() is incorrect.

Member Data Documentation

cList<cVec3i> comms::cMeshContainer::m_Raw

protected

Polygon info or 3 references to the arrays of positions, texture coordinates, and normals with tangents (optional) respectively.

Info0 = { Count0, idMtl, idObj } idMtl = 
Indices_0 = { iPosition, iTexCoord, iNormal (iTangent) }
...
Indices_(Count0 - 1)
Info1
...

Classes

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation