---
title: "convertSparsePixelRegions(_:toTileRegions:withTileSize:alignmentMode:numRegions:)"
framework: metal
role: symbol
role_heading: Instance Method
path: "metal/mtldevice/convertsparsepixelregions(_:totileregions:withtilesize:alignmentmode:numregions:)"
---

# convertSparsePixelRegions(_:toTileRegions:withTileSize:alignmentMode:numRegions:)

Converts a list of sparse pixel regions to tile regions.

## Declaration

```swift
optional func convertSparsePixelRegions(_ pixelRegions: UnsafePointer<MTLRegion>, toTileRegions tileRegions: UnsafeMutablePointer<MTLRegion>, withTileSize tileSize: MTLSize, alignmentMode mode: MTLSparseTextureRegionAlignmentMode, numRegions: Int)
```

## Parameters

- `pixelRegions`: A pointer to a C array of pixel doc://com.apple.metal/documentation/Metal/MTLRegion instances.
- `tileRegions`: A pointer to a C array of tile doc://com.apple.metal/documentation/Metal/MTLRegion instances.
- `tileSize`: An doc://com.apple.metal/documentation/Metal/MTLSize instance that represents a sparse tile’s size, in pixels.
- `mode`: An doc://com.apple.metal/documentation/Metal/MTLSparseTextureRegionAlignmentMode instance.
- `numRegions`: The number of regions you want the method to convert.

## Mentioned in

Converting between pixel regions and sparse tile regions

## See Also

### Working with sparse textures

- [sparseTileSize(textureType:pixelFormat:sampleCount:sparsePageSize:)](metal/mtldevice/sparsetilesize(texturetype:pixelformat:samplecount:sparsepagesize:).md)
- [sparseTileSize(with:pixelFormat:sampleCount:)](metal/mtldevice/sparsetilesize(with:pixelformat:samplecount:).md)
- [sparseTileSizeInBytes(sparsePageSize:)](metal/mtldevice/sparsetilesizeinbytes(sparsepagesize:).md)
- [sparseTileSizeInBytes](metal/mtldevice/sparsetilesizeinbytes.md)
- [convertSparseTileRegions(_:toPixelRegions:withTileSize:numRegions:)](metal/mtldevice/convertsparsetileregions(_:topixelregions:withtilesize:numregions:).md)
- [MTLSparsePageSize](metal/mtlsparsepagesize.md)
- [MTLSparseTextureRegionAlignmentMode](metal/mtlsparsetextureregionalignmentmode.md)