Atmospheric light pillars

更新时间:
复制 MD 格式

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.

Note

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 panelimage.png

  • 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.

    Note

    If 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.

    Note

    If 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.

      Note

      Only 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.

      Note

      Only 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 panelimage.png

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 刷新图标 icon on the right to view the real-time data response.

Note

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:

  1. 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.

  2. From the Data Project drop-down list at the bottom of the panel, select an existing data project from the spatial build platform.选择数据项目

  3. After you select a data project, select a matching dataset from the Dataset drop-down list.数据集面板

    Note

    If 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

  1. In the layer list on the left of the scene editor, click the Export to Blueprint Editor icon to the right of Atmospheric Light Column.

  2. Click the 蓝图图标 icon in the upper-left corner of the page.

  3. 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.test and the data passed to the Request Data API action is { id: '1'}, the final request URL is https://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.