VisualApplets
Operator Reference

VAF_GRAY = FL_NONE

VAF_COLOR = FL_RGB

(If Color Format is VAF_GRAY, Color Flavor is FL_NONE; if Color Format is VAF_COLOR, Color Flavor is FL_RGB.)

The CameraID parameter defines the CXP master port ID to the firmware of the camera operator to allow automatic CXP topology discovery (camera-to-applet and applet-to-camera).

By using this parameter, you can specify the ID directly here in the operator. However, we recommend to specify the resources of the operator in the Resources dialog. (To open the Resources dialog, simply highlight the camera operator and select from the Design menu the menu item Resources.) The CameraID parameter will automatically update to the correct master port, using the resource dialog parameters. The following example is using one single camera and one dual camera:

The CameraID (CXP master port ID) of module3 (single camera) is 2. The CameraID (CXP master port ID) of module5 (dual camera) is 1.

The dual camera requires 2 CXP camera ports. (A quad camera requires 4 ports.) Only the master port is reflected in the CameraID parameter of the operator.

When you define more CameraPort resources than possible (the maximum is 4), e.g., when you instantiate 5 "CXPSingleCamera"" operators, the camera operator which requests the CameraPort resource last (while all four available ones are already occupied) sets its CameraID to -1. In this case, the design rule check reports an error.

The parameter CameraID is in range {-1,0,1,2,3}.

A read-only parameter that provides the minimal parallelism for the output link O that still allows to transport the maximal bandwidth of the camera without losing data. The minimal parallelism is calculated automatically.

The value depends on the pixel format you select in parameter FormatMode.

If you define parameter FormatMode to be a dynamic parameter (see description of parameter FormatMode below), the smallest minimal parallelism that might occur is calculated.

The minimal parallelism might lead to the creation of dummy pixels, because the operator might convert the parallelism twice and add dummy values in this process. Because of these dummy pixels, the expected output image width is:

The Status parameter is a runtime, read-only parameter to reflect the current status of the camera operator. Bit[0] signalizes CXP stream packet loss detection. Bit[1] signalizes single byte error correction in CXP stream packets. Bit[2] signalizes multiple byte error detection in CXP stream packets. Bit[3..6] are reserved. This parameter might change in future versions.

Here, you can select which kind of pixel format (as defined by the CXP specification) you want to receive. The value you select here defines which pixel formats can be selected in parameter FormatMode. Hence, the setting of this parameter directly influences parameter FormatMode. See also documentation of parameter FormatMode below.

The parameter offers all pixel formats (as defined by the CXP specification) that belong to the format type you selected in parameter FormatType.

The pixel formats you can select here depend on the setting of parameter FormatType. Hence, you always have only a pre-set of the full value range available.

To get another set of pixel formats, change the setting of parameter FormatType. See also documentation of parameter FormatType above.

In detail, the following settings of parameter FormatType provide the following pixel formats in parameter FormatMode:

FormatType == GRAY: {Mono8, Mono10, Mono12, Mono14, Mono16, BayerGR8, BayerGR10, BayerGR12, BayerGR14, BayerGR16, BayerRG8, BayerRG10, BayerRG12, BayerRG14, BayerRG16, BayerGB8, BayerGB10, BayerGB12, BayerGB14, BayerGB16, BayerBG8, BayerBG10, BayerBG12, BayerBG14, BayerBG16}

FormatType == RGB: {RGB8, RGB10, RGB12, RGB14, RGB16}

FormatType == RGBA: {RGBA8, RGBA10, RGBA12, RGBA14, RGBA16}

FormatType == RAW: {Raw} Pixel format Raw has a fix bit width of 32Bit. The data are interpreted as received.

You can decide if you want to use this parameter as a dynamic or as a static parameter. Select in column Parameter Type:

With parameter TxTriggerPacketMode you can increase the bandwidth of the CXP cables that connect the frame grabber with the camera. The increase of bandwidth is achieved by a slight modification of the camera trigger signal interpretation.

Please note that this feature can only be used with specific cameras that support this feature. For details, please contact your local distributor or the Basler Support.

Parameter TxTriggerPacketMode allows two values (CxpStandard, RisingEdgeOnly):

The TxTriggerEventCount parameter indicates how many trigger edge events have been sent to the camera.

The TxTriggerAcknowledgementCount parameter indicates how many trigger acknowledgement packets sent by the camera (in answer to the trigger edge packets sent before) have been received by the frame grabber.

The parameter is set to 1 by the camera operator if the operator detects a distance between two trigger edges on port TriggerI which violates the minimal edge frequency. The minimal edge frequency is 550 ns (nanoseconds) on all microEnable 5 platforms. The parameter holds its value until it has been read. After being read, the parameter updates the value. Frequency control is running permanently and is not influenced by the read status of the parameter.