com.openinventor.inventor.misc

Class SbExtrusionGenerator

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SbExtrusionGenerator

public class SbExtrusionGenerator
extends Inventor

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.

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
static SoShape	createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam, SbMatrix localToCam) Calls createFrom2DPoints(pointsInCam, localToCam, new com.openinventor.inventor.SbBox3f()).
static SoShape	createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam, SbMatrix camToLocal, float zMin) Calls createFrom2DPoints(pointsInCam, camToLocal, zMin, (float)1.0f).
static SoShape	createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam, SbMatrix camToLocal, float zMin, float zMax) Create an extruded shape from points in camera space.
static SoShape	createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam, SbMatrix localToCam, SbBox3f bboxInLocal) Create an extruded shape from points in camera space.
static SoShape	createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam, SoPath nodePath, SbViewVolume volume) Calls createFrom2DPoints(pointsInCam, nodePath, volume, new com.openinventor.inventor.SbBox3f()).
static SoShape	createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam, SoPath nodePath, SbViewVolume volume, SbBox3f bboxInLocal) Create an extruded shape from points in camera space.
static SoShape	createFrom3DPoints(java.util.Collection<SbVec3f> pointsInWorld, SoPath nodePath, SbViewVolume volume) Calls createFrom3DPoints(pointsInWorld, nodePath, volume, new com.openinventor.inventor.SbBox3f()).
static SoShape	createFrom3DPoints(java.util.Collection<SbVec3f> pointsInWorld, SoPath nodePath, SbViewVolume volume, SbBox3f bboxInLocal) Create an extruded shape from points in world space.

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createFrom2DPoints

public static SoShape createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam,
                                         SbMatrix localToCam)

Calls createFrom2DPoints(pointsInCam, localToCam, new com.openinventor.inventor.SbBox3f()).

createFrom2DPoints

public static SoShape createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam,
                                         SoPath nodePath,
                                         SbViewVolume volume)

Calls createFrom2DPoints(pointsInCam, nodePath, volume, new com.openinventor.inventor.SbBox3f()).

createFrom2DPoints

public static SoShape createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam,
                                         SbMatrix camToLocal,
                                         float zMin)

Calls createFrom2DPoints(pointsInCam, camToLocal, zMin, (float)1.0f).

createFrom3DPoints

public static SoShape createFrom3DPoints(java.util.Collection<SbVec3f> pointsInWorld,
                                         SoPath nodePath,
                                         SbViewVolume volume)

Calls createFrom3DPoints(pointsInWorld, nodePath, volume, new com.openinventor.inventor.SbBox3f()).

createFrom2DPoints

public static SoShape createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam,
                                         SbMatrix camToLocal,
                                         float zMin,
                                         float zMax)

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.

createFrom3DPoints

public static SoShape createFrom3DPoints(java.util.Collection<SbVec3f> pointsInWorld,
                                         SoPath nodePath,
                                         SbViewVolume volume,
                                         SbBox3f bboxInLocal)

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.

createFrom2DPoints

public static SoShape createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam,
                                         SoPath nodePath,
                                         SbViewVolume volume,
                                         SbBox3f bboxInLocal)

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.

createFrom2DPoints

public static SoShape createFrom2DPoints(java.util.Collection<SbVec2f> pointsInCam,
                                         SbMatrix localToCam,
                                         SbBox3f bboxInLocal)

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.