Tutorial
Creating an App
This section will guide you through the process of creating your first indoor navigation app using IndoAR.
First click on “New project” in the “My projects” section. This will lead you to the overview of all the available AR solutions we provide as part of our AR ecosystem. Please choose IndoAR. If you are using the template for the first time, the system will ask you to request access, providing a few details about the plan, demos and projects.
As soon as you have been granted access you are ready to create your first project.
Adding app information
Simply type in your project and company name. The combination of these two fields will automatically create your app ID, which is important later on to load your project on your mobile phone. The app ID for your project is always visible on the top left corner of your screen when you are working in your project.
Style your app
In the “Style” section you can style the start screen of the app. You can add and change the backgrounds, insert a logo and a logo thumbnail. The logo can be scaled. You can also customize the buttons of your app by selecting the desired color and font. This ensures that the app is in line with your corporate identity. On the top left corner you can choose a preview device to see how the start screen will look like on mobile and tablet devices.
Import your map
Import your first scan, see Map Import for more information.
Set up your map
Using the admin interface, you can open your imported map and set up points-of-interest (POIs), Tours, etc.
Please read these articles: 3D Admin Panel, POIs, Tours, Pathfinding
Test your app
In order to test your created app click on the preview button in the top right corner. Scan the QR code to download the ViewAR app from the App or Play Store. If you already have installed the app you can go to the second tab and either scan the QR code or type in the app ID to preview your project. Then use the search feature to start a search. Enjoy your customized AR indoor navigation experience.
To test your app right away with the VIEWAR app, download the ViewAR SDK Application from the App Store. Then either scan the QR code or type in the ID to preview your project.
See Testing & Preview for more information.
Large Mulitscan Projects
(coming soon)
Updating Scans
To update a scan within your project select the add scan option in the map menu. Select the scan you want to update and select the Parent Editor from the map menu.
This allows you to ttransfer all the content of your old scan(POIs, environment objects, beactons, etc) to the newly uploaded one. Delete the old scan once you are finished.
Setting Up Leica Scan Exports
Prerequisites for scanning with Leica scanners
- A Leica BLK360 or RTC360 scanner, including the tripod, and recommended accessories – also known as a Mission Kit.
- An activated Cyclone FIELD 360 app, installed on your mobile device.
- An activated recent version (2021.1.0 and later) of the Cyclone REGISTER 360 software package, installed on your desktop machine to process scans.
Scanning an Environment
For scanning and device operation follow the extensive guides and video tutorials on the product pages for the Leica BLK360 and the Leica RTC360 scanners. Please note that setting higher scanning densities increases the time for each scan to complete and results in considerable larger files. Area Targets do not benefit from high point cloud density, scan in high resolution only if you wish to use the scan for additional purposes as well. Following settings can be set in the Field 360 app or the control panel of the RTC360: BLK360 recommended scanning settings:
- The panoramas must be included in the scan.
- Scan in low resolution.
- Disable HDR image capturing and use the LDR mode instead. See HDR-tonemapping if you decide to enable HDR on the BLK360.
RTC360 recommended scanning settings:
- The panoramas must be included in the scan.
- Set the point cloud density to low resolution.
- In environments with moving persons or objects, you can enable Double Scan.
A few things to be aware of:
- Scan in doorways and move only the scanner to a position visible from the previous scan.
- Highly reflective, absorbent or transparent materials can be often difficult to capture.
- Annotations and Markings are not preserved via the Area Targets toolchain.
Transferring and Post-processing the Scan
When a scan is finished, transfer the scan to your desktop for processing the data; transfer the raw data via USB-stick or Wi-Fi, or by connecting to the FIELD 360 app from your desktop. For the detailed steps on importing and post-processing scans, follow the manuals and video tutorials as provided on the Cyclone REGISTER 360 product page. Following settings shall be set in the REGISTER 360 software prior to starting processing and exporting data for Area Targets:
1. On the General tab of the Settings, set the length unit to meter:
2. At the bottom of the same tab, check both options to export cleaned points and create the finalised point cloud.
NOTE: Do not export structured E57 in the compatibility format as it will cause the Area Target Generator to reject the E57 file!
3. In Cyclone REGISTER 360, start a new project and import the scan data folder (For RTC360, don’t forget to add the project.rtc360 file next to the root of the raw scan folder!).
4. Adjust the import properties of the data in the Properties tab found on the right,
- For BLK360, check the Auto Cloud option.
- Data from RTC360 should be imported using the Pre-Registered option if the VPS system was used as recommended during scanning. Alternatively, one can use the Auto Cloud as well, but it will result in a longer import duration and a possibly worse registration.
- When using scanning targets, check the Sphere and/or B&W target options to enable auto-alignment. Press Import. The tool responds with feedback on the number of imported set-ups and created links.
5. Press Import. The tool responds with feedback on the number of imported set-ups and created links.
Network Links
By enabling the Pre-Registered option on import, the resulting links between scans may insufficient. Additional steps are therefore recommended.
6. Review and Optimize the registration and links between scans
a. To improve the accuracy of the overall scan, we recommend increasing the number of links between individual scans by choosing Show Suggested Links Within Bundle in the context menu of the Bundle.
b. Select one of the suggestions indicated by a dashed line between two setups and select Add all visible suggested links.
7. To further improve link strength and reduce global registration errors, it is recommended to also trigger Run Cloud-to-Cloud on all links… once the link network is dense.
Cropping Scans
Use the Fence tool to cut away undesired parts of the scans. For example, cut away structures and objects that were captured through windows and doorways. Additionally, inspect the scans for ghost structures introduced by glass walls with reflections that are being interpreted as physical parts of a scene. Such artefacts can obstruct the future authoring process in Unity.
The Fence tool is available in the tool bar under the Review and Optimize tab. Use it in the Bundle Cloud view for fast cropping of the whole scan. Switch to Setup Cloud view for cropping out parts and ghost structures of each scan position.
HDR-tonemapping
In case the scanner was set to HDR mode, we recommend reviewing the tonemapping settings of the panoramas.
Right-click the Bundle in the SiteMap, select Edit HDR Image... and change the tone map to Linear. Set the Gamma close to 0.4545, adjust Brightness to 0.198, and Gain dB to a higher value (e.g. 4) in case the images still appear dark.
Select Apply to Project and press OK.
Panoramas from the RTC360 can be kept at the default tonemapping.
Publish Report
8. Once the optimization is finished, finalize the scan by accepting the registration report.
9. In the Report tab, select Publish options and check E57 (as one file) as the output format and choose the export filename.
Pointcloud sub-sampling Reduce large files by using sub-sampling on scans with dense point clouds.
For BLK360, low resolution scans requires no sub-sampling. High resolution scans from this device can be sub-sampled up to 1/9 sub-sampling without an observable quality loss.
For RTC360, low resolution can be set to 1/9 sub-sampling. High resolution scans can be sub-sampled up to 1/25 without loss in quality.
10. In the Report tab, select Properties -> Publish Options and click the Decimate Setups/Point Cloud.
11. Check the Sub-sampling factor (setups) and select from the dropdown menu 1/9 or 1/25 depending on your setup. Close the dialog with OK.
12. Press Publish to generate the output E57 file.