# Import of Resources

# Manage Imports

#### Manage Imports

The **Scene Composer Solution Explorer** enables users to manage and organize all files associated with a solution. Imported resources can be arranged into folders based on user requirements, and this folder structure is linked to the directory structure stored locally on the system.

<p class="callout info">For additional details on managing solutions using folders, refer to <span style="color:rgb(230,126,35);">[here](https://doc3161en.candera.eu/books/solution-handling/page/organize-a-solution-using-folders)</span>.</p>

The folder organization of imported resources can be modified directly within the **Solution Explorer** panel. In addition, some **imported** assets may also appear in the **Imports** panel.

#### Original Image File Retention

When an image file is imported via  the menu **File &gt; Import &gt; Import Resources**, Scene Composer retains both the original image file and the associated bitmap information file (**\*.bin**), which is used internally by the application.

<p class="callout info">Original image files are **not** retained when importing formats such as **FBX** or **glTF**, nor when resources are imported using the **Smart Importer**.  
</p>

##### Original Image File Name  


The name of an imported image is constructed as follows:

- **the image information name + the original image file extension**

The name of the original image file is displayed in the **Original Image** section of the **Properties** panel for the imported resource.

If the resource file name is modified in the  **Solution Explorer**, the corresponding original image file name is automatically updated as well.

<div drawio-diagram="6826"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-4-1726708047.png" alt="drawing-4-1726708047.png"/></div>

##### Original Image File Location  


The **Solution Explorer** displays only the bitmap information file (**\*.bin**), the original image file is retained in the local **Solution** folder. This folder mirrors the directory structure shown in the **Solution Explorer**.

Here is how to easily view the local file system location of a resource:

1. In **Solution Explorer**, select the resource.
2. Right-click the selected resource. 
    - The context menu is opened as shown in the figure below. <div drawio-diagram="6825"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-4-1726707944.png" alt="drawing-4-1726707944.png"/></div>
3. In the context menu, select **Open In File System**. 
    - Windows Explorer is opened, displaying the folder that contains both the **bitmap information files** and their **corresponding original image files** (see figure below).

<div drawio-diagram="6827"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-4-1726708917.png" alt="drawing-4-1726708917.png"/></div>

##### Moving Original Image Files  


When an imported resource is moved from one folder to the other within the **Solution Explorer**, its original image file is moved together with the corresponding locally stored bitmap information file.

#### Imports Panel

The **Imports** panel can be displayed or hidden via the menu option **View &gt; Libraries &gt; Imports**. This panel presents imported resources in a hierarchical structure. Resources listed in this panel can be added to the scene - either in the **Scene Editor** or the **Scene Tree Panel** - by using drag-and-drop operations.

<div drawio-diagram="5921"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717167173.png" alt="drawing-5-1717167173.png"/></div>

#### Properties of Imported Resources

When an imported resource is selected in either the **Solution Explorer** or the **Imports** panel, its properties are shown in the **Properties** panel. By default, this panel is located in the lower-right area of the interface and provides detailed Information about the currently selected resource.

<div drawio-diagram="5922"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717167248.png" alt="drawing-5-1717167248.png"/></div>



#### Clone, Delete and Rename Items

Imported resources can be **cloned, renamed** or **deleted** within the Solution **Explorer** panel. To perform these actions, right-click the desired item in the Solution Explorer and select the appropriate option from the context menu.

Additionally, you can right-click a folder containing imported files to **delete multiple resources** at once.

For more information, see the <span style="color:rgb(230,126,35);">[Context Menu](https://doc3161en.candera.eu/link/46#bkmrk-copy%2C-clone%2C-rename-) <span style="color:rgb(0,0,0);">section of the Solution Explorer documentation</span></span>.

#### Delete Unused Imports  


If a solution contains unused imports or import components, they can be removed to clean up the project by using the **Delete Unused Imports...** command. This command is available from the following locations:

<div class="contents" id="bkmrk-import-menu-solution"><div class="contents"><div class="textblock">

- **Import** menu
- **Solution Explorer**
- **Imports** panel

</div></div></div><div drawio-diagram="6870"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-4-1727160497.png" alt="drawing-4-1727160497.png"/></div>

The **Delete Unused Imports** dialog displays all imports included in the solution, allowing you to review and remove those that are no longer referenced or required.

Imports currently in use - and therefore not eligible for deletion- are displayed in a disabled (greyed out) state. You can toggle the visibility of these non-deletable items using the **Filter** button located in the upper-right corner of the dialog.

<div drawio-diagram="5929"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717168584.png" alt="drawing-5-1717168584.png"/></div>

To delete unused imports, select the checkboxes next to the items you want to remove and click **Delete**.

Import items that can be identified and removed as unused include:

- Images
- Raw resources
- Fonts
- Fragment shaders
- Vertex shaders
- 3D model files
- Scripts

<div class="contents" id="bkmrk-the-only-imports-whi"><div class="contents"><div class="textblock"><dl class="note"><dt></dt><dd></dd></dl>  
</div></div></div><p class="callout info">If an import folder contains additional files or folders that are not part of the imported resources, the folder itself is not deleted. Only the unused imported files within that folder are removed.</p>

#### Export Imported Images

Imported images can be exported from the solution as **.png** files. This option is available in the context menu when right-clicking an imported image. The export operation also supports **multiple selection**, allowing multiple image resources to be exported at once.

<p class="callout info">An imported image can be exported **even if** it is in a **locked** state.</p>

<div class="contents" id="bkmrk-the-image-can-be-exp"><div class="contents"><div class="textblock">This export operation is available in several areas of the application:</div></div></div><div class="contents" id="bkmrk-solution-explorer-im"><div class="contents"><div class="textblock">

- **Solution Explorer**
- **Imports** panel
- **Canvas Node**
- **Canvas sprite**
- **Billboard**

</div></div></div>To export an imported image as a **.png** file:

1. Select the imported image you want to export.
2. Right-click on the selected image. 
    - The context menu is opened (see figure below). <div drawio-diagram="5927"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717168526.png" alt="drawing-5-1717168526.png"/></div>
3. In the context menu, select **Export Image To...**
    - The Windows **Save As** dialog appears.
4. Choose a destination folder and specify a file name, then click **Save**. 
    - The image is exported and saved in **.png** format.

<div class="contents" id="bkmrk-currently%2C-the-origi"><div class="textblock"><div class="contents" id="bkmrk--9"><div class="contents">  
</div></div><div class="contents"><div class="contents"><div class="textblock"><dl class="note"><dt></dt><dd><p class="callout info">Currently, the export operation outputs the **original image file** rather than the processed asset version.</p>

</dd></dl></div></div></div></div></div>#### Edit an Imported Script Resource

Scripts can be imported via the menu using **Import &gt; Import Resources...** By default, imported script files are **read-only**; however, they can be converted to an editable format if modifications are required.

To make an imported scripts editable:

1. In the **Solution Explorer**, select the script resource.
2. Right-click the script and choose **Change to Editable** from the context menu.

<div class="contents" id="bkmrk--13"><div class="textblock"><div class="contents"><div class="textblock"><div drawio-diagram="5926"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717168517.png" alt="drawing-5-1717168517.png"/></div>

<div class="contents" id="bkmrk--16"><div class="contents"><div class="textblock">  
</div></div></div><dl class="note"></dl></div></div></div></div><p class="callout info">For instructions on working with script resources, refer to the <span style="color:rgb(230,126,35);">[Scripting](https://doc3161en.candera.eu/books/scripting)</span> documentation.</p>

# Import Dialog Options

This section describes the configuration of the **Import** dialog that appears when importing resources such as FBX files, images, shaders, fonts, or scripts.

<p class="callout info">The available options within the dialog may vary depending on the type of asset being imported.</p>

#### Import Dialog

<div class="textblock" id="bkmrk-"><div drawio-diagram="9018"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-5-1780046106.png" alt="drawing-5-1780046106.png"/></div>

</div><div class="textblock" id="bkmrk--0"></div><table class="align-center" id="bkmrk-%281%29-%E3%82%A4%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%88%E5%AF%BE%E8%B1%A1%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%A8%E3%81%97%E3%81%A6%E6%8C%87%E5%AE%9A" style="border-collapse:collapse;width:800px;height:1336.65px;border-width:1px;"><tbody><tr style="height:147.2px;"><td style="width:61.2656px;height:147.2px;border-width:1px;">1</td><td class="align-left" style="width:737.734px;height:147.2px;border-width:1px;">**Comparison:**

Resources at the import destination are compared with those included in the current import, and the resulting update status is displayed. The import status is indicated by icons and tooltips in the **Status** column and is also reflected by the font color of each resource name in the **After Import** column.

**Green:** A new resource will be added.  
**Yellow:** A resource with the same name exists, but its properties differ.  
**No highlight:** A matching resource already exists with identical properties, or the resource is not included in the current import.

</td></tr><tr style="height:63.2px;"><td style="width:61.2656px;height:63.2px;border-width:1px;">2</td><td class="align-left" style="width:737.734px;height:63.2px;border-width:1px;">**Save Report…:**

Generates and saves a report file (CVS format) summarizing the comparison results for the imported files. The report name and save location can be specified in the dialog that appears when this button is clicked.

</td></tr><tr style="height:46.4px;"><td style="width:61.2656px;height:46.4px;border-width:1px;">3</td><td class="align-left" style="width:737.734px;height:46.4px;border-width:1px;">**Select Files…:**

Opens a dialog that allows you to choose the items to be imported into the solution.

</td></tr><tr style="height:79.8667px;"><td style="width:61.2656px;height:79.8667px;border-width:1px;">4</td><td class="align-left" style="width:737.734px;height:79.8667px;border-width:1px;">**Folder:**

Select the destination folder for imported files. Use the drop-down menu or the **Browse** button to select any location in the Solution Explorer as root folder for the import destination. By default, the root folder **/Resources** is selected.

</td></tr><tr style="height:63.2px;"><td style="width:61.2656px;border-width:1px;height:63.2px;">5</td><td style="width:737.734px;border-width:1px;height:63.2px;">**Create new folder for import:**

Enable this option to create a new subfolder within the selected destination specified in (4) **Folder**. Enter the name of the new subfolder in the provided input field.

</td></tr><tr style="height:46.4px;"><td style="width:61.2656px;height:46.4px;border-width:1px;">6</td><td class="align-left" style="width:737.734px;height:46.4px;border-width:1px;">**Delete existing items in destination folder:**

When enabled, all existing content in the destination folder is deleted before the import operation is performed.

</td></tr><tr style="height:96.8px;"><td style="width:61.2656px;height:96.8px;border-width:1px;">7</td><td class="align-left" style="width:737.734px;height:96.8px;border-width:1px;">**Preserve imported folder structure:**

This option is available only when importing **Image** or **3D model** file types, and it can be enabled only if **Delete existing items in destination folder** is active. When selected, all existing files in the destination folder are removed while retaining the existing folder structure.

<span style="color:rgb(224,62,45);">\*Note: This option is not available when importing **Font** or **Shader** file types.</span>

</td></tr><tr style="height:46.4px;"><td style="width:61.2656px;border-width:1px;height:46.4px;">8</td><td style="width:737.734px;border-width:1px;height:46.4px;">**Visible in imports panel:**

When enabled, imported items are displayed in both the **Imports** panel and the **Solution Explorer**.

</td></tr><tr style="height:180.667px;"><td style="width:61.2656px;border-width:1px;height:180.667px;">9</td><td style="width:737.734px;border-width:1px;height:180.667px;">**<span style="vertical-align:inherit;"><span style="vertical-align:inherit;">Preserve library item attributes:</span></span>**

This option allows you to retain specific item attributes during a re-import operation. When enabled, previously assigned attributes remain unchanged, even if newly imported data contains different values.

Attributes that can be preserved include:

**- Bitmap properties:** Converter, Target format, Origin

**- Vertex buffer properties:** Buffer type, enable cache, position, normal, texture coordinate, tangent, bi normal etc.

When preservation is applied, the re-import process does not overwrite these properties, regardless of the differences in the incoming data.

</td></tr><tr style="height:135.867px;"><td style="width:61.2656px;height:135.867px;border-width:1px;">10</td><td class="align-left" style="width:737.734px;height:135.867px;border-width:1px;">**Set bitmap profile:**

Specifies a default bitmap profile applied to all bitmaps that do not have an explicitly assigned profile. This option is available when importing **Images, FBX,** and **glTF** files.

Bitmap profiles can be configured in the following ways:

\- From the menu bar: **Solution &gt; <span style="color:rgb(230,126,35);">[Solution Options...](https://doc3161en.candera.eu/books/solution-handling/page/bitmap-profile)</span>**

\- From the **Properties** panel, which appears when selecting the target resource in the **Solution Explorer**.

</td></tr><tr style="height:85.6px;"><td style="width:61.2656px;border-width:1px;height:85.6px;">11</td><td style="width:737.734px;border-width:1px;height:85.6px;">**Import as wireframe:**

This option is available only when importing FBX files. When enabled, a wireframe vertex buffer is generated based on the triangles and rectangles defined in the FBX file. Both the standard vertex buffer and the  wireframe vertex buffer are then registered under **<span style="color:rgb(230,126,35);">[Associated Vertex Buffer](https://doc3161en.candera.eu/books/solution-handling/page/associated-vertex-buffer)</span>** in the Solution Options.

</td></tr><tr style="height:72.8px;"><td style="width:61.2656px;border-width:1px;height:72.8px;">12</td><td style="width:737.734px;border-width:1px;height:72.8px;">**Set the "Is Indexed" property of the vertex buffer to enabled:**

This option is available only when importing FBX files and is enabled by default.  
When selected, the buffer type is converted to an **index array**, allowing Scene Composer to automatically determine and apply the appropriate index size. If disabled, the buffer type is set to a **regular array** instead.

</td></tr><tr style="height:46.4px;"><td style="width:61.2656px;height:46.4px;border-width:1px;">13</td><td class="align-left" style="width:737.734px;height:46.4px;border-width:1px;">**OK button:**

Imports the selected resources using the configured settings.

</td></tr><tr style="height:46.4px;"><td style="width:61.2656px;height:46.4px;border-width:1px;">14</td><td class="align-left" style="width:737.734px;height:46.4px;border-width:1px;">**Cancel button:**

Closes the dialog without performing the import operation.

</td></tr><tr style="height:179.45px;"><td style="width:61.2656px;border-width:1px;height:179.45px;">15</td><td style="width:737.734px;border-width:1px;height:179.45px;">**Radiance HDR Format:**  
This option is displayed only when the import selection contains Radiance HDR (.hdr) files. The default value follows the format configured in Solution Options &gt; <span style="color:rgb(230,126,35);">[Import Images Config](https://doc3161en.candera.eu/books/solution-handling/page/import-images-config)</span>.

Available formats include:

- RgbFloatingPoint9E5PixelFormat
- RgbFloatPixelFormat
- RgbHalfFloatPixelFormat
- RgbaFloatPixelFormat
- RgbaHalfFloatPixelFormat

</td></tr></tbody></table>

<p class="callout info">In an OpenGL ES 2.0 environment, none of the available Radiance HDR Format options (RgbFloatingPoint9E5PixelFormat / RgbFloatPixelFormat / RgbHalfFloatPixelFormat / RgbaFloatPixelFormat / RgbaHalfFloatPixelFormat) are supported. If any of these formats are present in the solution, a warning is displayed in the <span style="color:rgb(230,126,35);">[Problems panel](https://doc3161en.candera.eu/books/solution-handling/page/problems-browser)</span>.</p>

#### SVG Importer Dialog

<div drawio-diagram="9019"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-5-1780046153.png" alt="drawing-5-1780046153.png"/></div>

<table class="align-center" id="bkmrk-%281%29-import-settings-" style="border-collapse:collapse;width:800px;height:290px;border-width:1px;"><tbody><tr style="height:29px;"><td style="width:61.2812px;height:29px;border-width:1px;">(1)</td><td class="align-left" style="width:737.719px;height:29px;border-width:1px;">**Import Settings**

**Import to folder:**

Specifies the destination folder in the **Solution Explorer** where the SVG file will be imported.

**Create new folder for import**

Enables the creation of a new subfolder within the selected destination. Enter the name of the new subfolder in the input field provided.

**Importing List**

Displays the items selected for import.

\- Items that cannot be imported are indicated with an **error icon**.

\- Items that can only be partially imported are indicated with a **warning icon**

<p class="callout info">Even if no icon is displayed, certain elements may still fail to load due to their content or structure.</p>

</td></tr><tr style="height:29px;"><td style="width:61.2812px;height:29px;border-width:1px;">(2)</td><td class="align-left" style="width:737.719px;height:29px;border-width:1px;">**Add/Delete:**

**Add:** Adds an additional SVG file to the list of items to be imported.  
**Delete**: Removes the selected SVG file from the import list.

</td></tr><tr style="height:29px;"><td style="width:61.2812px;height:29px;border-width:1px;">(3)</td><td class="align-left" style="width:737.719px;height:29px;border-width:1px;">**Preview Display:**

**Left-side:** Displays the original SVG image selected from the **Importing List**  
**Right-side:** Shows a preview of how the selected SVG image will appear after being imported into Scene Composer.

<p class="callout warning">In the current version of Scene Composer, the previewed size may not always match the original dimensions of the original SVG image.</p>

</td></tr><tr style="height:29px;"><td style="width:61.2812px;height:29px;border-width:1px;">(4)</td><td class="align-left" style="width:737.719px;height:29px;border-width:1px;">**Error Message:**

Displays any warnings or errors associated with the selected file.

</td></tr><tr><td style="width:61.2812px;border-width:1px;">(5)</td><td style="width:737.719px;border-width:1px;">**Import/Cancel:**

**Import:** Imports all items listed in the **Importing List.**  
**Cancel:** Cancels the import operation without importing any items.

</td></tr></tbody></table>

<div class="contents" id="bkmrk-this-feature-can-be-"><div class="contents"><div class="textblock"><dl class="note"><dt></dt><dd></dd></dl>  
</div></div></div><div drawio-diagram="3356"></div>

# How to Import Resources

This section describes how to import resources by selecting **Import Resources...** from the **Import** menu on the menu bar.

<div drawio-diagram="6871"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-4-1727160599.png" alt="drawing-4-1727160599.png"/></div>

#### Import File Formats

You can import the following file formats using this menu:

- Image files (`*.bmp, *.jpg, *.jpeg, *.gif, *.tga, *.png, *.dds, *.ktx, *.hdr, *.exr`)
- Font files (`*.ttf, *.ttc,*.otf, *.fnt, *.fbm, *.*`)
- Shader files (`*.vert, *.frag`)
- SVG files (`*.svg`)
- FBX files (`*.fbx`)
- glTF files (`*.gltf, *.glb`)
- Icon files (`*.bmp, *.ico, *.jpg, *.png`)
- Script files (`*.lua`)

Beside the formats listed above, Scene Composer also supports importing Photoshop (\*.psd) and Adobe XD (\*.xd) files. For more details on importing these formats, see the <span style="color:rgb(230,126,35);">[Smart Importer](https://doc3161en.candera.eu/books/import-of-resources/chapter/smart-importer "Smart Importer") <span style="color:rgb(0,0,0);">chapter</span></span>.

<p class="callout info">When importing **font files**, the application recognizes and imports them as fonts, regardless of their file extensions. For more information, see the explanation <span style="color:rgb(230,126,35);">[here](#bkmrk-image%2C-font%2C-shader%2C)</span>.</p>

<p class="callout info">Beginning with CGI 3.14, Scene Composer can play back <span style="color:rgb(230,126,35);">[skinning](https://doc3161en.candera.eu/books/import-of-resources/page/skinning)</span> animations after you import skinning-enabled FBX or glTF files.</p>

<details id="bkmrk-gltf-file-format-sce"><summary>About .glTF File Format</summary>

SceneComposer supports the following glTF file formats during import:

<div class="contents" id="bkmrk-gltf%3A-this-points-to"><div class="contents"><div class="textblock">

- **glTF:** References external binary data (geometry, animation keyframes, skinning data), and image files.
- **glTF-Embedded:** Contains base64-encoded binary data, and images embedded inline using data URIs.
- **glTF-Binary:** Packages the entire glTF asset (JSON description, .bin binary data, and images) into a single binary file.

</div></div></div><p class="callout info">For more detailed information on these file formats, see the Khronos website: <span style="color:rgb(230,126,35);">[GLB File Format Specification](https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#glb-file-format-specification).</span></p>

</details><details id="bkmrk-about-.ktx-file-form"><summary>About .ktx File Format</summary>

Scene Composer supports the following compressed image formats:

<div class="contents" id="bkmrk-etc2compressedrgbfor"><div class="contents"><div class="textblock">

- Etc2CompressedRgbFormat
- Etc2CompressedSrgbFormat
- Etc2Alpha1CompressedRgbaFormat
- Etc2Alpha1CompressedSrgbaFormat
- Etc2EacCompressedRgbaFormat
- Etc2EacCompressedSrgbaFormat

</div></div></div>To use these formats, you have to convert the source image from a supported image type (such as .tga, .gif, .psd, .bmp, .pgm, .png etc.) into a *.ktx* file. You can use the following tools to create KTX files:

<div class="contents" id="bkmrk-texgenpack-mali-text"><div class="contents"><div class="textblock">

- Texgenpack
- Mali Texture Compression Tool
- Ericsson Texture Compression Tool

</div></div></div>These tools compress texture images using Ericsson Texture Compression (ETC/ETC2) and Adaptive Scalable Texture Compression (ASTC). They supports the following output formats:

- **.pkm** - Contains compressed textures
- **.ktx** – Stores a 2D texture along with all associated mipmap levels.

After conversion, you can import the *.ktx* file into Scene Composer following the same process as for other image formats.

<div class="contents" id="bkmrk-in-the-case-of-a-con"><div class="contents"><div class="textblock"><dl class="note"><dt></dt><dd><p class="callout info">When importing a converted .**ktx** file into Scene Composer, you **cannot** use the **DefaultBitmapConverter** property that is  available for standard *.bmp* images.</p>

</dd></dl></div></div></div></details><details id="bkmrk-about-bitmap-font-bi"><summary>About Bitmap Font</summary>

Scene Composer supports the use of bitmap fonts. To enable the bitmap font functionality, you must compile the *SCHost.dll* using the **BitmapFont** engine. Note that only one font engine can be active at a time within an instance of SCHost.dll.

The following file types can be imported as bitmap fonts:

<div class="contents" id="bkmrk-.fnt-%28windows-font-f"><div class="contents"><div class="textblock">

- **.fnt** - Scene Composer converts these Windows font files to bitmap fonts.
- **.fbm** - Pre-converted bitmap font files

</div></div></div>When you import a font, Scene Composer sets the following property:

<div class="contents"><div class="contents"><div class="contents"><div class="contents"><div class="textblock">

- **Source file names** - Indicates the name of the imported file, helping you identify a font

</div></div></div></div></div><div drawio-diagram="5936"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717170340.png" alt="drawing-5-1717170340.png"/></div>

</details><p class="callout warning">On OpenGL ES1.1 platforms, such as Traveo2, importing shader files, SVG files, FBX files, and glTF files is not supported.</p>

---

#### Import Operation

Open the Import Dialog in one of the following three ways.

##### Menu Bar

Select **Import &gt; Import Resources...** from the menu bar.

<div drawio-diagram="6872"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-4-1727160619.png" alt="drawing-4-1727160619.png"/></div>

##### Context menu

Right-click on any folder in Solution Explorer and select **Import &gt; Resources...** from the context menu.

<div drawio-diagram="5935"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717170156.png" alt="drawing-5-1717170156.png"/></div>

##### Drag and Drop

Drag and drop the target file that you want to import into any folder under **Solution** in Solution Explorer.

<div drawio-diagram="5938"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717170521.png" alt="drawing-5-1717170521.png"/></div>

- - You can also import a glTF file by drag and drop to any folder under **Solution** in Solution Explorer.
    - Note that in an OpenGLES1.1 environment, you cannot import shader files (\*.vert, \*.frag), SVG files (\*.svg), FBX files, and glTF files via drag and drop.
    - When you drag an image file format (\*.bmp, \*.jpg, \*.png) that Scene Composer can import as an icon into any folder under **Solution** in Solution Explorer, a dialog box appears, allowing you to choose whether to import it as an image or icon resource. <div drawio-diagram="4336"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-09/drawing-4-1695617424.png" alt="drawing-4-1695617424.png"/></div>

##### Save Solution

When you start the import process, Scene Composer checks your solution for unsaved changes. If necessary, you are prompted to save your solution. Click OK to proceed. Once the solution is saved, Scene Composer opens the **Import Resources** dialog.

<div drawio-diagram="5939"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717170573.png" alt="drawing-5-1717170573.png"/></div>

To hide this dialog from popping up at future imports, clear the **Always show this dialog** checkbox.

#### Import operations by file format

After you select a file, Scene Composer shows different import operations depending on the file format. See the following topics for detailed import procedures.

- <span style="color:rgb(230,126,35);">[Image, font, shader, FBX, and script file formats](#bkmrk-image%2C-font%2C-shader%2C)</span>
- <span style="color:rgb(230,126,35);">[FBX files with multiple animations](#bkmrk-fbx-files-with-multi-1)</span>
- <span style="color:rgb(230,126,35);">[Icon file format](#bkmrk-%C2%A0-2)</span>
- <span style="color:rgb(230,126,35);">[SVG file format](#bkmrk--21)</span>
- <span style="color:rgb(230,126,35);">[glTF file format](#bkmrk-images%2C-fonts%2C-shade)</span>

##### Image, font, shader, FBX, and script files

<p class="callout info">For importing FBX files that contain skinning, see <span style="color:rgb(230,126,35);">[here](https://doc3161en.candera.eu/books/import-of-resources/page/skinning)</span>.</p>

<p class="callout info">When you import an image file, Scene Composer retains the original image file along with the bitmap information file (\*.bin file) used on Scene Composer. See <span style="color:rgb(230,126,35);">[here](https://doc3161en.candera.eu/link/74#bkmrk-original-image-file-)</span> for details.</p>

1. In the Import Resources dialog, select one or more resource files that you want to import and click OK.
    
    
    - Search for supported file formats by selecting them in the drop-down menu at the bottom right of the Import Resources dialog.
    - Import multiple files at once as long as their file format belong to the same category, such as Image files or a Font files.
    - Select **Font files** from the pull-down menu below, to import any file as a font file, regardless of its extension.  
        <div drawio-diagram="8534"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2025-08/drawing-4-1756260098.png" alt="drawing-4-1756260098.png"/></div>
2. After you selected the files to import, Scene Composer displays an Import dialog for the selected file type (Image, Font, FBX, Shader…).
    
    
    - See **<span style="color:rgb(230,126,35);">[Import Dialog Options](https://doc3161en.candera.eu/link/73#bkmrk-import-dialog "Import Dialog Options")</span>** for a description of the settings on the dialog screen.
    - Select <span style="color:rgb(230,126,35);">[**Import as wireframe**](https://doc3161en.candera.eu/books/import-of-resources/page/import-dialog-options#bkmrk--01)</span> check box to import the wireframe vertex buffer when importing an FBX file.
    - When the import selection contains Radiance HDR (.hdr) files, a Radiance HDR Format option appears in the Import dialog.
    - The available choices and the default value follow the setting made in the <span style="color:rgb(230,126,35);">**[Import Images Config](https://doc3161en.candera.eu/books/solution-handling/page/import-images-config)**</span> panel of Solution Options. See <span style="color:rgb(230,126,35);">**[Import Dialog Options](https://doc3161en.candera.eu/books/import-of-resources/page/import-dialog-options)**</span> for details.
        
        <div drawio-diagram="5940"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717170648.png" alt="drawing-5-1717170648.png"/></div>
3. Configure the import settings, then click OK.
    
    
    - Scene Composer imports the file as a resource in Solution Explorer.
        
        <div drawio-diagram="5941"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717170717.png" alt="drawing-5-1717170717.png"/></div>

<details id="bkmrk-wireframe-related-pr"><summary>Wireframe Related Properties</summary>

When importing an FBX file with the **<span style="color:rgb(230,126,35);">[Import as Wireframe](https://doc3161en.candera.eu/books/import-of-resources/page/import-dialog-options#bkmrk--01)</span>** option enabled, a **Line Width** property is added to the **Mesh** property item of the target node. This property specifies the line width of the mesh when Scene Composer renders it as a wireframe.

- Scene Composer determines the actual line width by rounding the specified width to the nearest integer.
- If the setting is less than “1”, Scene Composer always sets it to “1”.

<div drawio-diagram="6745"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-4-1725634285.png" alt="drawing-4-1725634285.png"/></div>

</details>##### FBX files with multiple animations

Scene Composer supports the import of FBX files that contain multiple animation tracks. Scene Composer automatically creates the names of the imported animation tracks based on the animation tracks contained in the FBX file.

<div drawio-diagram="6963"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1728536029.png" alt="drawing-4-1728536029.png"/></div>

You can import the following types of animations from FBX files:

- Translation
- Rotation
- Scaling

##### Icon files

<p class="callout info">See <span style="color:rgb(230,126,35);">[Icon Picker](https://doc3161en.candera.eu/books/solution-handling/page/icon-picker)</span> for information on how to use imported icon resources.</p>

1. In the Import Resources dialog, select the target file, then click OK.
2. If the selected file format is "\*.ico", Scene Composer displays the **Import Icons** dialog that provides the following options:
    
    
    - The **Selected files** field displays the path to the selected file. To re-select a file, click **Select File...** .
    - In **Destination folder**, specify the location where Scene Composer imports the file as a resource.
    - As explained in the <span style="color:rgb(230,126,35);">[Drag and Drop section](#bkmrk-drag-and-drop)</span>, when you drag and drop an image file (\*.bmp, \*jpg, \*.png) that can be imported as an icon, Scene Composer displays a prompt allowing you to select whether to import it as image or icon.  
          
        <div drawio-diagram="5943"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717170817.png" alt="drawing-5-1717170817.png"/></div>
3. Click OK to complete the import operation.

##### SVG files

1. In the Import Resources dialog, select one or more SVG files that you want to import and click OK.
    
    <div drawio-diagram="4458"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-10/drawing-4-1696552970.png" alt="drawing-4-1696552970.png"/></div>
2. Scene Composer displays the SVG Importer dialog:
    
    
    - See <span style="color:rgb(230,126,35);">[SVG Importer Dialog](https://doc3161en.candera.eu/link/73#bkmrk-%C2%A0-1 "Import Dialog Options")</span> for a description of the settings on the dialog screen.
        
        <div drawio-diagram="4361"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-09/drawing-4-1695790322.png" alt="drawing-4-1695790322.png"/></div>
3. Configure the import settings, then click **Import**..
    
    
    - Scene Composer creates the **ImportedScenes** and **Scenes** folders at the destination folder selected in **Solution Explorer**. The former holds data imported as template scenes, while the latter holds data imported as actual scenes.
    - If you import multiple SVG files, the Scene Editor displays the actual scene that corresponds to the topmost SVG file in the SVG Importer.
        
        
        - Transform &gt; Position &gt; X = 0, Y = 0 is the item's initial position.
    - You can copy group nodes from imported scenes and paste them into your desired scene to use them.
        
        <div drawio-diagram="7569"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-11/drawing-5-1732885221.png" alt="drawing-5-1732885221.png"/></div>

##### glTF files

<p class="callout warning">The CGI Studio glTF Importer does not support the following features:  
  - Morphing  
  - Vertex Buffer Streams  
  - Sparse Accessors  
</p>

<p class="callout info">For additional details on handling glTF files — e.g., supported extensions, multiple UV sets, and limitations — see the <span style="color:rgb(230,126,35);">[glTF file](https://doc3161en.candera.eu/books/import-of-resources/page/gltf-files)</span> page.</p>

<p class="callout info">For importing glTF files that contain skinning, see [here](https://doc3161en.candera.eu/books/import-of-resources/page/skinning).</p>

1. In the Import Resources dialog, select one or more resource files that you want to import, then click OK.
2. Scene Composer displays the **Import GLTF** dialog:
    
    
    - When you check **Import Dynamic Appearance**, Scene Composer imports the file with a dynamic GltfAppearance. When you clear it, Scene Composer imports the file with a static Appearance.
    - When you import the file with a dynamic GltfAppearance, Scene Composer attaches a GltfAppearance to Mesh, SkinningMesh, and SkyBox, and you can edit the glTF 2.0 material properties directly in the Properties panel. For details about each property, see <span style="color:rgb(230,126,35);">[**Properties Overview**](https://doc3161en.candera.eu/books/appendix/page/properties-overview)</span>.
    - When you import the file with a static Appearance, Scene Composer configures the appearance as a combination of shader uniforms and textures. For details, see **Physically Based Shading (PBS)** on the <span style="color:rgb(230,126,35);">[**glTF file**](https://doc3161en.candera.eu/books/import-of-resources/page/gltf-files)</span> page.
    - When you import a glTF file that uses KHR\_materials\_transmission, Scene Composer automatically creates the render targets and cameras that transmission requires. For details, see **Importing Transmissive Materials** on the **glTF file** page.
    - Use the import dialog to configure Image-Based Lighting (IBL). You cannot change these settings after the import.
    - If you do not want to use IBL, clear the **Use Image Based Lighting (IBL)** checkbox.
    - During glTF import, the Engine automatically generates the IBL from a single HDR panorama (latlong) image, so you do not have to set the radiance, irradiance, or BRDF integration textures manually.
    - Configure **HDR Panorama (Latitude/Longitude) Image**, **IBL Cubemap Texture Size**, and **IBL Lookup Texture Size** in the import dialog as necessary. 
        - **IBL cubemap textures size**: Specifies the size of the cubemap texture used for IBL generation. The default value is 256. On ES2.0 platforms, the minimum value is 64 and the size must be a power of two. On ES3.0 platforms, the minimum value is 64.
        - **IBL lookup textures size**: Specifies the size of the lookup texture used for IBL generation. The default value is 256. On ES2.0 platforms, the minimum value is 64 and the size must be a power of two. On ES3.0 platforms, the minimum value is 64.
    - You can also set IBL in **Solution Options**. For details about these settings, see [**IBL HDR**](https://doc3161en.candera.eu/books/solution-handling/page/ibl-hdr). <div drawio-diagram="9212"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-09/drawing-4-1788999660.png" alt="drawing-4-1788999660.png"/></div>
3. After confirming by clicking OK, Scene Composer displays the **Import GLTF** dialog: 
    - You can’t change IBL settings in the import dialog (red box below).
    - When you specify an HDR panorama image and run the import, the Engine automatically assigns the generated shared IBL textures to each mesh (orange box below).
    - The Engine generates the following textures: **LambertianTexture** (Diffuse/Irradiance), **GGXTexture** (Specular/Radiance), **GGXLutTexture** (BRDF 2D LUT), and **SkyBoxTexture** (Skybox).
    - For other settings on the dialog, see <span style="color:rgb(230,126,35);">[Import Dialog Options](https://doc3161en.candera.eu/link/73#bkmrk-import-dialog)</span>.  
          
        <div drawio-diagram="9017"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779926844.png" alt="drawing-4-1779926844.png"/></div>
4. Configure the import settings, then click OK.
    
    
    - Scene Composer imports the file as a resource in Solution Explorer , based on the selected dialog settings.
        
        <div drawio-diagram="5948"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-5-1717172418.png" alt="drawing-5-1717172418.png"/></div>

##### Shared IBL textures

When you import a glTF and generate IBL from an HDR panorama (lat/long), the importer automatically assigns the shared IBL textures (`LambertianTexture`/`GGXTexture`/`GGXLutTexture`/`SkyBoxTexture`) to each mesh. When you change a shared IBL texture, the importer propagates the change to all meshes that reference the shared IBL texture.

In the example below, select LambertianTexture (Diffuse/Irradiance) in Solution Explorer and set **Magnification Filter** to **Nearest** in the Properties panel. The importer applies the same setting to every mesh/material that references LambertianTexture.

<div drawio-diagram="8605"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2025-10/drawing-4-1759818288.png" alt="drawing-4-1759818288.png"/></div>

# Import Raw Resources

To import any type of raw resource, select **Import &gt; Import Raw Resources...** from the menu bar.

<dl class="note" id="bkmrk-"><dt></dt><dd><div drawio-diagram="5612"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-04/drawing-7-1713514243.png" alt="drawing-7-1713514243.png"/></div>

</dd></dl><div class="contents" id="bkmrk-it-is-possible-to-im"><div class="contents"><div class="textblock"><dl class="note"><dt></dt><dd><p class="callout info">You can import raw resources in SceneComposer by dragging them onto the **Solution Explorer** panel.</p>

</dd></dl></div></div></div>In the **Import Raw Resources** dialog, click the **Select Files...** button. SceneComposer opens the **Open File** dialog. In this dialog, select one or more raw resources to import, then click **OK**.

<div drawio-diagram="4347"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-09/drawing-4-1695701216.png" alt="drawing-4-1695701216.png"/></div>

Click **Save Report...** to save the content of the **Comparison** tab in CSV (Comma Separated Values) format. In the **Save As** dialog, enter a name and select the location for the CSV file.

For a description of the **Import Raw Resources** dialog's checkboxes, refer to <span style="color:rgb(230,126,35);">[Import Dialog Options](https://doc3161en.candera.eu/books/import-of-resources/page/import-dialog-options "Import Dialog Options")</span>.

To  compare new content with already imported resources, right-click a raw resource, to open the **Compare Properties** dialog.

---

#### Problems: Import Conflicts

SceneComposer's **Problems** panel lists potential import conflicts.

Dependency errors occur during import if you check the **Delete existing items in destination folder** checkbox and this destination folder contains items that are used in the solution.

# Import Benchmarks

CGI Analyzer is able to calculate render benchmarks. The result is a `*.crsms` file that you can export. It contains the calculated render time for each node that is part of a given scene. When you import a `*.crsms` file, CGI Analyzer makes node benchmarks available in the **Render Benchmark** node property. The camera render strategy **Benchmark** supports multi-pass rendering when benchmarks are available on the nodes of a scene,

To import a benchmark `*.crsms` file, select **Import &gt; Import Benchmarks** from the menu to open the **Import Benchmarks** dialog.

<div drawio-diagram="5992"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-06/drawing-5-1717742994.png" alt="drawing-5-1717742994.png"/></div>

<div class="contents" id="bkmrk--0"><div class="contents"><div class="textblock">  
</div></div></div>Click **Select Files...** and select a <code>&#42;&#46;crsms</code> file from the Window**s Open** dialog.

<div drawio-diagram="4348"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-09/drawing-4-1695701289.png" alt="drawing-4-1695701289.png"/></div>

<div class="contents" id="bkmrk--2"><div class="contents"><div class="textblock">  
</div></div></div>SceneComposer applies the values from the imported <code>&#42;&#46;crsms</code> file to the **Render Benchmark** property of all nodes. The **Import Benchmarks** dialog displays errors that occur after you select the <code>&#42;&#46;crsms</code> file.

For more detailed information, see <span style="color:rgb(230,126,35);">[CGI Studio Application Development Tutorial](https://doc3161en.candera.eu/books/candera)</span>.

# Import from Solution

**Import From Solution** is a powerful option for importing items from a specific solution previous created in SceneComposer.

Select **Import &gt; Import from Solution** in the menubar.

<div drawio-diagram="5614"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-04/drawing-7-1713514370.png" alt="drawing-7-1713514370.png"/></div>

<div class="contents" id="bkmrk--0"><div class="contents"><div class="textblock">  
</div></div></div>The **Import From Solution** dialog guides you through the steps of importing specific elements from a selected solution.

<div drawio-diagram="5993"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-06/drawing-5-1717743135.png" alt="drawing-5-1717743135.png"/></div>

---

#### Using **Import From Solution**

1. Click **Select**. In the Windows **Open** dialog, select the solution that contains the items you want to import.
2. SceneComposer loads the selected solution and displays a hierarchical list of all items that can be imported in the **Import From Solution** dialog.
3. Use the drop down menu next to **Import to folder** to select an existing folder for the imported items. Alternatively click **Browse.** In the **Select Location** dialog you can also create a new folder using the context menu **Add &gt; New Folder.**
4. In the list of items that can be imported, select the specific items that you would like to import using the checkboxes.
5. Click **OK** to import the selected elements.

<div drawio-diagram="5994"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-06/drawing-5-1717743555.png" alt="drawing-5-1717743555.png"/></div>

<div class="contents" id="bkmrk--4"><div class="contents"><div class="textblock">  
</div></div></div>If a selected item has dependent items, this information is displayed on the right side within the item list. Next to the items with dependencies, SceneComposer provides an **Options** button.

Clicking the button will present the following options:

<div class="contents" id="bkmrk-copy-all-skip-all-re"><div class="contents"><div class="contents"><div class="textblock">

- Copy all
- Skip all
- Replace all existing
- Skip all existing

</div></div></div></div><div drawio-diagram="5996"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-06/drawing-5-1717743743.png" alt="drawing-5-1717743743.png"/></div>

<div class="contents" id="bkmrk--6"><div class="contents"><div class="textblock">  
</div></div></div>For each imported-item category, you can see its relationship to existing imported items: **New**, **Existing** and **Conflict**.

<div drawio-diagram="5997"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-06/drawing-5-1717743930.png" alt="drawing-5-1717743930.png"/></div>

<div class="contents" id="bkmrk--8"><div class="contents"><div class="textblock">  
</div></div></div>Select one or more **Show** options to see the new items, existing items or conflicts between newly imported items and previously imported items. If there are different existing (\\=) items, another **Existing** button becomes available. Click **Existing** to open the **Compare Items** dialog and view the existing items.

<div drawio-diagram="4340"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-09/drawing-4-1695692624.png" alt="drawing-4-1695692624.png"/></div>

<div class="contents" id="bkmrk--10"><div class="contents"><div class="textblock">  
</div></div></div>Click **Show only differences** to see only the differences between selected items. You can use the comparison in different modes. For example, if the imported items are shaders, you can view them in three different modes: **Objects**, **Visual** and **Text**.

<div class="contents" id="bkmrk-%22show-only-differenc"><div class="contents"><div class="textblock"><table style="width:46.1728%;"><tbody><tr><td style="width:16.3684%;">[![03&#95;import&#95;solution&#95;7a.PNG](https://doc3161en.candera.eu/uploads/images/gallery/2023-02/scaled-1680-/03-import-solution-7a.PNG)](https://doc3161en.candera.eu/uploads/images/gallery/2023-02/03-import-solution-7a.PNG)

</td><td style="width:83.6358%;">**Show only differences** button</td></tr><tr><td style="width:16.3684%;">[![03&#95;import&#95;solution&#95;7b.PNG](https://doc3161en.candera.eu/uploads/images/gallery/2023-02/scaled-1680-/03-import-solution-7b.PNG)](https://doc3161en.candera.eu/uploads/images/gallery/2023-02/03-import-solution-7b.PNG)

</td><td style="width:83.6358%;">**Conflict** button</td></tr></tbody></table>

</div></div></div>If there are conflicts between the items, **Conflict** becomes available. Click **Conflict** to open the **Compare Items** dialog and show all existing conflicts.

<div drawio-diagram="4341"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-09/drawing-4-1695692686.png" alt="drawing-4-1695692686.png"/></div>

<div class="contents" id="bkmrk--12"><div class="contents"><div class="textblock">  
</div></div></div>The status signs indicate the nature of each conflict. When you click **Show only differences**, the dialog shows only the conflicts. When you click the button again, the dialog shows all items. When you select a conflict, the dialog shows all properties and their differences.

<div class="contents" id="bkmrk--14"><div class="textblock">  
</div></div>

# Smart Importer

# Smart Importer UI

This page describes the Smart Importer dialog. The Smart Importer dialog consists of the following four parts.

1. <span style="color: rgb(230, 126, 35);">[Preview](#bkmrk-Preview)</span>
2. <span style="color: rgb(230, 126, 35);">[Import](#bkmrk-Import)</span>
3. <span style="color: rgb(230, 126, 35);">[Layer Tree](#bkmrk-Layer-tree)</span>
4. <span style="color: rgb(230, 126, 35);">[Control](#bkmrk-Control)</span>

<div drawio-diagram="6726"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1725626895.png" alt=""/></div>

### Preview

The Preview panel displays a preview of the file to be imported.

##### Zoom factor of the preview

The current zoom factor is displayed in the lower-left corner. To adjust the zoom factor of the preview:

1. Use the mouse wheel to zoom in and out.
2. Click the button with the four arrows to preview the file at the maximum zoom factor within the display area.

<div drawio-diagram="5392"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-03/drawing-4-1710316832.png" alt=""/></div>

Select an element on the preview image. Artificial intelligence (AI) detects controls on the selected element and lists them in the **Control** section.

### Import

The import section consists of two tabs, **Import Settings** and **AI Settings**.

<div drawio-diagram="5393"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-03/drawing-4-1710316951.png" alt=""/></div>

##### Import Settings Tab

The **Import Settings** tab contains the following settings.

<table border="1" id="bkmrk-%%82%A8" style="border-collapse: collapse; width: 700px; border-width: 1px;"><colgroup><col style="width: 200px;"></col><col style="width: 500px;"></col></colgroup><tbody><tr><td>Import to folder</td><td>Select a destination folder for the imported resources. To change the destination folder, use the pull-down menu. create a new destination folder, use the **Create new folder for import** section. The destination folder can be any location in Solution Explorer.

</td></tr><tr><td>Create new folder for import</td><td>When this option is enabled, a new import folder can be created with any name. The created folder is located in the import destination folder specified in **Import to folder**.

</td></tr><tr><td>Scenes</td><td>Edit scenes with the Smart Importer. See the <span style="color: rgb(230, 126, 35);">[Basic Operations](https://doc3161en.candera.eu/books/import-of-resources/page/basic-operations#bkmrk-%E3%82%B7%E3%83%BC%E3%83%B3%E3%81%AE%E6%A7%8B%E6%88%90 "Basic Operations") </span>guide for editing scenes with Smart Importer.

</td></tr><tr><td>Toggle Applied Controls Preview</td><td>When this option is enabled, a green frame appears where the control is applied. The green frame allows you to visually check where the control is applied on the preview.

</td></tr><tr><td>Resize Display Resolution</td><td>This option is enabled when the resolution of the file to be imported is larger than the solution's display resolution. When this option is enabled, the Smart Importer automatically resizes the resolution of the imported file to fit the display resolution.

</td></tr><tr><td>Import State Machine</td><td>When this option is enabled,the Smart Importer imports state machines from your design file directly into your CGI Studio solution. If a global state machine already exists within your solution, the Smart Importer displays a prompt where you can choose whether to import the new state machines with the **Is Global** property enabled.

</td></tr></tbody></table>

##### AI Settings Tab

Configure AI detection settings on this tab.

<div drawio-diagram="7027"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729212783.png" alt=""/></div>

The Smart Importer uses the value specified in the <span style="color: rgb(230, 126, 35);">[Preferences](https://doc3161en.candera.eu/books/preferences/page/configure-the-smart-importer)</span> for **Edge Detection**. For details, see the [<span style="color: rgb(230, 126, 35);">Preferences</span> ](https://doc3161en.candera.eu/books/preferences/page/configure-the-smart-importer)page.

AI uses the color selected under **Transparent background color** to analyze the image being imported. The best background color for detecting controls depends greatly on the image content.

If AI has problems detecting controls, change this setting.

### Layer Tree

The Layer Tree displays a tree view of each element from the file being imported. The list displayed here corresponds to the scene tree in Scene Composer. When you select one or more elements in this list, AI detects controls on the selected elements and lists them in the **Control** section.

Enter keywords in the search field at the top of the Layer Tree to narrow the list to those layers that contain those keywords.

<div drawio-diagram="6727"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1725626973.png" alt=""/></div>

Check the checkbox to the left of each layer element to include it in the scene. The Smart Importer does not import cleared elements.

#### Revert/Revert All button

To cancel the applied control settings, select the target item in the Layer Tree panel and click **Revert**.

To cancel all applied control settings in the Layer Tree, click **Revert All**. The Smart Importer displays a confirmation dialog before continuing.

###   
Control

#### Control List Tab

Select any layer in the Layer Tree, and AI detects the most suitable controls. The **Control List** tab displays the analysis results and lists candidate controls in order of probability.

The Smart Importer categorizes the controls by solution and reference, such as ConstructionKit and Custom Controls.

- For controls in ConstructionKit, the probability of matching with the AI is displayed as a number (and bar) to the right of the control name, and they are listed in descending order from the highest number. 
    - Custom controls that are not included in ConstructionKit are displayed in order of control name.
- By default, each category displays five controls. Clicking **View All** (red box in the image below) displays a list of all controls.
- The list of controls that is displayed can be narrowed down by entering keywords in the search field at the top (orange box in the image below).
- To apply the controls to the selected element, use **Apply** in the **Control List**.

<div drawio-diagram="7029"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729213292.png" alt=""/></div>

To configure the display settings, click the triangle icon on the left side of the search field. The settings section lets you configure which controls appear according to the detection value.

To apply a control to a selected element, click **Apply** in the **Control List**. When you apply a control with a low AI detection probability, a dialog box appears to confirm your selection.

#### Appearance Tab

When you apply any control, the display automatically switches to the **Appearance** tab. Configure the appearance properties for the applied control. Some controls, such as TextValue, do not require appearance settings.

The **Appearance** tab is made up of the following three main sections.

1. <span style="color: rgb(230, 126, 35);">[<span style="color: rgb(230, 126, 35);">Image</span>](#bkmrk-layer-mapping)</span>
2. <span style="color: rgb(230, 126, 35);">[Pivot Point](#bkmrk-configure-the-pivot-)</span>
3. <span style="color: rgb(230, 126, 35);">[9-Patch](#bkmrk-9-patch)</span>

<div drawio-diagram="7030"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729213616.png" alt=""/></div>

##### Image

For each control image properties, select the layer image from the file to import. If the control image property name matches the layer name, the Smart Importer automatically sets the layer image. You cannot edit the image layer.

<p class="callout info">For example, when you apply the Gauge control, the Control Image has a NeedleImage property. Therefore, if NeedleImage exists in the layer name of the file to import, the Smart Importer automatically sets it to the NeedleImage property.</p>

<div drawio-diagram="7031"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729213753.png" alt=""/></div>

When you assign a control to a group layer, you can choose from the following options for the control image.

<div drawio-diagram="7032"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729213848.png" alt=""/></div>

<table border="1" class="align-center" id="bkmrk-select-layers-select" style="border-collapse: collapse; width: 700px; border-width: 1px;"><colgroup><col style="width: 22.7385%;"></col><col style="width: 77.2368%;"></col></colgroup><tbody><tr><td class="align-left" style="border-width: 1px;">Select layers</td><td class="align-left" style="border-width: 1px;">Select any image layer from the group layer. You can use composite images with multiple layers. For more information, please refer to <span style="color: rgb(230, 126, 35);">[Configure a control image with multiple layers](https://doc3161en.candera.eu/link/1150#bkmrk-configure-a-control-)</span>.

After importing, the Smart Importer places the composite image in the **ControlBitmaps** folder and sets the bitmap name to the property name specified here.

If you select a single layer, the Smart Importer uses the original bitmap placed in the **Bitmaps** folder. For folder locations, see <span style="color: rgb(230, 126, 35);">[Folder structure after import](#bkmrk-folder-structure-aft)</span>.

</td></tr><tr><td class="align-left" style="border-width: 1px;">Transparent</td><td class="align-left" style="border-width: 1px;">The Smart Importer uses a transparent image.</td></tr><tr><td class="align-left" style="border-width: 1px;">Default value</td><td class="align-left" style="border-width: 1px;">The Smart Importer uses the default image for the applied control.</td></tr></tbody></table>

Select images included in the group layer by clicking the selection icon on the right of the image.

- Select images from the descendant layers and the current layer as property values
- You cannot select layers other than images (except for bitmap layers to which controls have been applied).
- After you selected the image, the Smart Importer sets the pivot point to the center of the composite image.

<div drawio-diagram="9227"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-09/drawing-5-1789127376.png" alt=""/></div>

For each control image properties, set the layer image in the file to import. If the control image property name and the layer name match, the Smart Importer automatically sets the layer image.

##### Image Array Properties

The Smart Importer supports image array properties and automatically assigns images in the FlipBook control. The numbers attached to each Image element on the Appearance tab correspond to the values displayed in descending order in the layer tree.

<div drawio-diagram="7044"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729230884.png" alt=""/></div>

##### Folder structure after import

After import, the Smart Importer creates the **Bitmaps**, **ControlBitmaps**, and **TextStyles** folders in the Solution Explorer.

<table border="1" class="align-center" id="bkmrk-bitmaps-the-imported" style="border-collapse: collapse; width: 700px; border-width: 1px;"><colgroup><col style="width: 159px;"></col><col style="width: 540px;"></col></colgroup><tbody><tr><td class="align-left" style="border-width: 1px;">Bitmaps</td><td class="align-left" style="border-width: 1px;">Smart Importer places the imported bitmap for each layer in this folder.</td></tr><tr><td class="align-left" style="border-width: 1px;">ControlBitmaps</td><td class="align-left" style="border-width: 1px;">Smart Importer places the bitmap composed of multiple layers in this folder for the control properties.</td></tr><tr><td class="align-left" style="border-width: 1px;">ImportedScenes</td><td class="align-left" style="border-width: 1px;">Smart Importer places the scene imported as a template in this folder.</td></tr><tr><td class="align-left" style="border-width: 1px;">Scenes</td><td class="align-left" style="border-width: 1px;">When you import a StateMachine (screen transition), the Smart Importer places the target scene in this folder.</td></tr><tr><td class="align-left" style="border-width: 1px;">TextStyles</td><td class="align-left" style="border-width: 1px;">Smart Importer places the created text style in this folder.</td></tr></tbody></table>

<div drawio-diagram="7136"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729754524.png" alt=""/></div>

##### Pivot Point

When you set up a control image with layer mapping, the Smart Importer automatically sets the pivot point. The pivot point values that the Smart Importer sets automatically are as follows. (However, if the pivot point values are specified with the layer names mentioned later, the specified values are used as the set values.)

- Pivot point X value: 0
- Pivot point Y value: 0

In addition, when you select the **Pivot Point** check box (No.1 in the image below), you can use the following options:

<div drawio-diagram="7034"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729214188.png" alt=""/></div>

- Enter values for the X and Y coordinates of the pivot point. You can enter decimal values.
- Set the pivot point to the center of the image by clicking No.2 in the image above).
- Click No. 3 in the image above to open the **Freehand** dialog box. Move the crosshair cursor in the dialog box to configure the pivot point.
- Set the background color of the **Freehand** dialog to black or gray from **Background Color** in the lower-right corner of the dialog (highlighted in the orange box in the figure below). Additionally, configure the default background color in **<span style="color: rgb(230, 126, 35);">[Preferences &gt; Smart Importer](https://doc3161en.candera.eu/books/preferences/page/configure-the-smart-importer)</span>**.

<div drawio-diagram="8022"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2025-03/drawing-4-1741158028.png" alt=""/></div>

Alternatively, you can apply any pivot point value by specifying it in the layer name of the image to import.

- If the layer name in the target file to be imported is something like `***@X10@Y20`, the pivot point values are automatically set as X = 10 and Y = 20.
- If the layer name in the file to be imported is `***@X10.5`, the pivot point value is automatically set as X = 10.5 and Y = 0.

##### 9-Patch

This option appears when the **Enable editing 9-Patch** option is enabled in the **<span style="color: rgb(230, 126, 35);">[Preferences &gt; Smart Importer](https://doc3161en.candera.eu/books/preferences/page/configure-the-smart-importer)</span>** settings. When enabled, the 9-Patch feature can be configured (input values must be positive numbers only).



#### Basic Properties Tab

This section lets you set properties for the applied control. After importing, select the target control and configure it on the **Properties** panel.

<div drawio-diagram="6735"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1725628096.png" alt=""/></div>

<p class="callout info">If the layer name is the same as the control's property name, the Smart Importer automatically maps the individual properties from the file to import.</p>

# Basic Operations

This section describes the basic operations in Smart Importer.

#### Import File Formats

The Smart Importer imports files using one of the following two methods, depending on the file format:

- Local files: \*.psd, \*.xscil, \*.xd
- Cloud resources: Figma data

<div drawio-diagram="6896"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1727940873.png" alt=""/></div>

<p class="callout info">For more information on the Photoshop layer structure format, see <span style="color: rgb(230, 126, 35);">[Recommended Layers Structure for Smart Importer](https://doc3161en.candera.eu/books/import-of-resources/page/recommended-layers-structure-for-smart-importer)</span>.</p>

#### Restore Settings

The Smart Importer saves the settings that you applied when configuring the import in the solution along with the imported scene. Therefore, when you importing the same file again to the same path in **Solution Explorer**, the Smart Importer displays a dialog asking if you want to use the saved settings.

<div drawio-diagram="8929"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-02/drawing-7-1770713035.png" alt=""/></div>

<table border="1" class="align-center" id="bkmrk-restore-saved-settin" style="border-collapse: collapse; width: 700px; border-width: 1px; height: 59.4034px;"><colgroup><col style="width: 24.7475%;"></col><col style="width: 75.3648%;"></col></colgroup><tbody><tr style="height: 29.7017px;"><td class="align-left" style="border-width: 1px; height: 29.7017px;">Use</td><td class="align-left" style="border-width: 1px; height: 29.7017px;">The Smart Importer applies the saved settings.</td></tr><tr><td class="align-left" style="border-width: 1px;">Merge</td><td class="align-left" style="border-width: 1px;">Merges both the saved settings and the new settings.</td></tr><tr style="height: 29.7017px;"><td class="align-left" style="border-width: 1px; height: 29.7017px;">Don't use</td><td class="align-left" style="border-width: 1px; height: 29.7017px;">The Smart Importer does not apply saved settings and creates new settings.</td></tr></tbody></table>

If an image has been replaced in an imported file, select the **Use** Radiobutton to replace the old image in the scene with the updated image while maintaining the previous mapping between layers and colors.

For other behaviors when reimporting files, see <span style="color: rgb(230, 126, 35);">[reimporting files](https://doc3161en.candera.eu/link/1150#bkmrk-re-importing-a-file-)</span>.

#### Conversion to 2D Nodes

During import, Smart Importer converts specific elements, such as Photoshop artboards and Color Pickers, to optimal nodes in Scene Composer.

<table border="1" class="align-center" id="bkmrk-artboards-artboards-" style="border-collapse: collapse; width: 700px; border-width: 1px;"><colgroup><col style="width: 120px;"></col><col style="width: 580px;"></col></colgroup><tbody><tr><td class="align-left" style="border-width: 1px;">Artboards</td><td class="align-left" style="border-width: 1px;">Smart Importer can treat artboards in the file you imported as Group Node.

</td></tr><tr><td class="align-left" style="border-width: 1px;">Color Picker</td><td class="align-left" style="border-width: 1px;">Smart Importer can treat Color Pickers in the file you imported as Solid Color Nodes. In this case, the solid color layer uses the same icon as the Solid Color Node in Smart Importer.

</td></tr></tbody></table>

You cannot edit the **Appearance** tab under any of the following conditions:

- The layer of the file to be imported does not have image information.
- The applied control does not have a properties that refers to an image.

In all other cases, the same options are available as for image layers. For example, the **Layer Mapping** section can generate image resources after you map control properties to a layer. Similarly, other prototyping tools do the same with Color Pickers.

<p class="callout info">For each node in a 2D scene, see <span style="color: rgb(230, 126, 35);">[2D scene nodes](https://doc3161en.candera.eu/link/147#bkmrk-create-2d-nodes)</span>.</p>

#### Control instance configured with Smart Importer

After you finished applying the detected controls and configuring images, pivot points, and other properties, click **OK** at the bottom of the Smart Importer dialog to import the configured file.

<p class="callout info">See the <span style="color: rgb(230, 126, 35);">[Smart Importer UI](https://doc3161en.candera.eu/books/import-of-resources/page/smart-impoter-ui)</span> for details on what to configure in each part of the Smart Importer dialog.</p>

The Smart Importer imports the configured file to the location specified in the <span style="color: rgb(230, 126, 35);">[Import Settings Tab](https://doc3161en.candera.eu/link/1148#bkmrk-%E3%82%A4%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%88%E8%A8%AD%E5%AE%9A)</span> using the configured settings. Note that you can view the control instance configured in Smart Importer , such as **Gauge left** in the image below, in the **Imports** panel.

<div drawio-diagram="6738"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1725628567.png" alt=""/></div>

You can use control instances configured in Smart Importer in the Scene Editor or drag them into the Scene Tree.

<div drawio-diagram="7570"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-11/drawing-5-1732885515.png" alt=""/></div>

#### Configure Scenes

The **Import Settings** tab allows you to manage scenes that you import into Scene Composer. To see the available options, select a target scene from **Scenes**, then right-click the target scene:

<div drawio-diagram="5367"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-03/drawing-4-1710298666.png" alt=""/></div>

<table border="1" class="align-center" id="bkmrk-%E3%82%B7%E3%83%BC%E3%83%B3%E3%82%92%E8%BF%BD%E5%8A%A0-%E6%96%B0%E8%A6%8F%E3%82%B7%E3%83%BC%E3%83%B3%E3%82%92%E8%BF%BD%E5%8A%A0%E3%81%97%E3%81%BE%E3%81%99%E3%80%82%E3%81%AA" style="border-collapse: collapse; width: 695px; border-width: 1px; height: 193.183px;"><colgroup><col style="width: 136px;"></col><col style="width: 558px;"></col></colgroup><tbody><tr style="height: 79.8667px;"><td class="align-left" style="border-width: 1px; height: 79.8667px;">**Add Scene**</td><td class="align-left" style="border-width: 1px; height: 79.8667px;">Adds a new scene. The Smart Importer clears all checkboxes for each element displayed in the Layer Tree.

After you select this option, the **Add Scene...** dialog box appears. Enter a name for the new scene.

</td></tr><tr style="height: 63.0667px;"><td class="align-left" style="border-width: 1px; height: 63.0667px;">**Clone Scene**</td><td class="align-left" style="border-width: 1px; height: 63.0667px;">The Smart Importer duplicates the scene while maintaining the configuration on the current Layer Tree.

After you select this option, the **Add Scene...** dialog box appears. Enter a name for the new scene.

</td></tr><tr style="height: 29.4667px;"><td class="align-left" style="border-width: 1px; height: 29.4667px;">**Remove Scene**

</td><td class="align-left" style="border-width: 1px; height: 29.4667px;">Deletes the selected scene.</td></tr><tr style="height: 20.7833px;"><td class="align-left" style="border-width: 1px; height: 20.7833px;">**Rename Scene**</td><td class="align-left" style="border-width: 1px; height: 20.7833px;">Rename the scene. You can also double-click the target scene name to change the name.

</td></tr></tbody></table>

#### TextStyle

When you import a Text Layer into Scene Composer, Scene Composer creates a a new TextStyle. Its name combines the font name and font size used in the Text Layer of the PSD file. When Scene Composer creates a new TextStyle, it checks whether the Scene Composer solution includes a font resource with the corresponding name. If Scene Composer cannot find the appropriate font resources in the solution, it displays a dialog box like the one below.

If the font does not exist in the solution, you can use an existing font resource by specifying an alternative font on this dialog.

<div drawio-diagram="6869"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-4-1727138202.png" alt=""/></div>

#### Text and text-containing controls

Scene Composer imports the bounding rectangle (width and height) of text and controls containing text as automatic values.

<div drawio-diagram="6741"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1725631019.png" alt=""/></div>

#### Global State Machine

Scene Composer imports all State Machine elements as Global State Machine elements and does not display a confirmation dialog.

<div drawio-diagram="5371"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-03/drawing-4-1710298910.png" alt=""/></div>

<div drawio-diagram="501"></div>

# Smart Importer UseCase

This section describes various use cases for Smart Importer operations.

#### Configure Scene Contents

This section explains how to configure the contents by using an example that imports an image file consisting of two scenes, an In-Vehicle Infotainment (IVI) scene (e.g., music player and climate control) and a cluster scene.

- The IVI layer is an IVI scene consisting of a music player and air conditioning controls.
- The Cluster layer is a scene that contains only clusters.

If the import file **IVI\_Scene** contains the two layers described above, you can configure the two scenes to contain different elements by following these steps.

1. In the Smart Importer window's **Import Settings** tab, select **IVI** from **Scenes:** and select **Clone Scene...** from the context menu.  
    
    - In the **Clone Scene...** dialog box, enter `Cluster_Scene` in the name field, and then click **OK**.
    - Two scenes, **IVI\_Scene** and **Cluster\_Scene**, appear under **Scenes**.
2. Select **IVI\_Scene** from **Scenes**, and then clear the **Cluster** check box in the **Layer Tree**.
    
    
    - Smart Importer excludes the Cluster layer from the IVI\_Scene scene structure.
        
        <div drawio-diagram="6755"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726214385.png" alt=""/></div>
3. Select **Cluster\_Scene** from **Scenes**, and then clear the **IVI\_Sample** check box in the **Layer Tree**.
    
    
    - Smart Importer excludes the IVI\_Sample layer from the Cluster\_Scene scene configuration.
        
        <div drawio-diagram="6754"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726214339.png" alt=""/></div>
4. Click **OK** in Smart Importer to perform the import.
    
    
    - You can see the imported scenes and resources in the **Solution Explorer** panel.
    - The **IVI\_Scene** and **Cluster\_Scene** scenes do not contain the layers specified in steps two and three, respectively.
        
        <div drawio-diagram="6756"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726214473.png" alt=""/></div>

#### Re-importing a file containing new images

If you reopen a previously imported file using **Restore**, and the file has the same name and path, Smart Importer loads the saved settings, including applied controls and appearance settings. If the destination folder or scene already exists, Smart Importer displays blue information icons (see orange frames in the image below). Hold the mouse cursor over these icons to display the necessary information in a tooltip. When you run the import with the current settings, Smart Importer overwrites already imported resources and scenes, keeps the Layer Mapping settings and applied controls information, and updates the images in the Scene Composer solution to the latest image.

<div drawio-diagram="6758"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726214928.png" alt=""/></div>

<p class="callout info">If you want to import image content into the Scene Composer solution a second time, keeping the resources and scenes from both imports, select a different import location or a different scene name.</p>

#### Re-importing a file containing images with different layers

If you import a previously imported file, that has the same destination path and same file name, but a partially different layer structure, the **Layer Tree** in Smart Importer dialog appears as follows.

<table border="1" class="align-center" id="bkmrk-%E8%BF%BD%E5%8A%A0%2F%E4%BF%AE%E6%AD%A3%E3%81%95%E3%82%8C%E3%81%9F%E3%82%B0%E3%83%AB%E3%83%BC%E3%83%97%E3%83%AC%E3%82%A4%E3%83%A4%E3%83%BC-%E3%82%B0%E3%83%AB%E3%83%BC" style="border-collapse: collapse; width: 800800px; height: 105.188px; border-width: 1px;"><colgroup><col style="width: 33.2441%;"></col><col style="width: 66.7559%;"></col></colgroup><tbody><tr style="height: 45.5938px;"><td class="align-left" style="height: 45.5938px; border-width: 1px;">Added or modified group layers</td><td class="align-left" style="height: 45.5938px; border-width: 1px;">Smart Importer adds an orange icon to the Group Node icon. This symbol helps you identify groups that have been modified since the last import (see orange frame in the image below).

</td></tr><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px; border-width: 1px;">Control Assigned Bitmap</td><td class="align-left" style="height: 29.7969px; border-width: 1px;">If you have already assigned a control to a bitmap node and another control uses that bitmap, Smart Importer displays the bitmap in yellow font.

</td></tr><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px; border-width: 1px;">Newly added layer</td><td class="align-left" style="height: 29.7969px; border-width: 1px;">Smart Importer displays newly added layers in green font (see green frame in the image below).

Note that Smart Importer does not show newly added layers in **Preview**, it disables the check box in **Layer Tree** by default. To show the layer in **Preview**, select the check box.

</td></tr><tr><td class="align-left" style="border-width: 1px;">Deleted Layer</td><td style="border-width: 1px;">Smart Importer displays in red font layers that existed in the previously imported file but do not exist in the current import file (see reed frame in the image below).

Smart Importer also disables the check boxes in **Layer Tree**. Since these layers are not included in the current import file, Smart Importer does not display these layers in **Preview**, even if you select them in **Layer Tree**.

</td></tr></tbody></table>

<div drawio-diagram="7104"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729307338.png" alt=""/></div>

#### Merging multiple scene settings

Smart Importer saves the settings that you apply during the import run in the solution along with the imported scene. This settings-saving behavior allows you to import various configurations into the solution by using a single import target file and eventually merge the configurations into a single configuration. The following example shows how to set this up.

##### Creating Multiple Configurations

This section uses the Photoshop Document (PSD) file `Car_Cluster.psd` in the following location as an import example. Note that Smart Importer does not display the **New SPI configuration was found** dialog during each import operation because you specify a different import-destination folder.

`<strong><root>\cgi_studio_content\2D\PSD\Car_Cluster.psd</strong>`

1. Open the `Car_Cluster.psd` file in the Smart Importer and configure the Telltale control. Then, under **Import to Folder**, enter `/Resources/Cluster_Telltales` as the import destination and perform the import. 
    - See **1. TellTale Settings** in the image below.
2. Re-open the same image file in the Smart Importer, this time setting the Gauge control. Enter `/Resources/Cluster_Gauge` as the import destination and perform the import.
    
    
    - See **2. Gauge Settings** in the image below.
3. Repeat the process for the ProgressBar control. Enter `/Resources/Cluster_ProgressBar` as the import destination and perform the import.
    
    
    - See **3. ProgressBar Settings** in the image below.

<div drawio-diagram="6763"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726221490.png" alt=""/></div>

##### Merge of multiple scene configurations

1. Open the `Car_Cluster.psd` file in the Smart Importer.
2. Enter `/Resources/Cluster_Telltales` in the **Import into folder** and clear the **Create new folder for import** check box.  
    
    - The Smart Importer dialog appears.
3. Select **Use**, and then click **OK** to restore and apply the Telltale control settings. 
    - A blue caution icon appears in **Scenes**.  
        <div drawio-diagram="8926"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-02/drawing-7-1770712185.png" alt=""/></div>
4. Change the import destination to `/Resources/Cluster_Gauge`.  
    
    - A dialog box similar to the one below appears.
5. Select **Merge**, and then click **OK**.  
    
    - The configured Gauge control is added to the previously configured Telltale control.  
        <div drawio-diagram="8934"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-02/drawing-7-1770720061.png" alt=""/></div>
6. Similarly, change the import destination to `/Resources/Cluster_ProgressBar`.  
    
    - As in step 4, a dialog box similar to the one shown below appears.
7. Select **Merge,** and then click **OK**.  
    
    - The configured **ProgressBar** control is added.  
        <div drawio-diagram="8935"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-02/drawing-7-1770720114.png" alt=""/></div>

These steps create a configuration with the TellTale, Gauge, and ProgressBar controls applied.

#### Configure a control image with multiple layers

In some cases, the imported image file may contain a complex structure, where elements such as the gauge background and needle are composed of multiple images or layers. However, the Gauge control in Scene Composer requires only one image for the background and one for the needle. To support complex image configurations while preserving control settings, Smart Importer allows multiple layers for each image used in the control.

This section uses the `Car_Cluster.psd` file as an example.

The Smart Importer window displays the following, after you selected `Car_Cluster.psd` as file to import with the Smart Importer (see also image below):

- The **Layer Tree** of the imported `Car_Cluster.psd` file
- **Gauge left** is the Gauge's root layer. 
    - The orange framed layer contains the **Gauge needle**.
    - The blue framed layer contains the **background**.
- The **Control List** tab lists the artificial intelligence (AI) automatic-control-detection results.

<div drawio-diagram="7038"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729224666.png" alt=""/></div>

Follow the steps below to configure a Gauge control with a background image that has multiple layers:

1. In the **Layer Tree**, select the root layer of the target layer group (**Gauge left** in the image above). 
    - Smart Importer lists the results of AI generated automatic control detection in the **Control List** tab.
2. In the Control List, find the Gauge control and click the **Apply** button next to the **Gauge** control. 
    - Smart Importer assigns the **Gauge** control to the **Gauge left** layer group.
    - Smart Importer switches the focus to the **Appearance** tab. 
        
        <p class="callout info">When you select the root layer to which you apply the control, Smart Importer can configure the entire layer group, including all child layers.  
        To select multiple layers and set them all at once, hold `ctrl` or `shift` and click the target layer, or click and drag around the layer you want to select.</p>
    - Smart Importer was able to configure the NeedleImage property with the NeedleImage layer, because the layer name of the file to import contains `NeedleImage`.
    
    <div drawio-diagram="7039"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729225203.png" alt=""/></div>
    
    
    - The `Car_Cluster.psd` file contains multiple background-image layers.
3. Select **Select layers** from the **BackgroundImage** drop-down menu. <div drawio-diagram="7040"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729225226.png" alt=""/></div>
    
    
    - The **ImageLayers Selection** dialog box appears.
4. Select the layer you want to assign to **BackgroundImage** and click **OK**. <div drawio-diagram="7041"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729225434.png" alt=""/></div>
5. After you finished your configuration in Smart Importer, click **OK** to start the import. 
    - Smart Importer creates a background image by merging the specified layers and creating a new BackgroundImage.
    - You can see this newly created image in the SceneComposer's Solution Explorer.
6. Double-click this image 
    - The Image Preview window displays the BackgroundImage. <div drawio-diagram="7042"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729225962.png" alt=""/></div>

<p class="callout info">Smart Importer places bitmaps merged from multiple layers for control properties in the **ControlBitmaps** folder in **Solution Explorer**.</p>

# Recommended Layers Structure for Smart Importer

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">This page shows you how to set up items so that Smart Importer automatically detects the items and their nested group items as controls when you import Adobe Photoshop (.psd), Adobe XD (.xd), o Figma (.fig) files.</span></span>

<p class="callout info"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Smart Importer can automatically assign only controls in the ***Touchable, Common** and **Core*** categories.  
</span></span></p>

---

#### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Creating Design Files</span></span>

To enable the automatic application of controls to group items in a design file and their subsequent import into Scene Composer, group items must be created following the recommended layer structure.

The recommended layer structure is primarily designed to support the text-related and image-related properties of a control. By creating layers that correspond to these properties and naming them according to the associated Scene Composer property names, the Smart Importer can automatically identify and map the layers to the appropriate control properties.

The following sections provide detailed instructions for creating the required layer structure.

##### <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">For Adobe Photoshop（.psd）Files</span></span>

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">You can create controls from Photoshop layer data as follows:</span></span>

<div class="contents" id="bkmrk-create-a-group-item-"><div class="contents"><div class="contents"><div class="contents"><div class="textblock">

1. <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Create a group item for the control that you want Smart Importer to assign and name it "SC\_*&lt;ControlName&gt;*". For example, name the top layer "SC\_TextButton" to make a TextButton control (see blue box).</span></span>
2. <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Under the group item that you created in step 1, create property layers for the desired control (see red and green boxes).  
    These properties include text-related properties (e.g., Text, FirstText) and image-related properties (e.g., NormalImage, PressedImage).  
    </span></span>
3. <span style="vertical-align: inherit;"><span style="vertical-align: inherit;">Use the control properties names for the Photoshop layer names. Delete any spaces in Photoshop layer names (see green boxes for comparison)</span></span>

</div></div></div></div></div><div drawio-diagram="3874"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-06/drawing-7-1686313199.png" alt=""/></div>

<div class="contents" id="bkmrk--0"><div class="contents">  
</div></div><p class="callout info">The Smart Importer automatically recognizes and maps a group item that is named SC\_&lt;ControlName&gt;” in the design file.  
You are not required to create layers for all text-related and image-related properties of the control. Even if only the required properties are created as layers, the control will still be applied correctly.</p>

<span style="vertical-align: inherit;"><span style="vertical-align: inherit;">After following the steps above, select **Import &gt; Smart Importer &gt; From Local File... from the Scene Composer toolbar, then select the finished Photoshop file. Smart Importer opens the **Smart Importer** panel, loads the file according to the .psd layers that you configured, confirms the TextButtonControl, and applies it, as you can see in the image below.</span></span>

<div drawio-diagram="6772"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726226385.png" alt=""/></div>

<div class="contents" id="bkmrk-each-property-on-the"><div class="contents"><div class="textblock">  
</div><div class="textblock">Each property on the **Appearance** and **Basic Properties** tabs reflects the layers that you set in the .psd file.   
</div><div class="textblock"><div drawio-diagram="7037"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-4-1729219437.png" alt=""/></div>

</div></div></div><div class="contents" id="bkmrk--7"></div><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">The **Properties** panel also reflects these settings after Smart Importer completes the import</span></span>.

<div drawio-diagram="6774"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726226731.png" alt=""/></div>

<div class="contents" id="bkmrk--10"><div class="contents"><div class="textblock">  
</div></div></div><div class="contents" id="bkmrk-the-size-of-the-impo"><div class="contents"><div class="textblock"><dl class="note"><dt></dt><dd><p class="callout info"><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">The imported control's size matches the width and height of the largest image layer that you applied.</span></span></p>

</dd><dd></dd></dl></div></div></div><span style="vertical-align: inherit;"><span style="vertical-align: inherit;">When Smart Importer imports nodes with mismatching layers and properties, it creates new group nodes and additional properties as child elements.</span></span>

##### For Adobe XD（.xd）Files

Prepare .xd files in the same way as described in<span style="color: rgb(230, 126, 35);"> [For Adobe Photoshop (.psd) Files](https://doc3161en.candera.eu/link/84#bkmrk-adobe-photoshop%EF%BC%88.psd)</span>. Structure the Adobe XD items to match the structure and property names of the controls that Smart Importer automatically applies.

<div drawio-diagram="3877"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-06/drawing-7-1686313818.png" alt=""/></div>

##### For Figma（.fig）Files 

Prepare .fig files in the same way as described in <span style="color: rgb(230, 126, 35);">[For Adobe Photoshop (.psd) Files](https://doc3161en.candera.eu/link/84#bkmrk-adobe-photoshop%EF%BC%88.psd)</span>. Structure the Figma items to match the structure and property names of the controls that Smart Importer automatically applies.

<div drawio-diagram="3876"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-06/drawing-7-1686313403.png" alt=""/></div>

---

<div class="contents" id="bkmrk--41"></div>#### Layer Structure and Naming Guideline for Controls

In general, keep the PSD layer format close to the standard controls. Use the following guide to format and name layers for some controls.

##### Touchable

- **Button**  
    SC\_Button  
    ├ NormalImage  
    ├ PressedImage  
    └ FocusedImage
- **CheckBox**  
    SC\_CheckBox  
    ├ Text  
    ├ NormalImage  
    ├ PressedImage  
    ├ SelectedImage  
    ├ SelectedPressedImage  
    └ FocusedImage
- **MultiStateButton**  
    SC\_MultiStateButton  
    ├ Text  
    ├ StateImages0  
    ├ StateImages1  
    ├ StateImages2  
    └ StateImages3
- **ToggleButton**  
    SC\_ToggelButton  
    ├ FirstText  
    ├ SecondText  
    ├ FirstImage  
    ├ FirstPressedImage  
    ├ SecondImage  
    └ SecondPressedImage

<div class="scriptor-paragraph" id="bkmrk-%60%60%60plaintext"></div><div class="scriptor-paragraph" id="bkmrk-sc_button"></div>##### Common

- **AnalogClock**  
     SC\_AnalogClock  
      ├ SecondsNeedleImage  
      ├ MinutesNeedleImage  
      ├ HoursNeedleImage  
      └ FaceImage
- **Gauge** SC\_Gauge  
      ├ BackgroundImage  
      └ NeedleImage
- **Menu Icon**  
    SC\_MenuIcon  
      ├ Image  
      └ BackgroundImage
- **Mesh2D**  
    SC\_Mesh2D  
      └ Image

##### Core

- **CoreDial**  
    SC\_CoreDial  
      ├ KnobImage  
      ├ BackgroundImages0  
      ├ BackgroundImages1  
      └ BackgroundImages2
- **CoreTextButton**  
    SC\_CoreTextButton  
      ├ NormalImage  
      ├ PressedImage  
      ├ DisabledImage  
      └ Text
- **CoreRadioButton**  
    SC\_CoreRadioButton  
      ├ Text  
      ├ NormalImage  
      ├ SelectedImage  
      ├ NormalDisabledImage  
      └ SelectedDisabledImage
- **CoreSlider**  
    SC\_CoreSlider  
      ├ TrackImage  
      ├ TrackDisabledImage  
      ├ TrackFillImage  
      ├ TrackDisabledFillImage  
      ├ KnobNormalImage  
      ├ KnobPressedImage  
      └ KnobDisabledImage

<div class="contents" id="bkmrk-analogclock-secondsn"><div class="contents"></div></div>

# Adobe XD Importing

#### Description

This section explains about Adobe XD file format, its layer structure, naming conventions, and an import example that uses a sample file.

---

#### Layer Structure and Naming Guideline

As with Photoshop Document (PSD) file format, the SmartImporter's AI analyzes imported files to detect, propose, and create Controls for the solution. Keep the Adobe XD layer format close to the standard Controls in Scene Composer. The naming guideline is as same as the PSD guideline. For details, refer to the <span style="color: rgb(230, 126, 35);">[Recommended Layers Structure for Smart Importer](https://doc3161en.candera.eu/link/84#bkmrk-page-title "Recommended Layers Structure for Smart Importer")</span>.

Additional naming conventions exist for efficiently importing AdobeXD files, such as the following.

##### Control: Text

The Smart Importer creates **Text Control** for each **text layer**.

<div drawio-diagram="6795"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726235688.png" alt=""/></div>

<div class="contents" id="bkmrk--87"><div class="contents"><div class="textblock">  
</div></div></div>##### Control: Tell Tale

The Smart Importer creates a **Tell Tale Control** when the **group name** has the `_telltale` **suffix and contains a child image layer**.

<div class="contents" id="bkmrk--89"><div class="contents"><div class="textblock"><div drawio-diagram="6785"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726233615.png" alt=""/></div>

</div></div></div>##### Control: TextButton

The Smart Importer creates a **TextButton** Control when the layer meets either of the following conditions:

- the group layer contains a **child text layer**
- the text layer name has a `_Button` **suffix**.

<div drawio-diagram="6796"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726235918.png" alt=""/></div>

<div class="contents" id="bkmrk-the-rectangle-shape-"><div class="textblock"><dl class="note"><dd><p class="callout info">Smart Importer supports only rectangle shapes; it does not support other shapes, such as polygons.</p>

</dd></dl></div></div><div class="contents" id="bkmrk--0"><div class="contents"><div class="textblock">---

</div></div></div>#### AdobeXD Features Supported by CGI Studio Smart Importer

The Smart Importer supports importing the following Adobe XD features:

<div class="contents" id="bkmrk-artboards-components"><div class="contents"><div class="contents"><div class="textblock">

- <span style="color: rgb(230, 126, 35);">[Artboards](#bkmrk-artboards)</span>
- <span style="color: rgb(230, 126, 35);">[Components](#bkmrk-components)</span>
- <span style="color: rgb(230, 126, 35);">[Texts](#bkmrk-texts)</span>
    - Text
    - Font
    - FontStyle
    - FontSize
    - FillColor
    - Position
    - Size
- <span style="color: rgb(230, 126, 35);">[Images](#bkmrk-images)</span>
    - Position
    - Size
- <span style="color: rgb(230, 126, 35);">[Solid Rectangles](#bkmrk-solid-rectangles)</span>
    - Color
    - Position
    - Size
- <span style="color: rgb(230, 126, 35);">[Buttons](#bkmrk-buttons)</span>
    - Text
- <span style="color: rgb(230, 126, 35);">[Transitions](#bkmrk-transitions)</span>
- [<span style="color: rgb(230, 126, 35);">TellTales</span>](#bkmrk-telltales)

</div></div></div></div>##### Artboards

The Smart Importer converts each AdobeXD Artboard into a **Scene** in SceneComposer.

##### Components

Adobe XD has a component system where you can define components once and instantiate them multiple times. If an artboard references a component, the Adobe XD converter looks up and instantiates components as needed.

##### Texts

The Smart Importer converts Adobe XD **text areas** into **Text Nodes** in SceneComposer.

It reads the configuration of the Adobe XD text and applies the following properties to the SceneComposer Text Node:

<table border="1" id="bkmrk-property-description" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 16.5741%;"></col><col style="width: 50.1455%;"></col><col style="width: 33.3598%;"></col></colgroup><tbody><tr><td style="background-color: rgb(53, 152, 219);"><span style="color: rgb(236, 240, 241);">**Property**</span></td><td style="background-color: rgb(53, 152, 219);"><span style="color: rgb(236, 240, 241);">**Description**</span></td><td style="background-color: rgb(53, 152, 219);"><span style="color: rgb(236, 240, 241);">**Example**</span></td></tr><tr><td>Text</td><td>the text to display</td><td>  
</td></tr><tr><td>Font</td><td>the font's PostScript name</td><td>OpenSans-Light</td></tr><tr><td>FontStyle</td><td>the font's style</td><td>Light</td></tr><tr><td>FontSize</td><td>the font's point size</td><td>72</td></tr><tr><td>FillColor</td><td>a fill color (if the Adobe XD file configures a <code>solid</code>-style)</td><td>  
</td></tr><tr><td>Position</td><td>the position of the text area in the scene</td><td>  
</td></tr><tr><td>Size</td><td>the size of the text area (see note below)</td><td>  
</td></tr></tbody></table>

<div class="contents" id="bkmrk-if-an-adobexd-text-a"><div class="contents"><div class="contents"><div class="textblock"><dl class="note"><dd><p class="callout info">If the AdobeXD file defines a text area with <code>Auto Width</code> and <code>Auto Height</code>, the Smart Importer cannot calculate the text area bounding box. </p>

</dd></dl></div></div></div></div>See section <span style="color: rgb(230, 126, 35);">[Text Controls](#bkmrk-text-controls)</span> in the<span style="color: rgb(0, 0, 0);"> Adobe XD import example.</span>

##### Images

The Smart Importer converts Adobe XD shapes (`"type": "shape"`) with a pattern fill (a `fill` of `"type": "solid"`) to **RenderNodes**.

It applies the following properties to the SceneComposer RenderNode:

<div class="contents" id="bkmrk-position-size"><div class="contents"><div class="contents"><div class="textblock">

- *Position*
- *Size*

</div></div></div></div>##### Solid Rectangles

The Smart Importer converts rectangles (`shape`s of `"type": "rect"`) with a solid fill (a `fill` of `"type": "solid"`) to **SolidColorNodes**.

It applies the following properties to the SceneComposer SolidColorNode:

<div class="contents" id="bkmrk-color-position-size"><div class="contents"><div class="textblock">

- *Color*
- *Position*
- *Size*

</div></div></div>See section<span style="color: rgb(230, 126, 35);"> [Rectangle](#bkmrk-rectangle)</span> in the<span style="color: rgb(0, 0, 0);"> Adobe XD import example.</span>

##### Buttons

If the Adobe XD resource contains a group whose name ends with` _Button`, the Smart Importer creates a **TextButton**.

<div class="contents" id="bkmrk-smart-importer-check"><div class="contents"><div class="textblock"><dl class="note"><dd><p class="callout info">The Smart Importer checks the suffix in a **case insensitive** way, so <code>&#95;button</code> or <code>&#95;BUTTON</code>, and similar also work.</p>

</dd></dl></div></div></div>The Smart Importer applies the following properties to the SceneComposer TextButton:

<div class="contents" id="bkmrk-text---the-first-tex"><div class="contents"><div class="contents"><div class="textblock">

- *Text* - The Smart Importer uses the first text label inside the Adobe XD group as the TextButton's Text.

</div></div></div></div><div drawio-diagram="9201"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-09/drawing-5-1788512522.png" alt=""/></div>

<div class="contents" id="bkmrk--7"><div class="contents"><div class="textblock">  
</div></div></div><div class="contents" id="bkmrk-the-button-depicted-"><div class="contents"><div class="textblock"><dl class="note"><dd><p class="callout info">The button depicted above provokes a Scene transition. The Smart Importer takes this transition from the first artboard transition inside the group. See <span style="color: rgb(230, 126, 35);">[Transitions](#bkmrk-transitions)</span>.</p>

</dd></dl></div></div></div>#####  

##### Transitions

Adobe XD supports building interactive prototypes with several kinds of transitions. A button can trigger a navigation transition to a different artboard, and a component can support transitions between different states. SceneComposer supports button-triggered Scene transitions that Scene Composer generates from artboard transitions in the XD file.

<div drawio-diagram="544"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-02/drawing-4-1676360249.png" alt=""/></div>

<div class="textblock" id="bkmrk--9"></div><div class="textblock" id="bkmrk--10"></div><div class="textblock" id="bkmrk--11"><div drawio-diagram="6791"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726235118.png" alt=""/></div>

</div><div class="textblock" id="bkmrk--12"></div>See <span style="color: rgb(230, 126, 35);">[Transition](#bkmrk-transition) </span>in th<span style="color: rgb(0, 0, 0);">e Adobe XD import example.</span>

##### Tell Tales

The Smart Importer creates a **Tell Tale Control** for an Adobe XD group whose name ends with `_TellTale`.

- If the group contains an image with `OnState` in its name, the Smart Importer sets it as the Tell Tale Control's **On State Image**.
- If the group contains an image with `OffState` in its name, the Smart Importer sets it as the Tell Tale Control's **Off State Image**.

<div class="contents" id="bkmrk-smart-importer-check-0"><div class="contents"><div class="textblock"><dl class="note"><dd><p class="callout info">The Smart Importer checks the group name's suffix and the image names in a **case insensitive** way, so <code>&#95;Telltale </code>or <code>&#95;telltale</code>, <code>ONSTATE&#95;pic</code>,  <code>image&#95;offstate&#95;picture</code> and similar variants also work.</p>

</dd></dl></div></div></div>See <span style="color: rgb(230, 126, 35);">[Tell Tale Control](#bkmrk-tell-tale-control)</span> in the Adobe XD import example.

---

#### Adobe XD import example

This sample explains the layer structure and restrictions for Adobe XD.

Get the sample Adobe XD file from the following location:

**"...\\cgi\_studio\_content\\2D\\XD\\XD\_SampleCluster.xd"**

##### Rectangle

The Smart Importer supports only rectangle shapes for import, therefore it does not import the polygon in the "Next\_Button" group as depicted below.

<div drawio-diagram="9200"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-09/drawing-5-1788512471.png" alt=""/></div>

<div class="contents" id="bkmrk--17"><div class="contents"><div class="textblock"></div></div></div>##### Text Controls

The Smart Importer sets a text layer as a Text Control, as it does for other file formats. In this sample, the following layers are text layers:

<div class="contents" id="bkmrk-change-view-under-%22n"><div class="contents"><div class="contents"><div class="textblock">

- Change view under "Next\_Button"
- All child layers under "Textboxes".
- The 72kmh label under "Speed gauge"
- D under "Battery gauge"

</div></div></div></div><div drawio-diagram="9202"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-09/drawing-5-1788512848.png" alt=""/></div>

<div class="contents" id="bkmrk--19"><div class="contents"><div class="textblock"></div></div></div>##### Tell Tale Control

Because the sample file contains a "TellTale" group whose name has the `_telltale` suffix, the Smart Importer sets its child image layers as Tell Tale Control.

<div drawio-diagram="9199"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-09/drawing-5-1788512239.png" alt=""/></div>

<div class="contents" id="bkmrk--21"><div class="contents"><div class="textblock"></div></div></div>##### Transition

The Smart Importer transfers the transition setting that is included in the Adobe XD file to State Machine Editor.

<div drawio-diagram="541"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-02/drawing-4-1676360124.png" alt=""/></div>

<div class="contents" id="bkmrk--23"><div class="contents"><div class="textblock"></div></div></div>##### Other options

If necessary, change the **Import to folder** setting and its related options. Check **Resize Display Resolution** if needed.

<div drawio-diagram="6805"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726236863.png" alt=""/></div>

<div class="contents" id="bkmrk--49"><div class="contents"><div class="textblock"></div></div></div>##### Check the Import Result in the Player

1. After configuring these settings, click **OK** in the Smart Importer dialog to proceed with the import.
2. Click **Play** with **Generate and Play** selected.
3. When the Player application starts, clear "Scenes#Scene2D" to view the import result.
4. Click **Change view** in the lower-right corner to transition to the other scene according to the transition defined in Adobe XD.

<div drawio-diagram="543"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-02/drawing-4-1676360178.png" alt=""/></div>

<div class="contents" id="bkmrk--53"><div class="textblock">  
</div></div>

# Figma

Smart Importer can import Figma data. This page explains how to import Figma data with Smart Importer and how to work with the results.

<p class="callout warning">You cannot import Figma data for which you do not have editing privileges.</p>

---

### Preparations for Importing Figma Data

#### Preparing the URL and Access Token  


Before you import Figma data with Smart Importer, acquire the URL and access token for the Figma data.

Obtain the URL and access token in the Figma Desktop App as follows.

<p class="callout info">Ensure that you have access to the Figma REST API (<span style="color: rgb(230, 126, 35);">[https://api.figma.com](https://api.figma.com)</span>). In case of a connectivity issue, contact your IT department because a firewall might block the API.  
</p>

##### Acquiring the URL

In the top bar of the Figma Desktop App, right-click the relevant project tab, and then select **Copy Link** from the context menu.

<div drawio-diagram="8004"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2025-02/drawing-7-1740621465.png" alt=""/></div>

##### Acquiring the Access Token

1. In the Figma Desktop App, select **Figma Icon &gt; Help and Account &gt; Account Settings** to open the dialog.  
    <div drawio-diagram="8005"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2025-02/drawing-7-1740621587.png" alt=""/></div>
2. In the **Security** tab of the dialog, click **Generate new token** under **Personal access tokens**.  
    <div drawio-diagram="8006"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2025-02/drawing-7-1740621955.png" alt=""/></div>
3. In the **Generate new token** dialog, set the **Token name, Expiration**, and **Scopes**, and then click **Generate token**.  
    <div drawio-diagram="8907"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-01/drawing-7-1768380041.png" alt=""/></div>
4. Figma displays the created access token under **Personal access tokens** on the **Security** tab of the dialog.  
    <div drawio-diagram="8008"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2025-02/drawing-7-1740622348.png" alt=""/></div>

<p class="callout info">The instructions on how to obtain the URL and access token apply to Figma Desktop App version 125.10.8.</p>

---

### How to Import Figma Data

1. From the Scene Composer toolbar, select **Import &gt; Smart Importer &gt; From Cloud Resource...**
    - Scene Composer displays a new dialog titled **Import from cloud resource**.
    
    <div drawio-diagram="7111"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-7-1729497030.png" alt=""/></div>
2.  Enter the URL and access token in the respective fields and click **OK**. For information about acquiring the URL and access token, see <span style="color: rgb(0, 0, 0);"><span style="color: rgb(230, 126, 35);">[Preparing the URL and Access Token](#bkmrk-PreparingTheURLAndAccessToken)</span>.</span><div drawio-diagram="7110"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-7-1729496909.png" alt=""/></div>
3. The Smart Importer dialog opens. The procedure for using Smart Importer is the same as for other file types. 
    - For details, see <span style="color: rgb(230, 126, 35);">[3. Scene Composer &gt; Import of Resources &gt; Smart Importer &gt; Basic Operation](https://doc3161en.candera.eu/books/import-of-resources/page/basic-operations "Smart Importer")</span>.
4. Adjust the necessary settings, and then click **OK**. 
    - Smart Importer imports the data into the folder that you specified <span style="color: rgb(0, 0, 0);">in **Import to folder**.</span><div drawio-diagram="7112"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-7-1729497265.png" alt=""/></div>
        
        <p class="callout info">If you entered an incorrect or invalid URL or access token in the **Import from cloud resource** dialog, Smart Importer stops the import and displays the following error dialog.</p>
        
        <div drawio-diagram="9126"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-07/drawing-7-1784179561.png" alt=""/></div>

<p class="callout info">API access limits vary depending on your subscription plan. If your API requests exceed that limit, Smart Importer stops the import and displays the following error dialog. For details on each plan, see Figma’s official website.</p>

<div drawio-diagram="9127"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-07/drawing-7-1784179587.png" alt=""/></div>

---

### Importing Figma Data - Advanced  


#### Importing as a scene

Smart Importer imports the topmost item of each page in the Figma data as a scene.   
Use the following naming : `<span style="color: rgb(0, 0, 0);"><Page name>_<Parent item name></span>`

<div drawio-diagram="7113"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-7-1729498578.png" alt=""/></div>

#### Relationship between Figma items and Scene Composer Nodes   


When you import Figma items with Smart Importer, Smart Importer imports each item as a specific type of node, as shown in the following table.

<table border="1" id="bkmrk-scene-composer-node-" style="border-collapse: collapse; width: 100%; height: 327.766px; border-width: 1px;"><colgroup><col style="width: 23.3622%;"></col><col style="width: 25.8344%;"></col><col style="width: 17.1817%;"></col><col style="width: 16.6891%;"></col><col style="width: 16.809%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td colspan="2" rowspan="2" style="height: 59.5938px; border-width: 1px;">  
</td><td class="align-center" colspan="3" style="height: 29.7969px; border-width: 1px;">Scene Composer node type  
</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px; border-width: 1px;">Group</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">Bitmap</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">Text</td></tr><tr style="height: 29.7969px;"><td rowspan="14" style="height: 268.172px; border-width: 1px;">Figma item type  
</td><td style="height: 29.7969px; border-width: 1px;">Component</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">✓</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-width: 1px;">ComponentSet</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">✓</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-width: 1px;">Ellipse</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">✓</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-width: 1px;">Frame</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">✓</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-width: 1px;">Group</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">✓</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-width: 1px;">Instance</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">✓</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-width: 1px;">Line</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">✓</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-width: 1px;">Polygon</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">✓</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; border-width: 1px;">Rectangle</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">✓</td><td class="align-center" style="height: 29.7969px; border-width: 1px;">  
</td></tr><tr><td style="border-width: 1px;">Section</td><td class="align-center" style="border-width: 1px;">✓</td><td class="align-center" style="border-width: 1px;">  
</td><td class="align-center" style="border-width: 1px;">  
</td></tr><tr><td style="border-width: 1px;">Slice</td><td class="align-center" style="border-width: 1px;">  
</td><td class="align-center" style="border-width: 1px;">✓</td><td class="align-center" style="border-width: 1px;">  
</td></tr><tr><td style="border-width: 1px;">Star</td><td class="align-center" style="border-width: 1px;">  
</td><td class="align-center" style="border-width: 1px;">✓</td><td class="align-center" style="border-width: 1px;">  
</td></tr><tr><td style="border-width: 1px;">Text</td><td class="align-center" style="border-width: 1px;">  
</td><td class="align-center" style="border-width: 1px;">  
</td><td class="align-center" style="border-width: 1px;">✓</td></tr><tr><td style="border-width: 1px;">Vector</td><td class="align-center" style="border-width: 1px;">  
</td><td class="align-center" style="border-width: 1px;">✓</td><td class="align-center" style="border-width: 1px;">  
</td></tr></tbody></table>

<p class="callout info">Smart Importer imports bitmap and text items only when Figma provides their render data. For example, if you set a Figma item to **hidden**, Smart Importer cannot import it.</p>

#### Importing as Controls or Bitmaps

Smart Importer can import any Figma item as a control or bitmap. The imported item can contain the following child items:

- Component
- ComponentSet
- Frame
- Group
- Instance
- Section

##### Importing as a control

Smart Importer imports an item as a control when the name is <span style="color: rgb(0, 0, 0);">`SC_<control name>`</span>. You can also specify control property values by naming child items after the corresponding control properties. If a child item name matches a control property name in Scene Composer, Smart Importer can automatically map the bitmap from the Figma file to that property.

For example, Scene Composer's **CheckBox** control provides multiple image properties. When a Figma file contains an item named **SC\_CheckBox** with child items whose names match these properties, Smart Importer automatically assigns the corresponding bitmaps to the correct control properties (see the image below). This way, no manual assignment of image properties is necessary in Smart Importer.

<div drawio-diagram="7115"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-7-1729499805.png" alt=""/></div>

<p class="callout info">Smart Importer supports this functionality only for *Touchable* and *Common* controls.  
</p>

##### Importing as bitmaps

Smart Importer can import group items that contain child items as bitmaps when you prefix the group item name with <span style="color: rgb(0, 0, 0);">`SC_Bmp`.</span>

<div drawio-diagram="7116"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-7-1729501904.png" alt=""/></div>

---

#### Import as a State Machine  


When you define flows (screen transitions) in Figma, Smart Importer imports the structure of screen transitions into Scene Composer as a state machine.    
You can review the imported state machine in the **State Machine Editor** in **Scene Composer**.

##### Figma Settings: Scenes and Flows

In Figma, define multiple scenes and the flows that connect them. Create screen transitions beginning with the scene designated as the flow start point.

<div drawio-diagram="8980"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-04/drawing-7-1776928546.png" alt=""/></div>

##### The Import Result in Scene Composer

Smart Importer imports the flow structure defined in Figma into CGI Studio as a state machine.

<div drawio-diagram="8981"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-04/drawing-7-1776928764.png" alt=""/></div>

The state machine starts from the state that corresponds to the scene that you set as the flow start point in Figma. After importing, for each generated state, Smart Importer automatically creates a screenshot of the corresponding Figma scene. Scene Composer's State Machine Editor displays this screenshot as a Scene Image.

<div drawio-diagram="8983"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-04/drawing-7-1776929717.png" alt=""/></div>

If a Figma file contains multiple flows, Smart Importer imports each flow as an independent state machine.

<div drawio-diagram="7125"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-7-1729503521.png" alt=""/></div>

<div drawio-diagram="7124"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-7-1729503495.png" alt=""/></div>

<p class="callout info">If you include a transition from one flow in a separate flow (that is, when a transition is duplicated), Smart Importer does not import the separate flow.   
</p>

##### Names and Behavior After Importing as a State Machine

- Names After Import 
    - The name of the state machine after import is `StateMachine<Flow Name>`.
    - After import, each state has the same name as the Figma item that Smart Importer imports as a scene.
- <div class="scriptor-paragraph">In Figma, you can select the interaction that triggers screen transitions, such as click, drag, or mouse over. </div><div class="scriptor-paragraph">Regardless of the interaction that you defined in Figma, Smart Importer sets Scene Composer's Transition properties as follows:  
    </div>
    
    
    - **Event**: &#96;Clicked&#96;
    - **Condition**: &#96;Check Click&#96;

---

#### Importing a Layout

##### Auto layout

If you set **Auto layout** on a Figma **Frame**, Smart Importer imports the frame as a **Stack Layout** in **Scene Composer** and applies each Auto layout setting as a Stack Layout property.

<div drawio-diagram="8009"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2025-02/drawing-7-1740634409.png" alt=""/></div>

Smart Importer applies Figma Auto layout settings as properties of Scene Composer's Stack Layout:

<div drawio-diagram="7128"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-7-1729578499.png" alt=""/></div>

<table border="1" id="bkmrk-auto-layout-%EF%BC%88figma%EF%BC%89-" style="border-collapse: collapse; width: 97.037%; height: 648.266px;"><colgroup><col style="width: 4.45869%;"></col><col style="width: 22.0387%;"></col><col style="width: 73.5046%;"></col></colgroup><tbody><tr style="height: 57.7812px;"><td style="height: 57.7812px; background-color: rgb(230, 126, 35);">  
</td><td class="align-center" style="height: 57.7812px; background-color: rgb(230, 126, 35);"><span style="color: rgb(255, 255, 255);">**Auto layout**</span>

<span style="color: rgb(255, 255, 255);">**(Figma)**</span>

</td><td class="align-center" style="height: 57.7812px; background-color: rgb(230, 126, 35);"><span style="color: rgb(255, 255, 255);">**Stack Layout Properties**</span>

<span style="color: rgb(255, 255, 255);">**(Scene Composer)**</span>

</td></tr><tr style="height: 57.7812px;"><td rowspan="2" style="height: 214.422px; background-color: rgb(230, 126, 35);"><span style="color: rgb(255, 255, 255);">**1**</span>  
<span style="color: rgb(255, 255, 255);">  
</span><span style="color: rgb(255, 255, 255);">  
</span><span style="color: rgb(255, 255, 255);">  
</span></td><td style="height: 57.7812px;">**Direction**

</td><td style="height: 57.7812px;">Stack Layout

**Layouter &gt; Arrangement**

</td></tr><tr style="height: 156.641px;"><td colspan="2" style="height: 156.641px;"><table border="1" style="width: 100.137%; height: 119.188px;"><colgroup><col style="width: 22.5412%;"></col><col style="width: 77.4588%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td class="align-center" style="background-color: rgb(230, 126, 35); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Direction</span></td><td class="align-center" style="background-color: rgb(230, 126, 35); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Arrangement</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Vertical layout**</td><td style="height: 29.7969px;">Vertical</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Horizontal layout**</td><td rowspan="2" style="height: 59.5938px;">Horizontal  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Wrap**</td></tr></tbody></table>

</td></tr><tr style="height: 46.0156px;"><td rowspan="2" style="background-color: rgb(230, 126, 35); height: 202.719px;"><span style="color: rgb(255, 255, 255);">**2**</span>  
<span style="color: rgb(255, 255, 255);">  
</span></td><td style="height: 46.0156px;">**Gap**</td><td style="height: 46.0156px;">Each node after the first node in the Stack Layout  
**Layout &gt; Margin &gt; Left or Top**

</td></tr><tr style="height: 156.703px;"><td colspan="2" style="height: 156.703px;"><table border="1" style="border-collapse: collapse; width: 100.137%;"><colgroup><col style="width: 22.4044%;"></col><col style="width: 77.5956%;"></col></colgroup><tbody><tr><td class="align-center" style="height: 29.8785px; background-color: rgb(230, 126, 35);"><span style="color: rgb(255, 255, 255);">Direction</span></td><td class="align-center" style="height: 29.8785px; background-color: rgb(230, 126, 35);"><span style="color: rgb(255, 255, 255);">Margin</span></td></tr><tr><td>**Vertical layout**</td><td>Top</td></tr><tr><td>**Horizontal layout**</td><td rowspan="2">Left  
</td></tr><tr><td>**Wrap**</td></tr></tbody></table>

</td></tr><tr style="height: 57.7812px;"><td style="background-color: rgb(230, 126, 35); height: 57.7812px;"><span style="color: rgb(255, 255, 255);">**3**</span></td><td style="height: 57.7812px;">**Alignment**</td><td style="height: 57.7812px;">Nodes included in a Stack Layout

**Layout &gt; VerticalAlignment and HorizontalAlignment**

</td></tr><tr style="height: 57.7812px;"><td style="height: 57.7812px; background-color: rgb(230, 126, 35);"><span style="color: rgb(255, 255, 255);">**4**</span></td><td style="height: 57.7812px;">**Padding (Horizontal)**</td><td style="height: 57.7812px;">The node to be placed at the leftmost position of the Stack Layout  
**Layout &gt; Margin &gt; Left**

</td></tr><tr style="height: 57.7812px;"><td style="height: 57.7812px; background-color: rgb(230, 126, 35);"><span style="color: rgb(255, 255, 255);">**5**</span></td><td style="height: 57.7812px;">**Padding (Vertical)**</td><td style="height: 57.7812px;">The topmost node in the Stack Layout  
**Layout &gt; Margin &gt; Top**

</td></tr></tbody></table>

The following example shows how Scene Composer's Stack Layout inherits Figma's horizontal Auto layout settings.

<div drawio-diagram="7189"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-10/drawing-7-1730094273.png" alt=""/></div>

##### Text Layout

When Smart Importer imports a Figma text layer into Scene Composer, it creates a Group node with LayoutType **Overlay**, and additionally a TextNode under that group.

<div drawio-diagram="7574"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-11/drawing-5-1732891835.png" alt=""/></div>

In addition, Scene Composer's TextNode layout property inherits the Typography Alignment settings from the Figma text layer.

<div drawio-diagram="7575"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-11/drawing-5-1732891908.png" alt=""/></div>

---

#### Importing Fonts

When importing Figma data with Smart Importer, you can import any fonts that are used in the Figma design but are not available in the current Scene Composer solution.

During import, Smart Importer compares the fonts used in the Figma design with the fonts available in the solution. If it detects a missing font, Smart Importer opens the Smart Importer dialog and displays font-selection options.

In the Smart Importer dialog, select one of the following options for each missing font:

<div id="bkmrk-replace-it-with-an-e">

- Replace it with an existing font (select an existing font from the dropdown menu)
- Import the font as a new resource (select **Import** from the dropdown menu)

</div><div drawio-diagram="9020"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-06/drawing-7-1780564485.png" alt=""/></div>

<div id="bkmrk--54"></div><div id="bkmrk-if-import-is-selecte">If you select **Import**, Smart Importer adds the corresponding font to the solution and stores it in the <code>Resources&#92;Fonts</code> folder. <div>If you select an existing font, Smart Importer applies that font to the imported data.</div></div><p class="callout info">In the Smart Importer dialog, Smart Importer displays the **Import** option for each font in the dropdown menu only when it can import the corresponding font.</p>

<p class="callout info">If the `Resources\Fonts` folder does not exist in the solution, Smart Importer automatically creates it.</p>

---

#### Automatic Text Mapping

During the import of Figma data, Smart Importer can compare the TextNode content with the Language Table and automatically assign matching Text IDs. Previously, you had to manually assign a Text ID to each TextNode after import. This feature enables automation of the mapping process.

Smart Importer compares the displayed text Strings in the Figma data with the Master Language Strings in the Language Table. If it finds a matching String, it automatically assigns the corresponding Text ID for that String.

##### Configuration

<div id="bkmrk-smart-importer-123"><div>Enable or disable this feature in the Smart Importer dialog under the **Import Settings** tab using the **Map language table to texts** option. Smart Importer enables this setting by default.</div><div><div drawio-diagram="9021"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-06/drawing-7-1780564599.png" alt=""/></div>

</div></div>
##### Behavior

The feature workflow includes the following three steps: Smart Importer retrieves the text, compares it with the Language Table and assigns the Text ID.

1. Smart Importer retrieves the text String from the TextNode  
    In the following example, it retrieves the String "TEST".  
    <div drawio-diagram="9025"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-06/drawing-7-1781072528.png" alt=""/></div>
2. Smart Importer compares the retrieved String with the master language in the Language Table  
    
    In the following example, it compares the String retrieved in step 1 with the master language \[00\] in the **Language Table**.
    
    <div drawio-diagram="9022"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-06/drawing-7-1780564721.png" alt=""/></div>
3. If Smart Importer finds a match, it assigns the Text ID  
    <div>In the example below, it assigns the Text ID of the matching Language Table entry to the TextNode <div drawio-diagram="9024"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-06/drawing-7-1780564930.png" alt=""/></div>
    
    </div>

<p class="callout info">If multiple Text IDs exist for the same text String, Smart Importer uses the first matching Text ID.</p>

<p class="callout info">If there is no matching text String, Smart Importer does not assign a Text ID.</p>

---

# The example file of Figma

This section describes how to use the instrument cluster as a Figma design file. The example file is stored in the following location.

<span style="color: rgb(0, 0, 0);">`<root>/cgi_studio_content/2D/Figma/AI_Cluster_Sample.fig`</span>

Due to technical limitations, Scene Composer cannot open Figma design files directly. For this reason, the first step is to import them into your personal Figma account.

1. Log in to your Figma account.  
    <div drawio-diagram="3723"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-06/drawing-4-1686099974.png" alt=""/></div>
2. In your Figma account, click **Import Files** and load the ***AI\_Cluster\_Sample.fig*** file.  
    <div drawio-diagram="3724"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-06/drawing-4-1686099989.png" alt=""/></div>
3. Figma uploads the ***AI\_Cluster\_Sample.fig*** file to your account.  
    <div drawio-diagram="3725"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-06/drawing-4-1686100005.png" alt=""/></div>
4. After Figma uploads the file, ***AI\_Cluster\_Sample*** appears in your file list.  
    <div drawio-diagram="3726"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-06/drawing-4-1686100021.png" alt=""/></div>

To import this sample file using the Smart Importer, select **Import &gt; Smart Importer &gt; Import from Cloud Resource...** from the menu and follow the import instructions. See <span style="background-color: rgb(255, 255, 255);"><span style="color: rgb(230, 126, 35);">[Figma import instructions](https://doc3161en.candera.eu/books/import-of-resources/page/figma)</span> </span>for more information.

# Automatic Imports

If necessary, you can configure monitored folders for Automatic Imports of both images and Filmbox (FBX) files. To use the Automatic Imports feature, enable Automatic Imports. This can be done in two ways:

1. Open the **Automatic Imports Configuration** dialog by selecting **Import &gt; Configure  Automatic Imports...** in the menu. In this dialog, check the **Enable automatic import** box. <div drawio-diagram="6812"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726239930.png" alt="drawing-5-1726239930.png"/></div>
    
    Each item in the **Automatic Import Configuration** dialog lets you configure Automatic Import settings.
    
    <table style="border-collapse:collapse;width:100%;"><colgroup><col style="width:25.5363%;"></col><col style="width:74.5979%;"></col></colgroup><tbody><tr><td>**Monitored Folder**</td><td>Specifies the folder that SceneComposer monitors.</td></tr><tr><td>**Import Destination**</td><td>Specifies the destination folder for imported files.</td></tr><tr><td>**Include subfolders**</td><td>Specifies if SceneComposer should monitor files in the subfolders of the selected **Monitored Folder**.</td></tr><tr><td>**Sync on startup**</td><td>Specifies if SceneComposer should automatically sync the selected **Monitored Folder** when this solution is opened.
    
    If **Sync on startup** is enabled, the **Automatic Import** prompt appears when the solution is opened, allowing you to confirm the import before it proceeds.
    
    </td></tr></tbody></table>
    
    <p class="callout info">SceneComposer synchronizes monitored folders in the following two cases:  
    - You enable **Sync on startup** in the **Automatic Imports Configuration** dialog, but SceneComposer has not synchronized monitored folders during solution startup.  
    - You change **Sync on startup** from disabled to enabled.</p>
2. Open the **Solution Options** dialog by selecting **File &gt; Solution Options...** in the menu. In the **General Configuration** section, check the **Enable automatic import** box. <div drawio-diagram="6811"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726239874.png" alt="drawing-5-1726239874.png"/></div>

<div class="contents" id="bkmrk-"><div class="contents"><div class="textblock">  
</div></div></div>When the folder contents change, SceneComposer notifies you that imports are pending, offering the following import options:

- **Import with preview changes**: SceneComposer opens the **Import Images** dialog granting you full control over the import process.
- **Import without preview changes**: SceneComposer imports the files without any further user interaction necessary.

 Scene Composer saves the configured paths for each solution in

```
	USER_DIR\ AppData\Roaming\SceneComposer\Solutions\
```

<div drawio-diagram="6813"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726240359.png" alt="drawing-5-1726240359.png"/></div>

<div class="contents" id="bkmrk-when-a-solution-is-c"><div class="contents"><div class="textblock"><dl class="note"><dt></dt><dd></dd><dd><p class="callout info">When you convert a solution to another version or migrate it to another platform, the Automatic Imports configuration will not be preserved.</p>

</dd><dd></dd></dl></div></div></div>As a best practice, consider configuring the monitored folders so that they contain either

- only image files or
- only FBX files and images required by these FBX files.

The reason for this is, if the modified files on disk include an FBX file, SceneComposer performs only an FBX import and does not import modified image files that are not required by the FBX file.

# Image Update

#### Image Update

This feature allows you to update an entire folder including all subfolders and images in a single operation rather tan updating individual image files separately. Using **Image Update**, SceneComposer preserves the folder hierarchy of the imported folder and applies it to the **Solution Folder** defined in the solution.

Select **Import &gt; Image Update...** in the menu to open the **Image Update** dialog.

<div drawio-diagram="6815"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726240488.png" alt="drawing-5-1726240488.png"/></div>

<div class="contents" id="bkmrk--0"><div class="contents"><div class="textblock">  
</div></div></div>In the **Image Update** dialog's **Solution Folder** drop down menu, select the solution folder containing the images you want to update. Click **Select Update Folder...**, then select the folder that contains the replacement images and click **OK**. SceneComposer shows a warning if the folder is empty or does not contain any images.

Click **Read Folder** to scan the selected folder and its subfolders recursively for images to import. This may take several minutes for large amounts of images. The result of this scan is displayed in a table directly below.

You can filter the images displayed in the table. Select a search criterion from the **Search by** drop-down menu to specify the column to search. Then, enter a search string in the text field to the right. SceneComposer displays all matching results.

The following options are available in **Search by**:

<div class="contents" id="bkmrk-image-to-update%3A-the"><div class="contents"><div class="textblock">

- **Image to update**: The image's relative path in the SceneComposer solution. <div drawio-diagram="6817"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726240850.png" alt="drawing-5-1726240850.png"/></div>
- **Status**: The status of the image. <div drawio-diagram="3353"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-04/drawing-4-1682645044.png" alt="drawing-4-1682645044.png"/></div>
- **Update with**: The image's relative path on the storage device. <div drawio-diagram="434"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-02/drawing-4-1676352432.png" alt="drawing-4-1676352432.png"/></div>

</div></div></div>Check **Add new images** to add newly found images to the solution. Clear **Add new images** to update only existing images.

<div drawio-diagram="435"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-02/drawing-4-1676352460.png" alt="drawing-4-1676352460.png"/></div>

<div class="contents" id="bkmrk--2"><div class="contents"><div class="textblock">  
</div></div></div>Click **Save Report...** to save the image comparison results as a comma-separated values (CSV) file. In the **Save Image Update Report** dialog specify the file name and location for the report.

If the update folder contains fewer images than the solution, SceneComposer updates only the images found in the selected folder. Images that are not found are listed as **Missing** **images** in the report and are not modified by the update process.

---

#### Summary of the update process

After the images have been updated, SceneComposer displays a summary of the actions performed in the **Image Update Summary** dialog. Click **Save Report...** to save this summary as a comma-separated values (CSV) file. In the **Save Image Update Summary Report** dialog specify the file name and location for this report.

<div drawio-diagram="3354"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-04/drawing-4-1682645087.png" alt="drawing-4-1682645087.png"/></div>

<div class="contents" id="bkmrk--5"><div class="textblock">  
</div></div>

# glTF Files

This section provides additional information on the use of glTF files in Scene Composer.

<div class="contents" id="bkmrk--4"><div class="contents">  
</div></div>#### Animations

Scene Composer provides a working sample that shows how to use glTF animations. See <span style="color:rgb(230,126,35);">[Physically Based Rendering Solution](https://doc3161en.candera.eu/books/sample-solutions/page/physically-based-rendering-solution "Physically Based Rendering Solution")<span style="color:rgb(0,0,0);"> for details.</span></span>

Scene Composer supports interpolation animation; however, morphing or the channel path "weights" are not supported.

The following animation types are supported:

<div class="contents" id="bkmrk-translation-rotation"><div class="contents"><div class="textblock">

- translation
- rotation
- scale.

</div></div></div>The following interpolation strategies are supported:

<div class="contents" id="bkmrk-linear-step-cubicspl"><div class="contents"><div class="contents"><div class="textblock">

- linear
- step
- cubicspline

</div></div></div></div><p class="callout info">glTF specifies rotation angles in quaternions. CGIStudio converts the values to Euler angles.  
</p>

For more information about animations, see <span style="color:rgb(230,126,35);">[the Khronos website: animations](https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#animations)</span>. For a more detailed description about interpolation types see <span style="color:rgb(230,126,35);">[the Khronos website: animation sampler](https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#reference-animation-sampler)</span>.

<div class="contents" id="bkmrk--15"><div class="contents"><div class="textblock">  
</div></div></div>---

#### The Software Development Kit (SDK) version

The glTF importer uses the Microsoft glTF-SDK in version v1.9.1.0. Download the Microsoft glTF-SDK from <span style="color:rgb(230,126,35);">[Microsoft gtTF-SDK GitHub repository](https://github.com/microsoft/glTF-SDK)</span>.

<div class="contents" id="bkmrk--17"><div class="contents"><div class="textblock">  
</div></div></div>---

#### Reference models

Scene Composer uses the boombox as a reference model. The folder `cgi_studio_content/3D/glTF/ `contains the glTF file. Visit [<span style="color:rgb(230,126,35);">The Khronos website: glTF Sample Models</span>](https://github.com/KhronosGroup/glTF-Sample-Models) to find more available reference models.

<div class="contents" id="bkmrk--19"><div class="contents"><div class="contents"><div class="textblock"><div drawio-diagram="291"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2023-02/drawing-4-1676342296.png" alt="drawing-4-1676342296.png"/></div>

</div><div class="textblock">  
</div></div></div></div>#### Supported glTF Extensions and Multi UV

Scene Composer’s glTF import supports the following glTF 2.0 extensions as well as multiple UV sets (Multi UV).

<table id="bkmrk-khr_lights_punctual-" style="border-collapse:collapse;width:800px;height:555.818px;border-width:0px;"><colgroup><col style="width:239px;"></col><col style="width:561px;"></col></colgroup><tbody><tr style="height:29.5227px;"><td style="background-color:rgb(53,152,219);height:29.5227px;"><span style="color:rgb(236,240,241);">**Extension**</span></td><td style="background-color:rgb(53,152,219);height:29.5227px;"><span style="color:rgb(236,240,241);">**Description**</span></td></tr><tr style="height:46.3182px;"><td style="height:46.3182px;">KHR\_lights\_punctual</td><td style="height:46.3182px;">Imports point, spot, and directional lights defined in the glTF file as lights in Scene Composer.</td></tr><tr style="height:29.5227px;"><td style="height:29.5227px;">KHR\_materials\_anisotropy</td><td style="height:29.5227px;">Reproduce materials with anisotropic highlights, such as brushed metal.</td></tr><tr style="height:29.5227px;"><td style="height:29.5227px;">KHR\_materials\_clearcoat</td><td style="height:29.5227px;">Reproduces materials that have a clear-coat layer (clear paint).</td></tr><tr style="height:46.3182px;"><td style="height:46.3182px;">KHR\_materials\_ior</td><td style="height:46.3182px;">Specifies the *Index of Refraction* (IOR) and improves refraction for materials such as glass.</td></tr><tr style="height:46.3182px;"><td style="height:46.3182px;">KHR\_materials\_iridescence</td><td style="height:46.3182px;">Represents iridescence effects where the color changes depending on the viewing and incident angles.</td></tr><tr style="height:46.3182px;"><td style="height:46.3182px;">KHR\_materials\_specular

</td><td style="height:46.3182px;">Supports materials that independently control the intensity and color of specular reflection.</td></tr><tr style="height:46.3182px;"><td style="height:46.3182px;">KHR\_materials\_unlit</td><td style="height:46.3182px;border-width:0px;">Supports “unlit” materials that are not affected by lighting calculations.

</td></tr><tr style="height:46.3182px;"><td style="height:46.3182px;">KHR\_texture\_transform</td><td style="height:46.3182px;">Interprets UV transforms such as offset, scale, and rotation per texture.

</td></tr><tr style="height:79.9091px;"><td style="height:79.9091px;">KHR\_materials\_emissive\_strength</td><td style="height:79.9091px;">This extension scales the emissive color or texture by a scalar *emissiveStrength* factor, allowing materials to represent much brighter emission, especially in *high dynamic range* (HDR) rendering environments.

</td></tr><tr style="height:79.9091px;"><td style="height:79.9091px;">KHR\_materials\_sheen</td><td style="height:79.9091px;">This extension adds a sheen layer on top of an existing *physically based rendening* (PBR) material to simulate soft, fabric-like highlights caused by fine microfibers such as cloth or velvet.

</td></tr><tr style="height:29.5227px;"><td style="height:29.6px;">KHR\_materials\_dispersion</td><td style="height:29.5227px;">Represents the dispersion of light caused by differences in the index of refraction per wavelength.

</td></tr><tr><td style="height:29.6px;">KHR\_materials\_transmission</td><td>Represents the transmission of light and reproduces transparent materials such as glass.

</td></tr><tr><td style="height:14.4px;">KHR\_materials\_volume</td><td>Represents the attenuation of light inside a transmissive material (thickness, attenuation color, and attenuation distance).

</td></tr></tbody></table>

Even when UV sets other than `uv0` are specified in these extensions, Scene Composer imports multiple UV sets (Multi UV) and assigns them to the corresponding textures.

When you import a glTF file with **Import Dynamic Appearance** enabled, Scene Composer displays the properties that correspond to the extensions in the preceding table as GltfAppearance properties in the Properties panel, and you can edit them there. For the individual properties, see <span style="color:rgb(230,126,35);">[**Properties Overview**](https://doc3161en.candera.eu/books/appendix/page/properties-overview)</span>.

##### Limitations

- Limitations in OpenGL Embedded Systems (ES) 2.0 might prevent some sample glTF files that use these extensions from producing the expected visual results in ES 2.0 environments.
    
    
    - KHR\_materials\_transmission: Scene Composer does not apply the transmission effect and renders the material as an opaque material.
    - KHR\_materials\_volume: Scene Composer applies only transmission and does not render the absorption of light.
    - KHR\_materials\_dispersion: Scene Composer applies only transmission and does not render dispersion.
- By design, you cannot use some combinations of extensions together. For details, check the **glTF 2.0 extension specifications** provided by Khronos.
    
    
    - For example, by design you cannot use some extensions, such as KHR\_materials\_anisotropy, KHR\_materials\_iridescence, KHR\_materials\_specular, KHR\_materials\_ior, KHR\_materials\_emissive\_strength, and KHR\_materials\_sheen, together with KHR\_materials\_unlit.
- Meshes that use **KHR\_materials\_anisotropy** must have normal and tangent attributes, or the base material must have a normal map. If these conditions are not met, the anisotropy effect may not be rendered correctly.
- KHR\_materials\_volume and KHR\_materials\_dispersion require KHR\_materials\_transmission. When you import a glTF file that does not use KHR\_materials\_transmission, Scene Composer ignores these properties.

For details on the properties and parameters of each extension, refer to the <span style="color:rgb(230,126,35);">[glTF 2.0 extension specifications](https://github.com/KhronosGroup/glTF/tree/main/extensions/2.0/Khronos) </span>provided by Khronos.

For the behavior when you import a glTF file that uses KHR\_materials\_transmission, see <span style="color:rgb(230,126,35);">[**Importing Transmissive Materials**](#bkmrk-importing-transmissi)</span>.

---

#### Physically Based Shading (PBS)

This section describes the shader and appearance configuration that Scene Composer creates when you import a glTF file with a static Appearance. For the individual properties that apply when you import with a dynamic GltfAppearance, see <span style="color:rgb(230,126,35);">[**Properties Overview**](https://doc3161en.candera.eu/books/appendix/page/properties-overview)</span>.

The importer applies the metal-roughness material model to the imported 3d model. If the glTF file does not define image-based lightning (IBL) textures, the importer applies a default material. Scene Composer provides shaders for OpenGL ES 2.0 and 3.0.

The property names used in SceneComposer differ from the glTF standard:

<table id="bkmrk-standard-property-na" style="border-collapse:collapse;width:76.1905%;"><colgroup><col style="width:28.9341%;"></col><col style="width:71.1702%;"></col></colgroup><tbody><tr><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Standard Property Name**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Usage in SceneComposer**</span></td></tr><tr><td>baseColor</td><td>u\_Base Color Factor</td></tr><tr><td>metallic</td><td>determined by the X value in the u\_Metallic Roughness Value</td></tr><tr><td>roughness</td><td>determined by the Y value in the</td></tr></tbody></table>

<div class="contents" id="bkmrk-the-standard-propert"><div class="contents"><div class="textblock">  
</div></div></div>The importer automatically sets the following appearance and shader properties, but you can also configure them manually:

##### Uniforms:

<table id="bkmrk-optional-uniform-nam" style="border-collapse:collapse;width:100%;"><colgroup><col style="width:9.29235%;"></col><col style="width:22.2797%;"></col><col style="width:68.3863%;"></col></colgroup><tbody><tr><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Optional**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Uniform Name**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Description**</span></td></tr><tr><td>  
</td><td>u\_MetallicRoughnessValues</td><td>holds the metallic factor in X and the roughness factor in Y. The shader multiplies these values with the metallic and roughness values from the metallic-roughness texture on a per-pixel basis. If no such texture exists, the shader uses the values from the uniform instead.</td></tr><tr><td>  
</td><td>u\_BaseColorFactor</td><td>is a factor that the shader multiplies with the value from the albedo texture on a per-pixel basis. If no such texture exists, the shader uses the values from the uniform instead.</td></tr><tr><td>  
</td><td>u\_MipmapCount</td><td>specifies the number of mipmaps, excluding level 0, from the specular/radiance texture.</td></tr><tr><td>optional</td><td>u\_NormalScale</td><td>is a factor that the shader multiplies with the X and Y component of the normal. This uniform is available only if the fragment shader and vertex shader define <code>HAS&#95;NORMALMAP</code>.</td></tr><tr><td>optional</td><td>u\_OcclusionStrength</td><td>is a factor for the linear interpolation between the color and the color times ambient occlusion. This uniform is available only if the fragment shader and the vertex shader define <code>HAS&#95;OCLUSIONMAP</code>*.*</td></tr><tr><td>optional</td><td>u\_EmissiveFactor</td><td>is a factor that the shader multiplies with the value from the emissive texture on a per-pixel basis. This uniform is available only if the fragment shader and the vertex shader define <code>HAS&#95;EMISSIVEMAP</code></td></tr></tbody></table>

<div drawio-diagram="6818"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-5-1726241135.png" alt="drawing-5-1726241135.png"/></div>

#####  Textures:

<table id="bkmrk-optional-texture-nam" style="border-collapse:collapse;width:100%;"><colgroup><col style="width:9.29309%;"></col><col style="width:15.0119%;"></col><col style="width:9.41261%;"></col><col style="width:8.22043%;"></col><col style="width:58.0222%;"></col></colgroup><tbody><tr><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Optional**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Texture Name**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Channels**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Texture Level**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Description**</span></td></tr><tr><td>optional</td><td>albedo </td><td>RGBA</td><td>0</td><td>Set at texture unit 0, and define <code>HAS&#95;BASECOLORMAP </code>in the fragment shader.</td></tr><tr><td>optional</td><td>metallic-roughness </td><td>GB</td><td>1</td><td>Set at texture unit 1, and define <code>HAS&#95;METALROUGHNESSMAP </code>in the fragment shader. The metallic values must be stored in the blue channel. The roughness value must be stored in the green channel of the texture.</td></tr><tr><td>optional</td><td>tangent-space normal</td><td>RGB</td><td>2</td><td>Set at texture unit 2, and define <code>HAS&#95;NORMALMAP </code>in the fragment shader and vertex shader.</td></tr><tr><td>optional</td><td>occlusion</td><td>R</td><td>3</td><td>Set at texture unit 3, and define <code>HAS&#95;OCCLUSIONMAP </code>in the fragment shader and vertex shader. The occlusion values are stored in the red channel of the texture.</td></tr><tr><td>optional</td><td>emissive</td><td>RGB</td><td>4</td><td>Set at texture unit 4, and define <code>HAS&#95;EMISSIVEMAP </code>in the fragment shader and the vertex shader.</td></tr><tr><td>optional</td><td>Image-based lighting (IBL)</td><td>  
</td><td> </td><td>Provide the following textures for IBL to work correctly:

- diffuse radiance cubemap (see below)
- specular/radiance cubemap (see below)
- bidirectional reflectance distribution function (BRDF) (see below)

</td></tr><tr><td>optional</td><td>IBL - diffuse radiance cubemap</td><td>RGB</td><td>5</td><td>Set at texture unit 5, and define <code>USE&#95;IBL </code>in the fragment shader.

</td></tr><tr><td>optional</td><td>IBL - specular/radiance cubemap</td><td>RGB</td><td>6</td><td>Set at texture unit 6, and define USE\_IBL in the fragment shader. Build the specular pre-convolved environment into the mipmaps. The importer automatically sets the number of mipmaps, excluding level 0, in the shader uniform *u\_MipmapCount*. If you set this cubemap manually, configure this value manually.

</td></tr><tr><td>optional</td><td>IBL - bidirectional reflectance distribution function (BRDF)</td><td>RG</td><td>7</td><td>Set at texture unit 7, and define <code>USE&#95;IBL </code>in the fragment shader.

</td></tr></tbody></table>

<div class="contents" id="bkmrk-%28optional%29-the-albed"><div class="contents"><div class="textblock">  
</div></div></div>The Scene Tree shows details of the imported appearance:

<div drawio-diagram="7576"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-11/drawing-5-1732892596.png" alt="drawing-5-1732892596.png"/></div>

<div class="contents" id="bkmrk--24"><div class="contents">  
</div></div>##### Mesh:

<table id="bkmrk-optional-mesh-proper" style="border-collapse:collapse;width:100%;"><colgroup><col style="width:11.9137%;"></col><col style="width:17.4106%;"></col><col style="width:70.7511%;"></col></colgroup><tbody><tr><td style="background-color:rgb(53,152,219);"><span style="color:rgb(255,255,255);">**Optional**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(255,255,255);">**Mesh Properties**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(255,255,255);">**Description**</span></td></tr><tr><td>  
</td><td>position</td><td>Provide the mandatory position attribute.</td></tr><tr><td>optional</td><td>normals</td><td>Define <code>HAS&#95;NORMALS</code> in the fragment shader and vertex shader.</td></tr><tr><td>optional</td><td>tangents</td><td>Define <code>HAS&#95;TANGENTS</code> in the fragment shader and vertex shader.</td></tr><tr><td>optional</td><td>uv set</td><td>Define <code>HAS&#95;UV</code> in the fragment shader and vertex shader.</td></tr></tbody></table>

<div class="textblock" id="bkmrk--25"></div>[![glTF&#95;shader&#95;variants.png](https://doc3161en.candera.eu/uploads/images/gallery/2023-02/scaled-1680-/gltf-shader-variants.png)](https://doc3161en.candera.eu/uploads/images/gallery/2023-02/gltf-shader-variants.png)

<div class="textblock" id="bkmrk-different-shader-var" style="padding-left:40px;">*The image shows different shader variants (Click the image to enlarge it).*</div><div class="textblock" id="bkmrk--27"></div>##### Uniform Setter:

<table id="bkmrk-optional-uniform-set" style="border-collapse:collapse;width:100%;"><colgroup><col style="width:11.5566%;"></col><col style="width:21.1141%;"></col><col style="width:67.4068%;"></col></colgroup><tbody><tr><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Optional**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Uniform Setter**</span></td><td style="background-color:rgb(53,152,219);"><span style="color:rgb(236,240,241);">**Description**</span></td></tr><tr><td> </td><td>model view projection</td><td>Provide the mandatory model view projection.</td></tr><tr><td> </td><td>model matrix</td><td>Provide the mandatory model matrix</td></tr><tr><td>  
</td><td>normal model matrix</td><td>Provide the normal model matrix, which is mandatory if the shader defines <code>HAS&#95;NORMALS </code>and <code>HAS&#95;TANGENTS</code>.</td></tr></tbody></table>

##### Optimization Tips:

<div class="contents" id="bkmrk-use-one-texture-for-"><div class="contents"><div class="textblock">

- Use one texture for occlusion, roughness, and metallic values, stored as an RGB texture.
- Providing tangents in the mesh avoids calculating the tangent space matrix on a per pixel basis.

</div></div></div>For a more information about physically based rendering, see [the Khronos website: metallic roughness](https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#reference-pbrmetallicroughness).

<div class="textblock" id="bkmrk--1">  
</div>#### Importing Transmissive Materials

When you import a glTF file that uses KHR\_materials\_transmission, Scene Composer automatically creates the **multiple render pass** configuration that transmission requires.

##### Render Targets That Scene Composer Creates Automatically

Scene Composer creates the following two render targets and links the offscreen render target to the onscreen render target.

<div class="textblock" id="bkmrk-render-target-descri"><table style="width:800px;border-collapse:collapse;border-width:1px;"><thead><tr style="background-color:rgb(35,111,161);"><th style="width:29.4369%;border-width:1px;">**<span style="color:rgb(255,255,255);">Render Target</span>**</th><th style="width:70.5393%;border-width:1px;">**<span style="color:rgb(255,255,255);">Description</span>**</th></tr></thead><tbody><tr><td style="width:29.4369%;border-width:1px;">OnScreenRenderTarget</td><td style="width:70.5393%;border-width:1px;">The render target that appears on the screen. The Copy camera and the Transmission camera render into this render target.</td></tr><tr><td style="width:29.4369%;border-width:1px;">OffScreenRenderTarget</td><td style="width:70.5393%;border-width:1px;">The render target that renders the area behind transmissive objects. The Opaque camera renders into this render target, and the transmission rendering references the result.</td></tr></tbody></table>

</div>##### Cameras That Scene Composer Creates Automatically

Scene Composer creates three cameras in the imported scene and assigns each of them to a render target automatically.

If the glTF file contains a camera, Scene Composer creates the three cameras based on that camera and collects them into a group named `<camera name>_Group`. The camera names take no suffix (Opaque), `_Copy`, and `_Transmission`, respectively. If the glTF file contains no camera, Scene Composer creates GeneratedCamera\_Opaque, GeneratedCamera\_Copy, and GeneratedCamera\_Transmission.

<div class="textblock" id="bkmrk-properties-opaque-ca"><table style="width:800px;border-collapse:collapse;border-width:1px;height:206.659px;"><thead><tr style="background-color:rgb(35,111,161);height:29.5227px;"><th style="width:175.83px;border-width:1px;height:29.5227px;">**<span style="color:rgb(255,255,255);">Properties</span>**</th><th style="width:207.807px;border-width:1px;height:29.5227px;">**<span style="color:rgb(255,255,255);">Opaque Camera</span>**</th><th style="width:207.807px;border-width:1px;height:29.5227px;">**<span style="color:rgb(255,255,255);">Copy Camera</span>**</th><th style="width:207.83px;border-width:1px;height:29.5227px;">**<span style="color:rgb(255,255,255);">Transmission Camera</span>**</th></tr></thead><tbody><tr style="height:29.5227px;"><td style="width:175.83px;border-width:1px;height:29.5227px;">Render Target</td><td style="width:207.807px;border-width:1px;height:29.5227px;">OffScreen</td><td style="width:207.807px;border-width:1px;height:29.5227px;">OnScreen</td><td style="width:207.83px;border-width:1px;height:29.5227px;">OnScreen</td></tr><tr style="height:29.5227px;"><td style="width:175.83px;border-width:1px;height:29.5227px;">Scope Mask</td><td style="width:207.807px;border-width:1px;height:29.5227px;">1</td><td style="width:207.807px;border-width:1px;height:29.5227px;">1</td><td style="width:207.83px;border-width:1px;height:29.5227px;">2</td></tr><tr style="height:29.5227px;"><td style="width:175.83px;border-width:1px;height:29.5227px;">Clear Color Buffer</td><td style="width:207.807px;border-width:1px;height:29.5227px;">Enabled</td><td style="width:207.807px;border-width:1px;height:29.5227px;">Enabled</td><td style="width:207.83px;border-width:1px;height:29.5227px;">Disabled</td></tr><tr style="height:29.5227px;"><td style="width:175.83px;border-width:1px;height:29.5227px;">Clear Depth Buffer</td><td style="width:207.807px;border-width:1px;height:29.5227px;">Enabled</td><td style="width:207.807px;border-width:1px;height:29.5227px;">Enabled</td><td style="width:207.83px;border-width:1px;height:29.5227px;">Disabled</td></tr><tr style="height:29.5227px;"><td style="width:175.83px;border-width:1px;height:29.5227px;">Enable Swapping</td><td style="width:207.807px;border-width:1px;height:29.5227px;">Disabled</td><td style="width:207.807px;border-width:1px;height:29.5227px;">Disabled</td><td style="width:207.83px;border-width:1px;height:29.5227px;">Enabled</td></tr><tr style="height:29.5227px;"><td style="width:175.83px;border-width:1px;height:29.5227px;">SkyBox</td><td style="width:207.807px;border-width:1px;height:29.5227px;">Used</td><td style="width:207.807px;border-width:1px;height:29.5227px;">Used</td><td style="width:207.83px;border-width:1px;height:29.5227px;">Not Used</td></tr><tr><td style="width:175.83px;border-width:1px;">Create Mipmaps After Rendering</td><td style="width:207.807px;border-width:1px;height:29.5227px;">Enabled</td><td style="width:207.807px;border-width:1px;height:29.5227px;">Disabled</td><td style="width:207.83px;border-width:1px;height:29.5227px;">Disabled</td></tr></tbody></table>

</div>The Copy camera is the main camera for the on-screen display. If the glTF file contains a camera, Scene Composer sets the position and the look-at direction of the Copy camera from the transformation matrix of the glTF camera node.

<p class="callout info">Scene Composer does not set a SkyBox on the Transmission camera. It sets a SkyBox only on the Opaque camera and the Copy camera.</p>

The result that the Opaque camera renders into the offscreen render target is referenced when the Copy camera and the Transmission camera render. If the referenced texture has no mipmaps, aliasing occurs and the Roughness of transmissive materials does not appear as intended. For this reason, Scene Composer enables **Create Mipmaps After Rendering** automatically for the Opaque camera. For details about the property, see [Properties Overview](https://doc3161en.candera.eu/books/appendix/page/properties-overview).

##### Scope Mask Assignment

Scene Composer assigns a Scope Mask to each imported object automatically, depending on whether the object uses a transmissive material.

<div class="textblock" id="bkmrk-object-scope-mask-ob"><table style="width:57.8571%;border-collapse:collapse;border-width:1px;"><thead><tr style="background-color:rgb(35,111,161);"><th style="width:64.0959%;border-width:1px;">**<span style="color:rgb(255,255,255);">Object</span>**</th><th style="width:35.8629%;border-width:1px;">**<span style="color:rgb(255,255,255);">Scope Mask</span>**</th></tr></thead><tbody><tr><td style="width:64.0959%;border-width:1px;">Objects that do not use a transmissive material</td><td style="width:35.8629%;border-width:1px;">1</td></tr><tr><td style="width:64.0959%;border-width:1px;">Objects that use a transmissive material</td><td style="width:35.8629%;border-width:1px;">2</td></tr></tbody></table>

</div>##### Shaders and Uniforms

During the import, Scene Composer adds the following preprocessor definitions and uniforms to the shader, depending on the extensions that the glTF file uses.

<div class="textblock" id="bkmrk-extensions-preproces"><table style="width:800px;border-collapse:collapse;border-width:1px;"><thead><tr style="background-color:rgb(35,111,161);"><th style="width:28%;border-width:1px;">**<span style="color:rgb(255,255,255);">Extensions</span>**</th><th style="width:36%;border-width:1px;">**<span style="color:rgb(255,255,255);">Preprocessor Definitions</span>**</th><th style="width:36%;border-width:1px;">**<span style="color:rgb(255,255,255);">Uniform</span>**</th></tr></thead><tbody><tr><td style="width:28%;border-width:1px;">KHR\_materials\_transmission</td><td style="width:36%;border-width:1px;">MATERIAL\_TRANSMISSION  
LINEAR\_OUTPUT  
HAS\_TRANSMISSION\_MAP (if a transmission texture exists)</td><td style="width:36%;border-width:1px;">u\_TransmissionFactor  
u\_TransmissionSampler  
u\_TransmissionFramebufferSampler  
u\_TransmissionFramebufferSize</td></tr><tr><td style="width:28%;border-width:1px;">KHR\_materials\_volume</td><td style="width:36%;border-width:1px;">MATERIAL\_VOLUME  
HAS\_THICKNESS\_MAP (if a thickness texture exists)  
VOLUME\_UV (if the material uses a UV set other than uv0)</td><td style="width:36%;border-width:1px;">u\_ThicknessFactor  
u\_AttenuationDistance  
u\_AttenuationColor  
u\_ThicknessSampler</td></tr><tr><td style="width:28%;border-width:1px;">KHR\_materials\_dispersion</td><td style="width:36%;border-width:1px;">MATERIAL\_DISPERSION</td><td style="width:36%;border-width:1px;">u\_Dispersion</td></tr></tbody></table>

</div>The following describes each uniform.

<div class="textblock" id="bkmrk-uniform-description-"><table style="width:800px;border-collapse:collapse;border-width:1px;"><thead><tr style="background-color:rgb(35,111,161);"><th style="width:29.4369%;border-width:1px;">**<span style="color:rgb(255,255,255);">Uniform</span>**</th><th style="width:70.5393%;border-width:1px;">**<span style="color:rgb(255,255,255);">Description</span>**</th></tr></thead><tbody><tr><td style="width:29.4369%;border-width:1px;">u\_TransmissionFactor</td><td style="width:70.5393%;border-width:1px;">The transmission factor.</td></tr><tr><td style="width:29.4369%;border-width:1px;">u\_TransmissionSampler</td><td style="width:70.5393%;border-width:1px;">The transmission texture.</td></tr><tr><td style="width:29.4369%;border-width:1px;">u\_TransmissionFramebufferSampler</td><td style="width:70.5393%;border-width:1px;">The texture of the offscreen render target.</td></tr><tr><td style="width:29.4369%;border-width:1px;">u\_TransmissionFramebufferSize</td><td style="width:70.5393%;border-width:1px;">The width and height of the offscreen render target.</td></tr><tr><td style="width:29.4369%;border-width:1px;">u\_ThicknessFactor</td><td style="width:70.5393%;border-width:1px;">The thickness of the volume. The larger the value, the stronger the absorption.</td></tr><tr><td style="width:29.4369%;border-width:1px;">u\_AttenuationDistance</td><td style="width:70.5393%;border-width:1px;">The distance, in world units, that light travels before the volume absorbs it. The shader treats the medium as homogeneous over this attenuation distance.</td></tr><tr><td style="width:29.4369%;border-width:1px;">u\_AttenuationColor</td><td style="width:70.5393%;border-width:1px;">The color of the light that the volume absorbs. This color determines the tint of the volume material.</td></tr><tr><td style="width:29.4369%;border-width:1px;">u\_ThicknessSampler</td><td style="width:70.5393%;border-width:1px;">The thickness texture of the volume.</td></tr><tr><td style="width:29.4369%;border-width:1px;">u\_Dispersion</td><td style="width:70.5393%;border-width:1px;">The strength of the dispersion. A value of 0.0 means no dispersion. The larger the value, the stronger the iridescent refraction.</td></tr></tbody></table>

</div><p class="callout info">For the **Transmission**, **Volume**, and **Dispersion** properties that apply when you use GltfAppearance, see <span style="color:rgb(230,126,35);">[**Properties Overview**](https://doc3161en.candera.eu/books/appendix/page/properties-overview)</span>.</p>

<div class="textblock" id="bkmrk--3">  
</div>---

#### Useful links

Khronos references include the following resources:

<div class="contents" id="bkmrk-gltf-overview-%28https"><div class="contents"><div class="textblock">

- glTF Overview ([https://www.khronos.org/gltf/](https://www.khronos.org/gltf/))
- glTF 2.0 Specification ([https://github.com/KhronosGroup/glTF/tree/master/specification/2.0](https://github.com/KhronosGroup/glTF/tree/master/specification/2.0))
- glTF 2.0 Sample Models ([https://github.com/KhronosGroup/glTF-Sample-Models/tree/master/2.0](https://github.com/KhronosGroup/glTF-Sample-Models/tree/master/2.0))

</div></div></div>The Khronos specification is available here:

<div class="contents" id="bkmrk-specification-%28https"><div class="contents"><div class="textblock">

- Specification ([https://github.com/KhronosGroup/glTF](https://github.com/KhronosGroup/glTF))

</div></div></div>The following viewers are available:

<div class="contents" id="bkmrk-babylonjs-sandbox-%28h"><div class="textblock">

- BabylonJS Sandbox ([https://sandbox.babylonjs.com/](https://sandbox.babylonjs.com/))
- donmccurdy glTF viewer ([https://gltf-viewer.donmccurdy.com/](https://gltf-viewer.donmccurdy.com/))
- Khronos glTF Sample Viewer ([https://github.khronos.org/glTF-Sample-Viewer-Release/](https://github.khronos.org/glTF-Sample-Viewer-Release/))

</div></div>

# Skinning

Since CGI 3.14, you can import skinning Filmbox (FBX) or GL Transmission Format (glTF) files. Scene Composer can then play the skinning animations. However, the following limitations exist:

- The maximum number of joints associated with each vertex is 4.
- If the number of joints associated with a SkinningMesh is 100 or less, Scene Composer performs skinning using a shader.
- If the number of joints associated with the SkinningMesh is between 101 and 255 (maximum), Scene Composer performs skinning processing on the CPU. In this case, the performance decreases.
- CGI Studio manages rotations using Euler angles, so reproducing the animation might not be possible.
- If a SkinningMesh and the SkinningMesh's parent Transform are not identity matrices and the SkinningMesh does not appear as expected, set the identity matrix for SkinningMesh and the SkinningMesh's parent Transform.
- If you place a SkinningMesh and Joint Nodes under a Group, CGI Studio applies the changes in the Group's Transform to the SkinningMesh twice.

In addition to the above, note the following limitations when importing skinning in FBX file format.

- CGI Studio does not support FBX format FbxSkin::eDualQuaternion and FbxSkin::eBlend.
- CGI Studio does not support FbxCluster::eAdditive in FBX format.

#### SkinningMesh

Note that you can create a SkinningMesh that you can use in Scene Composer by importing an FBX or glTF file that contains at least one skinned mesh. A SkinningMesh that you create by importing a file has the following properties:

<p class="callout info">When you import a glTF file with **Import Dynamic Appearance** enabled, Scene Composer attaches a GltfAppearance to the SkinningMesh. For the individual properties of GltfAppearance, see <span style="color:rgb(230,126,35);">[**Properties Overview**](https://doc3161en.candera.eu/books/appendix/page/properties-overview)</span>.</p>

##### Skin (Common Properties)

<div drawio-diagram="6748"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-09/drawing-4-1725634469.png" alt="drawing-4-1725634469.png"/></div>

<table class="align-center" id="bkmrk-enable-cpu-skinning-" style="border-collapse:collapse;width:700px;border-width:1px;"><colgroup><col style="width:189px;"></col><col style="width:511px;"></col></colgroup><tbody><tr><td class="align-left" style="border-width:1px;">Line Width</td><td style="border-width:1px;">This property is only available if you enable the <span style="color:rgb(230,126,35);">[**Import as wireframe**](https://doc3161en.candera.eu/books/import-of-resources/page/import-dialog-options#bkmrk--01)</span> option when importing an FBX file that contains skinning. The Line Width property specifies the line width of the mesh when Scene Composer renders it as a wireframe.

- Scene Composer determines the actual line width by rounding the specified width to the nearest integer.
- If the setting is less than “1”, Scene Composer always sets it to “1”.

</td></tr><tr><td class="align-left" style="border-width:1px;">Enable CPU Skinning</td><td class="align-left" style="border-width:1px;">This property specifies whether you enable CPU Skinning. If you enable it, you can use vertex shaders other than those provided for skin with Skinning Mesh.

**Note**: It is recommended to avoid CPU skinning calculations because they are slow. If you enable CPU Skinning, edit or configure the shader in a way that skinning is not performed by the shader.

</td></tr></tbody></table>

##### Other Property items

CGI Studio sets the following properties during import, that are not editable:

<div drawio-diagram="5732"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-4-1715328271.png" alt="drawing-4-1715328271.png"/></div>

<table class="align-center" id="bkmrk-joint-node-sets-a-jo" style="border-collapse:collapse;width:700px;border-width:1px;"><colgroup><col style="width:202px;"></col><col style="width:498px;"></col></colgroup><tbody><tr><td class="align-left" style="border-width:1px;">Joint Node</td><td class="align-left" style="border-width:1px;">This property ses a joint node.</td></tr><tr><td class="align-left" style="border-width:1px;">Enable Inverse Bind Matrix</td><td class="align-left" style="border-width:1px;">This property specifies whether Inverse Bind Matrix is enabled.

If the property is enabled, the joint uses the Inverse Bind Matrix.

If the property is disabled, the joint uses the identity matrix.

</td></tr><tr><td class="align-left" style="border-width:1px;">Inverse Bind Matrix</td><td class="align-left" style="border-width:1px;">The Inverse Bind Matrix brings coordinates that are being skinned into the same space as the joint.</td></tr></tbody></table>

#### Adding Imported Scenes

Import of FBX or glTF files that include skinning by using the standard procedure (<span style="color:rgb(230,126,35);">[FBX import procedure](https://doc3161en.candera.eu/link/1101#bkmrk-image%2C-font%2C-shader%2C-1)</span>, [<span style="color:rgb(230,126,35);">glTF import procedure</span>](https://doc3161en.candera.eu/link/1101#bkmrk-images%2C-fonts%2C-shade)). After importing, create new scenes and animations from the scenes and animations in the imported resources.

1. Select a scene contained in the imported resource and select **Add Scene From Template...** from the context menu. 
    - The **Add New Scene 3D** dialog appears.
    - For more information on the **Add Scene From Template...** feature, see <span style="color:rgb(230,126,35);">[Add Scene From Template](https://doc3161en.candera.eu/link/41#bkmrk-imported-scene)</span>.
2. Configure the necessary settings on the **Add New Scene 3D** dialog and click **OK**. 
    - Scene Composer adds the scene as a new scene in the **Solution Explorer panel**, in the **Solution &gt; Scenes** folder.
    - The **Scene Tree** panel displays the added scene.  
          
        <div drawio-diagram="7577"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-11/drawing-5-1732893834.png" alt="drawing-5-1732893834.png"/></div>

<p class="callout info"><span style="color:rgb(230,126,35);"><span style="color:rgb(0,0,0);">CGI Studio adds the </span>[SkinningMesh](#bkmrk-skinningmesh)</span> to the imported scene (red frame in the right figure above). </p>

<p class="callout info">If the imported scene does not contain any <span style="color:rgb(230,126,35);">[camera](https://doc3161en.candera.eu/link/130#bkmrk-camera)</span> or <span style="color:rgb(230,126,35);">[light](https://doc3161en.candera.eu/link/130#bkmrk-light)</span> nodes, add them to the new scene from the **Node 3D** item in the **Toolbox** panel and configure the required settings.</p>





#### Add a Render Target

Add the camera of the imported scene to the render target.

##### When a camera node is added

1. Display the **Render Targets** panel.  
    
    - Scene Composer has already added a camera with the added scene name in the panel.
2. Select the checkboxes for the added cameras.

##### If the imported scene contains a camera

1. In the **Render Targets** panel, right click on the **Render Target** and select **Add Camera to Render Target...** from the context menu.  
    
    - The **Choose Item** dialog appears.
2. Expand the **Scenes** folder in the **Choose Item** dialog and select the cameras in the scene you added and click **OK**.

#### Add Imported Animations

To play the skinning animation in the Player, add the animation from the imported resource.

1. Right-click an animation contained in the imported resource and select **Add Animation From Template...** from the context menu. 
    - The **Add New Animations** dialog appears.
    - For more information on the  **Add Animation From Template...** feature, see <span style="color:rgb(230,126,35);">[Create animation from template](https://doc3161en.candera.eu/books/animation-design/page/create-animation-from-template)</span>.
2. Configure the required settings in the **Add New Animations** dialog and click **OK**. 
    - You can see in the Solution Explorer, that Scene Composer created a new animation.  
        <div drawio-diagram="6498">  
        </div>

#### Play Skinning Animation

Use CGI Player to play back skinning animations in a composed scene.

1. Click **Play selected scenario...**  on the toolbar to launch the CGI Player.  
    
    - If your solution contains unsaved changes, Scene Composer opens the **Save Solution** dialog asking you to save the solution. Click **OK** in the dialog to save the solution.
    - Scene Composer generates the asset file and opens it in CGI Player.
2. In the **CGI Panel**, check the target scene from the scene list on the left side.  
    <div drawio-diagram="5727"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-4-1715316125.png" alt="drawing-4-1715316125.png"/></div>
3. Use the pull-down menu to select the animation, that you want the CGI Player to play. <div drawio-diagram="5728"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-4-1715316183.png" alt="drawing-4-1715316183.png"/></div>
4. Click **Play Animation** in the toolbar to play the animation. 
    - CGI Player starts to play the skinning animation specified in the Panel.  
        <div drawio-diagram="5734"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2024-05/drawing-4-1715328731.png" alt="drawing-4-1715328731.png"/></div>
        
        [![SkinningAnime.gif](https://doc3161en.candera.eu/uploads/images/gallery/2024-05/skinninganime.gif)](https://doc3161en.candera.eu/uploads/images/gallery/2024-05/skinninganime.gif)