SbExtrusionGenerator Class Reference

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

#include <Inventor/misc/SbExtrusionGenerator.h>

List of all members.

Classes
class	TriangleCBData
	Struct given to pushTriangleCallback.
Static Public Member Functions
static SoShape *	createFrom3DPoints (const std::vector< SbVec3f > &pointsInWorld, SoPath *nodePath, const SbViewVolume &volume, const SbBox3f &bboxInLocal=SbBox3f())
static SoShape *	createFrom2DPoints (const std::vector< SbVec2f > &pointsInCam, SoPath *nodePath, const SbViewVolume &volume, const SbBox3f &bboxInLocal=SbBox3f())
static SoShape *	createFrom2DPoints (const std::vector< SbVec2f > &pointsInCam, const SbMatrix &localToCam, const SbBox3f &bboxInLocal=SbBox3f())
static SoShape *	createFrom2DPoints (const std::vector< SbVec2f > &pointsInCam, const SbMatrix &camToLocal, float zMin=-1.0f, float zMax=1.0f)

---

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.

See related examples:

CircularExtrusion, CSGClippingGroup, EditingExtrusion, Editing

---

Member Function Documentation

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.

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.

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.

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