Image Windows (pylon 3D Viewer)#
The pylon 3D Viewer supports all Basler 3D cameras, including blaze, Stereo ace, and Stereo mini.
When starting image acquisition, a default set of windows is opened in the image window area. They show 3D and 2D views of the scene that the camera is capturing. You can open additional windows using the Window menu.
Views#
-
Point Cloud (3D): Each point in the cloud holds three values representing the XYZ coordinates of the point. By default, the point cloud is colored based on confidence: near points are colored red and far points are colored blue. The intensity of the color is determined by the confidence value.
You can change the colorization using the drop-down in the view's toolbar. The following colorization modes are available:
Mode Description White All points displayed in white. Intensity Points colored using grayscale intensity values. Distance Points colored by distance using a rainbow color scale. Z Axis Points colored by Z coordinate using a rainbow color scale. Confidence Color Points colored by confidence value using a color map. Intensity Color Points colored by intensity using a color map. You can also toggle the display of 3D coordinate axes using Show Axes in the toolbar.
-
Depth Map (2D): The depth map is calculated from the point cloud data. You can switch the colorization between Gray (grayscale) and Rainbow using the toolbar. The interactive Depth Range slider lets you restrict the displayed depth range.
-
Intensity Image (2D): The intensity image shows the camera image. The available channels depend on the camera model. For Stereo ace and Stereo mini cameras, the following channels are available:
Channel Description Intensity Left Left rectified intensity image. Intensity Right Right rectified intensity image. Intensity Combined Combined intensity image. Infrared Left Left infrared image (Stereo mini only). Infrared Right Right infrared image (Stereo mini only). -
Confidence Map (2D): The confidence map represents how reliable each depth measurement is. The brighter the pixel, the more reliable the measurement. Confidence values represent the probability that the true disparity value lies within a range of three times the error around the measured disparity.
All of these image components can be saved as individual files using the Save Depth and Image Data command.
Info
The image windows displayed in the pylon 3D Viewer are only visual representations of the data that the camera transmits. Closing a window does not stop the camera from transmitting data to your computer.
Using the Pixel Information Pane#
You can pick any point in any of the image windows to get more details about it in the Pixel Information pane.
Single-Point Mode#
In single-point mode (default), left-clicking a point shows the following information:
- Horizontal/Vertical Pixel Position: The location of the pixel on the sensor.
- X/Y/Z Coordinates: The position of the pixel in a three-dimensional coordinate system.
- Intensity: The intensity value of the pixel.
- Confidence: The confidence of the measurement.
- Distance: The distance of the point in mm.
Dual-Point Mode#
In dual-point mode, you can pick two points. This mode is activated using the Toggle Pick Mode button in the Point Picking toolbar or by pressing Alt+P.
In addition to the values listed above, the Pixel Information pane shows delta values between the two picked points:
- dX, dY, dZ: Differences in X, Y, and Z coordinates.
- Euclidean Distance: The straight-line distance between the two points.
The Depth Line Plot pane also visualizes the depth profile along the line connecting the two points.
Press Alt+C to clear all picked points.
When picking a point, be aware of the following:
- When picking a point in the Point Cloud window, the corresponding point in the other windows will also be selected.
- When picking a point in any of the 2D views, the corresponding point in the Point Cloud window will be selected if depth data is available for that point.
Manipulating the Point Cloud#
Using the mouse or keyboard shortcuts, you can manipulate the point cloud in various ways.
| Action | Using the Mouse | Using the Keyboard |
|---|---|---|
| Orbit | Left-click + drag | n/a |
| Orbit left | ALT + Left-click + drag left |
|
| Orbit right | ALT + Left-click + drag right |
|
| Orbit up | SHIFT + left-click + drag up |
|
| Orbit down | SHIFT + left-click + drag down |
|
| Roll left | CTRL + left-click + drag left |
|
| Roll right | CTRL + left-click + drag right |
|
| Pan left | Middle-click + drag left |
|
| Pan right | Middle-click + drag right |
|
| Pan up | Middle-click + drag up |
|
| Pan down | Middle-click + drag down |
|
| Zoom in |
| + |
| Zoom out |
| - |
| Reset to original position | n/a | Pos1 / R |
| Point size of point cloud | n/a | Numbers 1–9 |