create_light
Add lighting to 3ds Max scenes by creating various light types like Omni, Spot, and Skylight with customizable position, color, and intensity parameters.
Instructions
在 3ds Max 场景中创建一个灯光对象。
支持的灯光类型(light_type 参数):
Omni: 泛光灯(点光源),向四周均匀照射(默认)。
TargetSpot: 目标聚光灯,带目标点的锥形光源。
FreeSpot: 自由聚光灯,无目标点的锥形光源。
TargetDirect: 目标平行光,平行方向光照。
FreeLight: 自由灯光。
Skylight: 天光,模拟天空环境光照。
mr_Sky_Portal: Mental Ray 天空门户(需要 MR 插件)。 以及 V-Ray、Arnold 等插件的灯光类型(如 VRayLight、aiAreaLight)。
Args: light_type: 灯光类型名称。默认为 "Omni"。 name: 灯光名称。如果为空则使用默认命名。 position: 灯光位置,格式为 "x,y,z"。默认为 "0,0,100"。 color: 灯光颜色,格式为 "r,g,b" (0-255)。默认为 "255,255,255"(白色)。 intensity: 灯光强度/倍增器,默认 "1.0"。 params: 灯光额外参数的 JSON 字符串。 例如: '{"castShadows": true, "hotspot": 30, "falloff": 60}' 用于聚光灯。
Returns: dict: 操作结果。 - success (bool): 是否成功。 - name (str): 创建的灯光名称。 - light_type (str): 灯光类型。 - position (list): 位置 [x, y, z]。 - message (str): 操作描述信息。
示例调用 - 创建泛光灯: create_light(light_type="Omni", name="MainLight", position="0,0,200", color="255,245,230", intensity="1.5")
示例调用 - 创建聚光灯: create_light(light_type="FreeSpot", name="SpotLight01", position="100,0,150", params='{"hotspot": 30, "falloff": 60}')
示例调用 - 创建天光: create_light(light_type="Skylight", intensity="0.8")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| light_type | No | Omni | |
| name | No | ||
| position | No | 0,0,100 | |
| color | No | 255,255,255 | |
| intensity | No | 1.0 | |
| params | No |