fiftyone.core.threed.object_3d

FiftyOne 3D Object3D base class.

Copyright 2017-2025, Voxel51, Inc.

voxel51.com

Classes:

Object3D(name[, visible, position, scale, ...])

The base class for all 3D objects in the scene.

class fiftyone.core.threed.object_3d.Object3D(name: str, visible=True, position: Vector3 | List[float] | Tuple[float] | array | None = None, scale: Vector3 | List[float] | Tuple[float] | array | None = None, quaternion: Quaternion | None = None)

Bases: object

The base class for all 3D objects in the scene.

Parameters:

• name – the name of the object

• visible (True) – default visibility of the object in the scene

• position (None) – the position of the object in object space

• quaternion (None) – the quaternion of the object in object space

• scale (None) – the scale of the object in object space

Attributes:

uuid	The unique ID of the object.
position	The position of the object in object space.
rotation	The rotation of the object in object space.
quaternion	The quaternion of the object in object space.
scale	The scale of the object in object space.
local_transform_matrix	The local transform matrix of the object.

Methods:

add(*objs)	Add one or more objects as children of this one.
clear()	Remove all children from this object.
traverse([include_self])	Traverse the scene graph.
as_dict()	Converts the object to a dict.

property uuid

The unique ID of the object.

property position

The position of the object in object space.

property rotation

The rotation of the object in object space.

property quaternion

The quaternion of the object in object space.

property scale

The scale of the object in object space.

property local_transform_matrix

The local transform matrix of the object.

Setting this property also decomposes the matrix into its constituent position, quaternion, and scale components. However, decomposition of matrices with skew / shear components (non-uniform scaling) might have unexpected results.

add(*objs: Object3D) → None

Add one or more objects as children of this one.

clear() → None

Remove all children from this object.

traverse(include_self=True)

Traverse the scene graph.

as_dict()

Converts the object to a dict.