MeshBuilder

public class MeshBuilder

extension MeshBuilder: NativeBase

extension MeshBuilder: Hashable

Builder for meshes. Such meshes can contain different kinds of primitives, like quads or triangles. Both primitives support adding texture coordinates that are mapped to the corners of the primitives. See TriangleMeshBuilder and QuadMeshBuilder for more details.

Note: Normals cannot be set as they are not necessary when using the MeshBuilder.

Example how to build a cube using QuadMeshBuilder

let cube = MeshBuilder()
    .quad(a: Point3D(x: 0.5, y: 0.5, z: 0.5),
          b: Point3D(x: -0.5, y: 0.5, z: 0.5),
          c: Point3D(x: 0.5, y: -0.5, z: 0.5),
          d: Point3D(x: -0.5, y: -0.5, z: 0.5))
    .quad(a: Point3D(x: -0.5, y: 0.5, z: -0.5),
          b: Point3D(x: 0.5, y: 0.5, z: -0.5),
          c: Point3D(x: -0.5, y: -0.5, z: -0.5),
          d: Point3D(x: 0.5, y: -0.5, z: -0.5))
    .quad(a: Point3D(x: 0.5, y: 0.5, z: -0.5),
          b: Point3D(x: 0.5, y: 0.5, z: 0.5),
          c: Point3D(x: 0.5, y: -0.5, z: -0.5),
          d: Point3D(x: 0.5, y: -0.5, z: 0.5))
    .quad(a: Point3D(x: -0.5, y: 0.5, z: 0.5),
          b: Point3D(x: -0.5, y: 0.5, z: -0.5),
          c: Point3D(x: -0.5, y: -0.5, z: 0.5),
          d: Point3D(x: -0.5, y: -0.5, z: -0.5))
    .quad(a: Point3D(x: -0.5, y: 0.5, z: 0.5),
          b: Point3D(x: 0.5, y: 0.5, z: 0.5),
          c: Point3D(x: -0.5, y: 0.5, z: -0.5),
          d: Point3D(x: 0.5, y: 0.5, z: -0.5))
    .quad(a: Point3D(x: 0.5, y: -0.5, z: 0.5),
          b: Point3D(x: -0.5, y: -0.5, z: 0.5),
          c: Point3D(x: 0.5, y: -0.5, z: -0.5),
          d: Point3D(x: -0.5, y: -0.5, z: -0.5))
    .build()

init()
Constructs an instance of MeshBuilder.
Declaration
Swift

public init()


                    
                    
                    triangle(a:b:c:)

Adds a triangle.

Triangle visibility is determined via back-face culling. Front-facing triangles are expected to have counter-clockwise winding.

Declaration

Swift

public func triangle(a: Point3D, b: Point3D, c: Point3D) -> TriangleMeshBuilder

Parameters

`a`	First vertex of the triangle.
`b`	Second vertex of the triangle.
`c`	Third vertex of the triangle.

Return Value

A TriangleMeshBuilder instance.


                    
                    
                    quad(a:b:c:d:)

Adds a quad. Internally, this will be transformed into triangles abc and bdc.

Triangle visibility is determined via back-face culling. Front-facing triangles are expected to have counter-clockwise winding.

Declaration

Swift

public func quad(a: Point3D, b: Point3D, c: Point3D, d: Point3D) -> QuadMeshBuilder

Parameters

`a`	First vertex of quad.
`b`	Second vertex of the quad.
`c`	Third vertex of the quad.
`d`	Fourth vertex of the quad.

Return Value

A QuadMeshBuilder instance.

build()
Declaration
Swift

public func build() -> Mesh?
Return Value

mesh containing added geometry or ‘null’ if no geometry was added.