3DPIXA | 3D-Viewer Manual

3DPIXA | 3D-Viewer Manual
CD40093 Version E06
Table of Contents
1
About Chromasens
1.1 Contact Information
1.2 Support
4
4
4
2
General Information
2.1 Software Requirements
2.2 Hardware Requirements
2.3 Compatible GPU
2.4 Recommended System
5
5
5
5
6
3
Getting started
3.1 Acquire a sharp and good illuminated image
3.2 Using the viewer
7
7
7
4
Installing the 3D-Viewer
8
5
CS-3D-Viewer
5.1 Online Mode and Offline Mode
5.2 Image Formats
5.2.1 Raw Images
5.2.2 Output Images
5.3 Export data
5.4 Display modes
9
9
9
9
9
10
10
6
Using the Viewer
6.1 Opening 3D-Viewer
6.2 Loading and saving a configuration file
6.2.1 Loading a configuration file
6.2.2 Saving a configuration file
6.3 Loading Raw Images
6.4 Adjust configuration parameters
6.5 Operating the 3D-Viewer - Mouse and Keyboard controls
6.5.1 3D Model
6.5.2 Disparity/Rectified Image
6.5.3 Pseudocolor image
6.5.4 Zoom ROI
6.6 Calculating 3D-data
6.7 Saving calculated Images
6.7.1 Export ROI (region of interest) as CSV-File
6.8 Loading precomputed Data:
6.9 Others
6.9.1 Other Menu Bar Functions
6.9.2 Sample Images
11
11
11
11
12
13
14
15
15
16
16
16
17
17
17
18
18
18
18
7
System Parameters
19
CD40093 Version E06
2
7.1
7.2
7.3
7.4
7.5
7.6
7.7
7.8
8
Gray Value Range
Disparity Range
Correlation Window Size
Minimum Correlation Factor
Left/Right Consistency
Minimum Contrast
Used Color Channels
Extras
7.8.1 Do Smoothing
7.8.2 Use Correction plane
Advanced
8.1 Command-Line parameters
8.1.1 General parameters
8.1.2 Calculation Parameters
8.2 Configuration file properties
CD40093 Version E06
19
19
19
21
22
22
22
22
22
22
23
23
23
23
24
3
1
About Chromasens
The name of our company, Chromasens, is a combination of 'Chroma' which means color, and
'Sens' which stands for sensor technology.
Chromasens designs, develops and produces high-quality and user-friendly products:

Color line scan cameras

3D stereo line scan cameras

Multi-spectral line scan cameras

Camera systems

Camera illumination systems

Image acquisition systems

Image processing solutions
Today, Chromasens GmbH is experiencing steady growth and is continually penetrating new
sales markets around the globe. The company's technologies are used, for example, in
products and for applications such as book and document scanners, sorting systems and
inspection systems for quality assurance monitoring.
Customers from all over the world of a wide range of industrial sectors have placed their trust
in the experience of Chromasens in the field of industrial image processing.
1.1
Contact Information
Chromasens GmbH
Max-Stromeyer-Str. 116
78467 Konstanz
Germany
Phone: +49 (0) 7531 / 876-0
Fax: +49 (0) 7531 / 876-303
Email: [email protected]
1.2
Support
Chromasens GmbH
Max-Stromeyer-Str. 116
78467 Konstanz
Germany
Telephone: +49 (0) 7531 / 876-500
Fax: +49 (0) 7531 / 876-303
Email: [email protected]
Visit our website at http://www.chromasens.de for detailed information on our company and
products.
CD40093 Version E06
4
2
General Information
The Chromasens CS-3D-Viewer is a C# program that uses the CS-3D-API to calculate 3D
information from the captured image(s). The CS-3D-API calculates a rectified RGB/BGR/grayimage and a 16-bit disparity image.
The Chromasens 3D-API and the Chromasens 3D-Viewer use the OpenCV library
http://opencv.org for image processing. The license of the OpenCV library is included in the
“…Chromasens/3D/docs”-folder.
2.1
Software Requirements

System
o

NVidia Driver Version 332.88 or newer

Software protection dongle drivers

For examples only:
o
o
2.2
2.3
Windows 7 x64
Development Environment

Microsoft Visual Studios 2010

MFC
OpenCV – Library v2.4
Hardware Requirements

CUDA 2.0 capable GPU hardware with at least 1.5 GB RAM (see chapter 2.3)

Quad Core >2,4 GHz

>8 GB RAM

Power-supply with enough power for the GPU(s)

Software protection dongle
Compatible GPU
In general, every 2.0 CUDA capable GPU can be used. The following GPUs were tested for
their compatibility:
Not compatible:
o
NVidia GTX 285
Compatibility tested:
o
NVidia GTX 480
o
NVidia GTX 580
o
NVidia GTX 680
o
NVidia GTX 680
o
NVidia GTX 770
o
NVidia GTX 780 TI
o
NVidia GTX Titan
CD40093 Version E06
5
2.4
Recommended System


Software
o
Windows 7 x64
o
NVidia Driver Version 332.88 or higher
o
Software protection dongle drivers
Hardware
o
NVidia GTX 580 2 GB RAM
o
Intel i7 3,2 GHz
o
16 GB RAM
o
Software protection dongle
o
Chromasens 3DPIXA stereo camera system
CD40093 Version E06
6
3
3.1
Getting started
Acquire a sharp and good illuminated image
Firstly, you need to acquire a good image which can be served for the 3D-calculation. Follow
the steps below:

Setup your 3DPIXA to the correct operating condition (refer to the 3DPIXA first steps).

If you take note of the following, the 3D calculation accuracy is increased:
o
The image should be sharp. Place your object in focus.
o
Take note of the brightness of your illumination. Try to get as less shadow and as less
glance as possible.
Details
Shadows
+ resolution
= accuracy
+ glance
= accuracy
After having the correct camera setting, acquire raw image(s) for 3D calculation. E.g. by using
the program shipped with the framegrabber you are using.
Make sure your raw image(s) have the correct format and size (chapter 5.2.1):
*You may use sample images provided to get acquainted with the 3D-Viewer (chapter 6.9.2).
3.2
Using the viewer
After acquiring your sharp and good illuminated raw image (chapter 3.1), continue with the
following steps:

Check the system requirements

Install the 3D-Viewer (Chapter 4), then launch the 3D-Viewer.

Stick the USB dongle into the USB-slot of your computer.

Load the correct configuration file (Chapter 6.2).

Load and calculate your raw image(s) (Chapter 6.3)
You will get your first 3D calculation results.

Change the system parameters to obtain the best 3D images according to your needs.
You may follow the description in (chapter 6.4) in order to see how to adjust the system
parameters
o
The height map is calculated and shown in the disparity image based on your
configured system parameters (chapter 7).
Congratulations, you have just created a 3D-image with highly precise height calculation with
your 3DPIXA.
*When having a computed 3D image already, you may directly load your saved precomputed
data into the viewer for e.g. demonstration purposes(chapter 6.8).
CD40093 Version E06
7
4
Installing the 3D-Viewer
For operating the 3D-Viewer, make sure you have installed the nVIDIA driver according to the
defined system requirements.
Doubleclick the “cd-3d-setup-vX.XXexe”-Icon and choose the installation language.
Follow the instructions of the setup to install the 3DPIXA-software package.You may select the
desired directory in which the 3DPIXA-software package should be installed. You may also
choose which components of the 3DPIXA-software package you would like to install.
The 3DPIXA-software packge includes the following:

CS-3D-API
o
USB-Dongle driver
o
Dlls
o
Header files
o
C++ Examples

3D-Viewer

Example images

Documentation and Manuals
CD40093 Version E06
8
5
CS-3D-Viewer
The Chromasens 3D-Viewer helps you to evaluate your images acquired with the 3DPIXA.
Menubar
Displays modes (Chapter 5.3)
5.1
Online Mode and Offline Mode
Online mode:
3D-data can be calculated based on the system parameters set (chapter 7). A direct visual
feedback is obtained after the calculation of the images.
A valid license (USB dongle) and a CUDA 2.0 enabled GPU are required to use the 3DViewer in Online mode.
Offline mode:
In offline mode, raw images cannot be loaded into the 3D-Viewer and 3D data cannot be
calculated. You may load pre-computed data into the 3D-Viewer (chapter 6.8) in order to
show the pre-computed 3D-data for e.g. demonstration purposes.
5.2
5.2.1
Image Formats
Raw Images
Image requirements:

8 or 24 bit - bitmap format

Image height: dependent of the available amount of RAM of the PC and the GPU

Image width 7296:

o
3DPIXA compact housing with 15 um and 30 um resolution
o
3DPIXA dual housing with 5, 30, 50 and 70 um resolution
Amount of raw images needed for 3D calculation
o
1 raw image for the 3DPIXA - compact housing
o
2 raw images for the 3DPIXA - dual housing
See chapter 6.3 how to load raw image(s) into the viewer.
Raw images may be acquired by a framegrabber specific program.
5.2.2
Output Images
The 3D- Viewer calculates the 3D-data and outputs the following images
CD40093 Version E06
9

Rectified image (24-bit bitmap format)
The rectified image is the corrected image based on the raw images. It is corrected in
that way that the disparity image perfectly fits on the rectified image.

3D-Point cloud
The 3D-Point cloud consists of a binary list of points with X, Y and Z coordinates. The
X, Y and Z coordinates of all points are stored in a 1-D float array with one float per
coordinate. The order of the coordinates is X0Y0Z0X1Y1Z1X2Y2Z2X3Y3Z3… . There
is not a delimiter between the points and between the coordinates. The unit is
millimeter.

Disparity image (16-bit gray-value tiff format)
The disparity image includes the height information of the scanned object. A high
disparity value corresponds to a high height. In the CS-3D-Api manual chapter 5.2.1,
you can read how the height in mm can be calculated from the disparity values.
5.3
Export data
You may export the 3D-point cloud information and the disparity image as csv-File (For
reading in excel). See chapter 6.7.1 for how to export those information.
5.4
Display modes
The 3D-Viewer offers you four options to display your calculated images.

3D Model

Disparity Image: Shows the 3D height calculated. Bright areas correspond to a high
height, dark areas correspond to low height.
o
The disparity image is subpixel accurate calculated and scaled to the 16-bit
value range within the selected disparity range (disparity min – disparity max).
Display of the gray values is reduced to 256 gray levels.
o
A value of “0” corresponds to a point where no information is present.

Rectified Image: A corrected image which fits to the disparity image.

Raw Image
Lower left corner display:
Disparity image: 16-bit disparity values are displayed (0-65535).
Rectified image: the R, G and B gray values are displayed (8 bit: 0-255).
Refer to chapter 6.5 to see how to operate the 3D-Viewer in the different displays.
CD40093 Version E06
10
6
Using the Viewer
6.1
Opening 3D-Viewer
The 3D-Viewer can be used in Online- and Offline-mode (chapter 5.1).
A valid license (USB dongle) and a CUDA 2.0 enabled GPU is required to use the 3D-Viewer
in Online mode.
Doubleclick the “CS-3D-Viewer”-Icon to open the 3D-Viewer.
““
””
Note: 3D-data (inclucing 3D height map) cannot be calculated in Offline mode. Pre-computed
data can be loaded into the 3D-Viewer and the 3D-data can be shown. This can be done for
demonstrations purposes for example.
6.2
6.2.1
Loading and saving a configuration file
Loading a configuration file
On the menu bar, click on “Calculation” and select “Options” to open the “Configuration
window”.
In the new opened “Configuration window”, click on “Settings” on the menu bar and select
“Load” to load the correct configuration file to the 3D-Viewer.
Select the configuration file “config.ini” or a previous saved “***_cfg.ini”, then Click on the
- Button of the “configuration window”
If an error does occur when loading the configuration file, refer to chapter 8.2 for possible
solutions.
First time loading the configuration file:
The configuration file can be found in the folder “CalibrationFile” of the USB stick provided.
Copy and paste both the Files “config.ini” and “calibration.ini” to a desired folder before loading
the configuration file.
CD40093 Version E06
11
6.2.2
Saving a configuration file
After modifying the system parameters (chapter 7), you may save the current configuration by
choosing “Save” or “Save as” under “Settings”
You may also save the current configuration as default by choosing “Save current config as
default” under “Settings”.
NOTE
The configuration file accesses information stored in the calibration file
“calibration.ini”. It is therefore important that the directory stated in the
configuration file is correct. Refer to chapter 8.2 for more information.
CD40093 Version E06
12
6.3
Loading Raw Images
Make sure you have the correct configuration file loaded before loading your raw image(s)
(chapter 6.2).
On the menu bar, click on “File”, point on “Load raw file(s)” then
3DPIXA - compact housing:
3DPIXA - dual housing:

 click “Two raw images” to load the two
acquired raw images
click “Single raw image” to load
your acquired raw image
 load ***_A.bmp first and ***_B.bmp secondly.
You may directly calculate the 3D height map based on the configuration file loaded. The 3Ddata then are directly calculated,.choose “Load and calculate” then
3DPIXA - compact housing:
3DPIXA - dual housing:

 click “Two raw images” to load the two raw
images
click “Single raw image” to load a
single raw image
 load ***_A.bmp first and ***_B.bmp secondly.
CD40093 Version E06
13
6.4
Adjust configuration parameters
After loading the calibration file and your acquired raw images, you may evaluate your images
and calculate the 3D-data by adjusting the system configuration parameters.
On the menu bar, click on “Calculation” and select “Options” to open the Configuration
window.
Figure 1 –Configuration window
Define your system parameters:
(1) Gray Value Range: Exclude dark and bright pixels of the image for the 3D calculation. By
leaving out those pixels, shadows and glance points will not be taken into account for 3D
calculation. Mostly, these points do not have enough contrast for correlation.
(2) Disparity Range: The disparity range indirectly defines the height range you want to
calculate your 3D data. The minimum value corresponds to the lowest point of your object
and the maximum value to the highest point of your object of interest. Start with a big
range then find the smallest possible disparity range that includes the structures you
would like to analyze. The 16-bit value will be ranged between the minimum and
maximum disparity range, leading to a highly accurate 3D height calculation. It is possible
to use the “Disparity Wizard” to find the correct disparity range. This wizard guides you to
find the disparity range you need.
(3) Correlation Window size: Choose the structures you want to analyze the 3D height by
choosing the correct window size. Fine structure can be analyzed by a smaller window
size better than big window sizes. As a trade-off, more unrelated points may be correlated
leading to false calculations. False calculations are avoided by using a bigger window.
For more information of the correlation window size, see chapter 7.3.
(4) “Minimum Correlation Factor”, “Left/Right Consistency” and “Minimum Contrast”:
These parameters can be used for final optimization to obtain accurate and correct 3Ddata.
CD40093 Version E06
14
With low “Minimum Correlation Factor”, “Minimum Contrast” and higher “Left/Right
Consistency”, many 3D calculation results can be obtained from the raw images.
However, the results are less filtered, which lead to a lower reliability of the calculated 3D
data.
High “Minimum Correlation Factor”, “Minimum Contrast and low “Left/Right consistency”,
filter accurate and correct 3D calculation results and the 3D height map contains less
wrong data and higher reliability of the data.
Refer to chapter 7.4 to 7.6 for more information.
(5) You have the possibility to smooth the results of the 3D-calculations. Use the “Do
smoothing” function, if needed.
(6) If your object is tilted to the sensor plane, use the “”Use correction plane”-function
(chapter 6.5.3).
(7) You may choose the color channel used for the 3D calculation. Refer to chapter 7.7 to
7.8.2 for further information
(8) Apply the changes to your raw images. Use the
the new calculated image based on the changes you have done.
- Button to directly see
For more detailed description of the system parameters, please refer to chapter 7 - System
Parameters.
6.5
6.5.1
Operating the 3D-Viewer - Mouse and Keyboard controls
3D Model
Mouse controls:

Rotation: Left mouse button pressed down

Panning: Middle mouse button pressed down

Zoom in and out: Scrolling the mouse wheel or Right mouse button pressed down
Keyboard controls:

Rotation around the X-axis: Insert / Delete

Rotation around the Y-axis: Home / End

Rotation around the Z-axis: Page up / Page down

Panning: Cursor keys

Zoom in and Zoom out: + / -

Reset: “R”
Reset 3D-Model to default position: Press the “R”-Key
Spread the height:
“Shift” + Scrolling middle mouse wheel
To make small height differences better visible, the Z-value of the 3D-points can be multiplied
by a factor.
3D mouse control:
Support of the 3D-Connexion SpaceNavigator
The movement of the object is very intuitiv, e.g. pull the button in your direction to zoom in
at the object.
Reset: Right button clicked
CD40093 Version E06
15
6.5.2
Disparity/Rectified Image
Mouse control:

Zoom in and out: Scrolling the mouse wheel

Show pseudocolor image: Left mouse button pressed down and drawing of a
rectangle (chapter 6.5.3).
o
6.5.3
By showing an area in pseudocolor image, the 3D model also shows the
pseudocolor image.

Zoom in rectangle area: Right mouse button pressed down and drawing of a
rectangle

Reset image: Click the middle mouse button or keyboard “r”.
Pseudocolor image
Press press down the left mouse button in the rectified or the disparity image and draw a
rectangle to specifiy the rectangle for the pseudocolor image.
There are two types of pseudocolor image.
6.5.4

Default:
The default pseudocolor image scales pseudocolor between the minimum and the
maximum disparity within the selected rectangle. The outer 5% of the pixels are treated
as outliers. The minimum disparity in the selection is displayed as 0 mm.

Correction plane (can be used, if your object is tilted to the 3DPIXA camera):
A plane is fitted through all the disparitiy values. A scanned object which lies tilted to the
3DPIXA camera within the 3D space is then fitted to the new plane. The pseudocolor view
shows the disparities relatively to the new fitted plane.The height in mm is displayed
relatively to that plane and the minimum disparity in the selection is displayed as 0 mm.
Activate the correction plane type pseudocolor image by the selection
“CalculationsOptions” on the menu bar and checking the “Use Correction Plane” check
the box of the “Configuration window”.

Reset: Click the middle mouse button or keyboard “r”.
Zoom ROI
Press down the right mouse button and draw a rectangle to specifiy the rectangle for the
region of interest. If you are interested in a particular region of the image, you can zoom at it.
Press “r” to reset.
CD40093 Version E06
16
6.6
Calculating 3D-data
Make sure, you have the correct configuration file and your raw image(s) loaded (chapter 6.2
and 6.3)
On the menu bar, click on “Calculation” and select “Do 3D Calculation”
You may wish to modify the system parameters before 3D-calculations. Refer to chapter 6.4.
6.7
Saving calculated Images
On the menu bar, click on “File” and select “Save calculated image-data”.
Following files are saved in the chosen directory (*** = chosen file-name):
File-type:
Filename:

Original image(s) in bmp-format:
***_AB.bmp for the single camera systems,
***_A.bmp and ***_B.bmp for the dual camera
systems.

Disparity image in tiff-format:
***_disp.tiff

3D-pointcloud in cs3d-format:
***_p3d.cs3d

The system parameter configuration file: ***_cfg.ini

The camera calibration file:
calibration.ini.
The newly saved configuration file “***_cfg.ini” accesses the information stored in the
calibration file “calibration.ini” located in the same directory. It is therefore important that by
changing the location of the configuration file, the calibration file has to be moved to the same
locations as the configuration file.
6.7.1
Export ROI (region of interest) as CSV-File
You may save a region of interest as CSV-File. Press down the right mouse button and draw a
rectangle of the ROI. If no ROI is drawn the whole image is selected. On the menu bar, click
on “File”, point on “Export” and select which file you would like to export.

Export disparity ROI as CSV:
You can save the chosen Zoom-Roi as a ***.csv file that includes the height in mm for
each pixel. The first row holds the X and Y position followed by the width and the height of
the ROI. The data follows one row for each line of the ROI.

Export 3D-point cloud ROI as CSV
You can save the X, Y and Z positions of an ROI of the point cloud to file. The first row
holds the X and Y position followed by the width and the height of the ROI. Then each
following row consists of the X. Y and Z coordinate of one point.
CD40093 Version E06
17
6.8
Loading precomputed Data:
Load the image data saved with the “Save calculated image-data” function of the viewer.
Choose the ***_p3d.cs3d - File.
The files saved (chapter 6.7) shall be located in the same folder as the ***_p3d.cs3d - File.
*** = given file name
6.9
6.9.1
Others
Other Menu Bar Functions
The 3D Model shows a closed-surface view. You may switch to the point-cloud presentation
by choosing “View” at the menu bar and enabling “Show point cloud”.
Under “View”, you have also the possibility to display the “noValue”-points in red.
By clicking “Info” at the menubar, your version of the 3D-Viewer is displayed.
6.9.2
Sample Images
To get acquainted with the 3D-Viewer, test images are provided. You may find them in your
installed directory
In windows 7 and a the default installation presets, the example images can be found in the
following directory:
C:\Program Files\Chromasens\3D\sample images

Choose the camera system you have purchased (single or dual camera system) and load
the precomputed data (chapter 6.8).
The source-files for the single camera system are starting with AB_***.bmp, for the dual
camera system A_***.bmp and B_***.bmp.
CD40093 Version E06
18
7
System Parameters
Open the system parameter window to change the system parameters (chapter 6.4).
7.1
Gray Value Range
This parameter serves to exclude too dark and too bright pixels. This is useful, since shadows
and glance points do not show enough texture for 3D calculation.
Exclude dark and bright pixels of the image for the 3D calculation. By leaving out those pixels,
shadows and glance points will not be taken into account for 3D calculation.
The minimum and the maximum gray pixel value that is used for calculation is between 0 and
255.
7.2
Disparity Range
The disparity range indirectly defines the height range you want to calculate your 3D data. The
minimum value corresponds to the lowest point of your object and the maximum value to the
highest point of your object of interest.

Minimum disparity: The lowest height

Maximum disparity: The highest height
Find the smallest possible disparity range that includes the structures you would like to
analyze.
The 16-bit disparity image is scaled between the minimum and the maximum disparity.

An object at the 3DPIXA’s working distance plane has the disparity value of 0.

An object below the working distance (more far from the camera) has a lower disparity
value < 0

An object above the working distance plane has a higher disparity value > 0
The disparity correlates to the height of the object. For conversion from the disparity to mm,
please refer to the 3D-API manual.
7.3
Correlation Window Size
The size of the pattern window is adjustable by a parameter. The larger the window size, the
better is the stability and reliability of the correlation results. In addition, height accuracy
increases with window size. If you want to see small defects we recommend smaller window
sizes.
Bigger window
Smaller window
Consider fine textures
e.g. edges
Robustness against errors
•
The window size defines the size of the neighborhood of the pixels that is used to find
for example a pixel from the left image in the right image.
•
A larger window is better for objects with less texture
•
Smaller window take account of fine texture structures
CD40093 Version E06
19
Sample image: Window size 3x3
Sharper edges, but more points without information (“black holes”)
Sample image: Window size 27x27
Smooth edges, but closed surface
CD40093 Version E06
20
7.4
Minimum Correlation Factor
The 3D image is calculated based on the image captured with the two front lenses of the
3DPIXA. The 3D-Viewer compares both images and window size and calculates correlation.
The higher the correlation the more same are the images. But not to hight, otherwise no
correlated images anymore due to occlusion.
The “Minimum Correlation Factor” can be set between 0.001 and 1.0.

Small factor: Weak correlating structures are accepted

Large factor: Only strong correlating structures are accepted
The higher the “Minimum Correlation Factor”, the more accurate is it.
Sample images:
(black pixels mean no height information):


Height image with a correlation factor of 0.5:
Height image with a correlation factor of 0.9:
CD40093 Version E06
21
7.5
Left/Right Consistency
The correlation is working in both ways. Points from the left image will be matched to the right
image and also points from the right image will be matched to the left image. So in total we
have for one object (image) point two correlation results (L->R and L<-R). For reliability
reasons both values were compared within the LR consistency value. The distance in pixels of
the final correlation points is meant by this value. A lower value will allow only to have more
reliable measurements.
 Value 1 means: fit by a range of up to +- 1px.
 Value 10 means: fit in a range up to +-10px
7.6
Minimum Contrast
With this function you can define the acceptable level of contrast for the correlation function.
 Range is from 0.00 – 1.00.
 1.00 means you only accept high contrast areas for correlation. All other areas with lower
contrast level not be taken in account for further processing (white areas in 3D model)
 0.00 means all contrast levels were accepted. Depended on surface structure this
contrast level can be set to an individual value.
 Setting it to a high level e.g. 0.9 contrast level will only show very high contrast results
from the correlation. All shown values can be considered as reliable. Using a very low
contrast level e.g. 0.05 will accept areas with less contrast for correlation.
7.7
Used Color Channels
You may choose which color channels are used for calculating the 3D data.
7.8
7.8.1
Extras
Do Smoothing
Using this function, the 3D disparity image is smoothed, so the 3D heights are averaged, also
the areas are interpolated
7.8.2
Use Correction plane
If your object is tilted, you may enable this function.
By enabling this function, the viewer creates a new plane and calculates the 3D height of the
object based on the created plane.
This function is used for the pseudocolor image
CD40093 Version E06
22
8
Advanced
8.1
Command-Line parameters
8.1.1
General parameters
--configFile [fn]
Loads the configuration file [fn] at the start of the viewer
--listen [port]
Listen on local-port [port] for remote control commands. See the
separate “3DViewer Remote Control Protocol” documentation for a
description of the protocol.
--mode load [fn] [[fn2]]
After starting the program, automatically load the source-image with
the filename [fn] or load an source image pair with the filenames [fn]
and [fn2].
--mode loadAndCalc [fn] [[fn2]] Same as “--mode load” but also start the calculation.
--movingDemo [msec]
Starts to rotate the 3D-model after [msec] milliseconds of mouseinactivity. The rotation is disabled, if the mouse is placed over the 3Dmodel window.
--offline
8.1.2
For the presentation of offline data, in that mode no calculation
possible but also no dongle needed. Used to avoid the “No license”
error-message
Calculation Parameters
The following parameters enable the possibility to set an initial value direct on startup of the viewer.
--minGrayVal [intVal]
Minimum gray value used for calculation [0 .. 255]
--maxGrayVal [intVal]
Maximum gray value used for calculation [0 .. 255]
--minStdDevA [floatVal]
Minimum contrast [0 .. 1]
--minKkf [floatVal]
Minimum cross-correlation factor [0 .. 1]
--maxConsistent [intVal]
Max difference between with correlation from left to right and right to
left in pixels. [0 .. ]
--dStart [intVal]
Minimum disparity that is considered
--dEnd [intVal]
Maximum disparity
--windowType [intVal]
window type
CD40093 Version E06
23
8.2
Configuration file properties
The configuration file accesses information stored in the calibration file “calibration.ini”. It is
therefore important that the directory of the calibration file is correct.
The following illustration shows how the calibration file is accessed by the configuration file:
This row indicates the location and directory of the
calibration file. In the example left, the configuration file
directly accesses the calibration file in the same folder.
You may replace this row by: calibrationFile={directory of the
calibration file} like in the example below..
The configuration file then will access the calibration file in
the specified directory.
Replace to your desired directory
Figure 2 - Configuration File
Errors when loading a configuration file may occur if the directory of the calibration file does
not match the directory in the configuration file.

By saving the 3D data by the “Save calculated image-data” (chapter 6.7), a configuration
file is created, which look for the calibration file created in the same folder.

By saving the configuration file with the “Save” and “Save as”-Function of the
“Configuration window” (chapter 6.2.2), the configuration file will save the directory of the
calibration file used in the previous configuration file and always access the calibration file
of the saved directory.

By saving the configuration file with the “Save current config as default”-Function of the
configuration window”, a configuration file and a calibration file are created in the directory:
C:\Users\Public\Documents\Chromasens\3D\settings.
CD40093 Version E06
24
July 2014 Copyright by Chromasens GmbH
Max-Stromeyer-Straße 116
Phone: +49 7531 876-0
www.chromasens.de
78467 Konstanz
Fax:
[email protected]
Germany
CD40093 Version E06
+49 7531 876-303
CD40093 Version E06
Chromasens GmbH
25