# init(matrix:) Initializes a transform object with the specified transform matrix. ``` convenience init(matrix: matrix_float4x4) ``` ## Parameters `matrix` A transform matrix that defines a local coordinate space relative to a parent coordinate space. ## Return Value A new transform object. ## Discussion A transform matrix defines the local coordinate space transformations for a 3D object—that is, its position, orientation, shear, and scale. After initializing a transform object from a matrix, you can use the [`translation`](/documentation/ModelIO/MDLTransform/translation), [`rotation`](/documentation/ModelIO/MDLTransform/rotation), [`shear`](/documentation/ModelIO/MDLTransform/shear), and [`scale`](/documentation/ModelIO/MDLTransform/scale) properties to individually work with those factors of the transform (or the corresponding methods listed in Using Factors of an Animated Transform to associate time-based transformation with each factor). To work with the complete transform matrix defined by those factors, use the [`matrix`](/documentation/ModelIO/MDLTransformComponent/matrix) property. The `matrix` parameter must be an invertible, homogeneous affine transform matrix. If you initialize a transform object with a nonaffine transform matrix, attempts to retrieve its translation, rotation, shear, or scale factors instead return identity values. --- 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)