# 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>