Image Format Control

Description

Effective width of the sensor in pixels.

Interface

Integer

Access mode

Read only

Adjustable

while grabbing

-

Value range

Depends on the built-in sensor.

Default value

1

Availability

ALL

Notes

-

Error behavior

-

Description

Effective height of the sensor in pixels.

Interface

Integer

Access mode

Read only

Adjustable

while grabbing

-

Value range

1

Default value

1

Availability

ALL

Notes

-

Error behavior

-

Description

Specifies the sensor color filter.

Interface

Enumeration

Access mode

Read only

Adjustable

while grabbing

-

Value range

See enum entry table below.

Default value

-

Availability

-

Notes

Only the display name is changed to sensor color filter for backward compatibility.

Error behavior

-

White

White

RGBW

Red, Green, Blue and White

RGBWIr

Red, Green, Blue, White and Infrared

RGBIr

Red, Green, Blue and Infrared

Description

Maximum width of the image (in pixels). The dimension is calculated after horizontal binning, decimation or any other function changing the horizontal dimensions of the image.

Interface

Integer

Access mode

Read only

Adjustable

while grabbing

-

Value range

>0

Default value

SensorWidth

Availability

ALL

Notes

-

Error behavior

-

Description

Maximum height of the image (in pixels). This dimension is calculated after vertical binning, decimation or any other function changing the vertical dimensions of the image.

Interface

Integer

Access mode

Read only

Adjustable

while grabbing

-

Value range

>0

Default value

-

Availability

ALL

Notes

The maximum height depends on your PC and Frame grabber configuration.

Error behavior

-

Description

Selects the Region of interest to control.

Interface

Enumeration

Access mode

Read/Write

Adjustable

while grabbing

-

Value range

See enum entry table below.

Default value

-

Availability

ALL

Notes

-

Error behavior

-

Region1

Selected feature will control the region 1

Region2

Selected feature will control the region 2. For ax_dsxge only.

Description

Controls whether the selected Region of interest is active and streaming.

Interface

Enumeration

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

See enum entry table below.

Default value

-

Availability

ALL

Notes

-

Error behavior

See the device error code documentation.

Off

Disable usage of the Region. For ax_dsxge only

On

Enable usage of the Region.

Description

Width of the Image provided by the device (in pixels).

Interface

Integer

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

[128 , Width Max]

Default value

WidthMax

Availability

ALL

Notes

The width value must be a multiple of eight for RGB.

Error behavior

See the device error code documentation.

Description

Height of the Image provided by the device (in pixels).

Interface

Integer

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

[16 , Height Max]

Default value

1024

Availability

ALL

Notes

This parameter influences the value range of AcquisitionFrameRate. Please read the AcquisitionFrameRate feature documentation for further details.

Error behavior

See the device error code documentation.

Description

Horizontal offset from the origin to the region of interest (in pixels).

Interface

Integer

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

≥0

Default value

0

Availability

ALL

Notes

-

Error behavior

See the device error code documentation.

Description

Horizontal offset from the origin to the region of interest in sensor coordinates (pixels).

Interface

Integer

Access mode

Read only

Adjustable

while grabbing

No

Value range

≥0

Default value

0

Availability

ALL

Notes

The display name is just Sensor Offset X.

Error behavior

See the device error code documentation.

Description

Width of the selected region of interest in sensor coordinates (in pixels).

Interface

Integer

Access mode

Read only

Adjustable

while grabbing

No

Value range

≥0

Default value

0

Availability

ALL

Notes

The display name is just Sensor Width. The feature resides below the Region Selector. There is a SensorWidth feature defining the sensor’s full width which resides in the top level of the image format control category.

Error behavior

See the device error code documentation.

Description

Number of horizontal photo-sensitive cells to combine. This increases the intensity (or signal-to-noise ratio) of the pixels and reduces the horizontal resolution (width) of the image.

Interface

Integer

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

Variant

Value Range

ax_X

1,2,4,8,16

g8_X

1,2,4,8,16

Default value

1 – Indicates that no horizontal binning is performed by the camera.

Availability

ALL

Notes

If you change this parameter, the Region OffsetX and Width is scaled according to the binning value.
Please check these parameters after adapting Binning Horizontal.

When Width is changed, the maximum BinningHorizontal value may be reduced and limited to that value. This is done to ensure that Width value doesn’t go below the minimum width value.

Error behavior

See the device error code documentation.

Description

This is the same feature as DecimationHorizontal as defined in the SFNC. However, it supports float values for decimation.

Horizontal sub-sampling of the image. This reduces the horizontal resolution (width) of the image by the specified horizontal decimation factor.

Interface

Float

Access mode

Read/Write

Adjustable

while grabbing

Yes

Value range

[0.5 , 3.999]

Default value

1.0

Availability

ALL

Notes

A value of 1 indicates that the camera performs no horizontal decimation.

If you change this parameter, the Region OffsetX and Width are scaled according to the decimation value. Please check these parameters after adapting Decimation Horizontal.

When Width is changed, the maximum DecimationHorizontalFloat value may be reduced and limited to that value. This is done to ensure that Width value doesn’t go below the minimum width value.

Error behavior

See the device error code documentation.

Description

Flip the image sent by the device horizontally.

Interface

Boolean

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

True  – Horizontally flipped image

False – Normal Image

Default value

False

Availability

ALL

Notes

This feature is effective only if Test Pattern is set to Off.

Error behavior

-

Description

Format of the pixels provided by the device. It represents all the information provided by PixelSize, PixelColorFilter combined in a single feature.

Interface

Enumeration

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

See enum entry table below.

Default value

Variant

Value

Color Camera

RGB8

Mono Camera

Mono8

Availability

ALL

Notes

-

Error behavior

See the device error code documentation.

Mono8

ALL

Mono10

ALL

Mono12

ALL

RGB8

ALL

RGB10

ALL

RGB12

ALL

RGB10p32

-

32-bits per pixel RGB format. The bit depth is 10-bits. Please check the PFNC (Pixel Format Naming Convention) for more details – Not available for g8_dxge packages!

BGR8

X_DXGE

24 bits per pixel BGR linear memory

RGBa8

g8_X

p6_nxge

32 bits per pixel RGBa linear memory. Component ‘a’ contains Infrared (Ir) or White(W).

RGBa10

g8_X

p6_nxge

RGBa at 10bit unpacked. Component ‘a’ contains Infrared (Ir) or White(W).

RGBa12

g8_X

p6_nxge

RGBa at 12bit unpacked. Component ‘a’ contains Infrared (Ir) or White(W).

Description

Selects the type of color filter that is applied to an image.

Interface

Enumeration

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

See enum entry table below.

Default value

Variant

Value

ax_X

RGB

g8_X

RGBIr

p6_nxge

RGBIr

p16_CXP

RGBIr

ALL

Availability

ALL

Notes

For mono cameras the pixel color filter will be White only.

Error behavior

See the device error code documentation.

RGB

ALL

Three color planes RGB at the sensor is selected.

RGBIr

p16_CXPp6_nxgeg8_X

Four color planes RGB and Infrared at the sensor is selected. Infrared is transmitted as component ‘a’ in the pixel format RGBa8, RGBa10 and RGBa12.

RGBW

p16_CXPp6_nxge

Four color planes RGB and White at the sensor is selected. White is transmitted as component ‘a’ in the pixel format RGBa8, RGBa10 and RGBa12.

White

g8_X

Only White plane at the sensor is selected

Description

The info block can be enabled for the first line, for each line or for first and each line.

Interface

Enumeration

Access mode

Read/Write

Adjustable

while grabbing

Yes

Value range

Enum entries table below.

Default value

Infoblock off

Availability

ALL

Notes

So far not all entries are working. There may be even differences between variants of allPIXAevo.

Error behavior

none

Off

No info block is displayed in the image.

Firstline

First line Info block which is in line 0 of each transmitted image is displayed.

Eachline

In each line from line 0 of each transmitted image the Each line info block is displayed.

FirstandEachLine

First and each line info block are displayed in each image.

In case both FirstlineandEach line info block are active, Eachline info block is always displayed from line 1 in every transmitted image!

Line 0

MARKER

SERIAL
NUMBER

MARKER

IMAGE
COUNT

EXPOSURE TIME

MARKER

LINE TIME

ENCODER
CLOCKS

ERROR
CODE

TIME STAMP

MARKER

MARKER

DIVERSE

Markers are used to mark the info block with red pixels.

SERIAL NUMBER

SAME

These pixels encode the serial number of the camera.

IMAGE COUNT

SAME

These pixels encode the image count of the camera.

EXPOSURE TIME

SAME

This is the current Exposure Time in camera internal clock cycles.

To decode the exposure time, use the following formula:

LINE TIME

SAME

This is the current line time in camera internal clock cycles.

Package 2.1.2 and later:

ENCODER CLOCKS

SAME

This is a 32-bit counter starting at power on with 0.
These counts either the line trigger (LineStart) or Encoder pulses depending on the selected mode.

When setting EncoderSourceA to Off the encoder clock counter will be reset.

ERROR CODE

UNUSED

CURRENTLY UNUSED PRESET WITH ZERO

TIMESTAMP

SAME

Timestamp starts counting from boot.

¹MS= Milliseconds

To achieve the milliseconds part of the timestamp the

Content of Px₂₁ must be multiplied by four.

Pixel

0

1

2

3

4

5

6

7

8

9

RED

MARKER

ERROR CODE

SPEED2HIGH

ENCODER CLOCKS

NEXT LINE POSITION

TIME STAMP

UNSUPPORTED

UNSUPPORTED

LINE STATUS/SCAN-DIR

MARKER

LINE TIME

GREEN

CONTINUOUS LINE COUNT

LINE COUNT

BLUE

Description

Selects which test pattern generator is controlled by the TestPattern feature.

Interface

Enumeration

Access mode

Read/Write

Adjustable

while grabbing

Yes

Value range

See enum entry table below.

Default value

ImageProcessing

Availability

ALL

Notes

-

Error behavior

-

ImageProcessing

TestPattern feature controls the Image Processing test pattern generator.

Description

Selects the type of test pattern that is generated by the device as image source.

Interface

Enumeration

Access mode

Read/Write

Adjustable

while grabbing

No

Value range

See enum entry table below.

Default value

Off

Availability

ALL

Notes

-

Error behavior

See the device error code documentation.

Off

Image is coming from the sensor.

GreyHorizontalRamp

Image is filled horizontally with pixels that go from the darkest possible value to the brightest.

GreyVerticalRamp

Image is filled vertically with pixels that go from the darkest possible value to the brightest.

GreyHorizontalRampMoving

Image is filled horizontally with pixels that go from the darkest possible value to the brightest and that move horizontally from left to right at each frame.

GreyVerticalRampMoving

Image is filled vertically with lines that go from the darkest possible value to the brightest and that move vertically from top to bottom at each frame.

ColorRamps

Horizontal ramp in red color channel. Vertical and horizontal ramp in green color channel. Vertical ramp in blue color channel.

TogglingPixels

Vertically and horizontally neighbored pixels have the inverse intensity value from each other.

PinStripes

Fixed pin stripe pattern with configurable background. The background is configurable with the test pattern value feature.

Description

Test-Pattern-specific value that influences the appearance of the generated image.

Interface

Integer

Access mode

Read/Write

Adjustable

while grabbing

Yes

Value range

[0 – 4095]

Default value

64

Availability

ALL

Notes

-

Error behavior

See the device error code documentation.