Skip to content

Commit 36af9ef

Browse files
emilybrown1noreply@unity3d.com
authored andcommitted
Updated Light Anchor page in line with updated HDRP page (#6956)
* Updated Light Anchor page in line with updated HDRP page * Update View-Lighting-Tool.md * Update View-Lighting-Tool.md * Update View-Lighting-Tool.md * Update View-Lighting-Tool.md * Update View-Lighting-Tool.md * Update View-Lighting-Tool.md * Apply formatting changes Co-authored-by: noreply@unity3d.com <noreply@unity3d.com>
1 parent a5a2d00 commit 36af9ef

File tree

3 files changed

+33
-3
lines changed

3 files changed

+33
-3
lines changed
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading

com.unity.render-pipelines.core/Documentation~/View-Lighting-Tool.md

Lines changed: 27 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,38 @@ The Light Anchor can help to place light sources around subjects, in relation to
44

55
## Using the Light Anchor Component
66

7-
To use the Light Anchor, you must set the Tag of at least one Camera to "MainCamera". By default, the Anchor's position will be the same as the position of the GameObject the Light Anchor Component is attached to.
7+
To add a Light Anchor component to a GameObject in your Scene:
8+
9+
1. Select a Light GameObject in the hierarchy to open its Inspector window.
10+
2. Go to **Add Component** > **Rendering** > **Light Anchor**
11+
12+
By default, the Anchor's position is the same as the position of the GameObject the Light Anchor Component is attached to.
13+
14+
**Note**: To use the Light Anchor, you must set the Tag of at least one Camera to "MainCamera".
815

916
Use the **Orbit** and **Elevation** to control the orientation of the light, in degrees, relative to the main Camera's and Anchor's positions. If the Light has a Cookie or an IES Profile, use the **Roll** to change their orientation. Use the **Distance** to control how far from the anchor, in meters, you want to place the Light.
1017

11-
Using the **Anchor Position Override**, you can provide a custom GameObject as an anchor point for the light. This is useful if you want the light to follow a specific GameObject in the Scene.
18+
You can use the **Anchor Position Override** to provide a GameObject’s [Transform](https://docs.unity3d.com/ScriptReference/Transform.html) as an anchor point for the Light. This is useful if you want the Light to follow a specific GameObject in the Scene.
19+
20+
![](Images/LightAnchorAnimation.gif)
21+
22+
**Note**: The above example uses the Main Camera as the reference Camera that adjusts the light rotation. The Common presets might create a different result in the Scene View if your view isn't aligned with the Main Camera.
1223

1324
You can set a **Position Offset** for this custom Anchor. This is useful if the Transform position of the custom Anchor isn't centered appropriately for the light to orbit correctly around the custom Anchor.
1425

15-
![](Images/view-lighting-tool-light-anchor0.png)
26+
![](Images/LightAnchor0.png)
27+
1628

1729
The Light Anchor component also includes a list of **Presets** that you can use to set the Light's orientation relative to the main Camera.
30+
31+
## Properties
32+
33+
| **Property** | **Description** |
34+
| --------------- | ------------------------------------------------------------ |
35+
| **Orbit** | Use the left icon to control the Orbit of the light. This tool becomes green when you move the icon. |
36+
| **Elevation** | Use the middle icon to control the Elevation of the light. This tool becomes blue when you move the icon. |
37+
| **Roll** | Use the right icon to control the Roll of the light. This tool becomes gray when you move the icon. This is useful if the light has an IES or a Cookie. |
38+
| **Distance** | Controls the distance between the light and its anchor in world space. |
39+
| **Up Direction** | Defines the space of the up direction of the anchor. When you set this value to Local, the Up Direction is relative to the Camera. |
40+
| **Anchor Position Override** | Allows you to use a GameObject's [Transform](https://docs.unity3d.com/ScriptReference/Transform.html) as anchor position instead of the LightAnchor's Transform. When the Transform of the GameObject you assigned to this property changes, the Light Anchor's Transform also changes. |
41+
| **Common** | Assigns a preset to the light component based on the behavior of studio lights. |

0 commit comments

Comments
 (0)