Skip to content

Standard Features#

Features are capabilities of Basler cameras that can be controlled by configuring firmware parameters.

You can configure the parameters via the Basler pylon API or via the Basler pylon Viewer.

How to Look Up Information#

To find information about the features of your camera, proceed as follows:

  • Look up general feature descriptions using the "General feature documentation" links in the sections below. The links point to the Basler Product Documentation. Ignore the "Specifics" sections you find there.
  • Look up specific feature information tailored to the atA320-50g-7mm and atA320-50g-19mm cameras in the "Specifics" tables in the sections below.

Acquisition Mode#

General feature documentation: Acquisition Mode

Acquisition Start, Stop, and Abort#

General feature documentation: Acquisition Start, Stop, and Abort

Specifics#

Camera Model AcquisitionAbort Command Available
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Yes

Acquisition Status#

General feature documentation: Acquisition Status

Specifics#

Camera Model Available Acquisition States
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Acquisition Active
Frame Trigger Wait
Readout Cycle

Action Commands#

General feature documentation: Action Commands

Auto Function ROI#

Info

  • Refer to the ace 2, boost, and dart IMX Cameras section in that topic for sample code relevant to Thermography Cameras.

General feature documentation: Auto Function ROI

Specifics#

Camera Model Auto Function ROIs Highlighting Supported
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 ROI 1
ROI 2		 Yes

Counter#

Info

  • Refer to the ace 2, boost, and dart IMX Cameras section in that topic for sample code and information relevant to Thermography Cameras.

General feature documentation: Counter

Specifics#

Camera Model Available Counters Function Event Source Related Data Chunk Can Be Reset
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Counter 1
Counter 2		 Configurable Configurable N/A Counter 1: Yes
Counter 2: Yes

Data Chunks#

General feature documentation: Data Chunks

Info

  • You can only use data chunks if the Type parameter is set to WindowsFilterDriver.

Image Statistics Chunk#

Info

  • You can only use the Image Statistics chunk if the PixelFormat parameter is set to a temperature-based pixel format (Data32f or Mono 12).

If this chunk is enabled, the camera retrieves the pixels with the lowest and the highest temperature values in the image. It also calculates the mean temperature across the entire image. These temperatures, along with the positions of the pixels with the lowest/highest temperatures, as well as the mean temperature are included in the chunk data.

Info

  • If pixels in the image ROI have the same value, the position of the last pixel will be included in the chunk data.

Enabling Image Statistics#

  1. Set the AutoFunctionROISelector parameter to the desired image ROI, e.g., ROI1.

  2. Use the following parameters to specify the size of the image ROI:

    • AutoFunctionROIWidth
    • AutoFunctionROIHeight

  3. Use the following parameters to specify the position of the image ROI:

    • AutoFunctionROIOffsetX
    • AutoFunctionROIOffsetY

  4. Set the ChunkModeActive parameter to true.

  5. Set the ChunkSelector parameter to ImageStatistics.
  6. Enable the chunk by setting the ChunkEnable parameter to true.
  7. Set the ChunkImageStatisticsROISelector parameter to the desired image ROI, e.g., ROI1.

Specifics#

Camera Model Available Data Chunks
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Counter Value Chunk
CRC Checksum Chunk
Image Statistics Chunk

Device Information Parameters#

General feature documentation: Device Information Parameters

Specifics#

Camera Model Additional Device Information Parameters
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 DeviceFamilyName
DeviceIndicatorMode
DeviceLinkCurrentThroughput
DeviceLinkSpeed
DeviceLinkThroughputLimit
DeviceLinkThroughputLimitMode (read-only)
DeviceScanType
DeviceSFNCVersionMajor
DeviceSFNCVersionMinor
DeviceSFNCVersionSubMinor
HeightMax
WidthMax

Device Temperature#

Info

  • Refer to the ace 2, boost, and dart IMX Cameras section in that topic for sample code relevant to Thermography Cameras.

General feature documentation: Device Temperature

Error Codes#

Info

  • Refer to the ace 2, boost, and dart IMX Cameras section in that topic for sample code and information relevant to Thermography Cameras.

General feature documentation: Error Codes

Event Notification#

General feature documentation: Event Notification

Info

Basler thermography cameras provide Temperature Alarms events that notify you when certain temperature events occur. See the Temperature Alarms topic for details how to configure temperature alarms.

Specifics#

Camera Model Available Events
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Action Late
Frame Buffer Overrun
Frame Trigger Missed
Overrun
Temperature Alarms ROI 1
Temperature Alarms ROI 2
Temperature Status Changed
Test

Input Filter#

General feature documentation: Input Filter

Line Format#

General feature documentation: Line Format

Line Inverter#

General feature documentation: Line Inverter

Line Logic#

General feature documentation: Line Logic

Line Mode#

General feature documentation: Line Mode

Line Overload Status#

Info

  • Refer to the ace 2 and boost Cameras section in that topic for sample code relevant to Thermography Cameras.

General feature documentation: Line Overload Status

Line Selector#

General feature documentation: Line Selector

Line Source#

General feature documentation: Line Source

Readout Cycle Signal#

You can use the Readout Cycle signal to monitor wether the camera is currently acquiring an image. The signal goes high when the image acquisition starts for row 1. The signal goes low when image acquisition has reached the 128th row.

The Readout Cycle signal can be used to synchronize external devices with the camera.

Example: Assume that the camera is acquiring images of objects on a conveyor belt and the conveyer belt needs to be stopped for image acquisition. In this case, you can monitor the Readout Cycle signal to know when image acquisition has started and the conveyer belt can start moving again.

Enabling the Readout Cycle Signal#

  1. Set the LineSelector parameter to an I/O line configured as output, e.g., Line2.
  2. Set the LineSource parameter to ReadoutCycle.

Temperature Alarms Signal#

You can use the Temperature Alarms signal to monitor whether an alarm is active or not. The signal goes high (1) when an alarm is active and goes low (0) when no alarm is active.

Enabling the Temperature Alarms Signal#

  1. Set the LineSelector parameter to the desired output line, e.g., Line2.
  2. Set the LineSource parameter to TemperatureAlarmsLowerThresholdROI1.
  3. If multiple User Output line sources are available (e.g., Temperature Alarms Lower Threshold ROI 1, Temperature Alarms Lower Threshold ROI 2), set the UserOutputSelector parameter to the corresponding source.

Specifics#

Camera Model Available Line Sources User Output Signal Assignment
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Acquisition Active
Counter 1 Active, Counter 2 Active
Frame Trigger Wait
Readout Cycle
Temperature Alarms Lower and Upper Threshold ROI 1
Temperature Alarms Lower and Upper Threshold ROI 2
Temperature Alarms Lower Threshold ROI 1
Temperature Alarms Lower Threshold ROI 2
Temperature Alarms Upper Threshold ROI 1
Temperature Alarms Upper Threshold ROI 2
Timer 1 Active, Timer 2 Active
User Output 1, User Output 2, User Output 3		 No assignment, signals freely selectable

Line Status#

General feature documentation: Line Status

Specifics#

Camera Model Output Status Relation LineStatusAll Bit-to-Line Association
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Output status 0 (e.g., User Output Value set to false or Flash Window signal low) = LineStatus false = voltage level lowa
Output status 1 = LineStatus true = voltage level high		 Bit 0 indicates Line1 status
Bit 1 indicates Line2 status
Bit 2 indicates Line3 status
Example: All lines high = 0b111

Pixel Format#

The Pixel Format camera feature allows you to choose the format of the image data transmitted by the camera.

Available Pixel Formats#

Info

  • Data32f, Mono 12: These two pixel formats are temperature-based and output the temperature values in Kelvin.
  • Other pixel formats: All other pixel formats output the sensor raw data in digital numbers (DN).

Data32f#

Data32f is a temperature-based pixel format. The temperature is given as a IEEE 754 floating point value in Kelvin.

If the PixelFormat parameter is set to Data32f, all raw data is converted to temperature data.

Info

Images acquired with the data32f pixel format are currently not shown in the pylon Viewer. Use the pylon API to display images.

Mono 12#

Mono 12 is a temperature-based pixel format. The temperature is given as an integer value in Kelvin.

If the PixelFormat parameter is set to Mono12, the camera outputs 12 bits of data for each pixel in the acquired frame.

Mono 16#

Mono 16 is a digital number-based pixel format. If this pixel format is selected, the image uses unsigned 16-bit integer values.

Info

Changing the Gain and Offset values changes the outputted data.

Mono 8#

Mono 8 is a digital number-based pixel format. The DN (Digital Number) value represents the brightness value of each pixel.

If the PixelFormat parameter is set to Mono8, the camera outputs 8 bits of data for each pixel in the acquired frame.

Info

Changing the Gain and Offset values changes the outputted data.

RGB 8#

RGB 8 is a digital number-based pixel format. The DN (Digital Number) value consists of a mean value of each of the three colors of each pixel.

If the PixelFormat parameter is set to RGB8, the camera outputs 8 bit of red data, 8 bit of green data, and 8 bit of blue data for each pixel in the acquired frame.

Info

When using the RGB 8 pixel format, the sensor raw data received is mapped onto a 5 color heat map which allows to represent the received data as colors. The value 0 represents the color blue and the value 65535 represents the color red.

Changing the Gain and Offset values changes the outputted data.

Selecting a Pixel Format#

Set the PixelFormat parameter to the desired pixel format.

Specifics#

Camera Model Available Pixel Formats
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Data32f
Mono 8
Mono 12
Mono 16
RGB 8

Precision Time Protocol#

Info

  • Refer to the ace 2 Cameras section in that topic for sample code relevant to Thermography Cameras.

General feature documentation: Precision Time Protocol

Resulting Frame Rate#

General feature documentation: Resulting Frame Rate

|

Scheduled Action Commands#

General feature documentation: Scheduled Action Commands

Specifics#

Camera Model Action Queue Size
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 3

Software Signal Pulse#

General feature documentation: Software Signal Pulse

Specifics#

Camera Model Supported Camera Features Available Software Signal Channels
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Triggered Image Acquisition
Counter
Timer		 Software Signal 1
Software Signal 2
Software Signal 3

Temperature State#

Info

  • Refer to the ace 2, boost, and dart IMX Cameras section in that topic for sample code relevant to Thermography Cameras.

Info

When the over temperature threshold has been reached, the camera switches off. To restart the camera, you must execute the DeviceReset command.

General feature documentation: Temperature State

Specifics#

Camera Model Critical Temperature Threshold Over Temperature Threshold Additional Parameters
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 66 °C (150.8 °F) 71 °C (159.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount

Test Patterns#

General feature documentation: Test Patterns

Specifics#

Camera Model Available Test Patterns
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Black
White
Test Image 1
Test Image 2
Test Image 3

Timer#

Info

  • Refer to the ace 2, boost, and dart IMX Cameras section in that topic for sample code and information relevant to Thermography Cameras.

General feature documentation: Timer

Specifics#

Camera Model Default Maximum Value for Timer Duration and Delay
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 16 777 215

Timestamp#

Info

  • Refer to the Other Cameras section in that topic for sample code relevant to Thermography Cameras.

General feature documentation: Timestamp

Specifics#

Camera Model Timestamp Tick Frequency Counter Can Be Reset during Camera Operation
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 1 GHz (= 1 000 000 000 ticks per second, 1 tick = 1 ns) No

Trigger Activation#

General feature documentation: Trigger Activation

Specifics#

Camera Model Trigger Activation Modes
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Rising Edge
Falling Edge
Any Edge
Level High
Level Low

Trigger Delay#

Info

  • Refer to the Other Cameras section in that topic for sample code relevant to Thermography Cameras.

General feature documentation: Trigger Delay

Trigger Mode#

General feature documentation: Trigger Mode

Specifics#

Camera Model Immediate Trigger Mode for Continous Image Acquisition Immediate Trigger Mode for Single Frame Acquisition
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 available Not available

Trigger Selector#

Info

  • Refer to the Other Cameras section in that topic for sample code relevant to Thermography Cameras.

General feature documentation: Trigger Selector

Specifics#

Camera Model Available Trigger Types Maximum Number of Images per Series
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Frame Start 1023

Trigger Software#

General feature documentation: Trigger Software

Trigger Source#

General feature documentation: Trigger Source

Specifics#

Camera Model Available Hardware Trigger Sources Available Software Trigger Sources
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Line 1
Line 2
Line 3		 Action 1
Counter 1 Active
Counter 1 End
Counter 1 Start
Counter 2 Active
Counter 2 End
Counter 2 Start
Periodic Signal 1
Timer 1 Active
Timer 1 End
Timer 2 Active
Timer 2 End
Software
Software Signal 1
Software Signal 2
Software Signal 3

User-Defined Values#

General feature documentation: User-Defined Values

User Output Value#

General feature documentation: User Output Value

Specifics#

Camera Model UserOutputValueAll Bit-to-Line Association
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 Bit 0 configures the status of the line associated to the User Output 0 signal
Bit 1 configures the status of the line associated to the User Output 1 signal
Bit 2 configures the status of the line associated to the User Output 2 signal
Example: You set the line source of Line 2 to User Output 0. Now, bit 0 configures the status of Line 1.

User Sets#

Info

  • Refer to the Other Cameras section in that topic for sample code relevant to Thermography Cameras.

General feature documentation: User Sets

Info

If you create a user set the DarkFrameCorrectionMode parameter settings will not not be included.

Specifics#

Camera Model Available User Sets
ata320‑50g‑lw‑7mm
ata320‑50g‑lw‑19mm		 User Set 1
User Set 2
User Set 3
Default

  1. This means that the line logic is positive. However, the LineLogic parameter is not available for this camera model.

Back to top