public class SoCircularExtrusion extends SoBaseExtrusion
SoCircularExtrusionnode is a geometric shape based on a constant
radiuscircle cross section extruded along a three-dimensional polyline (spine). The circle center lies on the spine and the circle lies on the plane normal to the spine at each point. This is similar to specifying an
SoExtrusionwith a circle cross-section, which is convenient for many applications, but this node has additional advantages because it responds to the
The application can specify the visible portion of the shape along the spine using normalized curvilinear coordinates (activeSection). By default the entire spine is visible.
SoCircularExtrusion representation is dependent on
SoComplexity.value. The shape is always simplified when the
SoComplexity value is less than 1. Both the cross section (number of segments used for the circle) and the spine (number of points used for the spine) are affected by the simplification. The simplification algorithm approximates the spine by taking into account its curvature. The cross section circle is approximated by at least 10 points. With a
SoComplexity value of 0 the extruded shape has the roughest representation.
Approximately the same geometry could be defined using an
SoExtrusion node, but that node does not currently respond the
SoComplexity value. Likewise the clipping behavior could be obtained using two
SoClipPlane nodes, but
SoCircularExtrusion uses less memory when the activeSection is a subset of the full spine. These two features make
SoCircularExtrusion valuable when a large number of cylindrical objects must be displayed.
scaleMode field (inherited from
SoBaseExtrusion) is used to select the points that will be scaled by the current transformation (for example
SoTransform), if any. Translation and rotation are applied in all cases. The options are:
SoExtrusionignores the scaling state. Not currently implemented.
The spine polyline segments must be C0 continous, that is, the spine must be connected at joints. The following segments may be C1 discontinous but be aware that very narrow angles between consecutive polyline semgments can produce odd results with SMOOTH
extrusionMode modes. This is especially noticeable when the angles between segments are very small with respect to the
radius. In the following images the consecutive points A, B, C in the spine show one of these cases. The problem is at point B whose cross sections are abnormally large.
|Modifier and Type||Class and Description|
|Modifier and Type||Field and Description|
Defines the visible section of the spine in normalized coordinates.
Radius of the circular cross-section.
Defines the spine simplification behavior of the extrusion.
BASIC, beginCap, endCap, extrusionMode, NONE, scaleMode, SECTION_ONLY, SMOOTH, SMOOTH_WITHOUT_SELF_INTERSECTIONS, spine, SPINE_ONLY
boundingBoxIgnoring, LINES, POINTS, POLYGONS, TEXT
|Constructor and Description|
getShapeType, isPrimitiveRestartAvailable, isPrimitiveRestartAvailable
affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults
dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable
getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads
@Deprecated public static final int DEFAULT
@Deprecated public static final int RESPECT_MATERIALS
public final SoSFFloat radius
public final SoSFVec2f activeSection
public final SoSFEnum<SoCircularExtrusion.SpineSimplificationModes> spineSimplificationMode
Generated on September 3, 2019, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com