> For the complete documentation index, see [llms.txt](https://docs.icraft.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.icraft.design/editor-features/resource-panel/basic-graphics/light.md). # Light In 3D scenes, lighting and shadows are essential for creating atmosphere, enhancing spatial depth, and achieving visual realism. iCraft provides three core lighting components: Directional Light, Point Light, and Spot Light. By arranging lights properly, you can bring depth, realism, and visual focus to your scene.

*** ## Directional Light A **Directional Light** simulates a very distant large light source (such as the sun). The light rays it emits are parallel and do not attenuate with distance. It is primarily used to provide global illumination and scene-wide shadows. ### Special Parameters #### Basic Parameters * **Position**\ Defines the spatial position of the directional light in the 3D scene coordinate system (X/Y/Z).\ The position can be adjusted freely within the canvas space. * **Rotation**\ Determines the direction of the light rays, which controls the direction and length of shadows. Default value: (0°, 0°, 0°) Adjustable range: `-360° to 360°` (supports continuous rotation beyond 360°)

#### Light Parameters * **Color**\ Select the main color of the light using the color picker.\ Default color: `#ffd17c` * **Intensity**\ Controls the brightness of the light. Default value: 1 Adjustable range: `0 – 10`

#### Shadow Parameters * **Cast Shadow**\ Toggle that determines whether objects cast shadows onto surfaces. Enabling this option makes lighting effects more realistic.\ Default: Disabled * **Resolution**\ Determines the quality level of the shadow map. Default: Medium Options: High / Ultra * **Range**\ Defines the area used for shadow calculations. Default value: 40 Adjustable range: `1 – 200`

*** ## Point Light A **Point Light** emits light equally in all directions from a single point, similar to a light bulb or candle. It produces a strong sense of spatial position, and the light naturally attenuates with distance. ### Special Parameters #### Basic Parameters * **Position**\ Defines the spatial position of the point light in the 3D scene coordinate system (X/Y/Z).\ The position can be adjusted freely within the canvas space. * **Rotation**\ Determines the direction of the light rays, which controls the direction and length of shadows. Default value: (0°, 0°, 0°) Adjustable range: `-360° to 360°` (supports continuous rotation beyond 360°)

#### Shadow Parameters * **Cast Shadow**\ Toggle that determines whether objects cast shadows. Default: Disabled * **Resolution**\ Determines the quality level of the shadow map. Default: Medium Options: High / Ultra

*** ## Spot Light A **Spot Light** emits a cone-shaped beam from a point in a specific direction, similar to a flashlight or stage spotlight. It is ideal for highlighting specific objects or creating strong light–shadow contrast in a scene. ### Special Parameters #### Basic Parameters * **Position**\ Defines the spatial position of the spot light in the 3D scene coordinate system (X/Y/Z).\ The position can be adjusted freely within the canvas space. * **Rotation**\ Determines the direction of the light rays, which controls the direction and length of shadows. Default value: (0°, 0°, 0°) Adjustable range: `-360° to 360°` (supports continuous rotation beyond 360°)

#### Style Parameters * **Color**\ Select the main color of the light using the color picker.\ Default color: `#ffd17c` * **Intensity**\ Controls the brightness of the light source. Higher values produce brighter light. Default value: 3 Adjustable range: `0 – 10` * **Distance**\ Defines the maximum effective illumination distance. Larger values increase the lighting coverage.\ Default value: 0.1 Adjustable range: `0.1 – 100` * **Angle**\ Controls how concentrated the light beam is. Smaller angles produce a more focused beam. Default value: 30° Adjustable range: `0° – 90°` * **Penumbra**\ Controls the softness of the spotlight’s edge. Higher values produce softer edges. Default value: 0.2 Adjustable range: `0 – 1` * **Attenuation**\ Controls how quickly the light fades with distance. Higher values make distant areas darker. Default value: 2 Adjustable range: `0 – 5`

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.icraft.design/editor-features/resource-panel/basic-graphics/light.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.