get_scene_objects
Retrieve and filter objects in a 3ds Max scene by type or name to access properties like position, visibility, and class information.
Instructions
获取当前 3ds Max 场景中的所有对象信息。
该工具可以列出场景中的所有对象，或者按类型/名称进行过滤。 返回每个对象的名称、类型、位置、是否隐藏等基本信息。
支持的过滤类型（object_type 参数）：
"": 返回所有对象（默认）
"Geometry": 仅返回几何体对象（Box、Sphere、Mesh 等）
"Light": 仅返回灯光对象
"Camera": 仅返回相机对象
"Helper": 仅返回辅助对象（Dummy、Point 等）
"Shape": 仅返回样条线/形状对象（Line、Circle、Rectangle 等）
"SpaceWarp": 仅返回空间扭曲对象
"Bone": 仅返回骨骼对象 也支持具体的类名，如 "Box"、"Sphere"、"Editable_Mesh" 等。
Args: object_type: 按类型过滤对象，可以是超类名（如 "Geometry"）或具体类名（如 "Box"）。 如果为空字符串则返回所有对象。 name_filter: 按名称过滤对象，支持通配符 ""。 例如: "Box" 匹配所有以 "Box" 开头的对象。 如果为空字符串则不按名称过滤。
Returns: dict: 操作结果。 - success (bool): 是否成功。 - objects (list): 对象信息列表，每个元素包含： - name (str): 对象名称。 - class_name (str): 对象类名。 - super_class (str): 对象超类名。 - position (list): 位置坐标 [x, y, z]。 - is_hidden (bool): 是否隐藏。 - is_frozen (bool): 是否冻结。 - count (int): 返回的对象数量。 - total_in_scene (int): 场景中的总对象数量。 - message (str): 描述信息。
示例调用 - 获取所有对象： get_scene_objects()
示例调用 - 仅获取几何体： get_scene_objects(object_type="Geometry")
示例调用 - 按名称过滤： get_scene_objects(name_filter="Box*")
示例调用 - 按类型和名称组合过滤： get_scene_objects(object_type="Geometry", name_filter="Wall*")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object_type | No | ||
| name_filter | No |