A procedural box-shaped geometry.

The size, shape and tesselation properties of the box can be controlled via constructor options. By default, a box centered on the object space origin with a width, length and height of 1.0 unit and 1 segment in either axis (2 triangles per face).

Note that the box is created with UVs in the range of 0 to 1 on each face.

Hierarchy (View Summary)

Constructors

  • Create a new BoxGeometry instance.

    Parameters

    • Optionalopts: {
          calculateTangents?: boolean;
          halfExtents?: Vec3;
          heightSegments?: number;
          lengthSegments?: number;
          widthSegments?: number;
          yOffset?: number;
      } = {}

      An object that specifies optional inputs for the function as follows:

      • OptionalcalculateTangents?: boolean

        Generate tangent information (defaults to false).

      • OptionalhalfExtents?: Vec3

        The half dimensions of the box in each axis (defaults to [0.5, 0.5, 0.5]).

      • OptionalheightSegments?: number

        The number of divisions along the Y axis of the box (defaults to 1).

      • OptionallengthSegments?: number

        The number of divisions along the Z axis of the box (defaults to 1).

      • OptionalwidthSegments?: number

        The number of divisions along the X axis of the box (defaults to 1).

      • OptionalyOffset?: number

        Move the box vertically by given offset in local space. Pass 0.5 to generate the box with pivot point at the bottom face. Defaults to 0.

    Returns BoxGeometry

Properties

blendIndices: number[]

Blend indices.

blendWeights: number[]

Blend weights.

colors: number[]

Colors.

Methods