Top bar

Configuration file management

In the left part of the top bar you will find buttons to save / load / download the current configuration file. You can load an existing config, save the current state or download the current state as a backup.
When configuring the system using the main interface (web based), there is only one configuration file available: RemoteControl.star. Even if you are accessing it through the Augmenta app window on a local machine. The workflow is the same as you would do on a remote server.
The RemoteControl.star file, that exists in your user's Documents folder, hold the current config.

Download configuration file

To download your configuration file, click on "Download". A .star file will be downloaded, that containes the latest saved state.
Download a configuration file in the web interface
Download a configuration file in the web interface

Load a configuration file

If you want to replace the current config with an already existing configuration file (.star), you need to load the file.
In the toolbar at the top, click on "Choose file" and select your .star file that will be uploaded. Then click on the "Load" button to load your file.
⚠️
This will override the existing RemoteControl.star file in the project directory. Make sure to download the current config file before loading a new one or you could lose your previous config.
Load a configuration file in the web interface
Load a configuration file in the web interface

Save current configuration

Throughout configuration and calibration, you can save the progress of your work by clicking on the "Save" button.
Automatic saves are performed every 5 minutes and stored in a folder that has the same name as the current config file, next to it. If at some point you end up missing some data you can recover your project with those .star files.

3D object gimzos

Most of the objects in the 3D world have their own transform to place them in the world. Gizmos are visual objects that allow you to change the transform of an object easily.
3 types of gizmos are possible: position, rotation and size gizmo. All objects with a size have all 3 available (e.g. scene, crop box, etc.). Objects with no size, such as cameras, have only the first 2 gizmos available.
Gizmos
Gizmos
There are two ways to make a gizmo appear on an object:
  • select it in the hierarchy panel (left panel in the calibrate menu)
  • click directly on the object in the 3D world
Make a gizmo appear in the web interface
Make a gizmo appear in the web interface
⚠️
When objects are locked (when the lock icon is red, you can see it in the hierarchy panel), it is not possible to display the gizmo. To be able to move the object with the gizmo, you will have to unlock the object before, by clicking on the lock icon.
Once the object's gizmo is visible, you can switch between the different gizmos:
  • by clicking on the letters 't', 'r', 's' on your keyboard (for translation, rotation and scale)
  • or by clicking on 'T', 'R', 'S' buttons in the top toolbar
Switch between the different gizmos in the web interface
Switch between the different gizmos in the web interface
There are two possible ways of modifying the transform parameters of an object
  • Click on an element of the gizmo to move the position, rotation or size, and drag while holding down the mouse button.
  • You can select it in the hierarchy panel and then modify its position, rotation or size directly in the toolbar parameters.
Image without caption

3D editor camera

In the 3D editor, three orthographic views (each looking at a 2D cutting plan) are available, as well as the standard perspective camera. The 3 orthographic views are very useful for camera calibration, for example, when you need to be very precise on a particular plane.
The standard perspective camera allows you to navigate in the 3D world more naturally.
There are two ways of navigating between the different 2D planes and the 3D world :
  • by clicking on the camera icon in the top toolbar
  • by clicking on the "c" key on your keyboard
Views in the web interface
Views in the web interface
⚠️
2D views are cross-sections of the 3D world. When you're in a 2D view, you can't move around in 3D with the mouse. It is necessary to return to the 3D view
In the 3D world, you can
  • zoom in and out by scrolling
  • move in rotation by left-clicking or wheel-clicking
  • move in translation by right-clicking
In 2D views, you can also
  • zoom in and out by scrolling
  • move in translation by right-clicking
In 2D views, left-clicking or wheel-clicking does nothing

World menu

If you have multiple tracking world, you can navigate between them by selecting them in the top bar
World selection in the web interface
World selection in the web interface

Update menu

Once you've installed Augmenta, there's no need to reinstall it to get updates. Just click on the update button in the top bar. A pop-up window will appear. You'll be able to see the latest stable and beta versions, and whether new updates are available.
Update version in the web interface
Update version in the web interface

Resync button

If you lose synchronization with the server (some objects are out of date, the synchronization button is red, etc.), you can click on the "Resync" button to resynchronize the server with your interface.
Now let’s check the Setup panelSetup panel