# newTextureViewWithPixelFormat:textureType:levels:slices: Creates a new view of the texture, reinterpreting a subset of its data using a different type and pixel format. ``` - (id) newTextureViewWithPixelFormat:(MTLPixelFormat) pixelFormat textureType:(MTLTextureType) textureType levels:(NSRange) levelRange slices:(NSRange) sliceRange; ``` ## Parameters `pixelFormat` A new pixel format, which needs to be compatible with the original pixel format. `textureType` A new texture type, which can be cast according to the original texture type as listed in the table below. `levelRange` A new base level range that restricts which mipmap levels are visible in the new texture. `sliceRange` A new base slice range that restricts which array slices are visible in the new texture. ## Return Value A new texture object that shares the same storage allocation of the calling texture object. ## Discussion The texture type can be cast between the targets listed in the following table. |Original texture type |New texture type | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |``doc://com.apple.metal/documentation/Metal/MTLTextureType/type1D`` |``doc://com.apple.metal/documentation/Metal/MTLTextureType/type1D`` | |``doc://com.apple.metal/documentation/Metal/MTLTextureType/type2D`` |``doc://com.apple.metal/documentation/Metal/MTLTextureType/type2D`` or ``doc://com.apple.metal/documentation/Metal/MTLTextureType/type2DArray`` | |``doc://com.apple.metal/documentation/Metal/MTLTextureType/type2DArray``, ``doc://com.apple.metal/documentation/Metal/MTLTextureType/typeCube``, or ``doc://com.apple.metal/documentation/Metal/MTLTextureType/typeCubeArray``|``doc://com.apple.metal/documentation/Metal/MTLTextureType/type2D``, ``doc://com.apple.metal/documentation/Metal/MTLTextureType/type2DArray``, ``doc://com.apple.metal/documentation/Metal/MTLTextureType/typeCube``, or ``doc://com.apple.metal/documentation/Metal/MTLTextureType/typeCubeArray``| |``doc://com.apple.metal/documentation/Metal/MTLTextureType/type3D`` |``doc://com.apple.metal/documentation/Metal/MTLTextureType/type3D`` | The `length` value of the `sliceRange` parameter needs to be `6` if the new texture type value is [`MTLTextureType.typeCube`](/documentation/Metal/MTLTextureType/typeCube), or a multiple of `6` if the new texture type value is [`MTLTextureType.typeCubeArray`](/documentation/Metal/MTLTextureType/typeCubeArray). For more information on pixel format restrictions, see [`makeTextureView(pixelFormat:)`](/documentation/Metal/MTLTexture/makeTextureView(pixelFormat:)) ## See Also [`parentRelativeLevel`](/documentation/Metal/MTLTexture/parentRelativeLevel) The base level of the parent texture used to create this texture. [`parent`](/documentation/Metal/MTLTexture/parent) The parent texture used to create this texture, if any. [`parentRelativeSlice`](/documentation/Metal/MTLTexture/parentRelativeSlice) The base slice of the parent texture used to create this texture. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)