PhoXi Control Application

From 3D scanning Knowledge base - Photoneo wiki
Revision as of 07:58, 26 October 2018 by Juranek (talk | contribs) (Corrupted Image Error)

Jump to: navigation, search

PhoXi Control Application: Downloads and information

Known issues

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

FAQ

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 here. Extract the zip file and follow the README.txt file.

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 phoxi_3d_scanner_set_ip.sh script. The script works also on the scanner itself. To set static IP address use it like this:

./phoxi_3d_scanner_set_ip.sh 2018-08-011-LC3 1 10.0.0.10 10.0.0.1 255.255.255.0 10.0.0.1

If you want to set dynamic address:

./phoxi_3d_scanner_set_ip.sh 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 = [10.0.0.10]
port = [65499]
txt = ["Occupied_By: ::ffff:10.0.0.1" "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

In general, these 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 totally 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 directly above the scanned object move it so that it is scanning the object from the side. 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.

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. Cameraspace.png

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.

Testspeed.png

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

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