Property Panel General Parameters

The Element Property Panel is located on the right side of the editor interface. It is used to view and edit various property parameters of the currently selected element.

Following a “What You See Is What You Get” approach, this panel allows users to precisely control the spatial state, visual appearance, and interactive information of scene elements.

This chapter focuses on the universal basic parameters applicable to all elements. Whether it is a model, annotation, light, or any other scene object, these parameters can be used for unified management.


Basic Information

  • Name

    The unique identifier of the element within the scene.

    It is used for identification in the Scene Element List, search, grouping, and scripting. The system automatically generates a default name based on the element type.

    You can enter any string or number in the input field to rename it. It is recommended to maintain consistent naming conventions within the same project.


Spatial Transformation Parameters

  • Position

    Defines the element’s location in the 3D scene coordinate system (X/Y/Z coordinates). Coordinates can be adjusted freely within the canvas range.

  • Rotation

    Controls the rotation angle of the element around the X/Y/Z axes to define its orientation.

    Default value: (0, 0, 0). Some asset library or custom elements may have modified default values.

    Adjustable range: -360° ~ 360°

    Supports continuous rotation values beyond 360°

  • Scale

    Defines the size multiplier of the element along the three axes.

    Default value: 1 (original size)

    Adjustable range: 0.1 ~ unlimite


Appearance & Rendering Parameters

  • Material Type

    Determines the surface rendering model of the element, affecting lighting, reflections, and overall visual effects. After changing the material, you can use the color picker below to adjust the element’s local color.

    Default: Original Material

    Available options:

    • Basic Material

    • Metallic Material

    • Clay Material

    • Glass Material

    • Wireframe Material

  • Opacity

    Controls the transparency level of the element. The lower the value, the more transparent the object becomes.

    Default value: 1 (fully opaque)

    Adjustable range: 0 ~ 1


Lighting & Display Control Parameters

  • Cast Shadow

    Determines whether the object blocks light and casts shadows onto other objects.

    Toggle switch

    Default: Off

  • Receive Shadow

    Determines whether the object’s surface can display shadows cast by other objects. Toggle switch

    Default: Off


Interaction Prompts

  • Show Tip

    Determines whether a floating 2D information label is displayed above the object. Toggle switch Default: Off

  • Tip Height

    Defines the vertical distance between the label and the object’s center point.

    Default value: 1.6

    Adjustable range: 1 ~ 10

  • Tip Color

    The background theme color of the label.

    Default: #FFFFFF

    Adjustable via color picker

  • Line Color

    The color of the guide line connecting the object and the label.

    Default: #000000

    Adjustable via color picker


Built-in Animation

  • Enable Animation

    Determines whether the animation embedded in the element plays automatically. Toggle switch Default: Off

  • Animation Clip

    Select the animation type embedded in the element from the dropdown list. The number of available animation clips depends on the uploaded element.

  • Loop Playback

    Determines whether the embedded animation loops continuously. Toggle switch Default: On

  • Speed

    Controls the playback speed multiplier of the embedded animation. Default: 1x

    Adjustable range: 0 ~ 5


Extended Parameters

  • Custom Data

    Structured extended information bound to the element. It can be used for:

    • Business system integration

    • Digital twin applications

    • Interactive logic

    • Data linkage

    Users must define the default values and data types.


Preset Parameters

Used to predefine “custom fields available for elements” at the editor level, enabling standardized data entry and reuse across different scenes or element instances. Through the 【Editor Configuration → Field Presets】 page, users can configure a unified and reusable field template for different element types. When selecting elements later, users can directly fill in these preset fields without redefining them.

1

Supported Element Types

  • Basic geometry (Cube / Cylinder / Sphere, etc.)

  • Directional Light / Point Light / Spot Light

  • Text / 3D Text

  • Line / Tube / Shape

  • Asset Library Model / Customer Model

  • Icon / Image / SVG Shape

Field configurations are independent between different element types, allowing flexible adaptation to diverse business requirements.

2

Field Configuration Details

  • Key: The unique identifier of the field, used for program recognition and data integration.

  • Name: The user-friendly display name of the field shown in the Property Panel.

  • Type: The data type of the field. Supported types: String, Number, Boolean

  • Default Value: The initial value automatically filled when creating a new element.

circle-info

Reference Scenario Example

In an IT server room scene where multiple servers need to be configured:

  • In the Preset Fields section, add a field for the External Model type:

    • Field Name: Serial Number

    • Type: String

  • Add another field:

    • Field Name: Power Consumption

    • Type: Number

    • Default Value: 300

    Afterward, whenever you drag any server model into the editor, the Preset Fields card in the right-side Property Panel will automatically display the “Serial Number” and “Power Consumption” input fields.

    You can directly input values or bind them to a real-time monitoring API for live data integration.

Last updated