PhoXi Control Application

From 3D scanning Knowledge base - Photoneo wiki
Revision as of 18:17, 20 February 2020 by Vrbovska (talk | contribs) (Upgrading firmware on your scanner)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Software download: Downloads and information

Known issues

  • Intel HD 3000 graphic card - the driver should be updated so it supports OpenGL extension GL_EXT_gpu_shader4


How do I save the point cloud?

To save the current point cloud, use the button "SavePointCloud" in the top panel. The file will be stored in selected file format. To choose what data will be stored in the file, click "Recording options" button and then button "Options" next to the desired file format.

Most general file format is PLY. Useful data to save are PointCloud, NormalMap, Texture and use BinaryFormat.

When you want to save all information about the scan, use Photoneo's Raw data format.

To automatically store every captured frame, use the "Record" button. Point clouds will be saved in the directory and file formats set in "Recording Options".

Retrieving intrinsic parameters of the scanner

Download the following zip file for Windows here.

Download the following zip file for Ubuntu here.

Extract the zip file and follow the README.txt file.

All of the coefficients are compatible with the OpenCV standard, you can read about the OpenCV standard here

Using script to set the IP address for a Photoneo PhoXi 3D Scanner with firmware v1.1.x

If you need to set the IP address for a scanner with firmware v1.1.x and all you have is a Ubuntu PC (16.04) with avahi-tools installed you can do so using the script. The script works also on the scanner itself. To set static IP address use it like this:

./ 2018-08-011-LC3 1

If you want to set dynamic address:

./ 2018-08-011-LC3 1 dhcp

The second parameter, CHANGE_REQUEST_ID, is a sequential integer number that needs to be incremented with each subsequent change. To find out what is the current value use the avahi-browse tool, for example:

$ avahi-browse -r -t _3d-camera._tcp 

The terminal will show the following output:

+ enp0s31f6 IPv4 PhoXi3DScan-2018-08-011-LC3                   _3d-camera._tcp      local 
= enp0s31f6 IPv4 PhoXi3DScan-2018-08-011-LC3 _3d-camera._tcp local
hostname = [ytrium1.local]
address = []
port = [65499]
txt = ["Occupied_By: ::ffff:" "changeId: 2" "version: 1.1.62" "status: Occupied" "description: Photoneo 3D Scanner" "id: 2018-08-011-LC3"]

So in this case we would use value 3 in next change IP request.

Scanning reflective materials

PhoXi 3D scanner uses diffuse reflection of the projected 3D pattern to reconstruct the surface of objects.

The following scheme depicts the difference between a beam reflected diffusely and specularly.


(source: Wikipedia )

In general, there are two main reasons for lower quality 3D reconstruction of reflective surfaces:

1) Reflective materials prevent diffuse reflection, this causes the projected laser pattern to have lower contrast between the dark and light stripes.

2) Interference, the specularly reflected laser pattern interferes with the diffusely reflected laser pattern and leads to incorrect pattern perception.

The following can be done to increase the quality:

1) Try changing the scanning angle, if the scanner is scanning the object from the side move it so that it is directly above the scanned object. This will cause more beams that are totally reflected to not be reflected back to the camera unit and therefore, not interfere with the diffusely reflected laser pattern. In general, the best method to get the best scan through trial and error and finding the optimal scanning position.

2) If sides the bin in which the object is inside of is reflective, then this utility can be used. (Please follow the README.txt, incorrect use of this utility can cause your scanner to be improperly calibrated) It will narrow the range of the projected laser pattern and therefore the red beam shown in the picture below will not be projected.

Draft 2.png

Corrupted Image Error

If during your scanning you are not able to get scans because "Image was corrupted" error, in most cases, this is caused when the coordinate space is set to markerspace and recognize markers is turned on, even though there is no marker pattern in the scene.


Be sure that you have set these settings.


Also, the second most common cause, is due to slow ethernet connection. The scanner requires a 1Gbit/s connection.

You can test your connection speed in PhoXi Control v1.2.X.


With 1Gbit connection your speed should be around 100MB/s.

How do I change settings of the scanner using API?

From PhoXi API v1.2.X and with Firmware v1.2.X it is possible to change scanning parameters using the API. The modified FullAPIExample that shows how this is done can be found here.

The resulting point cloud contains artefacts

To remove noise artefacts from the scene, it is recommended using this (Ubuntu this) utility, which to turns on the guided filter. You can read about the guided filter here . For more advanced users, you can also modify the input values for the guided filter and also the bilateral filter. You can download the advanced utility here (Ubuntu here). You can read about the bilateral filter here.

Is it possible to get a RGB pointcloud instead of a Grey-scale pointcloud?

There are two ways of creating a colored pointcloud using a PhoXi 3D scanner.

1) Using an external color camera

There is a possibility of using an external color camera, we would recommend placing this camera right below or above the scanner. However, the image made by this camera has to be integrated into the final pointcloud. This can be done via a mathematical computation using the intrinsic parameters of this colored camera.

2) Production of a customized scanner

The customized scanner would contain two cameras in its camera unit and the second one would take a colored image of the scene integrated into the final pointcloud

If a customer is interested in any of these options, both of them will have to be discussed internally at Photoneo. Whether Photoneo will be able to calibrate an external color camera (option (1)) or produce a customized scanner (option (2)) for the customer will depend on his/hers specific application and on the potentiality of collaboration between Photoneo and the customer. This is handled by the Sales department of Photoneo and can be contacted at

Upgrading firmware on your scanner

Please contact for information about firmware update.

Although PhoXi Control 1.2.14 has a functionality for firmware update handled by the user, currently it is reserved only for testing and development purposes. All firmware updates should be handled by qualified personnel.

Connecting multiple scanners to one computer

Using PhoXi Control

In PhoXi Control it is possible to connect to two scanners at the same time and trigger the scans one after another.

Connect to the first scanner, then click menu -> network discovery and then click the second scanner you want to connect to. You will then have two tabs as you can see in the picture below and then you can change between the two tabs by clicking on them. Pane wiki.png

Using the PhoXi API

Connecting mutliple scanners can also be done using the PhoXi API, you can download the example code for this here.

Important points to note are: 1) Define SCANNER_HWID_1 and SCANNER_HWID_2 to the correct Hardware identification strings of your scanners

2) Do not attempt to create 2 instances of pho::api::PhoXiFactory, instead create just 1 factory and call CreateAndConnect method twice to get 2 pointers to different scanners

Make PhoXi Control automatically connect to a specific scanner

You can download this utility, which will allow you to run PhoXi Control and automatically connect to one specific scanner. Please follow the readme.txt. The utility uses the PhoXi API and the source is included in the .zip file.

Guide to building SimpleLocateExample using Localization SDK

1) Find the SimpleLocateExample folder (by default in C:\Program Files\PhotoneoSDK\Localization\Examples\)

Find SLE.png

2) Copy this folder to a separate directory

Seperate folder.png

3) Open Cmake (you can download it here), input the source code path and where the binaries should be built (Photoneo recommends creating a /dev folder in the same path as the source code path)


4) Do the instructions based on the image, make you use Visual Studio 12 2013 Win64 generator, DO NOT USE A DIFFERENT GENERATOR, your program will NOT work. You will able to run the solution with VS 2013, VS 2015, VS 2017. footnote: If you get an error "Failed to run MSBuild command: MSBuild.exe." Then Photoneo recommends installing Visual Studio Express 2013 for Windows Desktop, the newer licences are applicable for this software.


5) Click the Generate button, this is how the window should look


6) Go to /dev folder and find the .sln file, this file can be opened with VS 2013, VS 2015, VS 2017.

Solution file.png

7) When you open the file in VS right-click SimpleLocateExample (Visual Studio 2013) on the Solution Explorer Pane and Set it as a startup project.

Set startup.png

8) Finally, run the code

Run code.png

The Depthmap has not transformed with a modification of the coordinate system of the scan

The Depthmap, by definition, is an image containing Z-values of the default coordinate system (camera coordinate system).

The get the "transformed" depthmap (i.e. Z-values of the custom coordinate system), Photoneo recommends the following:

1) To be Continued

Z-map guide 1.png