assign_material
Assign materials to objects in 3ds Max scenes using material names or editor slot indexes. Supports single objects, wildcard patterns, and batch assignments.
Instructions
将材质赋予 3ds Max 场景中的指定物体。
该工具可以将已存在的材质赋予物体,支持通过材质名称或材质编辑器槽位索引来指定材质。
Args: object_name: 目标物体名称。支持通配符 "",如 "Box" 会赋予所有以 Box 开头的物体。 也支持用英文逗号分隔多个名称,如 "Box001,Sphere001"。 material_name: 材质名称。在场景的所有材质中查找匹配的材质。 与 slot_index 二选一,优先使用 material_name。 slot_index: 材质编辑器的槽位索引(1-24)。当 material_name 为空时使用此参数。 默认为 "0"(不使用槽位)。
Returns: dict: 操作结果。 - success (bool): 是否成功。 - assigned (list): 成功赋予材质的物体列表。 - material_name (str): 使用的材质名称。 - message (str): 操作描述信息。
示例调用 - 按材质名称赋予: assign_material(object_name="Box001", material_name="RedMaterial")
示例调用 - 按槽位赋予: assign_material(object_name="Box001", slot_index="1")
示例调用 - 批量赋予: assign_material(object_name="Box*", material_name="WoodMaterial")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| object_name | Yes | ||
| material_name | No | ||
| slot_index | No | 0 |