Skip to main content

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
drawing-4-1727940873.png

For more information on the Photoshop layer structure format, see Recommended Layers Structure for Smart Importer.

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.

drawing-7-1770713035.png
Use The Smart Importer applies the saved settings.
Merge Merges both the saved settings and the new settings.
Don't use The Smart Importer does not apply saved settings and creates new settings.

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 reimporting files.

Conversion to 2D Nodes

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

Artboards

Smart Importer can treat artboards in the file you imported as Group Node.

Color Picker

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.

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.

For each node in a 2D scene, see 2D scene nodes.


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.

See the Smart Importer UI for details on what to configure in each part of the Smart Importer dialog.

The Smart Importer imports the configured file to the location specified in the Import Settings Tab 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.

drawing-5-1725628567.png

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

drawing-5-1732885515.png

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:

drawing-4-1710298666.png
Add Scene

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.

Clone Scene

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.

Remove Scene

Deletes the selected scene.
Rename Scene

Rename the scene. You can also double-click the target scene name to change the name.

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.

drawing-4-1727138202.png

Text and text-containing controls

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

drawing-5-1725631019.png

Global State Machine

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

drawing-4-1710298910.png