For the complete documentation index, see llms.txt. This page is also available as Markdown.

selectObjects

selectObjects

Select one or more objects in the scene by name or ID.

Signature

selectObjects(
  objectNamesOrIds: string | string[],
  addToSelection?: boolean
): Promise<SceneObject[]>

Parameters

Parameter
Type
Required
Description

objectNamesOrIds

string | string[]

Yes

Name(s) or ID(s) of objects to select

addToSelection

boolean

No

If true, adds to existing selection. If false or omitted, replaces current selection.

Returns

Promise<SceneObject[]> — the resulting selected objects. Each object includes full scene data: transform, materials, primitive settings, and children.

Examples

Notes:

  • Objects inside boolean operators are not directly clickable in the viewport. Use their ID to select them programmatically.

Last updated