Class SoSphere

  • All Implemented Interfaces:
    SafeDisposable

    public class SoSphere
    extends SoShape
    Sphere shape node. This node represents a sphere. By default, the sphere is centered at the origin and has a radius of 1. The sphere is transformed by the current cumulative transformation and is drawn with the current lighting model, drawing style, material, and geometric complexity.

    A sphere does not have faces or parts. Therefore, the sphere ignores material and normal bindings, using the first material for the entire sphere and using its own normals. When a texture is applied to a sphere, the texture covers the entire surface, wrapping counterclockwise from the back of the sphere. The texture has a seam at the back on the yz-plane.

    Picking: There is no SoDetail class associated with this node.

    OpenGL vertex arrays are used if they are available and if the environment variable IV_NO_VERTEX_ARRAY is not set.

    Consider using the SoAlgebraicSphere node instead of this one. Algebraic shapes are computed and rendered on the GPU and can be used with SoMultipleInstance.

    File format/default:

    Sphere {

      radius 1
    }

    Action behavior:

    SoGLRenderAction
    Draws sphere based on the current coordinates, materials, drawing style, and so on.

    SoRayPickAction
    Intersects the ray with the sphere. No details are created for intersections.

    SoGetBoundingBoxAction
    Computes the bounding box that encloses the sphere.

    SoCallbackAction
    If any triangle callbacks are registered with the action, they will be invoked for each successive triangle that approximates the sphere.

    See Also:
    SoAlgebraicSphere, SoCone, SoCube, SoCylinder, SoFullSceneAntialiasing
    • Field Detail

      • radius

        public final SoSFFloat radius
        Radius of sphere. This must be greater than 0.
    • Constructor Detail

      • SoSphere

        public SoSphere()
        Creates a sphere node with default settings.