Knowledge Base

There are 2 different ways to pair the Frontline Spatial Capture app installed on your iPhone with a server instance:

• Scanning the configuration code generated via the Frontline Command Center.
• Manually entering the server details provided by your administrator.

To pair the app via configuration code:

1. Tap on Scan configuration code.
2.  Use your device to scan the configuration code provided by your administrator.
3. Tap on Save.

To pair the app manually enter the server details:

1.  Enter the configuration link provided by your administrator.
2. Enter the domain name provided by your administrator.
3. Tap on Confirm.

Signing in to the app

To sign in manually entering your credentials:

1. Enter your username or email address.
2. Enter your password.
3. Tap on SIGN IN.

Signing out of the app

1. In the top-left corner, tap on the Menu button.
2. Tap on Sign Out.
3. When asked if you want to proceed, tap on Sign Out.

Reporting an issue

In case of a technical problem, you can report an issue to someone who is able to investigate more and provide you with a possible solution. In this case, this person will receive the app’s log files that contain important information regarding any applicable settings and technical events for a proper in-depth analysis.

To report an issue:

1. In the top-left corner, tap on the Menu button.
2. Tap on Report issue under Feedback.
3. Describe the issue in as much detail as you can.
4. Optional: You can send log files by toggling the Send logs button.
5. Tap on Send on the top-right corner.

⇒ Your text describing the issue and a copy of the log files are sent to the development team for analysis.

Note: You can always visit the Help page that is linked at the bottom.

Captures

Captures act as projects within the Frontline Spatial Capture app to create virtual representations of single objects or entire room setups. Once you have created a capture, you can use your device’s camera to take photos of the desired object or room which will then be used to create corresponding 3D models (for more information, please see the “Models” section).

Generally, there are 2 different types of captures:

• Object scans: These allow you to create virtual 3D models of real-world objects. This is especially useful when dealing with smaller objects (up to about 1 by 1 meter) or individual parts of larger machines. The corresponding 3D models can be used in Frontline Spatial workflows for training maintenance or repair tasks.
•  Room scans (only available on devices with LiDAR running iOS 16 and later): These allow you to create virtual floor plans of real-world locations together with schematic representations of the objects in them. The corresponding floor plans clearly show walls and windows as well as box-like shapes to indicate any objects inside the rooms. Additionally, the floor plans also contain the real-life dimensions and measurements of the respective rooms and objects.

Additionally, 

• Scene reconstruction: Allows you to capture both the floor plan of a room and the objects included in it in 3D, with refined details and texture.

 

To achieve the best possible results in terms of captures and virtual 3D models, apply the following principles:

• Choose the right object: Objects that do not move, show lots of surface details, and have a distinct texture are ideal. Objects with highly reflective surfaces should be avoided.
• Ensure proper lighting: Consistent and bright lighting is necessary for taking good pictures. It may help to open the curtains or turn on the lights.
•  Use a plain background: Backgrounds should be single-coloured without any complicated patterns or bright colours. In addition, backgrounds should provide a good contrast to the objects.
• Center the object: Objects should be placed in the middle of the camera’s field of view so that they fill the entire frame. It is important to make sure that no parts are hidden or cut off.
• Take pictures from all possible angles: Objects need to be photographed from multiple different angles and from all sides, providing a 360° view.
• Avoid motion blur: Taking good pictures requires a steady hand. Try to move slowly and evenly without any sudden gestures.

User interface

The Captures screen shows a list of all available captures. In addition to that, the top-left corner contains a menu button to access the app’s settings and important information. In the top-right corner, you can see a search button to quickly find a particular capture.

Creating a new object scan

There are two ways to create a new object scan. The first one allows you to scan objects that you look down to so that you can position yourself anywhere around the object and take pictures from all angles, while for the other one, the camera should be held parallel to the object (e.g., objects that are wall-mounted).

Creating a new object scan (Dome: above the object)

1. Go to the Captures screen.

2. At the bottom of the screen, tap on the Plus icon.

3. Tap on Object Scan.

4. Position your device at a higher angle by putting the object in the centre of the camera's field of view.

5. Tap on the centre of the object.

6. Adjust the size and position of the virtually displayed dome so that it covers the entire object and is located above the object’s centre.

• To resize the dome, use a pinch gesture.
• To reposition the dome, drag and drop it to the desired spot with your finger.

7. Once the dome is correctly placed, tap on Ready.

8. Slowly move your device around the object and take pictures from all possible angles:

• If auto mode is not enabled (i.e., if the Shutter button in the bottom centre of the screen shows an uppercase A in its middle), tap on the Shutter button each time you want to take a picture.
• If auto mode is enabled (i.e. if the Shutter button in the bottom centre of the screen shows an uppercase A in its middle), tap on the Shutter button once and the app will start taking multiple pictures while you move your device around the object.

9. If auto mode is enabled, tap on the Shutter button (currently showing a square stop symbol in its middle) in the top centre of the screen once all the necessary pictures are taken.

10. In the top-right corner tap on Done.

11. Enter a capture name.

12. Tap on Confirm.

13. To build a corresponding 3D model based on the capture, tap on Build.

14. Select the desired quality:

• High quality: Takes a relatively long time for processing but offers the highest level of detail. This quality setting is ideal for 3D models to be used in high-definition Frontline Spatial workflows.
• Medium quality: Takes a moderate time for processing but offers a higher level of detail. This quality setting is ideal for 3D models to be used in regular Frontline Spatial workflows.
• Preview quality: Takes a short time for processing but offers a relatively low level of detail. This quality setting is ideal for fast loading and real-time rendering.

⇒ The data is uploaded to the asset library. Once the upload is completed, the building process for the corresponding 3D model is started. After successful completion, the capture and its corresponding 3D model are ready to use.

Creating a new object scan (Plane: parallel to the object)

1. Go to the Captures screen.

2. At the bottom of the screen, tap on the Plus icon.

3. Tap on Object Scan.

4. Position your device parallel to the wall.

5. Tap on the centre of the object.

6. Adjust the size of the blue plane to fit the area you want to capture.

• To resize the plane, use a pinch gesture.
• To reposition the plane, move it with your finger to the desired spot.

7. Once the plane is correctly placed, tap on Ready.

8. Hold the device parallel to the wall and cover all the squares shown on the plane. (You can slowly pan around the area.)

• If auto mode is not enabled (i.e., if the Shutter button in the bottom centre of the screen shows an uppercase A in its middle), tap on the Shutter button each time you want to take a picture.
• If auto mode is enabled (i.e. if the Shutter button in the bottom centre of the screen shows an uppercase A in its middle), tap on the Shutter button once and the app will start taking multiple pictures.

9. If auto mode is enabled, tap on the Shutter button (currently showing a square stop symbol in its middle) in the bottom centre of the screen once all the necessary pictures are taken.

10. In the top-right corner tap on Done.

11. Enter a capture name.

12. Tap on Confirm.

13. To build a corresponding 3D model based on the capture, tap on Build.

14. Select the desired quality:

• Preview quality: Takes a short time for processing but offers a relatively low level of detail. This quality setting is ideal for fast loading and real-time rendering.
• Medium quality: Takes moderate time for processing but offers a higher level of detail. This quality setting is ideal for 3D models to be used in regular Frontline Spatial workflows.
• High quality: Takes a relatively long time for processing but offers the highest level of detail. This quality setting is ideal for 3D models to be used in high-definition Frontline Spatial workflows.

⇒ The data is uploaded to the asset library. Once the upload is completed, the building process for the corresponding 3D model is started. After successful completion, the capture and its corresponding 3D model are ready to use.

Creating a new room scan

1. Go to the Captures screen.

2. At the bottom of the screen, tap on the Plus button.

3. Tap on Room Scan.

4. Slowly move your device around the room so that the app can take pictures until the entire room is properly captured.

5. Once all the necessary pictures are taken, tap on Finish in the top-right corner.

6. Enter a capture name.

7. Tap on Confirm.

⇒ The data is uploaded to the asset library. Once the upload is completed, the building process for the corresponding 3D model is started. After successful completion, the capture and its corresponding 3D model are ready to use.

Resuming work on an incomplete capture

1. Go to the Captures screen.

2. Look for the desired capture. Optionally, you can use the search button in the top-right corner to do so.

3. Tap on the capture.

4. Tap on Add Photos.

5. Slowly move your device around the object and take pictures from all possible angles:

• If auto mode is not enabled (i.e., if the Shutter button in the bottom centre of the screen does not show an uppercase A in its middle), tap on the Shutter button each time you want to take a picture.
• If auto mode is enabled (i.e. if the Shutter button in the bottom centre of the screen shows an uppercase A in its middle), tap on the Shutter button once and the app will start taking multiple pictures while you move your device around the object.

6. Once all the necessary pictures are taken, tap on Done in the top-right corner.

7. Enter a capture name.

8. Tap on Confirm.

9. To build a corresponding 3D model based on the capture, tap on Build.

10. Select the desired quality:

• Preview quality: Takes a short time for processing but offers a relatively low level of detail. This quality setting is ideal for fast loading and real-time rendering.
• Medium quality: Takes moderate time for processing but offers a higher level of detail. This quality setting is ideal for 3D models to be used in regular Frontline Spatial workflows.
• High quality: Takes a relatively long time for processing but offers the highest possible level of detail. This quality setting is ideal for 3D models to be used in high-definition Frontline Spatial workflows.

⇒ The data is uploaded to the asset library. Once the upload is completed, the building process for the corresponding 3D model is started. After successful completion, the capture and its corresponding 3D model are ready to use.

Renaming a capture

1. Go to the Captures screen.
2. Look for the desired capture. Optionally, you can use the search button in the top-right corner to do so.
3. Long-press on the capture.
4. Tap on Rename capture.
5. Enter a new name.
6. Tap on Confirm.

⇒ The capture is renamed locally on your device as well as in the asset library.

Deleting a capture

1. Go to the Captures screen.
2. Look for the desired capture. Optionally, you can use the search button in the top-right corner to do so.
3. Long-press on the capture.
4. Tap on Delete capture.
5. When asked if you want to proceed, tap on Delete.

⇒ The capture is deleted locally on your device as well as in the asset library. This cannot be undone.

3D Models

As mentioned before, captures allow you to take photos of objects or rooms to create virtual 3D models (for more information, please see the “Captures” section). In doing so, both the 3D models, as well as the underlying images, are uploaded to an online asset library. This allows you to re-download existing models in case they have been locally deleted on your device or to build additional models with different quality settings.

Opening an existing 3D model

1. Go to the Captures screen.
2. Look for the desired capture. Optionally, you can use the search button in the top-right corner to do so.
3. Tap on the capture.

⇒ If the 3D model data for this capture has already been downloaded to your device, the model is displayed right away. If the data has not been downloaded, an overview screen is displayed that allows you to review the capture’s details and to download its model data.

Editing an existing 3D model

1. Go to the Captures screen.
2. Look for the desired model. Optionally, you can use the search bar at the top.

Note: If a model is Ready to download after being built, it cannot be edited. The status of the model should be Model ready, to be edited.

3. Tap on the capture you wish to edit.

4. Tap on the More options button (3 vertical dots) in the top right corner.

5. Select Edit.

⇒ Edit mode screen opens.

6. Here the model appears within the three-dimensional structure. It is possible to rotate and scale the model.

• Rotate: You can rotate the model by pinching and setting it with your fingers within the axis. Also, below, you can set the axis for width (X), height (Y) and depth (Z) by entering the desired angles, or by using the left-right arrows to rotate.
• Scale: You can scale the model by pinching and setting it with your fingers within the axis. Also, below, you can set the scale percentage by entering the number, or by using the up-down scale arrows.

7. After the edit is finished, tap on Done in the top-right corner.

8. The model will take some time to rebuild.

Building a 3D model with a different quality

1. Go to the Captures screen.
2. Look for the desired capture. Optionally, you can use the search button in the top-right corner to do so.
3. Tap on the capture.
4. In the top-right corner, tap on the More options button (3 vertical dots).
5. Tap on Build Other Quality.
6. Select the desired quality:
   • Preview quality: Takes a short time for processing but offers a relatively low level of detail. This quality setting is ideal for fast loading and real-time rendering.
   • Medium quality: Takes moderate time for processing but offers a higher level of detail. This quality setting is ideal for 3D models to be used in regular Frontline Spatial workflows.
   • High quality: Takes a relatively long time for processing but offers the highest possible level of detail. This quality setting is ideal for 3D models to be used in high-definition Frontline Spatial workflows.
7. Wait until the building process has been completed.
8. Tap on Download to open the new build on your device.

Note: Although this step is not mandatory and can be skipped to save storage space on your device, we strongly recommend downloading the build to check the 3D model at an early stage.

⇒ The newly created build (i.e., the corresponding 3D model) is uploaded to the asset library and is ready to use. Only the latest 3D model is stored in the asset library, any new builds replace the previous ones. However, since the underlying images are also stored in the asset library, you can create new builds with different quality settings at any time. If you locally delete a 3D model on your device, you can re-download it as needed.

Renaming a 3D model

1. Go to the Captures screen.
2. Look for the desired capture. Optionally, you can use the search bar at the top.
3. Tap on the capture.
4. In the top-right corner, tap on the More options button (3 vertical dots).
5. Tap on Rename capture.
6. Enter a label for your capture.
7. Tap on Confirm.

Sharing a 3D model

1. Go to the Captures screen.
2. Look for the desired capture. Optionally, you can use the search button in the top-right corner to do so.
3. Tap on the capture.
4. In the top-right corner, tap on the More options button (3 vertical dots).
5. Tap on Share.
6. Select the desired sharing option and proceed as necessary.

⇒ A copy of the capture’s 3D model is sent to another user who can use it for their own purposes. Any changes made afterwards by you or the other user are not synced.

Deleting a 3D model

1. Go to the Captures screen.
2. Look for the desired capture. Optionally, you can use the search button in the top-right corner to do so.
3. Tap on the capture.
4. In the top-right corner, tap on the More options button (3 vertical dots).
5. Tap on Delete 3D Model or Delete 3D Room Scan.
6. When asked if you want to proceed, tap on Delete.

⇒ The corresponding data is removed from your device. If the build data has been uploaded to the asset library, the model can be downloaded again at a later point. If necessary, you can also build a new 3D model with a different quality.

Settings and information

Viewing your user account details and current app version

1. In the top-left corner, tap on the Menu button.
2. You can see the following details:
   1. User account details: These are shown at the top of the screen and include your profile picture as well as the configuration link and domain currently used to connect to the server.
   2. App version: This information is shown at the bottom of the screen.

Changing settings

1. In the top-left corner, tap on the Menu button.
2. Tap on the desired settings category and change any of the following settings:
   1. Wi-Fi Options
      1. Upload photos (only when Wi-Fi is on): When enabled, images taken when creating a new capture are only uploaded to the asset library when the device is connected to a local network.
      2. Download 3D models (only when Wi-Fi is on): When enabled, already existing 3D models are only downloaded from the asset library when the device is connected to a local network.
   2. Scan Options
      1. Object Scan
         • Start camera in Auto Mode: When enabled, the app starts taking multiple pictures by default after you tap on the Shutter button once and start moving the device around the object. When disabled, the default setting is that you need to tap on the Shutter button each time you want to take a picture. Regardless of the chosen default setting, the auto mode can still be turned on or off as needed while creating an object scan.
         • AR Guidance type: With the Dome or Plane options here, it is possible to set the default guidance type for capturing. You can always switch to the other option via the Guidance Options toggle located at the bottom of the screen while capturing.
         • Enable masking: Masking feature enables you to capture the object without the background or anything else near it. It is possible to enable or disable it after capturing, therefore you can have both versions ready to be built. Here are the available options for masking elements explained:
           • AR Guidance: When chosen, highly focuses on the object and aims to cut out the surroundings. Some parts of the base can still be visible.
           • Capture Object: When chosen, the focused area would be the lifted subject and the captures will be reconstructed with only the lifted parts of the object (available for iOS17 or later).
           • System Default: When chosen, only the object of interest will be focused in the scene and the background will be removed.
      2. Room Scan (Capture structural elements only): When enabled, only the walls and windows of a room are captured when creating a new room scan. Any objects inside the room that would normally be represented by box-like shapes will be ignored and not included in the final model.

Viewing legal information

To view the TeamViewer Privacy Notices:

1. In the top-left corner, tap on the Menu button.
2. Tap on Product policy under Legal.

⇒ You are redirected to the section of the TeamViewer website that contains the various privacy notices.

To view the TeamViewer End-User License Agreement (EULA) and the TeamViewer Data Processing Agreement (DPA):

1. In the top-left corner, tap on the Menu button.
2. Tap on Agreements under Legal.

⇒ You are redirected to the section of the TeamViewer website that contains the EULA and the DPA.

To view the license information of third-party components used by the Frontline Spatial Capture app:

1. In the top-left corner, tap on the Menu button.
2. Tap on Third-party copyright under Legal.

⇒ An info screen opens, where you can see the respective license information.

 Frontline Expert can view and manage the captures in File Manager.