Creates a mesh in the shape of an ellipsoid or sphere.
- iOS 9.0+
- macOS 10.11+
- UIKit for Mac 13.0+Beta
- tvOS 9.0+
- Model I/O
A vector containing the width (x-component), height (y-component), and depth (z-component) of the bounding box of the ellipsoid to generate. If all components are equal, this method generates a sphere.
The number of points to generate around the horizontal circumference of the ellipsoid (that is, its cross-section in the xz-plane). A larger number of points increases rendering fidelity but decreases rendering performance.
The number of points to generate along the height of the ellipsoid. A larger number of points increases rendering fidelity but decreases rendering performance.
The type of geometric primitive from which to construct the mesh; must be either kindTriangles or kindQuads.
trueto generate normal vectors pointing toward the center of the ellipsoid;
falseto generate normal vectors pointing outward.
trueto generate only the upper half of the ellipsoid or sphere (a dome);
falseto generate a complete ellipsoid or sphere.
An object responsible for allocating mesh vertex data. If
nil, Model I/O uses an internal allocator object.
A new mesh object.
This method generates vertex data for an ellipsoid centered at the origin of its local coordinate system.
inward parameter determines the direction of generated vertex normal vectors for the mesh. Specify
true if the mesh will be viewed from inside (for example, for use in a sky effect), or
false if the mesh will be viewed from outside.
allocator parameter controls vertex data allocation for the mesh. For example, to use the MetalKit framework for loading vertex data into GPU buffers for rendering using Metal, pass a
MTKMesh object. By specifying an allocator, you can ensure that mesh data is copied a minimal number of times between being read from a file and being loaded into GPU memory for rendering.