FrameDecodingParameters

Defines a struct to configure the frame decoding Parameters.

Typedefs

typedef struct tagFrameDecodingParameters  FrameDecodingParameters

Attributes

maxQueueLength

The maximum number of frames waiting for decoding.

int tagFrameDecodingParameters::maxQueueLength

Value Range

[0,0x7fffffff]

Default Value

3

maxResultQueueLength

The maximum number of frames whose results (text result/localization result) will be kept for further reference.

int tagFrameDecodingParameters::maxResultQueueLength

Value Range

[0,0x7fffffff]

Default Value

10

width

The width of the frame image in pixels.

int tagFrameDecodingParameters::width

Value Range

[0,0x7fffffff]

Default Value

0

height

The height of the frame image in pixels.

int tagFrameDecodingParameters::height

Value Range

[0,0x7fffffff]

Default Value

0

stride

The stride (or scan width) of the frame image.

int tagFrameDecodingParameters::stride

Value Range

[0,0x7fffffff]

Default Value

0

imagePixelFormat

The image pixel format used in the image byte array.

ImagePixelFormat tagFrameDecodingParameters::imagePixelFormat

Value Range

A value of ImagePixelFormat Enumeration items.

Default Value

IPF_GRAYSCALED

See Also

ImagePixelFormat

region

The region definition of the frame to calculate the internal indicator.

RegionDefinition tagFrameDecodingParameters::region

Default Value

{ regionLeft = 0, regionRight = 100, regionTop = 0, regionBottom = 100, regionMeasuredByPercentage = 1 }

See Also

RegionDefinition

threshold

The threshold used for filtering frames.

float tagFrameDecodingParameters::threshold

Value Range

[0, 1]

Default Value

0.01

Remarks

The SDK will calculate an inner indicator for each frame from AppendFrame or DBR_AppendFrame, if the change rate of the indicators between the current frame and the history frames is larger than the given threshold, the current frame will not be added to the inner frame queue waiting for decoding.

fps

The frequency of calling AppendFrame or DBR_AppendFrame per second.

int tagFrameDecodingParameters::fps

Value Range

[0,0x7fffffff]

Default Value

0

Remarks

0 means the frequency will be calculated automatically by the SDK.

autoFilter

Sets whether to filter frames automatically.

int tagFrameDecodingParameters::autoFilter

Value Range

[0,1]

Default Value

1

Remarks

0: Diable filtering frames automatically. 1: Enable filtering frames automatically.

clarityCalculationMethod

Sets the method used for calculating the clarity of the frames.

ClarityCalculationMethod tagFrameDecodingParameters::clarityCalculationMethod

Value Range

Any one of the ClarityCalculationMethod Enumeration items.

Default Value

ECCM_CONTRAST

See Also

ClarityCalculationMethod

clarityFilterMode

Sets the mode used for filtering frames by calculated clarity.

ClarityFilterMode tagFrameDecodingParameters::clarityFilterMode

Value Range

Any one of the ClarityFilterMode Enumeration items.

Default Value

CFM_GENERAL

See Also

ClarityFilterMode

duplicateForgetTime

Set the time period used to ignore duplicate results found in frames. Measured in ms.

int tagFrameDecodingParameters::duplicateForgetTime

Value Range

[0, 600000]

Default Value

3000

Remarks

The library keeps each barcode result (type and value) in the buffer for a period of time (set with duplicateForgetTime) during which if a new result is an exact match, it’s seen as a duplicate and will again be kept for that period of time while the old result is removed and so on.

orientation

Set the orientation of the frame image data. The value is the angle that the image needs to be rotated clockwise so it shows correctly on the display in its natural orientation. It can be 0, 90, 180, or 270.

int tagFrameDecodingParameters::orientation

Value Range

0, 90, 180, or 270

Default Value

0

reserved

Reserved memory for the struct. The length of this array indicates the size of the memory reserved for this struct

char tagFrameDecodingParameters::reserved[12]