Class SoProfile

  • All Implemented Interfaces:
    SafeDisposable
    Direct Known Subclasses:
    SoLinearProfile, SoNurbsProfile

    public abstract class SoProfile
    extends SoNode
    Abstract base class for all profile nodes. This node is the abstract base class for all profile nodes, which define 2D curves. A profile is not itself geometry, but is used to change or delimit the geometry of something else. For an SoText3 node, the profile determines the cross-section of the side of each text character. For an SoNurbsSurface node, the profile is used to specify trim curves for the surface.

    The current profile state can consist of one or more profiles, each of which can be made up of one or more instances of SoProfile subclass nodes. Each profile node specifies (in the index field) a set of indices that refer to the current set of profile coordinates, specified using either an SoProfileCoordinate2 or an SoProfileCoordinate3 node. No profile curve should intersect itself or another profile curve.

    Profiles are part of the state, just like all other properties. The state contains a current list of profiles. Depending on the linkage field, a profile can clear the list and begin a new profile, begin a new profile at the end of those already in the list, or append to the last profile in the current list. Note that when appending profile B to the end of profile A, B must begin at the same 2D point at which A ends.

    File format/default:

    This is an abstract class. See the reference page of a derived class for the format and default values.

    Action behavior:

    SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction, SoRayPickAction
    Adds profile to current traversal state. Sets: SoProfileElement

    See Also:
    SoLinearProfile, SoNurbsProfile, SoNurbsSurface, SoProfileCoordinate2, SoProfileCoordinate3, SoText3
    • Field Detail

      • index

        public final SoMFInt32 index
        Indices into profile coordinates.
      • linkage

        public final SoSFEnum<SoProfile.Profiles> linkage
        Specifies connectivity of profile curve with respect to profiles in current list in state. . Default is START_FIRST.