Detailed model

Updated at:

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.

Note

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.

    Note

    If 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

  1. On the scene editor page, in the layer list on the left, click the Export to Blueprint Editor icon next to Detailed model.

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

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