Basler raL2048-48gm User Manual download pdf (Page 208)

Chunk Features AW00118302000

198 Basler racer GigE

11.2 Making the "Chunk Mode" Active and

Enabling the Extended Data Stamp

Before you can use any of the camera’s "chunk" features, the "chunk mode" must be made active.

Making the chunk mode active does two things:

 It automatically enables the Extended Frame Data chunk feature.

 It makes the camera’s other chunk features available to be enabled.

To make the chunk mode active:

 Set the Chunk Mode Active parameter to true.

You can set the Chunk Mode Active parameter value from within your application software by using

the pylon API. The following code snippet illustrates using the API to set the parameter value:

Camera.ChunkModeActive.SetValue( true );

Note that making the chunk mode inactive switches all chunk features off.

Also note that when you enable ChunkModeActive, the PayloadType for the camera changes from

"Pylon::PayloadType_Image" to "Pylon::PayloadType_ChunkData".

For detailed information about using the pylon API, refer to the Basler pylon Programmer’s Guide

and API Reference.

You can also use the Basler pylon Viewer application to easily set the parameters.

When the chunk mode made is active, the Extended Frame Data feature will automatically be

enabled, and the camera will add an "extended frame data" chunk to each acquired image. The

extended frame data chunk appended to each acquired image contains some basic information

about the frame. The information contained in the chunk includes:

 The X Offset, Width, and Height settings for the frame

 The Pixel Format of the image data in the frame

 The Minimum Dynamic Range and the Maximum Dynamic Range

To retrieve data from the extended frame data chunk appended to a frame that has been received

by your PC, you must first run the frame and its appended chunks through the chunk parser

included in the pylon API. Once the chunk parser has been used, you can retrieve the extended

frame data by doing the following:

 Read the value of the Chunk Offset X parameter.

 Read the value of the Chunk Width parameter.

 Read the value of the Chunk Height parameter.

 Read the value of the Chunk Pixel Format parameter.

 Read the value of the Chunk Dynamic Range Min.

 Read the value of the Chunk Dynamic Range Max.

1 2 ... 203 204 205 206 207 208 209 210 211 212 213 ... 237 238

No comments

Basler raL2048-48gm User Manual Page 208