The Definitive Guide to HoloBuilder: From zero to 3D-hero in a few simple steps

Even though HoloBuilder is developed with a strong focus on usability and intuitiveness, as an absolute beginner you might feel a little overwhelmed by its large variety of features and functions.

This is why we have created an easy to understand beginner tutorial that enables you to create amazing 3D  virtual reality construction projects from scratch, without any previous knowledge, in a few simple steps.

We think the guide provides everything you need to enjoy the usage of HoloBuilder, but if there should be anything that you are missing or if there are any questions left open, we would love to hear them. So please do not hesitate to contact us, whatever your concern might be.

The Definitive Guide to HoloBuilder

HoloBuilder.com is a web platform that allows users attach an unlimited number 360º images of their construction site to a series of floor plans.  Each location on the floorplan is known as a scene and each floor plan is referred to as a sheet. Over time, the scenes are updated by creating a new TimeTravel by taking updated images for each location. This set of scenes makes up your HoloBuilder project.

HoloBuilder supports 360° photospheres as well as custom 3D models and provides a wide variety of predefined 2D and 3D objects to insert in your 3D scenes. Thus, it should be incredibly easy for you to create great 360° and 3D content with HoloBuilder— there are absolutely no programming skills required!

Find below a list of the features presented in this guide – click on the corresponding heading to jump directly to the information you are looking for, or browse through the complete guide to get an overview of the full potential of HoloBuilder.

Creating your first HoloBuilder project – the basics
HoloBuilder from A to Z – The short version
Managing scenes
Adding further scenes
Orienting scenes
Changing photosphere/ AR marker
Calibrating photosphere
Adding 2D Text/ 3D text
Adding 2D/ 3D objects 
Manipulating 2D/3D objects
Animating 2D/ 3D objects
Adding an action to your 2D/ 3D objects
Interlinking scenes
HoloPlayer
Embedding & sharing your Holo
Upgrade your account

Get started!

Where can I find good photospheres?
Where can I find nice 3D models?

 

Creating your First HoloBuilder project

When first launching HoloBuilder, you are must enter the name, area in square feet, and address of your project. After filling out the required information, you are presented with a menu for creating a new project that lets you select the type of the initial scene format of your new HoloBuilder project.

By default, the initial view of the menu shows the three available scene types:

Drag and drop image files to upload

Figure 1: Drag and drop image files to upload

  • Virtual Reality Scenes: Add  360° images, known as  scenes, to your project. You can later attach each of the images to a location on a floorplan. Click here for a short overview of common cameras to be used for capturing 360° images. A list of cameras compatible with the JobWalk App can be found here.
  • Sheets: Start your project by adding one or multiple sheets, e.g. floor plans or similar mappings of the location – Learn more.
  • Augmented Reality Scenes:
    • Without Marker‘ creates an empty 3D room;
    • Image Tracking‘ lets you add a two-dimensional image as a marker that will be placed as a plain object at the center of the room. All additional 3D objects are then placed in relation to this image; and
    • Object Tracking‘ lets you add a three-dimensional model (in terms of a .cloudfile).
  • Import Existing Project: Load another existing project to this project –  Learn more.

Further listed options are not available for creating a new project but only when editing an existing project:

  • Time Travel Scenes: Time Travel scenes are not for creating new projects, but rather adding new 360º images taken from the same location as existing scenes. The new images are added to the same sheets to document construction progress over time. You can create a Time Travel using the JobWalk App or following the instructions here.

 

It is possible to simply drag and drop one or multiple 360° images directly onto the user interface, which will automatically add several scenes or sheets at once to your project.

 

Go to top!

 

HoloBuilder from A to Z – The short Version

When uploading any 360° images or sheets to your project, you will be presented with the HoloBuilder editor as shown in figure 2 below. Start adding any further information, e.g. actions, or additional documentation, e.g. as multiple sheets or time travels, without limitations.

Overview of the HoloBuilder web editor

Figure 2: Overview of the HoloBuilder web editor.

In general, we can divide the editor into three areas: the project panel, the display, and the object panel.

  • The project panel helps you organize and add new scenes, sheets, and time travels. Learn more about how to use all of the features of the Project Panel here.
  • The display shows the currently selected scene including all objects. You can manipulate the image with the action bar or interact with the added sheets and select the desired time travel.
  • The object panel provides a variety of predefined 2D & 3D objects, actions, and animations. Add custom objects and organize them, e.g. in groups.

Find below a list of HoloBuilder’s most important features and learn more about your possibilities! Get access to the right comprehensive tutorial answering you every question in detail here.

Go to top!

 

1 Managing existing scenes & sheets

Image preview & properties in the HoloBuilder project panel

Figure 3: Image preview and properties in the Project Panel.

Hide () and expand () the scene overview at the upper right corner of the panel.

In the left-hand sidebar, the project panel, you can manage your project scenes, sheets, and time travels. Edit the properties and rearrange each scene, sheet, and time travel scene individually in the project panel.

1.1 Scene & sheet properties

Click on the name above the scene or sheet preview to open the scene/sheet properties:

  • Rename: Each added scene or sheet will automatically be named with the name of the image file of the sphere or sheet.  Add/change the name and description of the selected scene or sheet in the properties.
  • Add a time: The timestamp of a scene or sheet can be useful for documentation purposes. Also, the timestamp for scenes is essential for arranging time travel scenes. Make sure to set the year, month, day, as well as time.
  • Change the thumbnail: The thumbnail of a scene displayed in the project panel can be changed by dragging and dropping an image file over the current thumbnail in the scene properties menu
1.2 Setting default scene orientation

Each scene or time travel scene has a default orientation for the initial view depending on the placing of the camera during the capturing process. This will be the default view when first loading a project. When switching between different scenes, the orientation of the scene will be adjusted to the direction the previously viewed scenes was facing. This way it is possible to easily orient oneself in the virtual environment when ‘walking’ through.

When creating a scene or adding time travel scenes, you can set a fixed orientation of the scene for when it is being opened. This helps to set a focus of an individual scene or a direction when creating a project. However, if a fixed orientation is set for a scene, the automated adaption of the previous scene’s direction, will be disabled.

Select the desired scene in the project panel. Rotate your scene to the right perspective, zoom in or out and click the camera icon  at the right border of the scene preview to set the orientation of the scene.

1.3 Rotating Sphere

Adjust the calibration of your added scenes or time travel scenes and straighten out tilted images. Click the rotation icon rotateSphere located in the upper-right corner of the display to change to the ‘Rotate Sphere’ mode. Rotate the 360° images of the selected scene in three dimensions to get the right perspective by dragging the corresponding toggle switch as shwon in figure 5.

Learn more about how to properly calibrate your 360° images with HoloBuilder in the corresponding tutorial!

Figure 5: Three-dimensions for rotating the 360° image.

 

Go to top!

 

1.4 Rearranging scenes and sheets

Rearrange the order of your added scenes, sheets, and time travel scenes by dragging and dropping each scene accordingly to its’ place. Click on the scene or sheet element you want to rearrange and hold while dragging it up and down in the list.

Drag a scene onto a sheet element in the list to assign it to this sheet. This will not add a waypoint for the scene to the sheet map in the display, simply arrange the scene to be subordinate to the sheet. To create a waypoint on the sheet, select the scene and click on the location on the sheet map.

1.5 Changing a scene’s image

To exchange the image of an existing scene/sheet but keep the inserted objects, actions, and connections/waypoints, click on the two facing arrows next to the preview thumbnail. Browse your local drive to add another image. Any added objects will not be removed and stay at the given position in the scene. Waypoints placed on a sheet will be kept in their place.

1.6 Removing a scene/sheet

Use the icon at the right border of the scene/sheet preview to delete a scene or sheet. Note that, when deleting a time travel scene, you will delete the whole time travel of this scene including all time travel scenes if you delete the initial scene for this time travel. You can delete single time travel steps by selecting any other timestamp with the time travel menu and then clicking the recycling bin. Learn more about how to work with Time Travel here.

Go to top!

 

1.7 Adding further scenes, sheets or time travels

To add a new scene to your HoloBuilder project, you need to click on the green plus button in the project panel. You can select any scene type to add to your project by selecting the corresponding tab in the popup as shown in figure 1.

Any newly added scenes, sheets or time travels will be directly visible in the project menu as shown below. Place new scene on a sheet by dragging and dropping it to the corresponding location in the sheet map. Learn more about adding time travels here and uploading additional sheets here.

Figure 4: Add new scenes, sheets or time travel scenes to a project with the project panel.

 

Go to top!

 

2 Custom text & objects

2.1 2D/ 3D text

Select the tab ‘ Custom Text & Objects’ in the object panel’s register ( tab) to add 2D or 3D text (see also figure 6):

  • Click A2D to open the 2D text editor. 2-dimensional text always faces the camera. It can be arbitrarily styled in the provided rich text editor, including some predefined backgrounds etc. Select the 2D text and click once again A2D  to edit the text. Learn more on how to add 2D text directly into your scene here.
  • Click A3D to open the 3D text editor. 3-dimensional text can be styled according to the given style elements, such as font, color etc. They can be rotated, scaled, and moved anyway in a scene. It is currently not possible to edit 3D text after it has been inserted into the scene. Learn more about 3D text directly in your scenes here.
2.2 2D/ 3D objects

Select the tab ‘ Custom Text & Objects’ in the object panel’s register ( tab) to upload custom 2- and 3-dimensional object. Click the button to add a 2D object, e.g. an icon, or  to upload a 3D model:

  • 2D models are simply images that are inserted into the slide and always face the camera (in analogy to 2D text). 2D objects can be added as .jpg, .jpeg or .png file.
  • 3D models need to be available as .dae or .obj file. In case your models are not available in one of these formats, you can convert them using, e.g., the Open Asset Import Library. Always make sure to have all assets, such as the texture files, e.g. .mtl & .jpeg for .obj, included.

 

Figure 6: Select the object menu in the object panel on the right to add predefined 2D & 3D objects or text to your scene.

If you have no 3D models present on your computer you can use our predefined models (“Arrows”, “Shapes”, “Textured Shapes”, “Tools” and “Icons”) that are provided in the right-hand sidebar ( tab) as well. Click on the corresponding model category and drag & drop or simply click on the model you want to add to your scene.

Alternatively, you can make use of our integrated search box to find 3D models on the web. Since you have to first download these from external sites, they are not automatically added to your HoloBuilder project. However, you can directly drag & drop them from your browser’s download bar onto HoloBuilder’s “Add Object or Image” dialog box and they will be instantly added to your project. The correct file formats are preselected in our meta-search.

Learn more about adding 3D models to your HoloBuilder project with this comprehensive tutorial.

Go to top!

3 Manipulate 2D/3D objects

Move, rotate and scale your added 2D and 3D objects to fit the AR or VR surroundings. Learn more about positioning, rotating and scaling your objects with this complete tutorial on ‘How to correctly Position, Rotate & Scale objects in HoloBuilder’.

Go to top!

3.1 Animations

Select an object you have added to your slide and set it in motion. Switch to the animations menu in the object panel, located in right-hand sidebar of the web editor ( tab). Choose either one of the predefined animations or create your own custom animation, which you can compose with the basic motion options “rotate”, “scale” and “position”.

Overview of the predefined animations HoloBuilder offers to get your 2D and 3D objects moving.

 

Go to top!

3.2 Actions

Bind objects in your slide to certain actions also called commands. Add a command to an object by clicking the rightmost icon at the top of the object panel (tab). Select the object that shall perform the action as soon as it’s clicked and choose a command from the list in the menu – e.g. opening a website or opening slides for building interactive tours.

The list of standard commands that can be used to enrich the AR and VR

 

Go to top!

3.3 Interlinking Scenes

One of the most important functionalities of HoloBuilder is the ability to interlink scenes. This way it is possible to, e.g., create a virtual tour of your construction site by displaying the appropriate HoloBuilder scene when a virtual “door” is clicked. To realize this, drag and drop a ‘Go to Scene’ action object panel into the scene. Select the scene that you would like to button to open from the drop down menu.

Go to top!

4 Preview Mode

After having edited your project (or while you’re still editing), you can view your project in preview mode and see how your project will look to colleagues with view permissions. To change to the preview mode click the “play” icon in the right part of the top menu bar (the one above the actual editor).

While in player mode, you can switch back to editor mode by clicking ‘Back to Editing’ icon in the menu at the bottom of the viewer. Moreover, you can enable sensor usage if viewing the project on your mobile device (i.e., you move the orientation of the current slide by moving your device), fullscreen mode, and stereo mode. Stereo mode is intended for use with Google Cardboard and offers a full VR experience. Share your project on social networks or embed it on your homepage.

Go to top!

5 Embedding & Sharing Your 3D Presentation

To share your 3D presentation, simply click the share icon in the top menu bar and copy/paste the URL from there or directly select the social network you want to share it on. Alternatively, HoloBuilder projects can be embedded on arbitrary web pages. For this, change to the “Advanced” sharing options and copy/paste the provided “Embed Code” into the HTML source code of the embedding website (e.g., your personal website or blog). For technical instructions on optimizing the embedded project for mobile devices click here. Adjust the settings of the player when embedding it to your personal preferences. Learn more about ‘How to Customize the HoloPlayer Layout for Sharing your Holo’ in a complete tutorial.

Left: Standard options for sharing #holo by social network or directly with URL. Right: Advanced sharing options for embedding your Holo into your website or distributing a custom fullscreen link.

Go to top!

6 Upgrade your account

Go to  our pricing page and purchase a HoloBuilder subscription to continue using all of our great features such as

  • Unlimited sheets, images, users, projects, storage, and scalability.
  • The JobWalk App for efficient capturing of your construction site.
  • Collaborative projects that allow multiple colleagues to capture, annotate, and view project content at the same time.

Go to top!

Get Started!

Now it’s your turn! Take the following 360° photosphere by clicking the “Copy & Edit” button and saving the project as your own:

Download the 3D model of a palm tree:

CoconutTreeCoconut Tree

and put them together on HoloBuilder.com. Your result could look something like this but it is up to you to put all components together as you wish:

Go to top!

More information and tutorials

If you have any questions, do not hesitate to contact support@holobuilder.com. Learn more about HoloBuilder by checking out our tutorials and blog.

Click below to learn more about

How to use the Project Panel, waypoints, filters, and organizing sheets and scenes

Customizing and optimizing embedded projects for mobile devices

 

If any further questions remain, please don’t hesitate to write us! Or take a look at our other tutorials for further instructions.