The Multi-point Model is a layer in 3D City Builder used to create models. It supports independent style configurations for multi-point models, including general, graphic, animation, and interaction styles. This topic describes the configuration items for the Multi-point Model layer.
In the layer list on the left side of the scene editor, click the Multi-point Model layer to configure the style and data of the Multi-point Model in the configuration panel.
If the Multi-point Model is not in the layer list, you need to add the Multi-point Model layer. To do so, see Add a Sub-widget.
Style panel
Avoid adding multiple Multi-point Model layers. This can cause high performance overhead, leading to page stuttering or slow loading.
-
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
Parameter
Description
Shade Settings
Turn on this switch to enable shade effects for the models loaded by the layer. Turn off this switch to disable shade effects.
Depth Test
Turn on this switch to enable depth testing for the models loaded by the layer. Turn off this switch to disable depth testing.
NoteIf depth testing is enabled, the object may be occluded by more distant objects.
Show Wireframe
Turn on this switch to show the wireframes of the models loaded by the layer. Turn off this switch to hide the wireframes.
Opacity
Sets the opacity coefficient for the models loaded by the layer. The value ranges from 0 to 1.
Height Offset
The offset value of the model's height from the ground plane. The value ranges from -300 to 5000.
Glow Effect Settings
Drag the slider to set the glow intensity for the models loaded by the layer. The value ranges from 0 to 1.
Graphics
Parameter
Description
Model URL
Sets the URL of the model to load.
Rotation
Drag the sliders to set the rotation angle of the model on the x-axis, y-axis, and z-axis.
Scaling
Drag the sliders to set the scaling value of the model on the x-axis, y-axis, and z-axis.
Animation
Parameter
Description
Model Animation
Sets the animation style for the model.
Autoplay: Turn on this switch to start animation playback. Turn off this switch to stop animation playback.
Loop Mode: Sets the loop mode for the animation playback. Options include Repeat Playback, Single Playback, and Reverse Playback.
Animation Speed: Drag the slider to set the animation speed for the model. The value ranges from -1.5 to 1.5.
Loop Mode
Sets the loop mode for the model animation playback. Options include Repeat Playback, Single Playback, and Reverse Playback.
Animation Speed
Drag the slider to set the animation speed for the model. The value ranges from -1.5 to 1.5.
Interaction: Configure the interaction style for the multi-point model.
Parameter
Description
Mouse Interaction
Turn on this switch to enable interaction using the mouse. Turn off this switch to disable mouse interaction.
Clickable Area
Sets the clickable area for the model. Options include Partial and Entire.
Click Color
The color of the object when you click the model.
Data panel
Field |
Description |
id |
The ID of the multi-point model. |
lng |
The longitude coordinate for the loaded model. |
lat |
Dimensional coordinates for loading a multi-point model. |
altitude |
The altitude for the loaded model. |
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 interaction
In the layer list of the scene editor, click the
icon next to Multi-point Model.Click the
icon in the upper-left corner of the page.On the Blueprint Editor configuration page, click the Multi-point Model layer in the imported nodes bar. The configuration parameters for the layer appear on the canvas, as shown in the following figure.
Events
Event
Description
When model point data request is complete
This event is triggered after the model point data request returns and the data is processed by a filter. The event also outputs the processed data in JSON format. For a data example, see the Data Response area on the Data tab of the widget's configuration panel in the canvas editor.
Left-click the Model
This event is triggered when the model is left-clicked. It outputs the clicked object, object name, and object instance ID.
Right-click the model
This event is triggered when the model is right-clicked. It outputs the clicked object, object name, and object instance ID.
Model Loaded
This event is triggered when the model is finished loading. It outputs data of the object type.
Actions
Action
Description
Request model point data
Requests data from the server again. 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 Multi-point Model layer is set to
http://api.testand the data passed to the Request Data API action is{ id: '1'}, the final requested API ishttps://api.test?id=1.Import model point data
Processes the data in the widget's drawing format and then imports it to the widget to be redrawn. This does not require another request to the server. For a data example, see the Data Response area on the Data tab of the widget's configuration panel in the canvas editor.
Update Configuration
Updates the model configuration. The action receives input data of the object type.
Update Data
Updates the model data. The action receives input data of the object type.
Destroy Widget
Destroys the widget. No parameters are required.
Show Widget
Shows the widget. No parameters are required.
Hide Widget
Hides the widget. No parameters are required.
icon next to Multi-point Model.
icon in the upper-left corner of the page.