MeshPartBuilder (libGDX Core 1.9.10 API)

All Known Implementing Classes:

MeshBuilder
```
public interface MeshPartBuilder
```

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static class MeshPartBuilder.VertexInfo
Class that contains all vertex information the builder can use.

Nested Classes
Modifier and Type	Interface and Description
`static class`	`MeshPartBuilder.VertexInfo` Class that contains all vertex information the builder can use.

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addMesh(float[] vertices, short[] indices)` Copies a mesh to the mesh (part) currently being build.
`void`	`addMesh(float[] vertices, short[] indices, int indexOffset, int numIndices)` Copies a (part of a) mesh to the mesh (part) currently being build.
`void`	`addMesh(Mesh mesh)` Copies a mesh to the mesh (part) currently being build.
`void`	`addMesh(Mesh mesh, int indexOffset, int numIndices)` Copies a (part of a) mesh to the mesh (part) currently being build.
`void`	`addMesh(MeshPart meshpart)` Copies a MeshPart to the mesh (part) currently being build.
`void`	`arrow(float x1, float y1, float z1, float x2, float y2, float z2, float capLength, float stemThickness, int divisions)` Deprecated. Use ArrowShapeBuilder.build instead.
`void`	`box(float width, float height, float depth)` Deprecated. use BoxShapeBuilder.build instead.
`void`	`box(float x, float y, float z, float width, float height, float depth)` Deprecated. use BoxShapeBuilder.build instead.
`void`	`box(Matrix4 transform)` Deprecated. use BoxShapeBuilder.build instead.
`void`	`box(MeshPartBuilder.VertexInfo corner000, MeshPartBuilder.VertexInfo corner010, MeshPartBuilder.VertexInfo corner100, MeshPartBuilder.VertexInfo corner110, MeshPartBuilder.VertexInfo corner001, MeshPartBuilder.VertexInfo corner011, MeshPartBuilder.VertexInfo corner101, MeshPartBuilder.VertexInfo corner111)` Deprecated. use BoxShapeBuilder.build instead.
`void`	`box(Vector3 corner000, Vector3 corner010, Vector3 corner100, Vector3 corner110, Vector3 corner001, Vector3 corner011, Vector3 corner101, Vector3 corner111)` Deprecated. use BoxShapeBuilder.build instead.
`void`	`capsule(float radius, float height, int divisions)` Deprecated. Use CapsuleShapeBuilder.build instead.
`void`	`circle(float radius, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`circle(float radius, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ, float angleFrom, float angleTo)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`circle(float radius, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ, float tangentX, float tangentY, float tangentZ, float binormalX, float binormalY, float binormalZ)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`circle(float radius, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ, float tangentX, float tangentY, float tangentZ, float binormalX, float binormalY, float binormalZ, float angleFrom, float angleTo)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`circle(float radius, int divisions, Vector3 center, Vector3 normal)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`circle(float radius, int divisions, Vector3 center, Vector3 normal, float angleFrom, float angleTo)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`circle(float radius, int divisions, Vector3 center, Vector3 normal, Vector3 tangent, Vector3 binormal)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`circle(float radius, int divisions, Vector3 center, Vector3 normal, Vector3 tangent, Vector3 binormal, float angleFrom, float angleTo)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`cone(float width, float height, float depth, int divisions)` Deprecated. Use ConeShapeBuilder.build instead.
`void`	`cone(float width, float height, float depth, int divisions, float angleFrom, float angleTo)` Deprecated. Use ConeShapeBuilder.build instead.
`void`	`cylinder(float width, float height, float depth, int divisions)` Deprecated. Use CylinderShapeBuilder.build instead.
`void`	`cylinder(float width, float height, float depth, int divisions, float angleFrom, float angleTo)` Deprecated. Use CylinderShapeBuilder.build instead.
`void`	`cylinder(float width, float height, float depth, int divisions, float angleFrom, float angleTo, boolean close)` Deprecated. Use CylinderShapeBuilder.build instead.
`void`	`ellipse(float width, float height, float innerWidth, float innerHeight, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, float innerWidth, float innerHeight, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ, float angleFrom, float angleTo)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, float innerWidth, float innerHeight, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ, float tangentX, float tangentY, float tangentZ, float binormalX, float binormalY, float binormalZ, float angleFrom, float angleTo)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, float innerWidth, float innerHeight, int divisions, Vector3 center, Vector3 normal)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ, float angleFrom, float angleTo)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ, float tangentX, float tangentY, float tangentZ, float binormalX, float binormalY, float binormalZ)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, int divisions, float centerX, float centerY, float centerZ, float normalX, float normalY, float normalZ, float tangentX, float tangentY, float tangentZ, float binormalX, float binormalY, float binormalZ, float angleFrom, float angleTo)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, int divisions, Vector3 center, Vector3 normal)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, int divisions, Vector3 center, Vector3 normal, float angleFrom, float angleTo)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, int divisions, Vector3 center, Vector3 normal, Vector3 tangent, Vector3 binormal)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ellipse(float width, float height, int divisions, Vector3 center, Vector3 normal, Vector3 tangent, Vector3 binormal, float angleFrom, float angleTo)` Deprecated. Use EllipseShapeBuilder.build instead.
`void`	`ensureCapacity(int numVertices, int numIndices)` Increases the size of the backing vertices and indices arrays to accommodate the specified number of additional vertices and indices.
`void`	`ensureIndices(int numIndices)` Increases the size of the backing indices array to accommodate the specified number of additional indices.
`void`	`ensureRectangleIndices(int numRectangles)` Increases the size of the backing indices array to accommodate the specified number of additional rectangles.
`void`	`ensureTriangleIndices(int numTriangles)` Increases the size of the backing indices array to accommodate the specified number of additional triangles.
`void`	`ensureVertices(int numVertices)` Increases the size of the backing vertices array to accommodate the specified number of additional vertices.
`VertexAttributes`	`getAttributes()`
`MeshPart`	`getMeshPart()`
`int`	`getPrimitiveType()`
`Matrix4`	`getVertexTransform(Matrix4 out)` Get the current vertex transformation matrix.
`void`	`index(short value)` Add an index, MeshPartBuilder expects all meshes to be indexed.
`void`	`index(short value1, short value2)` Add multiple indices, MeshPartBuilder expects all meshes to be indexed.
`void`	`index(short value1, short value2, short value3)` Add multiple indices, MeshPartBuilder expects all meshes to be indexed.
`void`	`index(short value1, short value2, short value3, short value4)` Add multiple indices, MeshPartBuilder expects all meshes to be indexed.
`void`	`index(short value1, short value2, short value3, short value4, short value5, short value6)` Add multiple indices, MeshPartBuilder expects all meshes to be indexed.
`void`	`index(short value1, short value2, short value3, short value4, short value5, short value6, short value7, short value8)` Add multiple indices, MeshPartBuilder expects all meshes to be indexed.
`boolean`	`isVertexTransformationEnabled()` Indicates whether vertex transformation is enabled.
`short`	`lastIndex()`
`void`	`line(float x1, float y1, float z1, float x2, float y2, float z2)` Add a line.
`void`	`line(MeshPartBuilder.VertexInfo p1, MeshPartBuilder.VertexInfo p2)` Add a line.
`void`	`line(short index1, short index2)` Add a line by indices.
`void`	`line(Vector3 p1, Color c1, Vector3 p2, Color c2)` Add a line.
`void`	`line(Vector3 p1, Vector3 p2)` Add a line.
`void`	`patch(float x00, float y00, float z00, float x10, float y10, float z10, float x11, float y11, float z11, float x01, float y01, float z01, float normalX, float normalY, float normalZ, int divisionsU, int divisionsV)` Deprecated. use PatchShapeBuilder.build instead.
`void`	`patch(MeshPartBuilder.VertexInfo corner00, MeshPartBuilder.VertexInfo corner10, MeshPartBuilder.VertexInfo corner11, MeshPartBuilder.VertexInfo corner01, int divisionsU, int divisionsV)` Deprecated. use PatchShapeBuilder.build instead.
`void`	`patch(Vector3 corner00, Vector3 corner10, Vector3 corner11, Vector3 corner01, Vector3 normal, int divisionsU, int divisionsV)` Deprecated. use PatchShapeBuilder.build instead.
`void`	`rect(float x00, float y00, float z00, float x10, float y10, float z10, float x11, float y11, float z11, float x01, float y01, float z01, float normalX, float normalY, float normalZ)` Add a rectangle Requires GL_POINTS, GL_LINES or GL_TRIANGLES primitive type.
`void`	`rect(MeshPartBuilder.VertexInfo corner00, MeshPartBuilder.VertexInfo corner10, MeshPartBuilder.VertexInfo corner11, MeshPartBuilder.VertexInfo corner01)` Add a rectangle.
`void`	`rect(short corner00, short corner10, short corner11, short corner01)` Add a rectangle by indices.
`void`	`rect(Vector3 corner00, Vector3 corner10, Vector3 corner11, Vector3 corner01, Vector3 normal)` Add a rectangle.
`void`	`setColor(Color color)` Set the color used to tint the vertex color, defaults to white.
`void`	`setColor(float r, float g, float b, float a)` Set the color used to tint the vertex color, defaults to white.
`void`	`setUVRange(float u1, float v1, float u2, float v2)` Set range of texture coordinates used (default is 0,0,1,1).
`void`	`setUVRange(TextureRegion r)` Set range of texture coordinates from the specified TextureRegion.
`void`	`setVertexTransform(Matrix4 transform)` Set the current vertex transformation matrix and enables vertex transformation.
`void`	`setVertexTransformationEnabled(boolean enabled)` Sets whether vertex transformation is enabled.
`void`	`sphere(float width, float height, float depth, int divisionsU, int divisionsV)` Deprecated. Use SphereShapeBuilder.build instead.
`void`	`sphere(float width, float height, float depth, int divisionsU, int divisionsV, float angleUFrom, float angleUTo, float angleVFrom, float angleVTo)` Deprecated. Use SphereShapeBuilder.build instead.
`void`	`sphere(Matrix4 transform, float width, float height, float depth, int divisionsU, int divisionsV)` Deprecated. Use SphereShapeBuilder.build instead.
`void`	`sphere(Matrix4 transform, float width, float height, float depth, int divisionsU, int divisionsV, float angleUFrom, float angleUTo, float angleVFrom, float angleVTo)` Deprecated. Use SphereShapeBuilder.build instead.
`void`	`triangle(MeshPartBuilder.VertexInfo p1, MeshPartBuilder.VertexInfo p2, MeshPartBuilder.VertexInfo p3)` Add a triangle.
`void`	`triangle(short index1, short index2, short index3)` Add a triangle by indices.
`void`	`triangle(Vector3 p1, Color c1, Vector3 p2, Color c2, Vector3 p3, Color c3)` Add a triangle.
`void`	`triangle(Vector3 p1, Vector3 p2, Vector3 p3)` Add a triangle.
`short`	`vertex(float... values)` Add one or more vertices, returns the index of the last vertex added.
`short`	`vertex(MeshPartBuilder.VertexInfo info)` Add a vertex, returns the index.
`short`	`vertex(Vector3 pos, Vector3 nor, Color col, Vector2 uv)` Add a vertex, returns the index.

Method Detail

getMeshPart
```
MeshPart getMeshPart()
```
Returns:

The MeshPart currently building.

getPrimitiveType
```
int getPrimitiveType()
```
Returns:

The primitive type used for building, e.g. GL20.GL_TRIANGLES or GL20.GL_LINES.

getAttributes
```
VertexAttributes getAttributes()
```
Returns:

The VertexAttributes available for building.

setColor
```
void setColor(Color color)
```
Set the color used to tint the vertex color, defaults to white. Only applicable for VertexAttributes.Usage.ColorPacked or VertexAttributes.Usage.ColorUnpacked.

setColor
```
void setColor(float r,
              float g,
              float b,
              float a)
```
Set the color used to tint the vertex color, defaults to white. Only applicable for VertexAttributes.Usage.ColorPacked or VertexAttributes.Usage.ColorUnpacked.

setUVRange

void setUVRange(float u1,
                float v1,
                float u2,
                float v2)

Set range of texture coordinates used (default is 0,0,1,1).

setUVRange
```
void setUVRange(TextureRegion r)
```
Set range of texture coordinates from the specified TextureRegion.

getVertexTransform
```
Matrix4 getVertexTransform(Matrix4 out)
```
Get the current vertex transformation matrix.

setVertexTransform
```
void setVertexTransform(Matrix4 transform)
```
Set the current vertex transformation matrix and enables vertex transformation.

isVertexTransformationEnabled
```
boolean isVertexTransformationEnabled()
```
Indicates whether vertex transformation is enabled.

setVertexTransformationEnabled
```
void setVertexTransformationEnabled(boolean enabled)
```
Sets whether vertex transformation is enabled.

ensureVertices
```
void ensureVertices(int numVertices)
```
Increases the size of the backing vertices array to accommodate the specified number of additional vertices. Useful before adding many vertices to avoid multiple backing array resizes.

Parameters:

numVertices - The number of vertices you are about to add

ensureIndices
```
void ensureIndices(int numIndices)
```
Increases the size of the backing indices array to accommodate the specified number of additional indices. Useful before adding many indices to avoid multiple backing array resizes.

Parameters:

numIndices - The number of indices you are about to add

ensureCapacity
```
void ensureCapacity(int numVertices,
                    int numIndices)
```
Increases the size of the backing vertices and indices arrays to accommodate the specified number of additional vertices and indices. Useful before adding many vertices and indices to avoid multiple backing array resizes.

Parameters:

numVertices - The number of vertices you are about to add

numIndices - The number of indices you are about to add

ensureTriangleIndices
```
void ensureTriangleIndices(int numTriangles)
```
Increases the size of the backing indices array to accommodate the specified number of additional triangles. Useful before adding many triangles using triangle(short, short, short) to avoid multiple backing array resizes. The actual number of indices accounted for depends on the primitive type (see getPrimitiveType()).

Parameters:

numTriangles - The number of triangles you are about to add

ensureRectangleIndices
```
void ensureRectangleIndices(int numRectangles)
```
Increases the size of the backing indices array to accommodate the specified number of additional rectangles. Useful before adding many rectangles using rect(short, short, short, short) to avoid multiple backing array resizes.

Parameters:

numRectangles - The number of rectangles you are about to add

vertex
```
short vertex(float... values)
```
Add one or more vertices, returns the index of the last vertex added. The length of values must a power of the vertex size.

vertex

short vertex(Vector3 pos,
             Vector3 nor,
             Color col,
             Vector2 uv)

Add a vertex, returns the index. Null values are allowed. Use getAttributes() to check which values are available.

vertex
```
short vertex(MeshPartBuilder.VertexInfo info)
```
Add a vertex, returns the index. Use getAttributes() to check which values are available.

lastIndex
```
short lastIndex()
```
Returns:

The index of the last added vertex.

index
```
void index(short value)
```
Add an index, MeshPartBuilder expects all meshes to be indexed.

index
```
void index(short value1,
           short value2)
```
Add multiple indices, MeshPartBuilder expects all meshes to be indexed.

index

void index(short value1,
           short value2,
           short value3)

Add multiple indices, MeshPartBuilder expects all meshes to be indexed.

index

void index(short value1,
           short value2,
           short value3,
           short value4)

Add multiple indices, MeshPartBuilder expects all meshes to be indexed.

index

void index(short value1,
           short value2,
           short value3,
           short value4,
           short value5,
           short value6)

Add multiple indices, MeshPartBuilder expects all meshes to be indexed.

index

void index(short value1,
           short value2,
           short value3,
           short value4,
           short value5,
           short value6,
           short value7,
           short value8)

Add multiple indices, MeshPartBuilder expects all meshes to be indexed.

line
```
void line(short index1,
          short index2)
```
Add a line by indices. Requires GL_LINES primitive type.

line

void line(MeshPartBuilder.VertexInfo p1,
          MeshPartBuilder.VertexInfo p2)

Add a line. Requires GL_LINES primitive type.

line

void line(Vector3 p1,
          Vector3 p2)

Add a line. Requires GL_LINES primitive type.

line

void line(float x1,
          float y1,
          float z1,
          float x2,
          float y2,
          float z2)

Add a line. Requires GL_LINES primitive type.

line

void line(Vector3 p1,
          Color c1,
          Vector3 p2,
          Color c2)

Add a line. Requires GL_LINES primitive type.

triangle
```
void triangle(short index1,
              short index2,
              short index3)
```
Add a triangle by indices. Requires GL_POINTS, GL_LINES or GL_TRIANGLES primitive type.

triangle

void triangle(MeshPartBuilder.VertexInfo p1,
              MeshPartBuilder.VertexInfo p2,
              MeshPartBuilder.VertexInfo p3)

Add a triangle. Requires GL_POINTS, GL_LINES or GL_TRIANGLES primitive type.

triangle

void triangle(Vector3 p1,
              Vector3 p2,
              Vector3 p3)

Add a triangle. Requires GL_POINTS, GL_LINES or GL_TRIANGLES primitive type.

triangle

void triangle(Vector3 p1,
              Color c1,
              Vector3 p2,
              Color c2,
              Vector3 p3,
              Color c3)

Add a triangle. Requires GL_POINTS, GL_LINES or GL_TRIANGLES primitive type.

rect

void rect(short corner00,
          short corner10,
          short corner11,
          short corner01)

Add a rectangle by indices. Requires GL_POINTS, GL_LINES or GL_TRIANGLES primitive type.

rect

void rect(MeshPartBuilder.VertexInfo corner00,
          MeshPartBuilder.VertexInfo corner10,
          MeshPartBuilder.VertexInfo corner11,
          MeshPartBuilder.VertexInfo corner01)

Add a rectangle. Requires GL_POINTS, GL_LINES or GL_TRIANGLES primitive type.

rect

void rect(Vector3 corner00,
          Vector3 corner10,
          Vector3 corner11,
          Vector3 corner01,
          Vector3 normal)

Add a rectangle. Requires GL_POINTS, GL_LINES or GL_TRIANGLES primitive type.

rect

void rect(float x00,
          float y00,
          float z00,
          float x10,
          float y10,
          float z10,
          float x11,
          float y11,
          float z11,
          float x01,
          float y01,
          float z01,
          float normalX,
          float normalY,
          float normalZ)

Add a rectangle Requires GL_POINTS, GL_LINES or GL_TRIANGLES primitive type.

addMesh
```
void addMesh(Mesh mesh)
```
Copies a mesh to the mesh (part) currently being build.

Parameters:

mesh - The mesh to copy, must have the same vertex attributes and must be indexed.

addMesh
```
void addMesh(MeshPart meshpart)
```
Copies a MeshPart to the mesh (part) currently being build.

Parameters:

meshpart - The MeshPart to copy, must have the same vertex attributes, primitive type and must be indexed.

addMesh
```
void addMesh(Mesh mesh,
             int indexOffset,
             int numIndices)
```
Copies a (part of a) mesh to the mesh (part) currently being build.

Parameters:

mesh - The mesh to (partly) copy, must have the same vertex attributes and must be indexed.

indexOffset - The zero-based offset of the first index of the part of the mesh to copy.

numIndices - The number of indices of the part of the mesh to copy.

addMesh
```
void addMesh(float[] vertices,
             short[] indices)
```
Copies a mesh to the mesh (part) currently being build. The entire vertices array is added, even if some of the vertices are not indexed by the indices array. If you want to add only the vertices that are actually indexed, then use the addMesh(float[], short[], int, int) method instead.

Parameters:

vertices - The vertices to copy, must be in the same vertex layout as the mesh being build.

indices - Array containing the indices to copy, each index should be valid in the vertices array.

addMesh
```
void addMesh(float[] vertices,
             short[] indices,
             int indexOffset,
             int numIndices)
```
Copies a (part of a) mesh to the mesh (part) currently being build.

Parameters:

vertices - The vertices to (partly) copy, must be in the same vertex layout as the mesh being build.

indices - Array containing the indices to (partly) copy, each index should be valid in the vertices array.

indexOffset - The zero-based offset of the first index of the part of indices array to copy.

numIndices - The number of indices of the part of the indices array to copy.

patch

@Deprecated
void patch(MeshPartBuilder.VertexInfo corner00,
                        MeshPartBuilder.VertexInfo corner10,
                        MeshPartBuilder.VertexInfo corner11,
                        MeshPartBuilder.VertexInfo corner01,
                        int divisionsU,
                        int divisionsV)

Deprecated. use PatchShapeBuilder.build instead.

patch

@Deprecated
void patch(Vector3 corner00,
                        Vector3 corner10,
                        Vector3 corner11,
                        Vector3 corner01,
                        Vector3 normal,
                        int divisionsU,
                        int divisionsV)

Deprecated. use PatchShapeBuilder.build instead.

patch

@Deprecated
void patch(float x00,
                        float y00,
                        float z00,
                        float x10,
                        float y10,
                        float z10,
                        float x11,
                        float y11,
                        float z11,
                        float x01,
                        float y01,
                        float z01,
                        float normalX,
                        float normalY,
                        float normalZ,
                        int divisionsU,
                        int divisionsV)

Deprecated. use PatchShapeBuilder.build instead.

box

@Deprecated
void box(MeshPartBuilder.VertexInfo corner000,
                      MeshPartBuilder.VertexInfo corner010,
                      MeshPartBuilder.VertexInfo corner100,
                      MeshPartBuilder.VertexInfo corner110,
                      MeshPartBuilder.VertexInfo corner001,
                      MeshPartBuilder.VertexInfo corner011,
                      MeshPartBuilder.VertexInfo corner101,
                      MeshPartBuilder.VertexInfo corner111)

Deprecated. use BoxShapeBuilder.build instead.

box

@Deprecated
void box(Vector3 corner000,
                      Vector3 corner010,
                      Vector3 corner100,
                      Vector3 corner110,
                      Vector3 corner001,
                      Vector3 corner011,
                      Vector3 corner101,
                      Vector3 corner111)

Deprecated. use BoxShapeBuilder.build instead.

box
```
@Deprecated
void box(Matrix4 transform)
```
Deprecated. use BoxShapeBuilder.build instead.

box

@Deprecated
void box(float width,
                      float height,
                      float depth)

Deprecated. use BoxShapeBuilder.build instead.

box

@Deprecated
void box(float x,
                      float y,
                      float z,
                      float width,
                      float height,
                      float depth)

Deprecated. use BoxShapeBuilder.build instead.