Provides a triangulation for a surface, a set of surfaces, or more generally a shape. More...

#include <Poly_Triangulation.hxx>

Inheritance diagram for Poly_Triangulation:

[legend]

Public Member Functions
	Poly_Triangulation ()
	Constructs an empty triangulation.

	Poly_Triangulation (const Standard_Integer theNbNodes, const Standard_Integer theNbTriangles, const Standard_Boolean theHasUVNodes, const Standard_Boolean theHasNormals=false)
	Constructs a triangulation from a set of triangles. The triangulation is initialized without a triangle or a node, but capable of containing specified number of nodes and triangles.

	Poly_Triangulation (const TColgp_Array1OfPnt &Nodes, const Poly_Array1OfTriangle &Triangles)
	Constructs a triangulation from a set of triangles. The triangulation is initialized with 3D points from Nodes and triangles from Triangles.

	Poly_Triangulation (const TColgp_Array1OfPnt &Nodes, const TColgp_Array1OfPnt2d &UVNodes, const Poly_Array1OfTriangle &Triangles)
	Constructs a triangulation from a set of triangles. The triangulation is initialized with 3D points from Nodes, 2D points from UVNodes and triangles from Triangles, where coordinates of a 2D point from UVNodes are the (u, v) parameters of the corresponding 3D point from Nodes on the surface approximated by the constructed triangulation.

virtual	~Poly_Triangulation ()
	Destructor.

virtual Handle< Poly_Triangulation >	Copy () const
	Creates full copy of current triangulation.

	Poly_Triangulation (const Handle< Poly_Triangulation > &theTriangulation)
	Copy constructor for triangulation.

Standard_Real	Deflection () const
	Returns the deflection of this triangulation.

void	Deflection (const Standard_Real theDeflection)
	Sets the deflection of this triangulation to theDeflection. See more on deflection in Polygon2D.

const Handle< Poly_TriangulationParameters > &	Parameters () const
	Returns initial set of parameters used to generate this triangulation.

void	Parameters (const Handle< Poly_TriangulationParameters > &theParams)
	Updates initial set of parameters used to generate this triangulation.

virtual void	Clear ()
	Clears internal arrays of nodes and all attributes.

virtual Standard_Boolean	HasGeometry () const
	Returns TRUE if triangulation has some geometry.

Standard_Integer	NbNodes () const
	Returns the number of nodes for this triangulation.

Standard_Integer	NbTriangles () const
	Returns the number of triangles for this triangulation.

Standard_Boolean	HasUVNodes () const
	Returns Standard_True if 2D nodes are associated with 3D nodes for this triangulation.

Standard_Boolean	HasNormals () const
	Returns Standard_True if nodal normals are defined.

gp_Pnt	Node (Standard_Integer theIndex) const
	Returns a node at the given index.

void	SetNode (Standard_Integer theIndex, const gp_Pnt &thePnt)
	Sets a node coordinates.

gp_Pnt2d	UVNode (Standard_Integer theIndex) const
	Returns UV-node at the given index.

void	SetUVNode (Standard_Integer theIndex, const gp_Pnt2d &thePnt)
	Sets an UV-node coordinates.

const Poly_Triangle &	Triangle (Standard_Integer theIndex) const
	Returns triangle at the given index.

void	SetTriangle (Standard_Integer theIndex, const Poly_Triangle &theTriangle)
	Sets a triangle.

gp_Dir	Normal (Standard_Integer theIndex) const
	Returns normal at the given index.

void	Normal (Standard_Integer theIndex, gp_Vec3f &theVec3) const
	Returns normal at the given index.

void	SetNormal (const Standard_Integer theIndex, const gp_Vec3f &theNormal)
	Changes normal at the given index.

void	SetNormal (const Standard_Integer theIndex, const gp_Dir &theNormal)
	Changes normal at the given index.

Poly_MeshPurpose	MeshPurpose () const
	Returns mesh purpose bits.

void	SetMeshPurpose (const Poly_MeshPurpose thePurpose)
	Sets mesh purpose bits.

const Bnd_Box &	CachedMinMax () const
	Returns cached min - max range of triangulation data, which is VOID by default (e.g, no cached information).

void	SetCachedMinMax (const Bnd_Box &theBox)
	Sets a cached min - max range of this triangulation. The bounding box should exactly match actual range of triangulation data without a gap or transformation, or otherwise undefined behavior will be observed. Passing a VOID range invalidates the cache.

Standard_Boolean	HasCachedMinMax () const
	Returns TRUE if there is some cached min - max range of this triangulation.

void	UpdateCachedMinMax ()
	Updates cached min - max range of this triangulation with bounding box of nodal data.

Standard_Boolean	MinMax (Bnd_Box &theBox, const gp_Trsf &theTrsf, const bool theIsAccurate=false) const
	Extends the passed box with bounding box of this triangulation. Uses cached min - max range when available and:

virtual void	DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=-1) const
	Dumps the content of me into the stream.

bool	IsDoublePrecision () const
	Returns TRUE if node positions are defined with double precision; TRUE by default.

void	SetDoublePrecision (bool theIsDouble)
	Set if node positions should be defined with double or single precision for 3D and UV nodes. Raises exception if data was already allocated.

void	ResizeNodes (Standard_Integer theNbNodes, Standard_Boolean theToCopyOld)
	Method resizing internal arrays of nodes (synchronously for all attributes).

void	ResizeTriangles (Standard_Integer theNbTriangles, Standard_Boolean theToCopyOld)
	Method resizing an internal array of triangles.

void	AddUVNodes ()
	If an array for UV coordinates is not allocated yet, do it now.

void	RemoveUVNodes ()
	Deallocates the UV nodes array.

void	AddNormals ()
	If an array for normals is not allocated yet, do it now.

void	RemoveNormals ()
	Deallocates the normals array.

void	ComputeNormals ()
	Compute smooth normals by averaging triangle normals.

Handle< TColgp_HArray1OfPnt >	MapNodeArray () const
	Returns the table of 3D points for read-only access or NULL if nodes array is undefined. Poly_Triangulation::Node() should be used instead when possible. Returned object should not be used after Poly_Triangulation destruction.

Handle< Poly_HArray1OfTriangle >	MapTriangleArray () const
	Returns the triangle array for read-only access or NULL if triangle array is undefined. Poly_Triangulation::Triangle() should be used instead when possible. Returned object should not be used after Poly_Triangulation destruction.

Handle< TColgp_HArray1OfPnt2d >	MapUVNodeArray () const
	Returns the table of 2D nodes for read-only access or NULL if UV nodes array is undefined. Poly_Triangulation::UVNode() should be used instead when possible. Returned object should not be used after Poly_Triangulation destruction.

Handle< TShort_HArray1OfShortReal >	MapNormalArray () const
	Returns the table of per-vertex normals for read-only access or NULL if normals array is undefined. Poly_Triangulation::Normal() should be used instead when possible. Returned object should not be used after Poly_Triangulation destruction.

Poly_Array1OfTriangle &	InternalTriangles ()
	Returns an internal array of triangles. Triangle()/SetTriangle() should be used instead in portable code.

Poly_ArrayOfNodes &	InternalNodes ()
	Returns an internal array of nodes. Node()/SetNode() should be used instead in portable code.

Poly_ArrayOfUVNodes &	InternalUVNodes ()
	Returns an internal array of UV nodes. UBNode()/SetUVNode() should be used instead in portable code.

NCollection_Array1< gp_Vec3f > &	InternalNormals ()
	Return an internal array of normals. Normal()/SetNormal() should be used instead in portable code.

void	SetNormals (const Handle< TShort_HArray1OfShortReal > &theNormals)

const Poly_Array1OfTriangle &	Triangles () const

Poly_Array1OfTriangle &	ChangeTriangles ()

Poly_Triangle &	ChangeTriangle (const Standard_Integer theIndex)

Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor.

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing.

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter.

virtual	~Standard_Transient ()
	Destructor must be virtual.

virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object.

Standard_Boolean	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type.

Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName.

Standard_Boolean	IsKind (const opencascade::handle< Standard_Type > &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

Standard_Boolean	IsKind (const Standard_CString theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

Standard_Transient *	This () const
	Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero.

Standard_Integer	GetRefCount () const noexcept
	Get the reference counter of this object.

void	IncrementRefCounter () noexcept
	Increments the reference counter of this object.

Standard_Integer	DecrementRefCounter () noexcept
	Decrements the reference counter of this object; returns the decremented value.

virtual void	Delete () const
	Memory deallocator for transient classes.

late-load deferred data interface
Bnd_Box *	myCachedMinMax
	Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

Standard_Real	myDeflection
	Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

Poly_ArrayOfNodes	myNodes
	Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

Poly_Array1OfTriangle	myTriangles
	Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

Poly_ArrayOfUVNodes	myUVNodes
	Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

NCollection_Array1< gp_Vec3f >	myNormals
	Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

Poly_MeshPurpose	myPurpose
	Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

Handle< Poly_TriangulationParameters >	myParams
	Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

virtual Standard_Integer	NbDeferredNodes () const
	Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

virtual Standard_Integer	NbDeferredTriangles () const
	Returns number of deferred triangles that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

virtual Standard_Boolean	HasDeferredData () const
	Returns TRUE if there is some triangulation data that can be loaded using LoadDeferredData().

virtual Standard_Boolean	LoadDeferredData (const Handle< OSD_FileSystem > &theFileSystem=Handle< OSD_FileSystem >())
	Loads triangulation data into itself from some deferred storage using specified shared input file system.

virtual Handle< Poly_Triangulation >	DetachedLoadDeferredData (const Handle< OSD_FileSystem > &theFileSystem=Handle< OSD_FileSystem >()) const
	Loads triangulation data into new Poly_Triangulation object from some deferred storage using specified shared input file system.

virtual Standard_Boolean	UnloadDeferredData ()
	Releases triangulation data if it has connected deferred storage.

virtual Handle< Poly_Triangulation >	createNewEntity () const
	Creates new triangulation object (can be inheritor of Poly_Triangulation).

virtual Standard_Boolean	loadDeferredData (const Handle< OSD_FileSystem > &theFileSystem, const Handle< Poly_Triangulation > &theDestTriangulation) const
	Load triangulation data from deferred storage using specified shared input file system.

void	unsetCachedMinMax ()
	Clears cached min - max range saved previously.

virtual Bnd_Box	computeBoundingBox (const gp_Trsf &theTrsf) const
	Calculates bounding box of nodal data.

Additional Inherited Members
Public Types inherited from Standard_Transient
typedef void	base_type
	Returns a type descriptor about this object.

Static Public Member Functions inherited from Standard_Transient
static constexpr const char *	get_type_name ()
	Returns a type descriptor about this object.

static const opencascade::handle< Standard_Type > &	get_type_descriptor ()
	Returns type descriptor of Standard_Transient class.

Detailed Description

Provides a triangulation for a surface, a set of surfaces, or more generally a shape.

A triangulation consists of an approximate representation of the actual shape, using a collection of points and triangles. The points are located on the surface. The edges of the triangles connect adjacent points with a straight line that approximates the true curve on the surface.

A triangulation comprises:

A table of 3D nodes (3D points on the surface).
A table of triangles. Each triangle (Poly_Triangle object) comprises a triplet of indices in the table of 3D nodes specific to the triangulation.
An optional table of 2D nodes (2D points), parallel to the table of 3D nodes. 2D point are the (u, v) parameters of the corresponding 3D point on the surface approximated by the triangulation.
An optional table of 3D vectors, parallel to the table of 3D nodes, defining normals to the surface at specified 3D point.
An optional deflection, which maximizes the distance from a point on the surface to the corresponding point on its approximate triangulation.

In many cases, algorithms do not need to work with the exact representation of a surface. A triangular representation induces simpler and more robust adjusting, faster performances, and the results are as good.

Constructor & Destructor Documentation

◆ Poly_Triangulation() [1/5]

Poly_Triangulation::Poly_Triangulation ( )

Constructs an empty triangulation.

◆ Poly_Triangulation() [2/5]

Poly_Triangulation::Poly_Triangulation	(	const Standard_Integer	theNbNodes,
		const Standard_Integer	theNbTriangles,
		const Standard_Boolean	theHasUVNodes,
		const Standard_Boolean	theHasNormals = false )

Constructs a triangulation from a set of triangles. The triangulation is initialized without a triangle or a node, but capable of containing specified number of nodes and triangles.

Parameters

theNbNodes	[in] number of nodes to allocate
theNbTriangles	[in] number of triangles to allocate
theHasUVNodes	[in] indicates whether 2D nodes will be associated with 3D ones, (i.e. to enable a 2D representation)
theHasNormals	[in] indicates whether normals will be given and associated with nodes

◆ Poly_Triangulation() [3/5]

Poly_Triangulation::Poly_Triangulation	(	const TColgp_Array1OfPnt &	Nodes,
		const Poly_Array1OfTriangle &	Triangles )

Constructs a triangulation from a set of triangles. The triangulation is initialized with 3D points from Nodes and triangles from Triangles.

◆ Poly_Triangulation() [4/5]

Poly_Triangulation::Poly_Triangulation	(	const TColgp_Array1OfPnt &	Nodes,
		const TColgp_Array1OfPnt2d &	UVNodes,
		const Poly_Array1OfTriangle &	Triangles )

Constructs a triangulation from a set of triangles. The triangulation is initialized with 3D points from Nodes, 2D points from UVNodes and triangles from Triangles, where coordinates of a 2D point from UVNodes are the (u, v) parameters of the corresponding 3D point from Nodes on the surface approximated by the constructed triangulation.

◆ ~Poly_Triangulation()

virtual Poly_Triangulation::~Poly_Triangulation ( )

virtual

Destructor.

◆ Poly_Triangulation() [5/5]

Poly_Triangulation::Poly_Triangulation ( const Handle< Poly_Triangulation > & theTriangulation )

Copy constructor for triangulation.

Member Function Documentation

◆ AddNormals()

void Poly_Triangulation::AddNormals ( )

If an array for normals is not allocated yet, do it now.

◆ AddUVNodes()

void Poly_Triangulation::AddUVNodes ( )

If an array for UV coordinates is not allocated yet, do it now.

◆ CachedMinMax()

const Bnd_Box & Poly_Triangulation::CachedMinMax ( ) const

Returns cached min - max range of triangulation data, which is VOID by default (e.g, no cached information).

◆ ChangeTriangle()

Poly_Triangle & Poly_Triangulation::ChangeTriangle ( const Standard_Integer theIndex )

inline

Deprecated: ("Deprecated method, SetTriangle() should be used instead")

◆ ChangeTriangles()

Poly_Array1OfTriangle & Poly_Triangulation::ChangeTriangles ( )

inline

Deprecated: ("Deprecated method, SetTriangle() should be used instead")

◆ Clear()

virtual void Poly_Triangulation::Clear ( )

virtual

Clears internal arrays of nodes and all attributes.

◆ computeBoundingBox()

virtual Bnd_Box Poly_Triangulation::computeBoundingBox ( const gp_Trsf & theTrsf ) const

protectedvirtual

Calculates bounding box of nodal data.

Parameters

theTrsf [in] optional transformation.

◆ ComputeNormals()

void Poly_Triangulation::ComputeNormals ( )

Compute smooth normals by averaging triangle normals.

◆ Copy()

virtual Handle< Poly_Triangulation > Poly_Triangulation::Copy ( ) const

virtual

Creates full copy of current triangulation.

◆ createNewEntity()

virtual Handle< Poly_Triangulation > Poly_Triangulation::createNewEntity ( ) const

inlineprotectedvirtual

Creates new triangulation object (can be inheritor of Poly_Triangulation).

◆ Deflection() [1/2]

Standard_Real Poly_Triangulation::Deflection ( ) const

inline

Returns the deflection of this triangulation.

◆ Deflection() [2/2]

void Poly_Triangulation::Deflection ( const Standard_Real theDeflection )

inline

Sets the deflection of this triangulation to theDeflection. See more on deflection in Polygon2D.

◆ DetachedLoadDeferredData()

virtual Handle< Poly_Triangulation > Poly_Triangulation::DetachedLoadDeferredData ( const Handle< OSD_FileSystem > & theFileSystem = Handle< OSD_FileSystem >() ) const

virtual

Loads triangulation data into new Poly_Triangulation object from some deferred storage using specified shared input file system.

◆ DumpJson()

virtual void Poly_Triangulation::DumpJson	(	Standard_OStream &	theOStream,
		Standard_Integer	theDepth = -1 ) const

virtual

Dumps the content of me into the stream.

◆ HasCachedMinMax()

Standard_Boolean Poly_Triangulation::HasCachedMinMax ( ) const

inline

Returns TRUE if there is some cached min - max range of this triangulation.

◆ HasDeferredData()

virtual Standard_Boolean Poly_Triangulation::HasDeferredData ( ) const

inlinevirtual

Returns TRUE if there is some triangulation data that can be loaded using LoadDeferredData().

Reimplemented in RWGltf_GltfLatePrimitiveArray.

◆ HasGeometry()

virtual Standard_Boolean Poly_Triangulation::HasGeometry ( ) const

inlinevirtual

Returns TRUE if triangulation has some geometry.

◆ HasNormals()

Standard_Boolean Poly_Triangulation::HasNormals ( ) const

inline

Returns Standard_True if nodal normals are defined.

◆ HasUVNodes()

Standard_Boolean Poly_Triangulation::HasUVNodes ( ) const

inline

Returns Standard_True if 2D nodes are associated with 3D nodes for this triangulation.

◆ InternalNodes()

Poly_ArrayOfNodes & Poly_Triangulation::InternalNodes ( )

inline

Returns an internal array of nodes. Node()/SetNode() should be used instead in portable code.

◆ InternalNormals()

NCollection_Array1< gp_Vec3f > & Poly_Triangulation::InternalNormals ( )

inline

Return an internal array of normals. Normal()/SetNormal() should be used instead in portable code.

◆ InternalTriangles()

Poly_Array1OfTriangle & Poly_Triangulation::InternalTriangles ( )

inline

Returns an internal array of triangles. Triangle()/SetTriangle() should be used instead in portable code.

◆ InternalUVNodes()

Poly_ArrayOfUVNodes & Poly_Triangulation::InternalUVNodes ( )

inline

Returns an internal array of UV nodes. UBNode()/SetUVNode() should be used instead in portable code.

◆ IsDoublePrecision()

bool Poly_Triangulation::IsDoublePrecision ( ) const

inline

Returns TRUE if node positions are defined with double precision; TRUE by default.

◆ LoadDeferredData()

virtual Standard_Boolean Poly_Triangulation::LoadDeferredData ( const Handle< OSD_FileSystem > & theFileSystem = Handle< OSD_FileSystem >() )

virtual

Loads triangulation data into itself from some deferred storage using specified shared input file system.

◆ loadDeferredData()

virtual Standard_Boolean Poly_Triangulation::loadDeferredData	(	const Handle< OSD_FileSystem > &	theFileSystem,
		const Handle< Poly_Triangulation > &	theDestTriangulation ) const

inlineprotectedvirtual

Load triangulation data from deferred storage using specified shared input file system.

Reimplemented in RWMesh_TriangulationSource.

◆ MapNodeArray()

Handle< TColgp_HArray1OfPnt > Poly_Triangulation::MapNodeArray ( ) const

Returns the table of 3D points for read-only access or NULL if nodes array is undefined. Poly_Triangulation::Node() should be used instead when possible. Returned object should not be used after Poly_Triangulation destruction.

◆ MapNormalArray()

Handle< TShort_HArray1OfShortReal > Poly_Triangulation::MapNormalArray ( ) const

Returns the table of per-vertex normals for read-only access or NULL if normals array is undefined. Poly_Triangulation::Normal() should be used instead when possible. Returned object should not be used after Poly_Triangulation destruction.

◆ MapTriangleArray()

Handle< Poly_HArray1OfTriangle > Poly_Triangulation::MapTriangleArray ( ) const

Returns the triangle array for read-only access or NULL if triangle array is undefined. Poly_Triangulation::Triangle() should be used instead when possible. Returned object should not be used after Poly_Triangulation destruction.

◆ MapUVNodeArray()

Handle< TColgp_HArray1OfPnt2d > Poly_Triangulation::MapUVNodeArray ( ) const

Returns the table of 2D nodes for read-only access or NULL if UV nodes array is undefined. Poly_Triangulation::UVNode() should be used instead when possible. Returned object should not be used after Poly_Triangulation destruction.

◆ MeshPurpose()

Poly_MeshPurpose Poly_Triangulation::MeshPurpose ( ) const

inline

Returns mesh purpose bits.

◆ MinMax()

Standard_Boolean Poly_Triangulation::MinMax	(	Bnd_Box &	theBox,
		const gp_Trsf &	theTrsf,
		const bool	theIsAccurate = false ) const

Extends the passed box with bounding box of this triangulation. Uses cached min - max range when available and:

input transformation theTrsf has no rotation part;
theIsAccurate is set to FALSE;

no triangulation data available (e.g. it is deferred and not loaded).

Parameters

theBox	[in] [out] bounding box to extend by this triangulation
theTrsf	[in] optional transformation
theIsAccurate	[in] when FALSE, allows using a cached min - max range of this triangulation even for non-identity transformation.

Returns: FALSE if there is no any data to extend the passed box (no both triangulation and cached min - max range).

◆ NbDeferredNodes()

virtual Standard_Integer Poly_Triangulation::NbDeferredNodes ( ) const

inlinevirtual

Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

Reimplemented in RWMesh_TriangulationSource.

◆ NbDeferredTriangles()

virtual Standard_Integer Poly_Triangulation::NbDeferredTriangles ( ) const

inlinevirtual

Returns number of deferred triangles that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

Reimplemented in RWMesh_TriangulationSource.

◆ NbNodes()

Standard_Integer Poly_Triangulation::NbNodes ( ) const

inline

Returns the number of nodes for this triangulation.

◆ NbTriangles()

Standard_Integer Poly_Triangulation::NbTriangles ( ) const

inline

Returns the number of triangles for this triangulation.

◆ Node()

gp_Pnt Poly_Triangulation::Node ( Standard_Integer theIndex ) const

inline

Returns a node at the given index.

Parameters

[in] theIndex node index within [1, NbNodes()] range

Returns: 3D point coordinates

◆ Normal() [1/2]

gp_Dir Poly_Triangulation::Normal ( Standard_Integer theIndex ) const

inline

Returns normal at the given index.

Parameters

[in] theIndex node index within [1, NbNodes()] range

Returns: normalized 3D vector defining a surface normal

◆ Normal() [2/2]

void Poly_Triangulation::Normal	(	Standard_Integer	theIndex,
		gp_Vec3f &	theVec3 ) const

inline

Returns normal at the given index.

Parameters

[in]	theIndex	node index within [1, NbNodes()] range
[out]	theVec3	3D vector defining a surface normal

◆ Parameters() [1/2]

const Handle< Poly_TriangulationParameters > & Poly_Triangulation::Parameters ( ) const

inline

Returns initial set of parameters used to generate this triangulation.

◆ Parameters() [2/2]

void Poly_Triangulation::Parameters ( const Handle< Poly_TriangulationParameters > & theParams )

inline

Updates initial set of parameters used to generate this triangulation.

◆ RemoveNormals()

void Poly_Triangulation::RemoveNormals ( )

Deallocates the normals array.

◆ RemoveUVNodes()

void Poly_Triangulation::RemoveUVNodes ( )

Deallocates the UV nodes array.

◆ ResizeNodes()

void Poly_Triangulation::ResizeNodes	(	Standard_Integer	theNbNodes,
		Standard_Boolean	theToCopyOld )

Method resizing internal arrays of nodes (synchronously for all attributes).

Parameters

theNbNodes	[in] new number of nodes
theToCopyOld	[in] copy old nodes into the new array

◆ ResizeTriangles()

void Poly_Triangulation::ResizeTriangles	(	Standard_Integer	theNbTriangles,
		Standard_Boolean	theToCopyOld )

Method resizing an internal array of triangles.

Parameters

theNbTriangles	[in] new number of triangles
theToCopyOld	[in] copy old triangles into the new array

◆ SetCachedMinMax()

void Poly_Triangulation::SetCachedMinMax ( const Bnd_Box & theBox )

Sets a cached min - max range of this triangulation. The bounding box should exactly match actual range of triangulation data without a gap or transformation, or otherwise undefined behavior will be observed. Passing a VOID range invalidates the cache.

◆ SetDoublePrecision()

void Poly_Triangulation::SetDoublePrecision ( bool theIsDouble )

Set if node positions should be defined with double or single precision for 3D and UV nodes. Raises exception if data was already allocated.

◆ SetMeshPurpose()

void Poly_Triangulation::SetMeshPurpose ( const Poly_MeshPurpose thePurpose )

inline

Sets mesh purpose bits.

◆ SetNode()

void Poly_Triangulation::SetNode	(	Standard_Integer	theIndex,
		const gp_Pnt &	thePnt )

inline

Sets a node coordinates.

Parameters

[in]	theIndex	node index within [1, NbNodes()] range
[in]	thePnt	3D point coordinates

◆ SetNormal() [1/2]

void Poly_Triangulation::SetNormal	(	const Standard_Integer	theIndex,
		const gp_Dir &	theNormal )

inline

Changes normal at the given index.

Parameters

[in]	theIndex	node index within [1, NbNodes()] range
[in]	theNormal	normalized 3D vector defining a surface normal

◆ SetNormal() [2/2]

void Poly_Triangulation::SetNormal	(	const Standard_Integer	theIndex,
		const gp_Vec3f &	theNormal )

inline

Changes normal at the given index.

Parameters

[in]	theIndex	node index within [1, NbNodes()] range
[in]	theVec3	normalized 3D vector defining a surface normal

◆ SetNormals()

void Poly_Triangulation::SetNormals ( const Handle< TShort_HArray1OfShortReal > & theNormals )

Deprecated: ("Deprecated method, SetNormal() should be used instead")

◆ SetTriangle()

void Poly_Triangulation::SetTriangle	(	Standard_Integer	theIndex,
		const Poly_Triangle &	theTriangle )

inline

Sets a triangle.

Parameters

[in]	theIndex	triangle index within [1, NbTriangles()] range
[in]	theTriangle	triangle node indices, with each node defined within [1, NbNodes()] range

◆ SetUVNode()

void Poly_Triangulation::SetUVNode	(	Standard_Integer	theIndex,
		const gp_Pnt2d &	thePnt )

inline

Sets an UV-node coordinates.

Parameters

[in]	theIndex	node index within [1, NbNodes()] range
[in]	thePnt	UV coordinates

◆ Triangle()

const Poly_Triangle & Poly_Triangulation::Triangle ( Standard_Integer theIndex ) const

inline

Returns triangle at the given index.

Parameters

[in] theIndex triangle index within [1, NbTriangles()] range

Returns: triangle node indices, with each node defined within [1, NbNodes()] range

◆ Triangles()

const Poly_Array1OfTriangle & Poly_Triangulation::Triangles ( ) const

inline

Deprecated: ("Deprecated method, Triangle() should be used instead")

◆ UnloadDeferredData()

virtual Standard_Boolean Poly_Triangulation::UnloadDeferredData ( )

virtual

Releases triangulation data if it has connected deferred storage.

◆ unsetCachedMinMax()

void Poly_Triangulation::unsetCachedMinMax ( )

protected

Clears cached min - max range saved previously.

◆ UpdateCachedMinMax()

void Poly_Triangulation::UpdateCachedMinMax ( )

inline

Updates cached min - max range of this triangulation with bounding box of nodal data.

◆ UVNode()

gp_Pnt2d Poly_Triangulation::UVNode ( Standard_Integer theIndex ) const

inline

Returns UV-node at the given index.

Parameters

[in] theIndex node index within [1, NbNodes()] range

Returns: 2D point defining UV coordinates

Field Documentation

◆ myCachedMinMax

Bnd_Box* Poly_Triangulation::myCachedMinMax

protected

Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

◆ myDeflection

Standard_Real Poly_Triangulation::myDeflection

protected

Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

◆ myNodes

Poly_ArrayOfNodes Poly_Triangulation::myNodes

protected

Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

◆ myNormals

NCollection_Array1<gp_Vec3f> Poly_Triangulation::myNormals

protected

Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

◆ myParams

Handle< Poly_TriangulationParameters > Poly_Triangulation::myParams

protected

Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

◆ myPurpose

Poly_MeshPurpose Poly_Triangulation::myPurpose

protected

Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

◆ myTriangles

Poly_Array1OfTriangle Poly_Triangulation::myTriangles

protected

Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

◆ myUVNodes

Poly_ArrayOfUVNodes Poly_Triangulation::myUVNodes

protected

Returns number of deferred nodes that can be loaded using LoadDeferredData(). Note: this is estimated values, which might be different from actually loaded values. Always check triangulation size of actually loaded data in code to avoid out-of-range issues.

The documentation for this class was generated from the following file:

Poly_Triangulation.hxx

Public Member Functions

late-load deferred data interface

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Poly_Triangulation() [1/5]

◆ Poly_Triangulation() [2/5]

◆ Poly_Triangulation() [3/5]

◆ Poly_Triangulation() [4/5]

◆ ~Poly_Triangulation()

◆ Poly_Triangulation() [5/5]

Member Function Documentation

◆ AddNormals()

◆ AddUVNodes()

◆ CachedMinMax()

◆ ChangeTriangle()

◆ ChangeTriangles()

◆ Clear()

◆ computeBoundingBox()

◆ ComputeNormals()

◆ Copy()

◆ createNewEntity()

◆ Deflection() [1/2]

◆ Deflection() [2/2]

◆ DetachedLoadDeferredData()

◆ DumpJson()

◆ HasCachedMinMax()

◆ HasDeferredData()

◆ HasGeometry()

◆ HasNormals()

◆ HasUVNodes()

◆ InternalNodes()

◆ InternalNormals()

◆ InternalTriangles()

◆ InternalUVNodes()

◆ IsDoublePrecision()

◆ LoadDeferredData()

◆ loadDeferredData()

◆ MapNodeArray()

◆ MapNormalArray()

◆ MapTriangleArray()

◆ MapUVNodeArray()

◆ MeshPurpose()

◆ MinMax()

◆ NbDeferredNodes()

◆ NbDeferredTriangles()

◆ NbNodes()

◆ NbTriangles()

◆ Node()

◆ Normal() [1/2]

◆ Normal() [2/2]

◆ Parameters() [1/2]

◆ Parameters() [2/2]

◆ RemoveNormals()

◆ RemoveUVNodes()

◆ ResizeNodes()

◆ ResizeTriangles()

◆ SetCachedMinMax()

◆ SetDoublePrecision()

◆ SetMeshPurpose()

◆ SetNode()

◆ SetNormal() [1/2]

◆ SetNormal() [2/2]

◆ SetNormals()

◆ SetTriangle()

◆ SetUVNode()

◆ Triangle()

◆ Triangles()

◆ UnloadDeferredData()

◆ unsetCachedMinMax()

◆ UpdateCachedMinMax()

◆ UVNode()

Field Documentation

◆ myCachedMinMax

◆ myDeflection

◆ myNodes

◆ myNormals

◆ myParams

◆ myPurpose

◆ myTriangles