All Frameworks Class Hierarchy This Framework Indexes Previous Next

GMModelInterfaces Interface CATICGMCellTessellator

Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.

interface CATICGMCellTessellator

Class defining a tessellation operator on a cell.

This operator discretizes a face geometry as triangles and an edge geometry as bars. The extremities of the bars are called points. Three parameters tune the tessellation result:

Sag: Defines the maximum distance between a bar and the object to tessellate
Step: Defines the maximum length of a bar. If not defined, the step is infinite (this parameter is unused)
Angle: Defines the maximum angle between the normals at each bar end.

The Tessellation operator follows the scheme of all the CGM operators:

Create an operator instance,
Add other cells to tessellate in the same operation,
Run,
Recover the results by the means of iterators,
Delete the operator instance. The deletion of the operator leads to the deletion of the iterators and the arrays of results.

Method Index

o AddEdge(CATEdge*): Adds another edge to this CATICGMCellTessellator.
o AddFace(CATFace*): Adds another face to this CATICGMCellTessellator.
o GetEdge(CATEdge*,CATLONG32&,float**): Retrieves the result (in floats) associated with a topological edge of the input cells.
o GetEdge(CATEdge*,CATLONG32&,double**): Retrieves the results (in doubles) associated with a topological edge of the input cells.
o GetEdge(CATEdge*,CATMathSetOfPointsND**,CATMathSetOfPointsND**): Retrieves the results associated with a topological edge of the input cells.
o GetFace(CATFace*,CATBoolean&,CATCGMTessPointIter**,CATCGMTessStripeIter**,CATCGMTessFanIter**,CATCGMTessPolyIter**,CATCGMTessTrianIter**,short*): Retrieves the results associated with a topological face of the input cells.
o GetVertex(CATVertex*,CATMathPoint*): Retrieves the result associated with a topological vertex of the input cells.
o Run(): Runs this CATICGMCellTessellator.
o SetOutputMode(CATTessOutputMode): Defines Output mode for triangulation.
o SetStep(double): Defines a finite step for this CATICGMCellTessellator.

Methods

o AddEdge

public virtual AddEdge( iEdge)

Adds another edge to this CATICGMCellTessellator.

Parameters:

iEdge: The pointer to another edge to tessellate in the same operation.

o AddFace

public virtual AddFace( iFace)

Adds another face to this CATICGMCellTessellator.

Parameters:

iFace: The pointer to another face to tessellate in the same operation.

o GetEdge

public virtual GetEdge(		`iEdge`,
		`oNumberOfPoints`,
		`oPointData`)

Retrieves the result (in floats) associated with a topological edge of the input cells.

Parameters:

iEdge: The pointer to an edge among the input cells.
oNumberOfPoints: The number of points of the resulting tessellation.
oPointData: The array of the resulting points. This array is allocated by the GetEdge method. The j-th coordinate of the i-th point is oPointData[3*(i-1)+j-1]. of the resulting tessellation.

o GetEdge

public virtual GetEdge(		`iEdge`,
		`oNumberOfPoints`,
		`oPointData`)

Retrieves the results (in doubles) associated with a topological edge of the input cells.

Parameters:

iEdge: The pointer to an edge among the input cells.
oNumberOfPoints: The number of points of the resulting tessellation.
oPointData: The array of the resulting points. This array is allocated by the GetEdge method. The j-th coordinate of the i-th point is oPointData[3*(i-1)+j-1].

o GetEdge

public virtual GetEdge(		`iEdge`,
		`oMathPoints`,
		`oCrvParams`)

Retrieves the results associated with a topological edge of the input cells.

Parameters:

iEdge: The pointer to an edge among the input cells.
oMathPoints: The pointer to the created CATMathSetOfPointsND pointer. This set contains the points (as 3 Cartesian coordinates) of the resulting tessellation.
oCrvParams: The pointer to the created CATMathSetOfPointsND pointer. This set contains the points (as a CATCrvParam on the underlying edge curve) of the resulting tessellation.

o GetFace

public virtual GetFace(	`iFace`,
	`oPlane`,
	`oPoints`,
	`oStrips`,
	`oFans`,
	`oPolygons`,
	`oTriangles`,
	`oSide`	`=(short*)0`)

Retrieves the results associated with a topological face of the input cells.
All the output iterators are allocated by the GetFace method, and are deleted when the operator is deleted.

Parameters:

iFace: The pointer to a face among the input cells.
oPlane: Retrieves 1 if the face is planar, 0 otherwise.
oPoints: The pointer to the created pointer to a CATCGMTessPointIter, to retrieve the computed points.
oStrips: The pointer to the created pointer to a CATCGMTessStripIter, to retrieve the computed triangle strips.
oStrips: The pointer to the created pointer to a CATCGMTessFanIter, to retrieve the computed triangle fans.
oStrips: The pointer to the created pointer to a CATCGMTessPolygonIter, to retrieve the computed polygons. The pointer to the created CATCGMTessPolygonIter, to retrieve the computed polygons.
oSide: The face orientation.
Legal values: 1 if the face orientation is outwards, -1 if it is inwards.

o GetVertex

public virtual GetVertex(		`iVertex`,
		`oMathPoint`)

Retrieves the result associated with a topological vertex of the input cells.

Parameters:

iVertex: The pointer to a vertex of the input cells.
oMathPoint: The corresponding CATMathPoint.

o Run

public virtual Run(

)

Runs this CATICGMCellTessellator.

o SetOutputMode

public virtual SetOutputMode( iMode = CATTessOutputMixed)

Defines Output mode for triangulation. Defaults to mixed output.

o SetStep

public virtual SetStep( iStep)

Defines a finite step for this CATICGMCellTessellator.

Parameters:

iStep: The Step value.

This object is included in the file: CATICGMCellTessellator.h
If needed, your Imakefile.mk should include the module: CATGMModelInterfaces