How can I test AugmentedPro Creator ?
Download AugmentedPro Creator, install it on your Windows PC and run it. Select New Project, select an existing device for your project or define a new one, and start your new project. A first step is already defined. You can insert content in your step through the Insert menu.
When your project is ready, click on the Export button in the File menu, an .app file will be saved on your disk, ready to be played by AugmentedPro Player. You can also open the Engine example from the starting page. AugmentedPro Creator is free with no time restriction.
How can I test AugmentedPro Player ?
Download AugmentedPro Player, install it on your Windows PC or on a Windows tablet and run it. An AugmentedPro example application is available in the starting page of AugmentedPro Player. This example includes 2 simple steps with augmented reality information displayed for the maintenance of an engine. Download the reference image to use for this example here and print it.
Make sure that your device has an internal camera or an external USB camera, run the AugmentedPro Player example application and click on the arrow button at the right bottom corner. Your camera should open and augmented reality information should appear for the 2 steps when pointing at the printed reference image. This example can be played with no time restriction.
How can I test my own projects in AugmentedPro Player ?
You can test your own projects created with AugmentedPro Creator just by copying an .app file exported from AugmentedPro Creator to the Projects Folder of AugmentedPro Player. The exact location of the Projects Folder can be found in Settings -> Folders -> Projects Folder in AugmentedPro Player. If you run one of your own projects for the first time you will be asked for a free 7 days trial period. Click OK and start your free trial period !
Don't forget to calibrate your camera: calibration is required for projects with 3D trackables and 3D objects displayed in augmented reality. Use AugmentedPro Player to calibrate your camera. Just download the calibration grid, print it and follow the calibration procedure in Settings > Cameras > Calibrate. Make sure you have selected the appropriate camera and resolution before starting the calibration process. When the calibration is done, copy the calibration parameters (Fu, Fv, Cu, Cv) to the device definition in AugmentedPro Creator.
How can I design a step with augmented reality information in AugmentedPro Creator ?
When the active tab is a step, a click on one of the Augmented Reality menu buttons (Texture, Photoframe, or 3D Model) creates a camera stream area in the active step tab, a beacon in the Libraries section and an empty Augmented Reality attached to the beacon.
When inserting an Augmented Reality button from an active step tab, a trackable has to be selected in a file explorer dialog. After selecting the trackable the Augmented Reality tab appears with only the trackable displayed. Elements like images, text, shapes or 3D models can then be inserted in the augmented reality container. They will be displayed in augmented reality when running the project in AugmentedPro Player.
What can I do if I receive a camera error in AugmentedPro Player ?
If you receive this error, you need to check that cameras are defined correctly in the AugmentedPro Creator project used to export your scenario. In AugmentedPro Creator, all the Camera Stream elements have a Camera assigned. Check that the cameras defined for your camera streams are either Default camera, or one of the cameras available in your target device.
To do so, open the Target device tab in AugmentedPro Creator (Settings -> Target device) and open the Settings -> Cameras tab in AugmentedPro Player on your target device. Cameras defined in AugmentedPro Creator should all be available in AugmentedPro Player. In particular the Identifier field is used by AugmentedPro Creator to refer to a camera available in AugmentedPro Player.
Camera resolution and camera parameters should also be copied from AugmentedPro Player to your AugmentedPro Creator project. You may need to launch the calibration procedure in AugmentedPro Player (Settings -> Cameras -> Calibrate button) to get the camera parameters if your camera has not been calibrated for a particular resolution.
If all the cameras are defined correctly, please click on the Send button and contact us at firstname.lastname@example.org with your Device ID in subject (AugmentedPro Player -> Settings -> Device -> Device ID).
What is the difference between a beacon and a trackable ?
Steps, reports, and libraries sections all have container objects that can be opened as a tab in the center section of the application. Containers have elements that are listed in the Elements section.
The beacon is the container where the trackable elements are defined. A trackable is a reference object that is tracked by AugmentedPro Player to enable augmented reality features. A trackable can be a textured image, a photoframe marker or a 3D model.
What is the difference between an Augmented Reality and a Detection ?
The Augmented Reality is a container that includes the trackable and also the elements displayed in augmented reality when the tracking succeeds. The elements displayed in augmented reality can be images, text, shapes or 3d models for a 3D Augmented Reality, and only images, text or shapes for a 2D augmented reality. When an Augmented Reality is first created, there is no augmented reality element included, only the trackable appears on screen. You should then insert elements to display in augmented reality through the Insert menu.
A Detection is a container that includes the trackable like an Augmented Reality, but no elements can be displayed. The Detection is meant to define a transition to another step or to a report when the trackable is detected. You can define this transition in the Interactions section on the left pane of the application.
Augmented Realities and Detections both have a parent Beacon that holds one or several common trackables for all its Augmented Realities and Detections children. Augmented Realities and detections can both be added to a step either through drag and drop of the Augmented Reality entry of the Libraries section or through a right click on the same entry. First open the step tab where you would like to add the Augmented Reality or Detection, then add it through drag and drop or right click. If a camera stream is already defined in your step, the Augmented Reality or Detection is added to the existing camera stream, else a camera stream is automatically created in your step.
What is a 2D augmentation ?
When an augmentation with a texture trackable only contains images as augmented reality elements, the 2D property is available in the properties pane of the augmentation. When checking the 2D property, the augmentation tab switches in a 2D view, which is easier to use for the positioning of images on the trackable plane.
The Z coordinate of the augmented reality elements is not reset to 0 though for elements that have previously been positioned in the 3D space. If you want your augmented reality elements to be displayed on the trackable plane, make sure that their Z coordinate is set to 0.
What is the default camera ?
All the devices defined in AugmentedPro Creator have a default camera that can be selected in a camera stream. You can use the default camera when you do not know the target device, the camera selected in the Camera tab of the Settings section of AugmentedPro Player will be used when playing the project. The default camera can only be used for 2D augmentations though, since 3D augmentations require the camera calibration parameters to be known when exporting the project from AugmentedPro Creator.
To create an augmentation with the default camera, insert a camera stream in a step, select 'Default Camera' as associated camera in the properties pane of the camera stream, and insert an augmentation.
Do I need an internet connectivity to run AugmentedPro ?
AugmentedPro Creator can be run without any network connectivity.
AugmentedPro Player may require an internet connection for license validation check purpose. Between two license checks, AugmentedPro Player can be run without any network connectivity. The date and time of the next validation check is available in Settings -> License. With a free test license, a license check is scheduled one hour after last check. With Demonstrator and Production licenses, the check frequency can be defined from the AugmentedPro license page. With a Production license, the check frequency can be set to "Never". In this case, AugmentedPro Player can be run without any network connectivity, with no license check scheduled. The action of setting the check frequency to "Never" cannot be reverted though, and license release is not possible anymore, in particular if the associated device is lost or broken.
When an internet connection is available, AugmentedPro Creator and AugmentedPro Player check the availability of a newer version at startup to keep you up to date with the latest features. When a version update is available, a window appears at startup asking for version update download and install.
Can I run AugmentedPro from command prompt ?
AugmentedPro Player can be run from command prompt to start an AugmentedPro Player project (.app file) directly, bypassing AugmentedPro Player start screen. In a Windows command prompt (Windows Start button + type 'cmd' + Enter), just type: "C:\Program Files\Robocortex\AugmentedPro Player X.Y.Z\AugmentedPro Player.exe" "C:\Users\MyUser\Documents\Robocortex\AugmentedPro Player\projects\myproject.app"
AugmentedPro Creator can be run from command prompt to export an AugmentedPro Creator project (.apc file) to an AugmentedPro Player project (.app file) without using AugmentedPro Creator graphical interface. In a Windows command prompt (Windows Start button + type 'cmd' + enter), just type: "C:\Program Files\Robocortex\AugmentedPro Creator X.Y.Z\AugmentedPro Creator.exe" "C:\my_apc_path.apc" "C:\my_app_path.app". When exporting an .app project from command prompt, you can check the following file for warnings or errors just after running the export command: "C:\Users\MyUser\AppData\LocalLow\Robocortex\AugmentedPro Creator\rox_ap_creator.log"