Breathing bubble

更新时间:
复制 MD 格式

The animated bubbles layer in 3D City Builder represents the location and properties of point features. You can configure the style and data for the bubbles, such as their color, scaling factor, rotation speed, brightness, and height offset. This topic describes the configuration items for this layer.

In the layer list on the left side of the scene editor, click the Breathing Bubble layer to open the configuration panel and configure the Breathing Bubble layer's style and data.

Note

If the Breathing Bubble is not in the layer list, you need to add the Breathing Bubble layer as described in 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.

  • The following parameters are available on the configuration panel for the animated bubbles layer.

    • General

      Parameter

      Description

      Mixed Mode

      Sets the blending and rendering mode for the animated bubbles layer. Options are Additive Mode and Normal Mode.

      Depth Write

      Turn on this switch to enable depth writing for the animated bubbles layer. Turn it off to disable depth writing.

      Note

      If depth writing is enabled, the object may obscure objects behind it.

      Depth Test

      Turn on this switch to enable depth testing for the animated bubbles layer. Turn it off to disable depth testing.

      Note

      If depth testing is enabled, the object may be obscured by objects behind it.

      Scaling Factor

      The scaling factor for the animated bubbles. A larger value indicates a larger size. The value can range from 0 to 1000.

      Height Offset

      The offset of the animated bubbles area from the ground plane. The value can range from -3000 to 5000.

    • Graphics

      Parameter

      Description

      Color

      Sets the color of the animated bubbles. For more information, see Color picker.

      Sprite Sheet

      In the Sprite Sheet Image area, select the type of sprite sheet.

      Horizontal Frames

      Drag the slider to set the number of horizontal frames for the animated bubbles.

      Vertical Frames

      Drag the slider to set the number of vertical frames for the animated bubbles.

      Brightness Coefficient

      Drag the slider to adjust the brightness coefficient of the animated bubbles.

    • Animation: Sets the animation effect for the animated bubbles layer.

      Parameter

      Description

      Frame Rate Coefficient

      Drag the slider to set the frame rate coefficient for the animated bubbles. A larger value makes the animation faster. The value can range from 0 to 2.

Data panelimage.png

Parameter

Description

lng

The longitude of the centroid of the breathing bubble.

lat

The latitude of the breathing bubble's centroid.

altitude

The height of the breathing bubble's centroid.

value

The radius of the breathing bubble'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. On the Scene Editor page, click the Export to Blueprint Editor icon next to Breathing Bubble in the layer list.

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

  3. On the Blueprint Editor page, click the Animated Bubbles layer in the Import Nodes section. The configuration parameters for the layer appear on the canvas, as shown in the following figure.

    • Events

      Event

      Description

      When Data API Request Is Complete

      This event is triggered after the data API request is returned and processed by the filter. The processed data is also returned in JSON format. For a data example, see the Data Response Result section on the Data tab of the widget's configuration panel in the canvas editor.

      Rendering Complete

      This event is triggered when the animated bubbles are rendered. Data of the object type is also returned.

    • Actions

      Action

      Description

      Request data API

      Sends a new request for server-side data. It uses data from input data processing nodes or layer nodes as parameters. For example, if a breathing bubble component has its API data source set to https://api.test, and the data { id: '1'} is passed to the Request data API action, the final request URL is https://api.test?id=1.

      Import data API

      Processes data into the component's drawing format, then imports the data to redraw the component. This action does not request new data from the server. For data examples, see the Data Response area on the Data tab of the component's configuration panel in the canvas editor.

      Show component

      Shows the component. No parameters are required.

      Hide component

      Hides the component. No parameters are required.