---
title: "newSubdividedMesh(_:submeshIndex:subdivisionLevels:)"
framework: modelio
role: symbol
role_heading: Type Method
path: "modelio/mdlmesh/newsubdividedmesh(_:submeshindex:subdivisionlevels:)"
---

# newSubdividedMesh(_:submeshIndex:subdivisionLevels:)

Creates a new mesh by subdividing the specified mesh.

## Declaration

```swift
class func newSubdividedMesh(_ mesh: MDLMesh, submeshIndex: Int, subdivisionLevels: Int) -> Self?
```

## Parameters

- `mesh`: The mesh from which to generate a new subdivided mesh.
- `submeshIndex`: The index of the submesh in the original mesh from which to generate the new mesh.
- `subdivisionLevels`: The number of times to iteratively perform the subdivision process.

## Return Value

Return Value A new mesh object, or nil if subdivision fails.

## Discussion

Discussion Surface subdivision creates a smooth mesh from a coarse mesh by splitting each primitive (triangle or quad) in the original mesh into multiple smaller primitives and projecting the newly created vertices along surface normal vectors. The subdivisionLevels parameter controls the level of detail (and resulting performance cost) of the subdivision process. For example, in a triangle mesh, a subdivision level of 1 replaces each triangle with a set of four smaller triangles; a subdivision level of 2 replaces each of those four triangles with four even smaller triangles (for a total of 16 created from the triangle in the original mesh. note: The computational cost of subdivision increases exponentially with subdivision level. Depending on the arrangement of the original mesh and the device on which a mesh is to be rendered, using a subdivision level greater than 4 may result in more detail than would be visible when rendering. Meshes intended for use with surface subdivision contain topology information to ensure that the results of subdivision match the artist’s intent. To make use of this information, use the init(url:vertexDescriptor:bufferAllocator:preserveTopology:error:) initializer when creating an MDLAsset object to load meshes from.

## See Also

### Creating a Custom Mesh

- [init(vertexBuffer:vertexCount:descriptor:submeshes:)](modelio/mdlmesh/init(vertexbuffer:vertexcount:descriptor:submeshes:).md)
- [init(vertexBuffers:vertexCount:descriptor:submeshes:)](modelio/mdlmesh/init(vertexbuffers:vertexcount:descriptor:submeshes:).md)
- [init(bufferAllocator:)](modelio/mdlmesh/init(bufferallocator:).md)
- [init(meshBySubdividingMesh:submeshIndex:subdivisionLevels:allocator:)](modelio/mdlmesh/init(meshbysubdividingmesh:submeshindex:subdivisionlevels:allocator:).md)