set_object_property
Modify object properties in 3ds Max scenes, including display settings like wirecolor, visibility, and creation parameters such as radius or dimensions.
Instructions
设置 3ds Max 场景中指定物体的属性值。
该工具可以设置物体的各种属性,包括显示属性和创建参数。
常用属性名称(property_name 参数):
wirecolor: 线框颜色,值格式 "r,g,b" (0-255),如 "255,0,0"
isHidden: 是否隐藏,值 "true" 或 "false"
isFrozen: 是否冻结,值 "true" 或 "false"
renderable: 是否可渲染,值 "true" 或 "false"
boxMode: 是否以盒模式显示,值 "true" 或 "false"
backfaceCull: 是否背面剔除,值 "true" 或 "false"
以及对象的创建参数(如 radius、length、width、height、segments 等)
Args: object_name: 目标物体名称。支持通配符 "*" 进行批量设置。 property_name: 属性名称。 property_value: 属性值(字符串形式)。 数字值: "30"、"1.5" 布尔值: "true"、"false" 颜色值: "255,0,0"(仅 wirecolor 属性使用)
Returns: dict: 操作结果。 - success (bool): 是否成功。 - modified (list): 成功修改的物体列表。 - property_name (str): 属性名称。 - property_value (str): 设置的属性值。 - message (str): 操作描述信息。
示例调用 - 设置线框颜色为红色: set_object_property(object_name="Box001", property_name="wirecolor", property_value="255,0,0")
示例调用 - 隐藏物体: set_object_property(object_name="Box001", property_name="isHidden", property_value="true")
示例调用 - 修改球体半径: set_object_property(object_name="Sphere001", property_name="radius", property_value="50")
示例调用 - 批量冻结所有 Box: set_object_property(object_name="Box*", property_name="isFrozen", property_value="true")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object_name | Yes | ||
| property_name | Yes | ||
| property_value | Yes |