StdPrs_ToolTriangulatedShape Class Reference

#include <StdPrs_ToolTriangulatedShape.hxx>

Inheritance diagram for StdPrs_ToolTriangulatedShape:

Static Public Member Functions
static Standard_Boolean	IsTriangulated (const TopoDS_Shape &theShape)
	Similar to BRepTools::Triangulation() but without extra checks.
static Standard_Boolean	IsClosed (const TopoDS_Shape &theShape)
	Checks back faces visibility for specified shape (to activate back-face culling). .
static Standard_Real	GetDeflection (const TopoDS_Shape &theShape, const Handle< Prs3d_Drawer > &theDrawer)
	Computes the absolute deflection value depending on the type of deflection in theDrawer:
static Standard_Boolean	IsTessellated (const TopoDS_Shape &theShape, const Handle< Prs3d_Drawer > &theDrawer)
	Checks whether the shape is properly triangulated for a given display settings.
static Standard_Boolean	Tessellate (const TopoDS_Shape &theShape, const Handle< Prs3d_Drawer > &theDrawer)
	Validates triangulation within the shape and performs tessellation if necessary.
static void	ClearOnOwnDeflectionChange (const TopoDS_Shape &theShape, const Handle< Prs3d_Drawer > &theDrawer, const Standard_Boolean theToResetCoeff)
	If presentation has own deviation coefficient and IsAutoTriangulation() is true, function will compare actual coefficients with previous values and will clear triangulation on their change (regardless actual tessellation quality). Function is placed here for compatibility reasons - new code should avoid using IsAutoTriangulation().
Static Public Member Functions inherited from BRepLib_ToolTriangulatedShape
static void	ComputeNormals (const TopoDS_Face &theFace, const Handle< Poly_Triangulation > &theTris)
	Computes nodal normals for Poly_Triangulation structure using UV coordinates and surface. Does nothing if triangulation already defines normals.
static void	ComputeNormals (const TopoDS_Face &theFace, const Handle< Poly_Triangulation > &theTris, Poly_Connect &thePolyConnect)
	Computes nodal normals for Poly_Triangulation structure using UV coordinates and surface. Does nothing if triangulation already defines normals.

Member Function Documentation

ClearOnOwnDeflectionChange()

void StdPrs_ToolTriangulatedShape::ClearOnOwnDeflectionChange ( const TopoDS_Shape & theShape, const Handle< Prs3d_Drawer > & theDrawer, const Standard_Boolean theToResetCoeff )

static

If presentation has own deviation coefficient and IsAutoTriangulation() is true, function will compare actual coefficients with previous values and will clear triangulation on their change (regardless actual tessellation quality). Function is placed here for compatibility reasons - new code should avoid using IsAutoTriangulation().

Parameters

[in]	theShape	the shape
[in]	theDrawer	the display settings
[in]	theToResetCoeff	updates coefficients in theDrawer to actual state to avoid redundant recomputations

GetDeflection()

Standard_Real StdPrs_ToolTriangulatedShape::GetDeflection ( const TopoDS_Shape & theShape, const Handle< Prs3d_Drawer > & theDrawer )

static

Computes the absolute deflection value depending on the type of deflection in theDrawer:

• Aspect_TOD_RELATIVE: the absolute deflection is computed using the relative deviation coefficient from theDrawer and the shape's bounding box;
• Aspect_TOD_ABSOLUTE: the maximal chordial deviation from theDrawer is returned.

In case of the type of deflection in theDrawer computed relative deflection for shape is stored as absolute deflection. It is necessary to use it later on for sub-shapes. This function should always be used to compute the deflection value for building discrete representations of the shape (triangulation, wireframe) to avoid inconsistencies between different representations of the shape and undesirable visual artifacts.

IsClosed()

Standard_Boolean StdPrs_ToolTriangulatedShape::IsClosed ( const TopoDS_Shape & theShape )

static

Checks back faces visibility for specified shape (to activate back-face culling).
.

Returns

true if shape is closed manifold Solid or compound of such Solids.

IsTessellated()

Standard_Boolean StdPrs_ToolTriangulatedShape::IsTessellated ( const TopoDS_Shape & theShape, const Handle< Prs3d_Drawer > & theDrawer )

static

Checks whether the shape is properly triangulated for a given display settings.

Parameters

[in]	theShape	the shape.
[in]	theDrawer	the display settings.

IsTriangulated()

Standard_Boolean StdPrs_ToolTriangulatedShape::IsTriangulated ( const TopoDS_Shape & theShape )

static

Similar to BRepTools::Triangulation() but without extra checks.

Returns

true if all faces within shape are triangulated.

Tessellate()

Standard_Boolean StdPrs_ToolTriangulatedShape::Tessellate ( const TopoDS_Shape & theShape, const Handle< Prs3d_Drawer > & theDrawer )

static

Validates triangulation within the shape and performs tessellation if necessary.

Parameters

[in]	theShape	the shape.
[in]	theDrawer	the display settings.

Returns

true if tessellation was recomputed and false otherwise.

---

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

• StdPrs_ToolTriangulatedShape.hxx