Skip to content

Latest commit

 

History

History
17 lines (12 loc) · 1.66 KB

ui-coordinate-tracker.md

File metadata and controls

17 lines (12 loc) · 1.66 KB

UICoordinateTracker component reference

The UICoordinateTracker component performs coordinate conversion on the UI and simulates the foreshortening effects of 3D objects in the perspective camera. Return the converted coordinates and the proportion of the object in the viewport through events. Suitable for functions such as 3D character blood bars and name bars.

Click the Add Component button at the bottom of the Inspector panel and select UICoordinateTracker from UI to add the UICoordinateTracker component to the node.

UICoordinateTracker properties

Property Function Description
Target Target object. Which UI node needs to be converted to.
Camera The 3D camera representing the original coordinate system.
UseScale Whether to enable scaling, needs to be used in combination with the Distance property. If enabled, the scaling of the mapped object in the perspective camera will be adjusted according to the distance between the 3D node coordinates and the camera, resulting in a foreshortening effects.
Distance The distance from the camera is calculated for normal display. Adjust the best position according to the illumination effect of the model under the camera, and use this position as the dividing line to calculate the proportion in the viewport.
SyncEvents Map data events. The first parameter of the callback is the local coordinates after mapping, and the second is the distance ratio from the camera.

For specific usage, please refer to the rocker scene in the UI display example.