Operator FrameMax

This operator returns the maximum pixel value found inside each input frame. The output frame has the same size as the input frame, where each pixel is replaced by the maximum value found in the image so far. If the current pixel is a new maximum the output Link IsMaxO is 1, otherwise it is 0.

[Note] Resource Consumption

The operator's FGPA resource consumption strongly increases with the parallelism. We recommend to use low parallelism at this operator.

In many use cases of this operator, the parallelism can be reduced selecting the max parallel component prior to this operator. Use SplitParallel, MergeKernel and MAX for this operation.

With every new input frame the maximum detection starts again. Additionally, it is possible to clear the current maximum manually when the ClrI link is set to 1. When a manual clear is not necessary, you must ensure a constant 0 at ClrI, to enable normal operation.

The following example shows the relation of the input pixel to the output values.

Often, this operator is used in conjunction with operators RemoveLine and RemovePixel to use only the last image pixel containing the results of all frame pixels.

Image Restrictions

  • Empty Images

    Empty images, i.e., images with no pixels, are allowed. The operator will output an empty image.

I/O Properties

Property Value
Operator Type O
Input Links I, Image Input
ClrI, Clear Input
Output Links O, Data Output
IsMaxO, binary output to indicate a new maximum

Supported Link Format

Link Parameter Input Link I Input Link ClrI Output Link O Output Link IsMaxO
Bit Width [1, 64] unsigned, [2, 64] signed 1 as I 1
Arithmetic {unsigned, signed} unsigned as I unsigned
Parallelism any as I as I as I
Kernel Columns 1 as I as I as I
Kernel Rows 1 as I as I as I
Img Protocol VALT_IMAGE2D, VALT_IMAGE1D, VALT_IMAGE0D as I as I as I
Color Format VAF_GRAY as I as I as I
Color Flavor FL_NONE as I as I as I
Max. Img Width any as I as I as I
Max. Img Height any as I as I as I

Parameters

None

Examples of Use

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

  • 'Blob2D ROI Selection'

    Examples - The blob analysis operator is applied to an input camera image. The applet shows the usage of the blob data in the applet. In this case, the object with the maximum are is localized and the coordinates are used to cut out the object from the original image.