Atmospheric light pillars are a layer in 3D City Builder. They render point data in a 3D space as pillars to decorate other point elements. Atmospheric light pillars support independent style and data configurations, such as radius scaling ratio, height scaling ratio, and side color. This topic describes the configuration items for atmospheric light pillars.
In the layer list on the left of the scene editor, click the Atmospheric Light Column layer to open the configuration panel and configure the style and data of the Atmospheric Light Column layer.
If you cannot find Highlighting Light Pillar in the layer list, you must first add the Highlighting Light Pillar layer. For more information, see Add a sub-widget.
Style panel
-
Search Configuration: To quickly find a specific configuration item, click on the Configuration panel in the upper right corner and enter the item's name in the Search Configuration field. The system utilizes a fuzzy match to assist in locating items. For more information, see search configuration items.
General: General configuration parameters.
Parameter
Description
Mixed Mode
Sets the blending mode for the pillar material. Options are Additive, Normal, and No Blending.
Depth Write
Turn on this switch to enable depth writing. Turn it off to disable depth writing.
NoteIf depth writing is enabled, this object may occlude objects behind it.
Depth Test
Turn on this switch to enable depth testing. Turn it off to disable depth testing.
NoteIf depth testing is enabled, this object may be occluded by objects behind it.
Altitude Offset
Drag the slider to set the offset of the pillar bottom from the ground plane. The value ranges from -1000 to 50000. The unit is meters.
Height Scaling Ratio
Drag the slider to set the overall height scaling ratio for all pillars. The value ranges from 0 to 5000.
Radius Scaling Ratio
Drag the slider to set the radius scaling ratio for the atmospheric light pillars. The value ranges from 0 to 3000.
Shape: Shape configuration parameters.
Parameter
Description
Side Segments
Drag the slider to set the number of side segments. The value ranges from 3 to 100. A larger value makes the cross-section more circular but increases performance overhead.
Side Color
Configures the color of the pillar sides. For more information, see Color picker.
Gradient
Turn on this switch to apply a gradient effect to the pillar color. Turn it off to display a solid color.
Side Texture
In the Texture Style area:
Move the mouse pointer over the image and click Delete to delete the current texture. Then, click the image area or drag a local image into the area to add a new side texture.
Move the mouse pointer over the image and click Change to re-upload a local image.
Alternatively, enter the URL of a texture to use an image from a remote server as the side texture.
NoteOnly PNG and JPG images are supported for textures.
Texture Color: Sets the color of the side texture. For more information, see Color picker to modify the color.
UV Tiling Value: Adjusts the UV tiling values of the side texture on the x-axis and y-axis.
Side Overlay Texture
In the Texture Style area:
Move the mouse pointer over the image and click Delete to delete the current texture. Then, click the image area or drag a local image into the area to add a new side overlay texture.
Move the mouse pointer over the image and click Change to re-upload a local image.
Alternatively, enter the URL of a texture to use an image from a remote server as the side overlay texture.
NoteOnly PNG and JPG images are supported for textures.
UV Tiling Value: Adjusts the UV tiling values of the side overlay texture on the x-axis and y-axis.
Animation: Animation configuration parameters.
Parameter
Description
Animation Mode
Sets the animation mode. Options are Horizontal or Vertical.
Movement Speed
Sets the movement speed.
Side Texture: Drag the slider to set the movement speed of the side texture. The value range is 0 to 0.5.
Side Overlay Texture: Drag the slider to set the movement speed of the side overlay texture. The value range is 0 to 0.5.
Data panel
Parameter |
Description |
lng |
The longitude of the pillar's centroid. |
lat |
The latitude of the pillar's centroid. |
altitude |
The altitude of the pillar's centroid. |
value |
The radius value of the pillar's centroid. |
Configuration Item |
Description |
Controlled Mode |
Turn on the switch to prevent the widget from requesting data upon initialization. Data is requested only through a callback ID or a method configured in the blueprint editor. Turn off the switch to allow automatic data update requests. The switch is off by default. |
Automatic Update Request |
Select this option to enable dynamic polling and manually set the polling frequency. If you clear this option, data is not updated automatically. You must manually refresh the page or trigger data update requests using the blueprint editor or callback ID events. |
Data Source |
Click Configure Data Source. In the Set Data Source panel, you can modify the data source type and data query code, preview the data source return results, and view the data response. |
Data Result |
Displays the response result of a data request. When the data source changes, click the |
You can also use the layer data API as a block data API to configure more data source types in the data dashboard or to interact with data from common chart widgets. For more information, see One-click generation of block APIs.
If you created your 3D City Builder project in Spatial Data Project mode and the project contains data primitive layer content, you can use the Spatial Build Data Source to obtain spatial map data when you configure the data panel in the scene editor. The steps are as follows:
In the layer configuration panel, select the Data tab. Click the Data Source Type drop-down list at the bottom of the panel and select Spatial Build Data Source.
From the Data Project drop-down list at the bottom of the panel, select an existing data project from the spatial build platform.

After you select a data project, select a matching dataset from the Dataset drop-down list.
NoteIf no configurable data types are available for the Data Project and Dataset configuration items, click Go to Spatial Build Platform to Manage Data in the panel to configure data in the spatial build platform. For more information, see Overview of spatial data management.
Blueprint interaction
In the layer list on the left of the scene editor, click the
icon to the right of Atmospheric Light Column.Click the
icon in the upper-left corner of the page.On the Blueprint Editor page, click the Atmospheric Light Pillars layer in the imported nodes bar. The configuration parameters for atmospheric light pillars appear on the canvas in the Blueprint Editor, as shown in the following figure.
Events
Event
Description
When a data API request is complete
An event that is triggered after a data API request is returned and processed by a filter. The event also returns the processed data in JSON format. For a data example, see the Data Response Result area on the Data tab of the widget's configuration panel on the right of the canvas editor.
Rendering complete
An event that is triggered when the atmospheric light pillars are rendered. The event returns object data.
Actions
Action
Description
Request Data API
Re-requests data from the server. Data from an input data processing node or a layer node is used as a parameter. For example, if the API data source for the atmospheric light pillars is set to
https://api.testand the data passed to the Request Data API action is{ id: '1'}, the final request URL ishttps://api.test?id=1.Import Data API
You can process data into the format required by the component, and then import it to redraw the component. This lets you avoid requesting data from the server-side again. For specific data examples, see the Data Response Result area on the Data tab of the configuration panel, located on the right side of the component in the canvas editor.
Show Widget
Shows the widget. No parameters are required.
Hide Widget
Hides the widget. No parameters are required.
icon in the upper-left corner of the page.