Skip to content

Getting Started

Introduction

The pylon Supplementary Package for blaze is an add-on to the pylon Camera Software Suite. It provides support for Basler blaze Time-of-Flight (ToF) 3D cameras.

The supplementary package contains the following:

  • GenICam GenTL-compliant GenTL producer for blaze cameras
  • pylon C++ Instant Camera class for blaze cameras
  • pylon .NET parameter lists for blaze cameras
  • blaze-specific C++, C#, VB, and Python programming samples

  • Robot Operating System (ROS 1) driver for blaze cameras
    (ROS 2 driver can be downloaded from GitHub)

  • Sample scripts for MVTec HALCON

This document serves as a supplement to the documentation included in the pylon Camera Software Suite. It provides information specific to Basler blaze cameras that isn't covered in the programmer's guides included in the pylon Camera Software Suite.

To get familiar with the pylon C++ API refer to the pylon C++ Programmer's Guide.

Refer to the Basler Product Documentation for more information about how to operate a Basler blaze camera and use its features.

pylon vs. Basler blaze SDK

The pylon Camera Software Suite and the pylon Supplementary Package for blaze replace the Basler blaze SDK. Although the Basler blaze SDK will continue to be available to allow users to maintain existing applications, Basler strongly recommends using the pylon Supplementary Package for blaze for developing new applications.

Tools for blaze Cameras

pylon IP Configurator

Use the pylon IP Configurator for checking and changing the IP configuration of blaze cameras.

Press the Win key, type pylon IP, and click the pylon IP Configurator icon in the search results.

Start the IP configuration tool by issuing the following command:

/opt/pylon/bin/ipconfigurator

Alternatively, you can start the pylon IP Configurator from within the blaze Viewer by clicking Tools > pylon IP Configurator.

For more details about how to adjust network settings, refer to the Network Configuration topic of the Basler Product Documentation.

blaze Viewer

The blaze Viewer provides a graphical user interface for viewing and configuring the camera's features and visualizing the available streaming formats. It also allows you to quickly save images.

Press the Win key, type blaze, and click the blaze Viewer icon in the search results.

Start the blaze Viewer by issuing the following command:

/opt/pylon/bin/blazeViewer

If the blaze Viewer doesn't find the camera(s) you expect to be found, use the pylon IP Configurator to check and adjust the camera's IP address configuration.

Diagnostic Tools

blaze Lister

The blaze Lister is a command-line tool that searches for connected blaze cameras and prints out information about the devices found, including their firmware versions.

Press the Win key, type blaze, and click the blaze Lister icon in the search results.

Start the blaze Lister by issuing the following command:

/opt/pylon/bin/blazeLister

Quit the tool by pressing Enter.

If the blaze Lister doesn't list the camera(s) you expect to be listed, use the pylon IP Configurator to check and adjust the camera's IP address configuration.

blaze Test

The blaze Test application is a command-line tool that continuously captures data from the first blaze camera the tool finds.

Every 10 seconds the tool prints the number of images grabbed and the stream statistics.

You can use this tool to check the network configuration. If you get incomplete frames, which are indicated by increasing values of error count, failed packet count, and resend packet count, check your network configuration.

Press the Win key, type blaze, and click the blaze Test icon in the search results.

Start the blaze Test application by issuing the following command:

/opt/pylon/bin/blazeTest

Quit the tool by pressing Ctrl+C.

blaze Feature Dumper

The blaze Feature Dumper is a command-line tool that connects to the first available blaze camera and prints out a list of camera parameters and detailed information about the parameters.

Press the Win key, type blaze and click the blaze Feature Dumper icon in the search results.

Start the blaze Feature Dumper by issuing the following command:

/opt/pylon/bin/blazeFeatureDumper

Quit the tool by pressing Enter.