Referencing external resource

External resources can be referenced and drawn on the scene editor. This feature is only available when launching Scene Composer on the Android platform.

Resource Reference Menu

[ Set External Resource Path... ] in the menu bar under [ File ] to browse external resources. This menu is grayed out and not selectable for Scene Composer on non-Android platforms.

 

Basic Usage

1. Run Scene Composer and open a new or existing solution file.
   
   
2. From [ File ] menu in the menu bar, select [ Set External Resource Path... ].
   
   
3. The ExternalResourceContainerPlugin dialog will appear.
   
   
   
   
   
4. Click the [ Browse... ] button in the dialog to select the external resource folder to be referenced.
   
   • Select the Android Studio project folder.
     
     
     
5. An [ External Resources ] folder will be added to the Solution Explorer.
   • The folder will list the image resources contained in the selected Android project folder.
     
     
     
     
     
6. Drag and drop the [ Node 2D > Bitmap Node ] from the toolbox onto the scene editor.
   
   
7. Attach [ Behavior > External Resource > Value Processing > External Bitmap Provider ] in the Toolbox to the Behavior in the Extra Scene Tree of the placed bitmap node by drag-and-drop operation.
   
   
   
   
   
8. Click External Bitmap Provider behavior and press the select item button to the right of ExternalResourceId in the properties panel.
   
   
   
   
   
9. A dialog box will appear and select the target image file and press the [ OK ] button.
   
   
10. The selected external resource will appear in the scene editor.
    • Save the solution and launch Player to confirm that this external resource is displayed.

 

The behaviors Set External Bitmap, Check External Resource Change, and External Bitmap Provider are used to display external resources. For details on each behavior, please refer to this page.