Skip to main content

How to Import Resources

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

drawing-4-1727160599.png

Import File Formats

TheYou can import the following file formats available for import throughusing this menu are listed below: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)

In addition toBeside the formats listed above, Scene Composer also supports importing Photoshop (*.psd), Adobe XD (*.xd), Axure RP (*.rp) and Sketch (*.sketch) files. For more details on importing these formats, refer tosee the Smart Importer chapter.

When importing font files, selecting them in the file selection dialog allows the application to recognizerecognizes and importimports them as fonts, regardless of their file extensions. For more information, please refer tosee the explanation here.

Beginning with CGI 3.14, Scene Composer can play back skinning animations canafter beyou played back by importingimport skinning-enabled FBX or glTF files.

About .glTF File Format

SceneComposer supports the following glTF file formats during import:

  • 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.

For more detailed information on these file formats, refer tosee the Khronos website: GLB File Format Specification.

About .ktx File Format

TheScene Composer supports the following compressed image formats are supported:formats:

  • Etc2CompressedRgbFormat
  • Etc2CompressedSrgbFormat
  • Etc2Alpha1CompressedRgbaFormat
  • Etc2Alpha1CompressedSrgbaFormat
  • Etc2EacCompressedRgbaFormat
  • Etc2EacCompressedSrgbaFormat

To use thisthese typeformats, ofyou format,have to convert the source image must first be converted from anothera supported image type (such as .tga, .gif, .psd, .bmp, .pgm, .png etc.) into a .ktx file. TheYou can use the following tools can be used to generatecreate KTX files:

  • Texgenpack
  • Mali Texture Compression toolTool
  • EriccsonEricsson Texture Compression Tool

ThisThese tooltools compressescompress texture images to theusing Ericsson Texture Compression (ETC/ETC2) and Adaptive Scalable Texture Compression (ASTC). ItThey supports the following output formats:

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

After theconversion, conversionyou iscan complete,import the .ktx file can be imported into SceneComposerScene usingComposer following the same workflowprocess as for other image formats.

When importing a converted .ktx file into SceneComposer,Scene Composer, you cannot use the DefaultBitmapConverter property -that is  available for standard .bmp images - can not be used.images.

About Bitmap Font

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

Users can import theThe following file types can be imported as bitmap fonts:

  • .fnt - Scene Composer converts these Windows font files that are converted to bitmap fontsfonts.
  • .fbm - Pre-converted bitmap font files

When you import a fontfont, isScene imported,Composer sets the following property is set:property:

  • Source file names - Indicates the name of the imported file, helping usersyou identify a font
drawing-5-1717170340.png

On OpenGL ES1.1 platforms, such as Traveo2, importing shader files, SVG files, FBX files, and glTF files is not supported.


Import Operation

You can openOpen the Import Dialog to proceed importing resources in one of the following three ways.

Menu Bar

Select [Import]Import > [Import Resources...] from the menu bar.

drawing-4-1727160619.png



Context menu

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

drawing-5-1717170156.png



Drag and Drop

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

drawing-5-1717170521.png
    • glTF fileYou can also beimport importeda glTF file by drag-and-drag and drop to any folder under Solution in Solution Explorer.

    • Note that underin an OpenGLES1.1 environment, you cannot import shader files (*.vert, *.frag), SVG files (*.svg), FBX files, and glTF files cannotvia bedrag importedand by drag-and-drop operation.drop.

    • When you drag an image file format (*.bmp, *.jpg, *.png) that Scene Composer can be importedimport as an icon is dragged and dropped into any folder under Solution in Solution Explorer, thea dialog box will appear as shown below,appears, allowing you to selectchoose whether to import it as an image or icon resource. You can choose whether to import it as an image or an icon.
      drawing-4-1695617424.png

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.

drawing-5-1717170573.png

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

Import operations by file format

After selectingyou select a file, Scene Composer shows different import operations will vary depending on the file format. Please refer toSee the following linkstopics for detailed operationimport procedures.

Image, font, shader, FBX, and script files

For importing FBX files containsthat contain skinning, see here.

When you import an image filefile, isScene imported,Composer retains the original image file is retained along with the bitmap information file (*.bin file) used on Scene Composer. See here for details.

  1. 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.

    drawing-5-1717170573.png

     

     

After saving the solution,In the Import Resources dialog is opened, where you candialog, select one or more resource files tothat beyou imported. Select your fileswant to import and pressclick OK.

  • You can searchSearch for supported file formats by selecting them in the drop-down menu at the bottom right of the Import Resources dialog.
  • You can importImport multiple files at once as long as their file format belong to the same category, such as an Image filefiles or a Font file.files.
  • By selectingSelect Font files from the pull-down menu below, you canto import any file as a font file, regardless of its extension.
    drawing-4-1756260098.png


After choosingyou yourselected the files to import, Scene Composer displays an Import dialog will be displayed depending onfor the selected file types you are importingtype (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.
  • 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 Import Images Config panel of Solution Options. See Import Dialog Options for details.

    drawing-5-1717170648.png



Configure the import settingssettings, to your needs andthen click "OK" button.OK.

  • TheScene Composer imports the file will be imported as a resource in the Solution Explorer in the location corresponding to the settings on the dialog screen.
    Explorer.

    drawing-5-1717170717.png
FBX files with multiple animations

Scene Composer supports the import of FBX files that contain multiple animation tracks. TheScene Composer automatically creates the names of the imported animation tracks arebased automaticallyon created from eachthe animation tracktracks contained in the FBX file.

drawing-4-1728536029.pngdrawing-4-1728536029.png

The animations thatYou can beimport importedthe following types of animations from FBX files are as follows.files:

  • Translation
  • Rotation
  • Scaling

Icon files

See Icon Picker for information on how to use imported icon resources.

  1. WhenIn the importImport processResources isdialog, executed, Scene Composer will display a message to save any unsaved changes inselect the solution.target Pressfile, OKthen toclick proceed.OK. If you do not want this dialog to appear during the import process, uncheck the "Always show this dialog" checkbox.

    drawing-5-1717170728.png

     

     

  2. After saving the solution, the Import Resources dialog will open. Select the target file and press OK. If the selected file format is "*.ico", Scene Composer displays the [ Import Icons ] dialog willthat appearprovides asthe shownfollowing below.options:

    • The Selected files field displays the path ofto the selected file is displayed in the [ Selected files ] field.file. To re-select a file, pressclick the [ Select File... ] button..
    • In [ Destination folder ], specify the location where Scene Composer imports the file will be imported as a resource.
    • As explained in the Drag and Drop section, ifwhen you drag and drop an image file format(*.bmp, *jpg, *.png) that can be imported as an iconicon, (*.bmp,Scene *jpg,Composer *.png),displays thea aboveprompt dialog will appear andallowing you canto select whether to import it as animage or icon.

      drawing-5-1717170817.png


  3. Click "OK" buttonOK to complete the import operation.

SVG files
  1. 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.

    drawing-5-1717170829.png

     

     

After saving the solution,In the Import Resources dialog is opened, where you candialog, select one or more SVG files tothat beyou imported. Select your fileswant to import and pressclick OK.

    You can import multiple files at once.


    drawing-4-1696552970.png



     

    AfterScene choosingComposer yourdisplays files to import, anthe SVG Importer dialog will be displayed.
    dialog:

    Configure the import settingssettings, to your needs andthen click "Import" button.Import..

    • "ImportedScenes"Scene Composer creates the ImportedScenes and "Scenes"Scenes folders have been created at the destination folder chosenselected in "Solution Explorer"Explorer. The former holds data imported as template scenes, while the latter holds data imported as actual scenes. 

    • If you import multiple SVG files have been imported,files, the Scene Editor will displaydisplays the actual scene forthat whatcorresponds wasto the topmost SVG file in the SVG Importer.

      • Transform > Position > X = 0, Y = 0 will beis the item's initial position.

    • CopyYou can copy group nodes withinfrom imported scenes and paste them into theyour desired scene andto use them.

      drawing-5-1732885221.png

    glTF files

    The CGI Studio glTF Importer does not support the following features:
      - MorpingMorphing
      - Vertex Buffer Streams
      - Sparse Accessors

    For additional details on handling glTF files—files — e.g., supported extensions, multiple UV sets, and limitations—pleaselimitations — see the glTF file page.

    For importing glTF files containsthat contain skinning, see here.

    1. 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.

      drawing-5-1717170856.png

       

       

    After saving the solution,In the Import Resources dialog is opened, where you candialog, select one or more resource files tothat beyou imported. Select your fileswant to importimport, andthen pressclick OK.

      You can import multiple files at once.inn

      AfterScene choosingComposer yourdisplays filesthe to import, an Import dialogGLTF will be displayed.
      dialog:

      • 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 needhave 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.
        drawing-4-1779079128.png



      Then,After "confirming by clicking OK, Scene Composer displays the Import GLTF"GLTF dialog will be displayed.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, please refer tosee Import Dialog Options.

        drawing-4-1779926844.png

      Configure the import settingssettings, to your needs andthen click "OK" button.
      OK.

      • TheScene Composer imports the file will be imported as a resource in the Solution Explorer in, the location corresponding to the settingsbased on the selected dialog screen.
        settings.

        drawing-5-1717172418.png

      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.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;panel. theThe importer applies the same setting to every mesh/material that references LambertianTexture (irradiance/diffuse slot).LambertianTexture. 

      drawing-4-1759818288.png