# changingLayout(to:) Returns a copy with the specified buffer layout. ``` func changingLayout(to bufferLayout: MLShapedArrayBufferLayout) -> MLShapedArray ``` ## Parameters `bufferLayout` The desired buffer layout. ## Discussion The returned shaped array will have `.strides` property according to the requested layout. The function may return a heap-memory backed shaped array even if `self` is backed by a pixel buffer. ```swift let source = MLShapedArray(scalars: 0..., shape: [2, 2]) // Returns a new MLShapedArray with the specified strides. _ = source.changingLayout(to: .custom(strides: [4, 1])) // Returns a new MLShapedArray with the first-major contiguous layout. _ = source.changingLayout(to: .firstMajorContiguous) // Returns a new MLShapedArray with the last-major contiguous layout. _ = source.changingLayout(to: .lastMajorContiguous) ``` The `withUnsafeShapedBufferPointer` function provides read-only access to the underlying buffer of the layout. The `withUnsafeMutableShapedBufferPointer(body:)` function may provide a buffer of different layout due to copy-on-write. Use `withUnsafeMutableShapedBufferPointer(bufferLayout:body:)` if you need a specific buffer layout. It raises a precondition error if the custom strides and the shape have different ranks. --- 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)