How to Add Custom 2D Images to your HoloBuilder Project

Additionally, to the basic range of built-in 2D icons, HoloBuilder provides an option to upload and integrate custom 2D images to enhance any 360° scene with close-ups.

1 Supported file types

HoloBuilder can handle .jpg/.jpeg or .png file formats to add standard 2D images to your 360° scenes. 2D images can be added either as interactable action object or directly to show in the 360° scene.

Alternatively, you can also add the standard 2D images as a rotatable 3D image directly into the 360° image with Textured 3D Shapes. Find out more about Custom Textured Shapes here.

2 Importing the 2D images

There are two options for adding standard images to a 360° image in HoloBuilder:

  1. Add an image directly to the scene
  2. Add an image as action object to open on demand

2.1 Add a standard image directly to the 360° scene

To integrate a standard 2D image to your HoloBuilder project, click the tab in the right-hand sidebar. Open the section ‘Custom Text and Objects ‘ at the top of the sidebar. Click on the button to open the image importer.

Add a 2D image

Upload 2D image

Drag and drop the image file into the highlighted area or browse your computer to upload it (see image above). Once the file was selected the import will start automatically and your 2D image will appear in the 360° scene (see image below).

You can move and scale the image as any other 2D object in HoloBuilder. However, it is not possible to rotate it. The 2D image will always rotate to face the viewer. If you would like to keep the image oriented in a specific direction, please use Textured Shapes to add your 2D image. Apart from moving and scaling the image, you can also add an action to it to make it interactive.

2D image integrated in the 360 scene

2.2 Adding a 2D image as interactive action object

Alternatively to adding a 2D image directly into a 360° scene or as a Textured Shape, you can also upload it with the ‘Show image’ action object. The action object will be used as a switch to open the 2D image in a pop-up view.

To add an image with the ‘Show image’ action object to your HoloBuilder project, click the tab in the right-hand sidebar. Open the section ‘Action Objects’. Click on the action object ‘Show image’ to add it to the scene. By default, the object will be placed in the middle of the screen. To directly place the action object in the correct location in the 360° scene, drag and drop it accordingly. 

In the opening dialog box, drag and drop the image file into the highlighted area or browse your computer to upload it (see image above). Once a file was uploaded, you can either chose another file or SAVE CHANGES to add this image to be shown with the action object.

Move and scale the action object like any other 2D object in your 360° scene. Please note that action objects are only two-dimensional and thus, cannot be rotated. The object will be always facing the viewer. To change the attached image after saving the changes, select the action object and switch to the last tab . Click on the highlighted action tile. The dialog box to attach a file will open. Choose SELECT ANOTHER FILE, browse for the file and SAVE CHANGES.

Add file to Show Image Action Object

 

In the player, you will see the action object. Hover the action object to see the image’s file name (see image below). Click the action object to open the attached image in a pop-up (second image below).

2D images with action objects attached

 

3 Support

If you have any questions or problems, you can always reach us at support@holobuilder.com for more information on this or any other topic.