Skip to main content

Part 1: Smart Importer

This section describes the creation of a new SolutionSolution. We will use the Smart Importer to import a Photoshop .psd file. Smart Importer will analyze the PSD file and howtry to proceedidentify importingwhich IVI_Sample.psdcontrols fileare viaincluded Smartin Importer.the Speciallypicture. aboutThe howfinal assignment of controls (such as RadioButtons, DigitalClocks, CheckBoxes, etc.) however has to assignbe performed manually. After some configuration effort Scene Composer Controls tocan eachbe imageimported parts.into your Scene Composer solution.

 

    Create

    Creating a new Solution

    1. SmartStart ImporterScene Composer and double-click on [Empty] from [Samples and Templates] on the startup screen.
      • HeaderA Treenew solution will be created based on the Empty solution template.
    2. Menu_button tree

    In the Render Targets panel, select [Display (0)].

    The

    Navigation[Properties] Treepanel will display [Display] properties.
    drawing-5-1746775102.png




    Create a new Solution

    The first step is to create a new Solution for Scene Composer.

    Double-click on

    In the Empty[Display] templatesection under Samples and Templates.
    * Selecting “Empty” template creates a new solution based onof the template.
    drawing-5-1729258109.png

    Activate the "Render Targets"[Properties] panel and selectconfigure the "Display". Change the display's resolution as shownin the table below.

      X Resolution
      640
      Y Resolution 960 Y Resolution 960
      drawing-5-1729259204.png

      Click the "[Save solution..." icon] in the menutoolbar.

      bar.

        The Windows [Save As] dialog will appear.

        drawing-5-1729259364.png
        drawing-5-1746775292.png

        A

        In the [Save As] dialog boxchoose willa appear,location allowing you to select an appropriate location. Input anyand name asfor ayour solution fileand name.click
        [Save].
          The solution is saved.

           

          Using Smart Importer

          In our example we will use the Smart Importer to import a Photoshop .psd file. Smart Importer will analyze the PSD file and try to identify which controls are included in the picture. After some configuration effort you can directly create CGI Studio Controls wherever it is applicable.

          Choose

          Configuration "of Header

            Select [Import > Smart Importer",Importer "> From Local File...".] This will openfrom the menu bar.
              A Windows Open dialog.dialog titled Smart Importer will be opened.

              Select the following Photoshop file and press "Open":[Open].

              <cgi-studio-root>\cgi_studio_content\2D\PSD\IVI_Sample.psd

              drawing-5-1729259481.png

              The photoshop[Smart fileImporter] willwindow is opened (please be loadedpatient, andthis themay Smarttake Importera dialogwhile). box will appear.
              drawing-5-1729259702.png

              The photoshopPhotoshop file's contentlayers will be displayed in the Layer Tree area marked in orange in the aboveimage picture.below. ClickThe Layer Tree is displayed in tree style. Initially it is collapsed, but it can be expanded via double-clicking or using the triangle to the [IVI_Sample]'s left.
              File path
              <cgi-studio-root>\cgi_studio_content\2D\PSD\IVI_Sample.psd

               

              drawing-5-1746777849.png


              Expanding the Layer Tree navigate to [IVI_Sample > Header > DigitalClock] and select [DigitalClock].
                In the Smart Importer's Preview the DigitalClock on the left-mosttop triangleleft buttonis tomarked extendwith thea IVI_Sampleyellow andborder. HeaderThe layerControl tree.List Check the checkbox to the leftright ofdisplays applicable Controls.

                In the Header and make sure that all items under the Header are checked. Click on DigitalClock in the tree. From the [Control List,List] click on the Apply[Apply] button toon the right side of the [DigitalClock] control (see image below).
                  Based on the Photoshop file's DigitalClock the Scene Composer control DigitalClock will be created when the import is done. DigitalClock will be displayed in a different color and with a different icon in the Layer Tree to indicate successful assignment of a Scene Composer control.
                  drawing-5-1729259835.png
                  drawing-5-1746782115.png

                  Click

                  on Switch to the [Basic Properties”Properties] tab and check “ShowFull24Hours” checkbox. This will maketick the displaycheckboxes shownoted 24 hours. Similarly, uncheck “ShowSeconds”. This will preventin the secondstable frombelow. being
                  displayed.After
                  import
                  the
                  created
                  drawing-5-1729259951.png

                  If aSceneComposer Control isDigitalClock set and imported with layers and properties that do not match when imported, the original group will not reflect the Control, and another new group node with Control applied will be added.

                  configured

                  Followingwith thethese previousproperty operation, similar operations are performed on each item.


                  Header Tree
                  drawing-5-1729260151.png
                  values.
                  Target LayerShowFull24Hours Control ListTRUE
                  TellTale_ErrorShowSeconds Tell TaleTRUE

                  In
                  Menu_buttonthe tree
                  Layer drawing-5-1729260308.pngTree drawing-5-1729260455.pngselect
                  [TellTale_Error].
                  In the Smart Importer's Preview the TellTale_Error on the top right is marked with a yellow border.
                  The Control List panel to the right displays applicable Controls.

                  In the Control List panel click the [Apply] button next to [Tell Tale].
                    The Scene Composer Control TellTale is applied to the Photoshop file's TellTale_Error layers.
                    In the Appearance Tab you can see that the Telltale's properties OnStateImage and OffStateImage are automatically configured with the Photoshop file's layers OnStateImage and OffStateImage. TellTale_Error as well as its OnStateImage and OffStateImage will be displayed in a different color and with different icon in the Layer Tree to indicate successful assignment of a Scene Composer control.

                     

                    Configuration of Menu Buttons

                      In the Layer Tree expand [Menu_button].
                        The Layer Tree displays 4 TextButtons, each of which has 3 images (NormalImage, PressedImage and FocussedImage).

                        In the Layer Tree select TextButton_Car.
                          The Control List offers a list of Controls to apply.

                          In the Control List apply the Scene Composer control TextButton.
                            In the Appearance tab you can see that NormalImage, PressedImage and FocussedImage have been configured automatically. In the Layer Tree the TextButton has changed its color and its icon.

                            In the [Basic Properties] tab empty the textfield of the Text property (delete "Text...").
                              The textfield of property Text is empty.

                              Repeat the 3 steps above with the other TextButtons to achieve a configuration as in the table below.
                                The menu buttons are configured for importing.
                                Target Layer Control List Basic Properties
                                TextButton_Car TextButton Text (blank space)
                                TextButton_Navigation TextButton Text (blank space)
                                TextButton_Phone TextButton Text (blank space)
                                TextButton_Music TextButton Text (blank space)

                                Configuration of Music Tree

                                drawing-5-1729260600.png
                                drawing-5-1729260737.png

                                  In the Layer Tree expand [Music].
                                    The Layer Tree displays among other things a Slider, DigitalClock_Time, DigitalClock_Total_Time and a CheckBox.

                                    In the Layer Tree select the target layer. Apply the controls in the [Control List] tab and configure the property values in the [Basic Properties] tab according to the table below.
                                      The controls of the Music part are configured for importing.
                                      Target Layer Control List Basic Properties Slider
                                      Slider
                                      Value 9000 Minimum 0 Maximum 18000


                                      drawing-5-1729260999.png

                                      drawing-5-1729261166.png
                                      Target Layer Control List Basic Properties
                                      Slider
                                      Slider Value Float 9000 Minimum Float 0 Maximum Float 18000 DigitalClock_Time DigitalClock ShowFull24Hours enableBoolean TRUE ShowSeconds
                                      Boolean FALSE
                                      DigitalClock_Total_Time
                                      DigitalClock
                                      Time UInt32 18000 ShowFull24Hours Boolean TRUE ShowSeconds disableBoolean FALSE CheckBox
                                      CheckBox
                                      Text String (blank space)

                                      Configuration of Comfort Tree


                                      drawing-5-1729261244.png
                                      drawing-5-1729261338.png
                                        In the Layer Tree expand [Comfort > Seat_Left].
                                          The Layer Tree displays among other things Seat_Left with TextValue_Temperature, Icon_Button_+, Icon_Button_-, ProgressBar and SeatHeating_Left.

                                          In the Layer Tree select the Seat_Left's target layer. Apply the controls in the [Control List] tab and configure the property values in the [Basic Properties] tab according to the table below.
                                            The controls of Comfort's Seat_Left are configured for importing.
                                            Seat_Left Target Layer Control List Basic Properties DigitalClock_Total_TimeTextValue_Temperature DigitalClockText Value TimeValue 18000Float 23 ShowFull24HoursFormatText enableString %02d ShowSecondsIcon_Button_+ disableIconButton    
                                             


                                            drawing-5-1729261440.png
                                            drawing-5-1729261506.png
                                            Target Layer Control List Basic Properties
                                            CheckBoxIcon_Button_- IconButton       ProgressBar ProgressBar Value Float 23 Minimum Float 16 Maximum Float 28 SeatHeating_Left CheckBox Text String (blank space)

                                            In
                                            the Layer Tree expand [Comfort > Seat_Right].
                                              The Layer Tree
                                              drawing-5-1729261607.png
                                              displays
                                              drawing-5-1729261689.png
                                              among
                                              other
                                              things
                                              Seat_Right
                                              with TextValue_Temperature, Icon_Button_+, Icon_Button_-, ProgressBar and SeatHeating_Left.

                                              In the Layer Tree select the Seat_Right's target layer. Apply the controls in the [Control List] tab and configure the property values in the [Basic Properties] tab according to the table below.
                                                The controls of Comfort's Seat_Right are configured for importing.
                                                Seat_Right
                                                Target Layer Control List Basic Properties Seat_Left TextValue_Temperature Text Value Value Float 23 FormatText String %02d


                                                drawing-5-1729261768.png

                                                Target Layer Control List Seat_Left Icon_Button_+ IconButton       Icon_Button_- IconButton    
                                                 

                                                drawing-5-1729261837.png
                                                drawing-5-1729261898.png

                                                Target Layer Control List Basic Properties Seat_Left ProgressBar ProgressBar Value Float 23 Minimum Float 16 Maximum Float 28

                                                drawing-5-1729261958.png
                                                drawing-5-1729261996.png

                                                Target Layer Control List Basic Properties Seat_Left SeatHeating_Left(*)SeatHeating_Right CheckBox Text String (blank space)

                                                In
                                                the

                                                (*)Layer Tree expand [Comfort > Fan].

                                                  The imageLayer isTree treateddisplays likeamong other things a checkbox.Slider.

                                                  So there isIn nothe additionalLayer rectangleTree select Fan. Apply the control in the [Control List] tab and configure the property values in the [Basic Properties] tab according to the table below.
                                                    The controls of the Comfort's Fan are configured for that.
                                                    importing.
                                                    Fan
                                                    Target Layer Control List Basic Properties Seat_Right TextValue_Temperature Text Value Value 23 FormatTextSlider %02dSlider      
                                                    In the Layer Tree expand [Comfort > Air].
                                                      The Layer Tree displays among other things a RadioButton_Outside  air, RadioButton_Inside air and RadioButton_AUTO.

                                                      In the Layer Tree select Air. Apply the control in the [Control List] tab and configure the property values in the [Basic Properties] tab according to the table below.
                                                        The RadioButtons are configured for importing.
                                                        Air
                                                        Target Layer Control List Seat_Right Icon_Button_+Basic IconButtonProperties Icon_Button_-
                                                        Target Layer Control List Basic Properties Seat_Right ProgressBar ProgressBar Value 23 Minimum 16 Maximum 28
                                                        Target Layer Control List Basic Properties Seat_Right SeatHeating_Right(*) CheckBox Text (blank space)


                                                        (*)The image is treated like a checkbox. So there is no additional rectangle for that.

                                                        drawing-5-1729262200.png
                                                        Target Layer Control List Fan slider slider


                                                        drawing-5-1729262278.png
                                                        drawing-5-1729262310.png

                                                        Target Layer Control List Basic Properties Air RadioButton_Outside Airair RadioButton Text String (blank space) RadioButton_Inside Airair
                                                        RadioButton
                                                        Text
                                                        String
                                                        (blank space) RadioButton_AUTO
                                                        RadioButton
                                                        Text
                                                        String
                                                        (blank space)

                                                        When expanding these RadioButtons in the Layer Tree, you can see that each of them contains a Control_Background. Uncheck the checkbox of these Control_Background images in the Layer Tree as seen in the image below.
                                                          All images for the RadioButtons are configured for importing
                                                          drawing-5-1729262402.png
                                                          [Air] In the Layer Tree Panel
                                                          Target Layer Configuration detailsDetails
                                                          Air RadioButton_Outside Air/air/Control_Background disable (uncheck checkbox onin theLayer left)Tree)
                                                          RadioButton_Inside Air/air/Control_Background
                                                          disable (uncheck checkbox onin theLayer left)Tree) RadioButton_AUTO Air/RadioButton_AUTO/Control_Background
                                                          disable (uncheck checkbox onin theLayer left)Tree)
                                                          drawing-5-1746798417.png
                                                          Navigation
                                                          Tree
                                                          drawing-5-1729262508.png

                                                          Since

                                                          this

                                                          Configuration of Navigation Tree

                                                            In the Layer Tree enable the Navigation tree isby currently being unchecked, please tickchecking the checkbox.checkbox Thereto the left of Navigation.
                                                              Navigation will be enabled as seen in the image below.
                                                              drawing-5-1729262508.png

                                                              Completing the Import

                                                                Since configuration is nodone neednow, to applyclick the control[OK] inbutton ControlList since it only imports a Navigation image. After completingon the settingsbottom up to this point, pressof the OKSmart buttonImporter towindow. perform
                                                                the import. The photoshopPhotoshop file will be imported with all configured controls and settings.

                                                                The imported content can be viewed in the Scene Composer's Solution Explorer. The imported scene IVI_Sample will be displayed in the Scene Editor. In the Scene Tree panel,panel you can confirm that all configured controls and settings made in Smart Importer have been applied during the import.

                                                                After

                                                                you finishIn importing,the rightScene Tree panel right-click on the Navigation GroupNode in Scene Tree and uncheck "Node Rendering Enabled”.Enabled" Thenin thisthe elementcontext menu. Alternatively press <Ctrl + E> on your keyboard.
                                                                  The Navigation GroupNode will not be notrendered displayed(i.e. displayed) by default.
                                                                  drawing-5-1729262651.png