clone_object
Clone objects in 3ds Max scenes using copy, instance, or reference modes to duplicate geometry with optional naming and positional offsets.
Instructions
克隆 3ds Max 场景中的指定物体。
支持三种克隆模式:
Copy: 完全独立的副本(默认)。
Instance: 实例,与原对象共享修改器和参数。
Reference: 引用,可以在原对象基础上添加新修改器。
Args: object_name: 要克隆的源物体名称。 clone_type: 克隆类型,可选 "copy"、"instance"、"reference"。默认为 "copy"。 new_name: 克隆体的名称。如果为空,则使用 3ds Max 默认命名。 offset: 克隆体相对于原物体的偏移量,格式为 "x,y,z"。 默认为 "0,0,0"(与原物体重叠)。
Returns: dict: 操作结果。 - success (bool): 是否成功。 - source_name (str): 源物体名称。 - clone_name (str): 克隆体名称。 - clone_type (str): 克隆类型。 - position (list): 克隆体位置 [x, y, z]。 - message (str): 操作描述信息。
示例调用 - 复制一个 Box: clone_object(object_name="Box001")
示例调用 - 实例化克隆并偏移: clone_object(object_name="Box001", clone_type="instance", offset="50,0,0")
示例调用 - 带名称的引用克隆: clone_object(object_name="Box001", clone_type="reference", new_name="Box001_Ref", offset="100,0,0")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object_name | Yes | ||
| clone_type | No | copy | |
| new_name | No | ||
| offset | No | 0,0,0 |