One Logo Pool Ball
Spatial · IOS API REFERENCE

Pose3D

struct · iOS 16.0+ · SDK 27.1

struct Pose3D

Members (34)

get · iOS 16.0+

position

TypeScript
get position(): Point3D
Swift declaration
var position: Point3D
set · iOS 16.0+

position

TypeScript
set position(value: Point3D)
Swift declaration
var position: Point3D
get · iOS 16.0+

rotation

TypeScript
get rotation(): Rotation3D
Swift declaration
var rotation: Rotation3D
set · iOS 16.0+

rotation

TypeScript
set rotation(value: Rotation3D)
Swift declaration
var rotation: Rotation3D
get · iOS 16.0+

isIdentity

TypeScript
get isIdentity(): boolean
Swift declaration
var isIdentity: Bool { get }

Returns `true` if the pose is the identity transform.

method · iOS 16.0+

translated

TypeScript
translatedBy(offset: Vector3D): Pose3D
Swift declaration
func translated(by offset: Vector3D) -> Pose3D

Returns the entity translated by the specified vector. - Parameter vector: The vector that defines that translation.

method · iOS 16.0+

translated

TypeScript
translatedBy72346(size: Size3D): Pose3D
Swift declaration
func translated(by size: Size3D) -> Pose3D

Returns the entity translated by the specified size. - Parameter size: The size structure that defines that translation.

get · iOS 16.0+

description

TypeScript
get description(): string
Swift declaration
var description: String { get }

A textual representation of this instance. Calling this property directly is discouraged. Instead, convert an instance of any type to a string by using the `String(describing:)` initializer. This initializer works with any type, and uses the custom `description` property for types that conform to `CustomStringConvertible`: struct Point: CustomStringConvertible { let x: Int, y: Int var description: String { return "(\(x), \(y))" } } let p = Point(x: 21, y: 30) let s = String(describing: p) print(s) // Prints "(21, 30)" The conversion of `p` to a string in the assignment to `s` uses the `Point` type's `description` property.

get · iOS 18.0+

customMirror

TypeScript
get customMirror(): SDKHandle
Swift declaration
var customMirror: Mirror { get }

The custom mirror for this instance.

method · iOS 16.0+

concatenating

TypeScript
concatenating(transform: Pose3D): Pose3D
Swift declaration
func concatenating(_ transform: Pose3D) -> Pose3D

Returns a transform that's constructed by concatenating two existing poses. - Parameter transform: The second pose.

method · iOS 18.0+

concatenating

TypeScript
concatenating63023(transform: ScaledPose3D): ScaledPose3D
Swift declaration
func concatenating(_ transform: ScaledPose3D) -> ScaledPose3D

Returns a transform that's constructed by concatenating two a pose and a scaled pose. - Parameter transform: The second scaled pose.

method · iOS 16.0+

isApproximatelyEqual

TypeScript
isApproximatelyEqual(other: Pose3D, tolerance?: number): boolean
Swift declaration
func isApproximatelyEqual(to other: Pose3D, tolerance: Double = sqrt(.ulpOfOne)) -> Bool

Returns a Boolean value that indicates whether two poses are equal within a specified tolerance. - Parameter other: The second pose. - Parameter tolerance: The tolerance of the comparison.

method · iOS 16.0+

flip

TypeScript
flip(axis: Axis3D): void
Swift declaration
mutating func flip(along axis: Axis3D)

Flips the pose along the specified axis. - Parameter axis: The axis of the flip operation.

init · iOS 16.0+

init

TypeScript
static initMatrix(matrix: SDKHandle): (Pose3D) | null
Swift declaration
init?(matrix: simd_float4x4)

Creates a pose with the specified single-precision 4 x 4 matrix - Parameter matrix: The source matrix - note If the upper-left 3 x 3 submatrix is not a rotation matrix (that is, orthogonal with a determinant of `+1`), the function returns `nil`. If the bottom row of the matrix is not `[0,0,0,1]`, the functions returns `SPPose3DInvalid`.

init · iOS 16.0+

init

TypeScript
static initMatrix96210(matrix: SDKHandle): (Pose3D) | null
Swift declaration
init?(matrix: simd_double4x4)

Creates a pose with the specified double-precision 4 x 4 matrix - Parameter matrix: The source matrix - note: if the upper-left 3 x 3 submatrix is not a rotation matrix (that is, orthogonal with a determinant of `+1`), the function returns `nil`.

get · iOS 16.0+

matrix

TypeScript
get matrix(): SDKHandle
Swift declaration
var matrix: simd_double4x4 { get }

A 4 x 4 matrix that represents the pose's translation and rotation.

method · iOS 16.0+

flipped

TypeScript
flipped(axis: Axis3D): Pose3D
Swift declaration
func flipped(along axis: Axis3D) -> Pose3D

Returns the pose flipped along the specified axis. - Parameter axis: The axis of the flip operation.

init · iOS 16.0+

init

TypeScript
static initForwardUp(forward: Vector3D, up?: Vector3D): Pose3D
Swift declaration
init(forward: Vector3D, up: Vector3D = Vector3D(x: 0, y: 1, z: 0))

Creates a pose with the specified forward and up vectors. - Parameter forward: The forward direction. - Parameter up: The up direction. - note: This function creates a pose where `+z` is forward.

get · iOS 16.0+

inverse

TypeScript
get inverse(): Pose3D
Swift declaration
var inverse: Pose3D { get }

The inverse of the pose's underlying matrix.

method · iOS 16.0+

rotated

TypeScript
rotatedBy(quaternion: SDKHandle): Pose3D
Swift declaration
func rotated(by quaternion: simd_quatd) -> Pose3D

Returns a pose with a rotation that's rotated by the specified quaternion. - Parameter quaternion: The quaternion that defines the rotation. - Returns A pose with a rotation that's rotated by the specified quaternion.

method · iOS 16.0+

rotated

TypeScript
rotatedBy97519(rotation: Rotation3D): Pose3D
Swift declaration
func rotated(by rotation: Rotation3D) -> Pose3D

Returns a pose with a rotation that's rotated by the specified rotation. - Parameter rotation: The rotation. - Returns A pose with a rotation that's rotated by the specified rotation.

method · iOS 27.0+

applying

TypeScript
applying(transform: ProjectiveTransform3D): Pose3D
Swift declaration
func applying(_ transform: ProjectiveTransform3D) -> Pose3D

Returns a pose that's transformed by the specified projective transform. - Parameter transform: The projective transform. - Returns The transformed pose. This function applies the transform to the pose.

get · iOS 16.0+

identity

TypeScript
static get identity(): Pose3D
Swift declaration
static var identity: Pose3D { get }

The identity pose.

init · iOS 16.0+

init

TypeScript
static initPositionTargetUp(position: Point3D, target: Point3D, up?: Vector3D): Pose3D
Swift declaration
init(position: Point3D = .zero, target: Point3D, up: Vector3D = Vector3D(x: 0, y: 1, z: 0))

Creates a pose at the specified position that's oriented towards a look at target. - Parameter position: The position of the pose. - Parameter target: The point that the ray looks at. - Parameter up: The up direction. - note: This function creates a pose where `+z` is forward.

init · iOS 16.0+

init

TypeScript
static initPositionRotation(position: Point3D, rotation: Rotation3D): Pose3D
Swift declaration
init(position: Point3D = .zero, rotation: Rotation3D)

Creates a pose from Spatial primitives that describe the position and rotation. - Parameter position: The position of the pose. - Parameter rotation: The rotation of the pose.

init · iOS 16.0+

init

TypeScript
static initPositionRotation12983(position: SDKHandle, rotation: SDKHandle): Pose3D
Swift declaration
init(position: simd_double3 = .zero, rotation: simd_quatd)

Creates a pose from double-precision simd primitives that describe the position and rotation. - Parameter position: The position of the pose. - Parameter rotation: The rotation of the pose.

init · iOS 16.0+

init

TypeScript
static initPositionRotation32075(position: SDKHandle, rotation: SDKHandle): Pose3D
Swift declaration
init(position: simd_float3 = .zero, rotation: simd_quatf)

Creates a pose from single-precision simd primitives that describe the position and rotation. - Parameter position: The position of the pose. - Parameter rotation: The rotation of the pose.

init · iOS 16.0+

init

TypeScript
static initTransform(transform: AffineTransform3D): (Pose3D) | null
Swift declaration
init?(transform: AffineTransform3D)

Creates a pose with with a position and rotation that are defined by an affine transform. - Parameter transform: The source transform. The function only considers the transform's rotation and translation components. - Returns: A pose with a position and rotation that are defined by an affine transform. - note: This function can't extract rotation from a non-scale-rotate-translate affine transform. In that case, the function returns `nil`.

init · iOS 16.0+

init

TypeScript
static initTransform52696(transform: ProjectiveTransform3D): (Pose3D) | null
Swift declaration
init?(transform: ProjectiveTransform3D)

Creates a pose with with a position and rotation that are defined by a projective transform. - Parameter transform: The source transform. The function only considers the transform's rotation and translation components. - Returns: A pose with a position and rotation that are defined by a projective transform. - note: This function can't extract rotation from a non-scale-rotate-translate affine transform. In that case, the function returns `nil`.

init · iOS 16.0+

init

TypeScript
static init(matrix: SDKHandle): (Pose3D) | null
Swift declaration
init?(_ matrix: simd_float4x4)

Creates a pose with the specified single-precision 4 x 4 matrix - Parameter matrix: The source matrix - note: This function can't extract rotation from a non-scale-rotate-translate affine transform. In that case, the function returns `nil`.

init · iOS 16.0+

init

TypeScript
static init18543(matrix: SDKHandle): (Pose3D) | null
Swift declaration
init?(_ matrix: simd_double4x4)

Creates a pose with the specified double-precision 4 x 4 matrix - Parameter matrix: The source matrix - note: This function can't extract rotation from a non-scale-rotate-translate affine transform. In that case, the function returns `nil`.

init · iOS 26.0+

init

TypeScript
static init208(pose: Pose3DFloat): Pose3D
Swift declaration
init(_ pose: Pose3DFloat)

Returns a double-precision pose from a single-precision pose.

init · iOS 16.0+

init

TypeScript
static initPositionRotation57303(position: Point3D, rotation: Rotation3D): Pose3D
Swift declaration
init(position: Point3D, rotation: Rotation3D)

Creates a pose from Spatial primitives that describe the position and rotation. - Parameter position: The position of the pose. - Parameter rotation: The rotation of the pose.

init · iOS 16.0+

init

TypeScript
static init39526(): Pose3D
Swift declaration
init()

Skipped declarations

No declarations were skipped in this snapshot.

All Spatial types →