set_key_light_position_spherical
Adjust the key light's horizontal and vertical angles around the camera using spherical coordinates to control lighting direction in 3D scenes.
Instructions
Set the key light position using camera-centric spherical coordinates. Preserves current distance - only changes azimuth and elevation. Azimuth: 0° = camera forward (North), 90° = camera right (East), 180° = behind camera (South), 270° = camera left (West). Elevation: 0° = horizon, 90° = overhead. Azimuth can be a number (0-360) or a direction name. Available direction names: north, east, south, west, northeast, northwest, southeast, southwest, ne, nw, se, sw, nne, ene, ese, sse, ssw, wsw, wnw, nnw. Examples: "north" (0°), "east" (90°), "northwest" (315°), "southeast" (135°).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| azimuth | Yes | Horizontal angle in degrees (0-360) or direction name (e.g., "north", "northwest", "NW"). 0° = camera forward (North), 90° = camera right (East), 180° = behind camera (South), 270° = camera left (West). Available directions: north, east, south, west, northeast, northwest, southeast, southwest, ne, nw, se, sw, nne, ene, ese, sse, ssw, wsw, wnw, nnw | |
| elevation | Yes | Vertical angle in degrees (0-90), 0° = horizon, 90° = overhead |