set_object_transform
Adjust position, rotation, or scale of 3D objects in 3ds Max scenes using absolute or relative transformations.
Instructions
设置 3ds Max 场景中指定物体的变换属性(位置/旋转/缩放)。
该工具可以设置物体的位置、旋转和缩放,支持绝对模式和相对模式。 可以同时设置多个变换属性,也可以只设置其中一个。
Args: object_name: 目标物体的名称(场景中已存在的对象)。 position: 位置坐标,格式为 "x,y,z",如 "100,50,0"。 留空则不改变位置。 rotation: 旋转欧拉角(度数),格式为 "x,y,z",如 "0,0,45"。 留空则不改变旋转。 scale: 缩放比例,格式为 "x,y,z",如 "2,2,2"(等比放大2倍)。 也可使用单个值表示等比缩放,如 "1.5"(等同于 "1.5,1.5,1.5")。 留空则不改变缩放。 relative: 是否使用相对模式。"true" 表示在当前值基础上叠加, "false"(默认)表示设置为绝对值。
Returns: dict: 操作结果。 - success (bool): 是否成功。 - object_name (str): 物体名称。 - old_transform (dict): 变换前的值。 - new_transform (dict): 变换后的值。 - message (str): 操作描述信息。
示例调用 - 移动物体到指定位置: set_object_transform(object_name="Box001", position="100,0,50")
示例调用 - 旋转物体45度(Z轴): set_object_transform(object_name="Box001", rotation="0,0,45")
示例调用 - 等比缩放物体: set_object_transform(object_name="Box001", scale="2,2,2")
示例调用 - 相对移动物体(在当前位置基础上偏移): set_object_transform(object_name="Box001", position="10,0,0", relative="true")
示例调用 - 同时设置位置和旋转: set_object_transform(object_name="Box001", position="100,50,0", rotation="0,0,90")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object_name | Yes | ||
| position | No | ||
| rotation | No | ||
| scale | No | ||
| relative | No | false |