SbExtrusionGenerator Class Reference

Factory that generates an extruded mesh from a polyline. More...

#include <Inventor/misc/SbExtrusionGenerator.h>

Static Public Member Functions
static SoShape *	createFrom3DPoints (const std::vector< SbVec3f > &pointsInWorld, SoPath *nodePath, const SbViewVolume &volume, const SbBox3f &bboxInLocal=SbBox3f())
	Create an extruded shape from points in world space.
static SoShape *	createFrom2DPoints (const std::vector< SbVec2f > &pointsInCam, SoPath *nodePath, const SbViewVolume &volume, const SbBox3f &bboxInLocal=SbBox3f())
	Create an extruded shape from points in camera space.
static SoShape *	createFrom2DPoints (const std::vector< SbVec2f > &pointsInCam, const SbMatrix &localToCam, const SbBox3f &bboxInLocal=SbBox3f())
	Create an extruded shape from points in camera space.
static SoShape *	createFrom2DPoints (const std::vector< SbVec2f > &pointsInCam, const SbMatrix &camToLocal, float zMin=-1.0f, float zMax=1.0f)
	Create an extruded shape from points in camera space.

Detailed Description

Factory that generates an extruded mesh from a polyline.

This class generates an extruded shape from a simple or a complex polyline. The line is extruded between the 2 planes parallel that can be specified with a boundingBox or directly in camera space (see createFrom2DPoints() methods) The generated shape is closed and contains only triangles in CCW order.

LIMITATIONS

• Only vertices are handled in the generated shape, none of the normal, color or texCoord properties are taken into account.

NOTES

• In an orthographic view, the polyline is extruded along the view vector (normal to the camera plane), but in a perspective view the generated shape is a truncated cone with a larger base farther from the camera, due to the perspective transform.
• Local space refers to the space in which the shape will be expressed.

Definition at line 58 of file SbExtrusionGenerator.h.

Member Function Documentation

createFrom2DPoints() [1/3]

static SoShape * SbExtrusionGenerator::createFrom2DPoints ( const std::vector< SbVec2f > &  pointsInCam, const SbMatrix &  camToLocal, float  zMin = -1.0f, float  zMax = 1.0f  )

static

Create an extruded shape from points in camera space.

Parameters

pointsInCam	Polyline in normalized screen space ([-1, 1]x[-1, 1]).
camToLocal	Transform matrix from camera space to local space (modelViewProjInv matrix)
zMin	Min extrusion plane, in camera space. By default, it's the camera's near clip plane.
zMax	Max extrusion plane, in camera space. By default, it's the camera's far clip plane.

Warning

Return NULL if error occurred.

createFrom2DPoints() [2/3]

static SoShape * SbExtrusionGenerator::createFrom2DPoints ( const std::vector< SbVec2f > &  pointsInCam, const SbMatrix &  localToCam, const SbBox3f &  bboxInLocal = SbBox3f()  )

static

Create an extruded shape from points in camera space.

Parameters

pointsInCam	Polyline in normalized screen space ([-1, 1]x[-1, 1]).
localToCam	Transform matrix from local space to camera space (modelViewProj matrix)
bboxInLocal	Bounding box that specifies limits of extruded shape, expressed in local space. If not specified, the shape will be extruded between the camera near and far planes.

Warning

Return NULL if error occurred.

createFrom2DPoints() [3/3]

static SoShape * SbExtrusionGenerator::createFrom2DPoints ( const std::vector< SbVec2f > &  pointsInCam, SoPath *  nodePath, const SbViewVolume &  volume, const SbBox3f &  bboxInLocal = SbBox3f()  )

static

Create an extruded shape from points in camera space.

Parameters

pointsInCam	Polyline in normalized screen space ([-1, 1]x[-1, 1]).
nodePath	Path from root to the node space in which the generated shape will be expressed. Generally, the separator which will contain the shape. If NULL, the shape will be expressed in world space.
volume	View volume corresponding to the camera in which the points were taken.
bboxInLocal	Bounding box that specifies limits of extruded shape, expressed in local space. If not specified, the shape will be extruded between the camera near and far planes.

Warning

Return NULL if error occurred.

createFrom3DPoints()

static SoShape * SbExtrusionGenerator::createFrom3DPoints ( const std::vector< SbVec3f > &  pointsInWorld, SoPath *  nodePath, const SbViewVolume &  volume, const SbBox3f &  bboxInLocal = SbBox3f()  )

static

Create an extruded shape from points in world space.

Parameters

pointsInWorld	Polyline in world space.
nodePath	Path from root to the node space in which the generated shape will be expressed. Generally, the separator which will contain the shape. If NULL, the shape will be expressed in world space.
volume	View volume corresponding to the camera in which the points were taken.
bboxInLocal	Bounding box that specifies limits of extruded shape, expressed in local space. If not specified, the shape will be extruded between the camera near and far planes.

Warning

Return NULL if error occurred.

---

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

• Inventor/misc/SbExtrusionGenerator.h