---
title: "setTransformMatrix(_:relativeTo:)"
framework: realitykit
role: symbol
role_heading: Instance Method
path: "realitykit/hastransform/settransformmatrix(_:relativeto:)"
---

# setTransformMatrix(_:relativeTo:)

Sets the transform of the entity relative to the given reference entity using a 4x4 matrix representation.

## Declaration

```swift
@MainActor @preconcurrency func setTransformMatrix(_ transform: float4x4, relativeTo referenceEntity: Entity?)
```

## Parameters

- `transform`: A 4x4 transform matrix, given relative to referenceEntity.
- `referenceEntity`: The entity that defines a frame of reference. Set this to nil to indicate world space.

## Discussion

Discussion The Transform component can’t represent all transforms that a general 4x4 matrix can represent. Setting a transform using a 4x4 matrix is therefore a lossy event that might result in certain transformations, like shear, being dropped.