The sequence frame animation is a layer in 3D City Builder that you can use to customize animation shapes and easing functions. This layer supports independent style and data configurations, such as animation scaling, height offset, and composite sequence frame images. This topic describes the configuration items for sequence frame animation.
In the layer list on the left of the scene editor, click the Sequence Frame Animation layer to configure the style and data of the Sequence Frame Animation layer in the configuration panel.
If the layer list does not contain Sequence Frame Animation, you need to add the Sequence Frame Animation 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 mixed mode for the sequence frame animation. Options are Additive, Normal, and No Superimposition.
Depth Write
If you enable this option, the depth value of the sequence frame animation is written to the 3D space. If you disable this option, the depth value is not written.
NoteEnabling this option may cause the object to block objects behind it.
Depth Test
If you enable this option, the widget checks the front-to-back position of the animation relative to other 3D objects. This ensures correct object occlusion in the 3D scene. If you disable this option, the position is not checked, which reduces performance overhead.
NoteEnabling this option may cause the object to be blocked by objects behind it.
Scaling
Drag the slider to set the size of the sequence frame animation. The value ranges from 0.01 to 1000.
Height Offset
Drag the slider to set the height difference between the sequence frame animation and the ground. The value ranges from -2000 to 8000.
Graphics: Graphics configuration parameters.
Parameter
Description
Sequence Frame Image
In the Sequence Frame Image area, customize the sequence frame image.
Move the mouse pointer over the image and click Delete to delete the current image. Then, click the image area or drag a local image into the area to add a texture map.
Move the mouse pointer over the image and click Change to re-upload a local image.
You can also enter the URL of a composite sequence frame image to use an image from a remote server.
Opacity Coefficient
Drag the slider to set the opacity coefficient of the sequence frame animation. The value ranges from 0.1 to 1.
Frame Count Settings
Set the number of frames for the sequence frame animation.
Horizontal Frames: Drag the slider to set the number of horizontal frames. The value ranges from 2 to 20.
Vertical Frames: Drag the slider to set the number of vertical frames. The value ranges from 2 to 20.
Frame Rate Coefficient: Drag the slider to set the frame rate coefficient. A larger value results in a faster animation. The value ranges from 0.01 to 2.
Data panel
Field |
Description |
lng |
The longitude where the sequence frame animation is located. |
lat |
The latitude where the sequence frame animation is located. |
altitude |
The altitude of the sequence frame animation. |
value |
The size value of the sequence frame animation. |
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.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 interactions
On the Scene Editor page, click the
icon to the right of Sequence Animation in the layer list on the left.Click the
icon in the upper-left corner of the page.On the Blueprint Editor page, click the Sequence Frame Animation layer in the import node bar. The configuration parameters for the layer appear on the canvas, as shown in the following figure.
Events
Event
Description
When a data API request is complete
This event is triggered after a 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 section on the Data tab of the configuration panel on the right side of the canvas editor.
Rendering Complete
This event is triggered when the sequence frame animation is rendered. The event returns object data.
Actions
Action
Description
Request data API
This action requests server-side data again, using data from input data processing nodes or layer nodes as parameters. For example, if a sequence animation has an API data source set to
https://api.test, and the data passed to the Request data API action is{ id: '1'}, the final request URL ishttps://api.test?id=1.Import data API
Processes data in the format required by the component, 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 in the component configuration panel on the right of the canvas editor.
Show component
Shows the component. No parameters are required.
Hide component
Hides the component. No parameters are required.