> For the complete documentation index, see [llms.txt](https://docs.icraft.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.icraft.design/editor-features/property-panel/property-panel-general-parameters.md). # 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. {% stepper %} {% step %} #### 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. {% endstep %} {% step %} #### 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. {% endstep %} {% endstepper %}
{% hint style="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. {% endhint %}
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.icraft.design/editor-features/property-panel/property-panel-general-parameters.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.