Detailed model
The detailed model is the base layer of the 3D City Builder. It supports independent style and data configurations, such as shadow settings and animation effects. This topic describes the configuration items for the detailed model.
In the layer list of the scene editor, click the Detailed model layer to open the configuration panel. You can then set the style and data for the Detailed model layer.
If the Fine Model is not in the layer list, it means the Fine Model layer has not been added. For more information, see Add a sub-widget.
Style panel
General: Set the general configuration parameters for the detailed model.
Parameter
Description
Shadow settings
Turn on the switch to enable shadows for the detailed model. Turn off the switch to disable shadows.
Depth test
Turn on the switch to enable depth testing for the detailed model. Turn off the switch to disable depth testing.
NoteIf you enable depth testing, the object may be blocked by objects behind it.
Show wireframe
Turn on the switch to show the wireframe for the detailed model. Turn off the switch to hide the wireframe.
Opacity
Drag the slider to adjust the opacity of the detailed model. The value ranges from 0 to 1. A larger value indicates that the model is more opaque.
Height offset
Drag the slider to adjust the height offset of the detailed model. The value ranges from -300 to 5000.
Light effect settings
Drag the slider to adjust the emission intensity of the detailed model. The value ranges from 0 to 1. A larger value makes the color of the emission map more visible.
Animation: Set the animation style for the detailed model.
Parameter
Description
Autoplay
Turn on the switch to enable animation playback for the detailed model. Turn off the switch to disable animation playback.
Loop mode
Set the loop mode for the animation. Options include Repeat playback, Play once, and Reverse playback.
Animation speed
Drag the slider to adjust the animation playback speed. The value ranges from -1.5 to 1.5.
Scanlight animation
The scanlight animation style for the detailed model. Click the
icon to show or hide the scanlight animation style. Front type: The type of the scanlight front. Options are Plane and Curved surface.
Scan axis: The axis for the scanlight animation. Options are X-axis, Y-axis, and Z-axis.
Direction: The direction of the scanlight animation. You can select Forward or Backward.
Color: The color of the scanlight animation.
Scanlight length: Drag the slider to set the length of the scanlight animation. The value ranges from 0.01 to 1.
Scanlight speed: Drag the slider to set the speed of the scanlight animation. The value ranges from 0 to 0.05.
Interaction: Set the interaction style for the detailed model.
Parameter
Description
Mouse interaction
Turn on the switch to enable mouse interaction. Turn off the switch to disable mouse interaction.
Clickable area
Set the area of the detailed model that responds to clicks. Options are Partial and Entire.
Click color
The color that appears when you click the detailed model.
Data panel
Reselect data: Click Reselect data at the bottom of the data panel to open the Select Range dialog box. You can then reselect the data range for the detailed model layer. For more information about selecting a scene range, see Create a scene using official base data.
Refresh data: If changes to the data in Spatial Build are not reflected in the detailed model widget, click Refresh data at the bottom of the data panel to refresh the data.
Blueprint interaction
On the scene editor page, in the layer list on the left, click the
icon next to Detailed model.Click the
icon in the upper-left corner of the page.On the blueprint editor configuration page, click the Detailed model layer in the imported nodes pane. The blueprint editor configuration parameters for the detailed model appear on the canvas, as shown in the following figure.
Events
Event
Description
When a data request is complete
An event that is triggered after the data API request returns a response and the response is processed by a filter. The event also returns 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
An event that is triggered when you left-click the model. The event returns data of the object type.
Right-click the Model
An event that is triggered when you right-click the model. The event returns data of the object type.
Model Loaded
An event that is triggered when the model is loaded. The event returns data of the object type.
Actions
Action
Description
Request data from API
Sends a new request for server-side data. 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 detailed model is set to
https://api.testand the data passed to the Request data from API action is{ id: '1'}, the final request URL ishttps://api.test?id=1.Data Import Interface
After the data is processed into the component's format, you can import and redraw the component without requesting server-side data again. For data examples, see the Data Response area on the Data tab of the configuration panel, located to the right 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.
Scanlight animation
Updates the scanlight animation configuration. The action receives data of the object type. The following code provides an example.
{ "enable": false, // Specifies whether to enable the scanlight animation. Default value: false. "frontier": 1, // The front type. Default value: 1. "axisType": 1, // The scan axis. Default value: 1. "direction": 1, // The scan direction. Default value: 1. "color": "#6699ff",// The color of the scanlight. "length": 0.05, // The length of the scanlight. "speed": 0.05 // The speed of the scanlight. }