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.
- 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_Scenein the name field, and then click OK. - Two scenes, IVI_Scene and Cluster_Scene, appear under Scenes.
- In the Clone Scene... dialog box, enter
-
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.
-
-
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.
-
-
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.
-
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.
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.
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.
| Added or modified group layers |
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). |
| Control Assigned Bitmap |
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. |
| Newly added layer |
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. |
| Deleted Layer |
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. |
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.
<root>\cgi_studio_content\2D\PSD\Car_Cluster.psd
- Open the
Car_Cluster.psdfile in the Smart Importer and configure the Telltale control. Then, under Import to Folder, enter/Resources/Cluster_Telltalesas the import destination and perform the import.- See 1. TellTale Settings in the image below.
- See 1. TellTale Settings in the image below.
-
Re-open the same image file in the Smart Importer, this time setting the Gauge control. Enter
/Resources/Cluster_Gaugeas the import destination and perform the import.-
See 2. Gauge Settings in the image below.
-
-
Repeat the process for the ProgressBar control. Enter
/Resources/Cluster_ProgressBaras the import destination and perform the import.-
See 3. ProgressBar Settings in the image below.
-
Merge of multiple scene configurations
- Open the
Car_Cluster.psdfile in the Smart Importer. - Enter
/Resources/Cluster_Telltalesin the Import into folder and clear the Create new folder for import check box.
- The Smart Importer dialog appears.
- The Smart Importer dialog appears.
- Select Use, and then click OK to restore and apply the Telltale control settings.
- A blue caution icon appears in Scenes.
- A blue caution icon appears in Scenes.
- Change the import destination to
/Resources/Cluster_Gauge.
- A dialog box similar to the one below appears.
- A dialog box similar to the one below appears.
- Select Merge, and then click OK.
- The configured Gauge control is added to the previously configured Telltale control.
- The configured Gauge control is added to the previously configured Telltale control.
- Similarly, change the import destination to
/Resources/Cluster_ProgressBar.
- As in step 4, a dialog box similar to the one shown below appears.
- As in step 4, a dialog box similar to the one shown below appears.
- Select Merge, and then click OK.
- The configured ProgressBar control is added.
- The configured ProgressBar control is added.
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.psdfile - 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.
Follow the steps below to configure a Gauge control with a background image that has multiple layers:
- 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.
- 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.
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, holdctrlorshiftand click the target layer, or click and drag around the layer you want to select. - Smart Importer was able to configure the NeedleImage property with the NeedleImage layer, because the layer name of the file to import contains
NeedleImage.
- The
Car_Cluster.psdfile contains multiple background-image layers.
- Select Select layers from the BackgroundImage drop-down menu.
- The ImageLayers Selection dialog box appears.
- Select the layer you want to assign to BackgroundImage and click OK.
- 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.
- Double-click this image
- The Image Preview window displays the BackgroundImage.
- The Image Preview window displays the BackgroundImage.
Smart Importer places bitmaps merged from multiple layers for control properties in the ControlBitmaps folder in Solution Explorer.