Skip to content

Deviating Parameter Interface During Runtime#

Application Note AN-eVA-1703

On platforms using embedded VisualApplets (eVA), during runtime some VisualApplets operators offer a parameter interface that slightly differs from the list of parameters which is presented in the VisualApplets GUI. This is true for the following nine operators:

  • Library Color:

    • ColorTransform
  • Library Memory:

    • ImageBufferMultiRoi
    • KneeLUT
    • LUT
    • CoefficientBuffer
    • RamLUT
    • ROM
  • Library Compression:

    • JPEG_Encoder_Gray
  • Library Transformation:

    • FFT

Find below information on how to adjust the settings of the affected parameters during runtime.

Accessing the Operator Instances During Runtime#

Operator Name Parameters Showing Different Interface During Runtime Alternative Access During Runtime
ColorTransform Coefficients:
  • CoefficientIndex
  • CoeffiecientValue
Field parameter Coefficients is replaced by separate index parameter and value parameters (parameter names: CoefficientIndex and CoefficientValue). The value is written on access to CoefficientValue.
CoefficientBuffer LoadCoefficients File input/output is not possible during runtime on eVA platforms. Thus, coefficient data cannot be loaded via image file (the normal use case for this parameter), but needs to be loaded as raw data.
To be able to load raw data, some additional parameters are used on eVA platforms during runtime:
RawDataXLength: Width of the ROI, in which the coefficients are to be defined.
RawDataXOffset: X position of the ROI, in which the coefficients are to be defined.
RawDataYOffset: Y position of the ROI, in which the coefficients are to be defined.
LoadCoefficients: The loading is triggered by a write cycle of value 1 to this parameter. Loading into the ROI is carried out via data word WriteRawData.WriteRawData: Data word that is written into the RAM at a write cycle to WriteRawData. With each write cycle, the writing position is automatically moved forward by one position within the ROI that has been defined by RawDataLength, RawDataOffset and RawDataYOffset. This way, a complete ROI is overwritten by continous write cycles to WriteRawData
ImageBufferMultiRoi XOffset
XLength
YOffset
YLength
RoiIndex (additional parameter)
During runtime on eVA platforms, the parameters XOffset, XLength, YOffset and YLength are available as scalar parameter. (In the VA GUI they are defined as arrays.) An additional parameter RoiIndex selects the region of interest. For each RoiIndex, XOffset, XLength, YOffset, and YLength can be defined.
KneeLUT StartBasePoints:
  • StartBasePointValue
  • Index

EndBasePoints:
  • EndBasePointValue
  • Index
During runtime on eVA platforms, instead of field parameter StartBasePoints/ EndBasePoints, the scalar parameter StartBasePointValue/EndBasePointValue is available. An additional parameter Index selects the index of the field parameter StartBasePoints/EndBasePointValue of the VisualApplets operator. With this common index, parameter StartBasePointValue/EndBasePointValue sets the addressed entry in the array. For each Index, one StartBasePointValue/EndBasePointValue can be defined.
LUT LUTcontent:
  • Value
  • Index
During runtime on eVA platforms, instead of field parameter LUTcontent, the scalar parameter Value is available. An additional parameter Index selects the index of the field parameter LUTcontent of the VisualApplets operator. With this common index, parameter Value sets the addressed entry in the array. For each Index, one Value can be defined.
RamLUT InitData
  • InitDataValue
  • InitDataIndex
During runtime on eVA platforms, instead of field parameter InitData, the scalar parameter InitDataValue is available. An additional parameter InitDataIndex selects the index of the field parameter InitData of the VisualApplets operator. With this common index, parameter InitDataValue sets the addressed entry in the array. Parameter InitDataIndex is only available when the VisualApplets operator parameter InitData contains more than one entry.
RamLUT InitFileLoadMode
InitFileName
LoadInitFile
During runtime on eVA platforms, parameters InitFileLoadMode, InitFileName, and LoadInitFile is not available, as the GenICam API doesn't support file input/output.
ROM ROMcontent
  • Value
  • Index
During runtime on eVA platforms, instead of field parameter ROMcontent, the scalar parameter Value is available. An additional parameter Index selects the index of the field parameter ROMcontent of the VisualApplets operator. With this common index, parameter Value sets the addressed entry in the array. For each Index, one Value can be defined.
JPEG_ENCODER_Gray quality_in_percent During runtime on eVA platforms, parameter quality_in_percent is not available. The quantization matrix must be written directly via the parameters quantization_matrix_index and Quantization_matrix_value which are used instead of the VisualApplets field parameter quantization_matrix (see description of parameter quantization_matrix below).
JPEG_ENCODER_Gray quantization_matrix During runtime on eVA platforms, instead of field parameter quantization_matrix, the scalar parameter quantization_matrix_value is available. An additional parameter quantization_matrix_index selects the index of the field parameter quantization_matrix of the VisualApplets operator. With this common index, parameter quantization_matrix_value sets the addressed entry in the array. For each quantization_matrix_index, one quantization_matrix_value can be defined.
FFT This operator currently doesn't support embedded VisualApplets devices.