Skip to main content

How to Import Resources

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

drawing-4-1695789293.png

 

    Import File Formats
    Import Operations
      Menu Bar
      Context menu
      Drag and Drop
      Import operations by file format
        Image, font, shader, FBX, and script file formats
        Icon file format
        SVG file format
        glTF file format

         

        Import File Formats

        The file formats to be imported when using this menu are as follows

        • Image files (*.bmp, *.jpg, *.jpeg, *.gif, *.tga, *.png, *.dds, *.ktx, *.hdr, *.exr)
        • Font files (*.ttf, *.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 above, Photoshop file (*.psd), Adobe XD file (*.xd), Axure RP file (*.rp) and Sketch file (*.sketch) can also be imported. For more information on these, please refer to Smart Importer chapter.

        glTF file format

        FBXSceneComposer andsupports following glTF file importformats operationswhen areimporting:

        not
        available
          glTF: This points to external binary data (geometry, key frames, skins), and images. glTF-Embedded: This embeds base64-encoded binary data, and images inline using data URIs. glTF-Binary: In Binary glTF, a glTF asset (JSON, .bin, and images) can be stored in a binary blob.

          For more detailed information on OpenGLthe ES1.1file platformsformats, suchplease assee Traveo2.the Khronos website: GLB File Format Specification.

          About .ktx File Format

          The following compressed image formats are supported:

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

          To use this type of format, first of all it is necessary to convert an image with a different format (.tga, .gif, .psd, .bmp, .pgm, .png etc.) in a .ktx file. The next tools support generating 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). The available output file formats are .pkm - that can contain compressed textures - and .ktx – which allows the compression of a 2D texture with all its mipmap levels.

          After the conversion is done, the .ktx resulted file can be imported in SceneComposer by following the same flow as in the case of other image formats.

          In the case of a converted .ktx file which is imported in the SceneComposer application, the usage of the "DefaultBitmapConverter" property - available for any usual .bmp image - is not possible.

          About Bitmap Font

          Bitmap fonts are supported by SceneComposer. In order to use bitmap fonts, the SCHost.dll must be compiled using BitmapFont font engine. Only one font engine can be active at a time in an SCHost.dll.

          The user can import 2 types of files as bitmap fonts:

          • .fnt (windows font files) - are converted to bitmap fonts
          • .fbm - already converted bitmap font files

          When a font is imported, following specific property will be set:

          • Source file names: specifies the name of the file which was imported - helps the user identify a font
          drawing-4-1695368958.pngdrawing-4-1695368958.png


          FBX and glTF file import operations are not available on OpenGL ES1.1 platforms such as Traveo2.

           

          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.

          drawing-4-1695713741.pngdrawing-4-1695713741.png



          Context menu

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

          drawing-4-1695713724.pngdrawing-4-1695713724.png



          Drag and Drop

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

          drawing-4-1695713707.pngdrawing-4-1695713707.png


            • glTF file can also be imported by drag-and-drop to any folder under Solution in Solution Explorer.

            • Note that shader files (*.vert, *.frag) and SVG files (*.svg) cannot be imported by drag-and-drop in OpenGL ES1.1 environment.

            • 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.
              drawing-4-1695617424.pngdrawing-4-1695617424.png

          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

            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-4-1695370668.png

             

             

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


              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.

                drawing-4-1695371400.png



                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.

                  drawing-4-1695371504.png

                  Icon 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-4-1695370668.png

                     

                     

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


                  3. After choosing your files to import, an Import dialog will be displayed depending on the file types you are importing (Image, Font, FBX, Shader…).

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

                      drawing-4-1695371504.png

                  SVG
                  Icon files

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

                  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-4-1695370668.pngdrawing-4-1695370668.png

                     

                     

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


                    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.

                      drawing-4-1695370668.png

                       

                       

                      After saving the solution, the Import Resources dialog is opened, where you can select one or more resourceSVG 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.once.
                      drawing-4-1695371038.pngdrawing-4-1695790224.png


                       

                      After choosing your files to import, an ImportSVG Importer dialog will be displayed depending on the file types you are importing (Image, Font, FBX, Shader…).displayed.

                      Configure import settings to your needs and click "OK" 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 asscenes a resource ininto the Solutiondesired Explorerscene inand theuse location corresponding to the settings on the dialog screen.them.

                        drawing-4-1695371504.pngdrawing-4-1695790438.png

                        glTF files

                        The CGI Studio glTF Importer does not support the following features:
                          - Skinning
                          - Morping
                          - Vertex Buffer Streams
                          - Sparse Accessors
                          - Multiple UV Maps

                        There



                        is a supplement on the handling of glTF files. Please check this page as well.

                        Images, fonts, shaders, FBXs, script 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-4-1695370668.png

                           

                           

                        2. 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.
                        3. 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.once.
                          drawing-4-1695371038.pngdrawing-4-1695790711.png


                        4. After choosing your files to import, an Import dialog will be displayed depending on the file types you are importing (Image, Font, FBX, Shader…).

                          • IBL settings are also available in Solution Options. See IBL Texture for more information on the settings.

                        5. These three values must be defined when using IBL. They cannot be reconfigured after import.

                        If you do not want to use the IBL settings, uncheck the "Use Image Based Lighting (IBL)" checkbox.

                        drawing-4-1695790835.png



                        Then, "Import GLTF" dialog will be displayed.
                          IBL settings cannot be changed on the Import Dialog.
                          See Import Dialog Options for ainformation descriptionon ofsetting the settingsitems on the dialog screen.
                          drawing-4-1695371400.pngdrawing-4-1695790941.png



                          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.

                            drawing-4-1695371504.pngdrawing-4-1695791720.png

                          Back to top