How to Import Resources
This section describes how to import resources usingby [selecting Import Resources... ] from [the Import ]menu on the menu bar.


Import File Formats
The file formats toavailable befor importedimport when usingthrough this menu are aslisted followsbelow:
- 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)
In addition to the formats listed above, Scene Composer also supports importing Photoshop file (*.psd), Adobe XD file (*.xd), Axure RP file (*.rp) and Sketch file (*.sketch) can also be imported.files. For more informationdetails on these,importing pleasethese formats, refer to the Smart Importer chapter.
ForWhen Fontimporting files,font byfiles, selecting Fontthem filesin duringthe file selection,selection theydialog canallows bethe importedapplication to recognize and import them as fontsfonts, regardless of their extension.file extensions. For more details,information, please refer to the explanation here.
WithBeginning with CGI 3.14 or later,14, skinning animations can be played back by importing skinningskinning-enabled FBX or glTF files.
About .glTF fileFile formatFormat
SceneComposer supports following glTF file formats whenduring importing:import:
- glTF:
This points toReferences external binary data (geometry,keyanimationframes,keyframes,skins)skinning data), andimages.image files. - glTF-Embedded:
This embedsContains base64-encoded binary data, and images embedded inline using data URIs. - glTF-Binary:
InPackagesBinarytheglTF, aentire glTF asset (JSON,JSON description, .bin,bin binary data, and images)can be stored ininto a single binaryblob.file.
For more detailed information on thethese file formats, pleaserefer seeto the Khronos website: .
About .ktx File Format
The following compressed image formats are supported:
- Etc2CompressedRgbFormat
- Etc2CompressedSrgbFormat
- Etc2Alpha1CompressedRgbaFormat
- Etc2Alpha1CompressedSrgbaFormat
- Etc2EacCompressedRgbaFormat
- Etc2EacCompressedSrgbaFormat
To use this type of format, firstthe of all it is necessary to convert ansource image withmust afirst differentbe formatconverted from another supported image type (such as .tga, .gif, .psd, .bmp, .pgm, .png etc.) ininto a .ktx file. The nextfollowing tools supportcan generatingbe used to generate KTX files:
- Texgenpack
- Mali Texture Compression tool
- Ericcson Texture Compression Tool
This tool compresses texture images to the Ericsson Texture Compression (ETC/ETC2) and Adaptive Scalable Texture Compression (ASTC). TheIt availablesupports the following output fileformats:
After the conversion is done,complete, the .ktx resulted file can be imported ininto SceneComposer by followingusing the same flowworkflow as in the case offor other image formats.
-
InWhenthe case ofimporting a converted .ktx filewhichintois imported inSceneComposer, theSceneComposerDefaultBitmapConverterapplication, the usage of the "DefaultBitmapConverter"property - available foranystandardusual.bmpimageimages -iscan notpossible.be used.
About Bitmap Font
BitmapSceneComposer fontssupports are supported by SceneComposer. In order tothe use of bitmap fonts,fonts. theTo enable bitmap font functionality, SCHost.dll must be compiled using the BitmapFont font engine. Only one font engine can be active at a time inwithin an instance of SCHost.dll.
The userUsers can import 2the following file types of files as bitmap fonts:
- .fnt
(windows- Windows fontfiles)files-that are converted to bitmap fonts - .fbm -
alreadyPre-converted bitmap font files
When a font is imported, the following specific property will beis set:
- Source file
names:namesspecifies- Indicates the name of thefile which wasimported-file,helpshelpingthe userusers identify a font


On OpenGL ES1.1 platforms, such as Traveo2, it is not possible to perform import operations onimporting shader files, SVG files, FBX files, and glTF files.files is not supported.
Import Operation
You can open the Import Dialog to proceed importing resources in one of the following three ways.
Menu Bar
Select [Import] > [Import Resources...] from the menu bar.


Context menu
Right-click on any folder in Solution Explorer and select [Import] > [Resource...] from the context menu that appears.


Drag and Drop
Drag and drop the target file to be imported into any folder under Solution in Solution Explorer.


-
- glTF file can also be imported by drag-and-drop to any folder under Solution in Solution Explorer.
- Note that under OpenGLES1.1 environment, shader files (*.vert, *.frag), SVG files (*.svg), FBX files, and glTF files cannot be imported by drag-and-drop operation.
- When an image file format (*.bmp, *.jpg, *.png) that can be imported as an icon is dragged and dropped into any folder under Solution in Solution Explorer, the dialog box will appear as shown below, allowing you to select whether to import it as an image or icon resource. You can choose whether to import it as an image or an icon.


- glTF file can also be imported by drag-and-drop to any folder under Solution in Solution Explorer.
Import operations by file format
After selecting a file, operations will vary depending on the file format. Please refer to the following links for detailed operation procedures.
Image, font, shader, FBX, and script files
For importing FBX files contains skinning, see here.
When an image file is imported, the original image file is retained along with the bitmap information file (*.bin file) used on Scene Composer. See here for details.
-
When the import process is executed, Scene Composer will display a message to save any unsaved changes in the solution. Press OK to proceed. If you do not want this dialog to appear during the import process, uncheck the "Always show this dialog" checkbox.


-
After saving the solution, the Import Resources dialog is opened, where you can select one or more resource files to be imported. Select your files to import and press OK.
- You can search for supported file formats by selecting them in the drop-down menu at the bottom right of the Import Resources dialog.
- You can import multiple files at once as long as their file format belong to the same category, such as an Image file or a Font file.
- By selecting Font files from the pull-down menu below, you can import any file as a font file, regardless of its extension.


-
After choosing your files to import, an Import dialog will be displayed depending on the file types you are importing (Image, Font, FBX, Shader…).
-
See Import Dialog Options for a description of the settings on the dialog screen.
-
Select [ Import as wireframe ] check box to import the wireframe vertex buffer when importing an FBX file.


-
-
Configure import settings to your needs and click "OK" button.
-
The file will be imported as a resource in the Solution Explorer in the location corresponding to the settings on the dialog screen.


-
FBX files with multiple animations
Scene Composer supports the import of FBX files that contain multiple animation tracks. The names of the imported animation tracks are automatically created from each animation track contained in the FBX file.


The animations that can be imported from FBX files are as follows.
- Translation
- Rotation
- Scaling
Icon files
See Icon Picker for information on how to use imported icon resources.
-
When the import process is executed, Scene Composer will display a message to save any unsaved changes in the solution. Press OK to proceed. If you do not want this dialog to appear during the import process, uncheck the "Always show this dialog" checkbox.


-
After saving the solution, the Import Resources dialog will open. Select the target file and press OK. If the selected file format is "*.ico", the [ Import Icons ] dialog will appear as shown below.
- The path of the selected file is displayed in the [ Selected files ] field. To re-select a file, press the [ Select File... ] button.
- In [ Destination folder ], specify the location where the file will be imported as a resource.
- As explained in the Drag and Drop section, if you drag and drop an image file format that can be imported as an icon (*.bmp, *jpg, *.png), the above dialog will appear and you can import it as an icon.


- The path of the selected file is displayed in the [ Selected files ] field. To re-select a file, press the [ Select File... ] button.
-
Click "OK" button to complete the import operation.
SVG files
-
When the import process is executed, Scene Composer will display a message to save any unsaved changes in the solution. Press OK to proceed. If you do not want this dialog to appear during the import process, uncheck the "Always show this dialog" checkbox.


-
After saving the solution, the Import Resources dialog is opened, where you can select one or more SVG files to be imported. Select your files to import and press OK.
- You can import multiple files at once.


- You can import multiple files at once.
-
After choosing your files to import, an SVG Importer dialog will be displayed.
-
See SVG Importer Dialog for a description of the settings on the dialog screen.


-
-
Configure import settings to your needs and click "Import" button.
-
"ImportedScenes" and "Scenes" folders have been created at the destination folder chosen in "Solution Explorer". The former holds data imported as template scenes, while the latter holds data imported as actual scenes.
-
If multiple SVG files have been imported, the Scene Editor will display the actual scene for what was the topmost SVG file in the SVG Importer.
-
Transform > Position > X = 0, Y = 0 will be the item's initial position.
-
-
Copy group nodes within imported scenes into the desired scene and use them.


-
glTF files
The CGI Studio glTF Importer does not support the following features:
- Morping
- Vertex Buffer Streams
- Sparse Accessors
For additional details on handling glTF files—e.g., supported extensions, multiple UV sets, and limitations—please see the glTF file page.
For importing glTF files contains skinning, see here.
-
When the import process is executed, Scene Composer will display a message to save any unsaved changes in the solution. Press OK to proceed. If you do not want this dialog to appear during the import process, uncheck the "Always show this dialog" checkbox.


-
After saving the solution, the Import Resources dialog is opened, where you can select one or more resource files to be imported. Select your files to import and press OK.
- You can import multiple files at once.
- You can import multiple files at once.
-
After choosing your files to import, an Import dialog will be displayed.
- 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 need to set the radiance, irradiance, or BRDF integration textures manually.
- When necessary, set the HDR panorama (latlong) image and IBL texture size in the import dialog.
- The default IBL texture size is 256. On ES2.0, set at least 64 and use a power-of-two value. On ES3.0, the minimum size is 64.
- You can also set IBL in Solution Options. For details about these settings, see IBL HDR.


- Use the import dialog to configure Image-Based Lighting (IBL). You cannot change these settings after the import.
- Then, "Import GLTF" dialog will be displayed.
- 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, please refer to Import Dialog Options.


- You can’t change IBL settings in the import dialog (red box below).
-
Configure import settings to your needs and click "OK" button.
-
The file will be imported as a resource in the Solution Explorer in the location corresponding to the settings on the dialog screen.


-
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 it.
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 (irradiance/diffuse slot).



