All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Member Functions | List of all members
Pylon::CBaslerGigEGrabResultData Class Reference

The GigE specific grab result data. More...

#include <pylon/gige/BaslerGigEGrabResultData.h>

Inheritance diagram for Pylon::CBaslerGigEGrabResultData:
Inheritance graph
[legend]

Public Member Functions

bool GrabSucceeded () const
 Returns true if an image has been grabbed successfully and false in the case of an error.
 
String_t GetErrorDescription () const
 This method returns a description of the error if GrabSucceeded() returns false due to an error.
 
uint32_t GetErrorCode () const
 This method returns the error code if GrabSucceeded() returns false due to an error.
 
EPayloadType GetPayloadType () const
 Get the current payload type.
 
EPixelType GetPixelType () const
 Get the current pixel type.
 
uint32_t GetWidth () const
 Get the current number of columns.
 
uint32_t GetHeight () const
 Get the current number of rows expressed as number of pixels.
 
uint32_t GetOffsetX () const
 Get the current starting column.
 
uint32_t GetOffsetY () const
 Get the current starting row.
 
uint32_t GetPaddingX () const
 Get the number of extra data at the end of each row in bytes.
 
uint32_t GetPaddingY () const
 Get the number of extra data at the end of the image data in bytes.
 
void * GetBuffer () const
 Get the pointer to the buffer. More...
 
size_t GetPayloadSize () const
 Get the current payload size in bytes.
 
uint32_t GetFrameNumber () const
 Deprecated: GetBlockID() should be used instead. Get the index of the grabbed frame (camera device specific).
 
uint64_t GetBlockID () const
 Get the block ID of the grabbed frame (camera device specific). More...
 
uint64_t GetTimeStamp () const
 Get the camera specific tick count (camera device specific). More...
 
bool GetStride (size_t &strideBytes) const
 Get the stride in byte.
 
size_t GetImageSize () const
 Get the size of the image in byte.
 
intptr_t GetCameraContext () const
 Get the context value assigned to the camera object. The context is attached to the result when it is retrieved.
 
int64_t GetID () const
 Get the ID of the grabbed image. More...
 
int64_t GetImageNumber () const
 Get the number of the image. This number is incremented when an image is retrieved using CInstantCamera::RetrieveResult(). More...
 
int64_t GetNumberOfSkippedImages () const
 Get the number of skipped images before this image. More...
 
bool IsChunkDataAvailable () const
 Returns true if chunk data is available. More...
 
GenApi::INodeMapGetChunkDataNodeMap () const
 Get the reference to the chunk data node map connected to the result. More...
 
bool HasCRC () const
 Checks if buffer has a CRC attached. This needs not be activated for the device. See the PayloadCRC16 chunk.
 
bool CheckCRC () const
 Checks CRC sum of buffer, returns true if CRC sum is OK.
 
intptr_t GetBufferContext () const
 Get the context value assigned to the buffer. The context is set when CInstamtCamera is using a custom buffer factory.
 

Public Attributes

ChunkData - This category includes items related to the chunk data that can be appended to the image data
GenApi::IIntegerChunkStride
 Indicates the number of bytes of data between the beginning of one line in the acquired image and the beginning of the next line in the acquired image. More...
 
GenApi::IIntegerChunkSequenceSetIndex
 Indicates the sequence set index number related to the acquired image. More...
 
GenApi::IIntegerChunkOffsetX
 Indicates the X offset of the area of interest represented in the acquired image. More...
 
GenApi::IIntegerChunkOffsetY
 Indicates the Y offset of the area of interest represented in the acquired image. More...
 
GenApi::IIntegerChunkWidth
 Indicates the widtth of the area of interest represented in the acquired image. More...
 
GenApi::IIntegerChunkHeight
 Indicates the height of the area of interest represented in the acquired image. More...
 
GenApi::IIntegerChunkDynamicRangeMin
 Indicates the minimum possible pixel value in the acquired image. More...
 
GenApi::IIntegerChunkDynamicRangeMax
 Indicates the maximum possible pixel value in the acquired image. More...
 
GenApi::IEnumerationT
< ChunkPixelFormatEnums > & 
ChunkPixelFormat
 Indicates the format of the pixel data in the acquired image. More...
 
GenApi::IIntegerChunkTimestamp
 Indicates the value of the timestamp when the image was acquired. More...
 
GenApi::IIntegerChunkFramecounter
 Indicates the value of the frame counter when the image was acquired. More...
 
GenApi::IIntegerChunkLineStatusAll
 A bit field that indicates the status of all of the camera's input and output lines when the image was acquired. More...
 
GenApi::IIntegerChunkVirtLineStatusAll
 A bit field that indicates the status of all of the camera's virtual input and output lines when the image was acquired. More...
 
GenApi::IIntegerChunkTriggerinputcounter
 Indicates the value of the trigger input counter when the image was acquired. More...
 
GenApi::IIntegerChunkLineTriggerIgnoredCounter
 Visibility = Beginner More...
 
GenApi::IIntegerChunkFrameTriggerIgnoredCounter
 Visibility = Beginner More...
 
GenApi::IIntegerChunkFrameTriggerCounter
 Visibility = Beginner More...
 
GenApi::IIntegerChunkFramesPerTriggerCounter
 Visibility = Beginner More...
 
GenApi::IIntegerChunkLineTriggerEndToEndCounter
 Visibility = Beginner More...
 
GenApi::IIntegerChunkInputStatusAtLineTriggerBitsPerLine
 Number of bits per status. More...
 
GenApi::IIntegerChunkInputStatusAtLineTriggerIndex
 Used to select a certain status. More...
 
GenApi::IIntegerChunkInputStatusAtLineTriggerValue
 Value of the status selected by 'Index'. More...
 
GenApi::IIntegerChunkShaftEncoderCounter
 Shaft encoder counter at frame trigger. More...
 
GenApi::IFloatChunkExposureTime
 Visibility = Beginner More...
 
GenApi::IIntegerChunkPayloadCRC16
 Indicates the value of CRC checksum. More...
 
GenApi::IIntegerChunkGainAll
 Visibility = Beginner More...
 
GenApi::IIntegerChunkLineTriggerCounter
 Visibility = Beginner More...
 

Detailed Description

The GigE specific grab result data.

Member Function Documentation

uint64_t Pylon::CGrabResultData::GetBlockID ( ) const
inherited

Get the block ID of the grabbed frame (camera device specific).

IEEE 1394 Camera Devices
The value of Block ID is always UINT64_MAX.
GigE Camera Devices
The sequence number starts with 1 and wraps at 65535. The value 0 has a special meaning and indicates that this feature is not supported by the camera.
USB Camera Devices
The sequence number starts with 0 and uses the full 64 Bit range.
Attention
A block ID with the value UINT64_MAX indicates that the block ID is invalid and must not be used.
void* Pylon::CGrabResultData::GetBuffer ( ) const
inherited

Get the pointer to the buffer.

If the chunk data feature is activated for the device, chunk data is appended to the image data. When writing past the image section while performing image processing, the chunk data will be corrupted.

GenApi::INodeMap& Pylon::CGrabResultData::GetChunkDataNodeMap ( ) const
inherited

Get the reference to the chunk data node map connected to the result.

An empty node map is returned when the device does not support this feature or when chunks are disabled.

int64_t Pylon::CGrabResultData::GetID ( ) const
inherited

Get the ID of the grabbed image.

Always returns a number larger than 0. The counting starts with 1 and is never reset during the lifetime of the Instant Camera object.

int64_t Pylon::CGrabResultData::GetImageNumber ( ) const
inherited

Get the number of the image. This number is incremented when an image is retrieved using CInstantCamera::RetrieveResult().

Always returns a number larger than 0. The counting starts with 1 and is reset with every call to CInstantCamera::StartGrabbing().

int64_t Pylon::CGrabResultData::GetNumberOfSkippedImages ( ) const
inherited

Get the number of skipped images before this image.

This value can be larger than 0 if EGrabStrategy_LatestImageOnly grab strategy or GrabStrategy_LatestImages grab strategy is used. Always returns a number larger than or equal 0. This number does not include the number of images lost in case of a buffer underrun in the driver.

uint64_t Pylon::CGrabResultData::GetTimeStamp ( ) const
inherited

Get the camera specific tick count (camera device specific).

This describes when the image exposure was started. Cameras that do not support this feature return zero. If supported, this can be used to determine which image AOIs were acquired simultaneously.

bool Pylon::CGrabResultData::IsChunkDataAvailable ( ) const
inherited

Returns true if chunk data is available.

This is the case if the chunk mode is enabled for the camera device. The parameter CInstantCamera::ChunkNodeMapsEnable of the used Instant Camera object is set to true (default setting). Chunk data node maps are supported by the Transport Layer of the camera device.

Member Data Documentation

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkDynamicRangeMax
inherited

Indicates the maximum possible pixel value in the acquired image.

This value indicates indicates the maximum possible pixel value acquired in the image

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkDynamicRangeMin
inherited

Indicates the minimum possible pixel value in the acquired image.

This value indicates the minimum possible pixel value in the acquired image.

Visibility = Beginner

GenApi::IFloat& Basler_GigEChunkData::CGigEChunkData_Params::ChunkExposureTime
inherited

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkFramecounter
inherited

Indicates the value of the frame counter when the image was acquired.

This integer indicates the value of the frame counter when the image was acquired.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkFramesPerTriggerCounter
inherited

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkFrameTriggerCounter
inherited

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkFrameTriggerIgnoredCounter
inherited

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkGainAll
inherited

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkHeight
inherited

Indicates the height of the area of interest represented in the acquired image.

This value Indicates the height of the area of interest represented in the acquired image.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkInputStatusAtLineTriggerBitsPerLine
inherited

Number of bits per status.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkInputStatusAtLineTriggerIndex
inherited

Used to select a certain status.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkInputStatusAtLineTriggerValue
inherited

Value of the status selected by 'Index'.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkLineStatusAll
inherited

A bit field that indicates the status of all of the camera's input and output lines when the image was acquired.

This value is a bit field that indicates the status of all of the camera's input and output lines when the image was acquired.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkLineTriggerCounter
inherited

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkLineTriggerEndToEndCounter
inherited

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkLineTriggerIgnoredCounter
inherited

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkOffsetX
inherited

Indicates the X offset of the area of interest represented in the acquired image.

This value Indicates the X offset of the area of interest represented in the acquired image.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkOffsetY
inherited

Indicates the Y offset of the area of interest represented in the acquired image.

This value Indicates the Y offset of the area of interest represented in the acquired image.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkPayloadCRC16
inherited

Indicates the value of CRC checksum.

This integer indicates the value of CRC checksum.

Visibility = Beginner

GenApi::IEnumerationT<ChunkPixelFormatEnums >& Basler_GigEChunkData::CGigEChunkData_Params::ChunkPixelFormat
inherited

Indicates the format of the pixel data in the acquired image.

This enumeration lists the pixel formats that can be indicated by the pixel format chunk.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkSequenceSetIndex
inherited

Indicates the sequence set index number related to the acquired image.

This value indicates the sequence set index number related to the acquired image.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkShaftEncoderCounter
inherited

Shaft encoder counter at frame trigger.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkStride
inherited

Indicates the number of bytes of data between the beginning of one line in the acquired image and the beginning of the next line in the acquired image.

This value indicates the number of bytes of data between the beginning of one line in the acquired image and the beginning of the next line in the acquired image.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkTimestamp
inherited

Indicates the value of the timestamp when the image was acquired.

This integer indicates the value of the timestamp when the image was acquired.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkTriggerinputcounter
inherited

Indicates the value of the trigger input counter when the image was acquired.

This integer indicates the value of the trigger input counter when the image was acquired.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkVirtLineStatusAll
inherited

A bit field that indicates the status of all of the camera's virtual input and output lines when the image was acquired.

This value is a bit field that indicates the status of all of the camera's virtual input and output lines when the image was acquired.

Visibility = Beginner

GenApi::IInteger& Basler_GigEChunkData::CGigEChunkData_Params::ChunkWidth
inherited

Indicates the widtth of the area of interest represented in the acquired image.

This value Indicates the width of the area of interest represented in the acquired image.

Visibility = Beginner


The documentation for this class was generated from the following file:

pylon 5.0.9
Copyright © 2006-2017 Basler AG (Tue May 30 2017 17:24:58)