Operator CameraGrayArea

Operator Library: Hardware Platform

This operator represents the image data interface between a grayscale area scan GigE Vision camera and VisualApplets. This operator requires one VisualApplets resource of type CAM. Set the resource index for the camera in the resource dialog. The resource index 0 maps the camera to port 0, index 1 to port 1, etc. Check 'Allocation of Device Resources' for more information.

This operator can be configured to support the different data formats specified by the GigE Vision standard. The following figure illustrates the data formats.

The packed formats require 3 bytes for transmitting 2 pixels. MONO8 and MONO8_SIGNED require only 1 byte per pixel. MONO10, MONO12 and MONO16 need 2 bytes per pixel.


  • MONO8_SIGNED is managed by the operator as MONO8 and the output link format will be set to UNSIGNED type. If a SIGNED link is required use CastType operator and change the link type to SIGNED.
  • Bayer formats can be mapped to these Gray formats because the camera operator does not interpret the pixel content.

The parameterized format is converted to match with the parameterized output link format of the camera operator. The output link can be configured to several bit widths. Conversion is performed by adding bits to the lower bit positions if the camera format bit width is higher than the parameterized bit width in the output link. However, if the camera format bit width is less than the available bits at the output link, only the most significant bits are used.

Moreover, in the output link the maximum possible image dimensions have to be specified. The size of the actual transfered images however may be less but must not exceed this parameterized maximum.

Available for Hardware Platforms
microEnable IV VQ4-GE/-GPoE

I/O Properties

Property Value
Operator Type M
Output Link O, image data output

Supported Link Format

Link Parameter Output Link O
Bit Width {8, 10, 12, 14, 16}
Arithmetic unsigned
Parallelism 4
Kernel Columns 1
Kernel Rows 1
Img Protocol VALT_IMAGE2D
Color Format VAF_GRAY
Color Flavor FL_NONE
Max. Img Width any
Max. Img Height any


Type dynamic read/write parameter
Default MONO8

This parameter specifies the data format of the connected camera. The format has to match with the camera configuration.

Type dynamic read parameter
Default 0
Range {0, 1}

This parameter indicates if an overflow at the camera operator has occurred i.e. image data has been lost. Each time an overflow occurs, the parameter is set to one. This value is kept until the value is read. Thus, reading the parameter will reset it to value 0. In normal operations this should never happen. The parameter is used for maintenance.

Examples of Use

The use of operator CameraGrayArea is shown in the following examples: