Loading Reference... User Guide... Hardware-specific Notes...

Customize Help

MIL systems:
Show All

Installed MIL systems

Multiple

None

Host system

Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)*

Matrox Morphis

Matrox Morphis QxT

Matrox Orion HD

Matrox Radient eCL

Matrox Radient eV-CXP (MIL 10 or Update 29)*

Matrox Solios eA/XA

Matrox Solios ecl/xcl/ev-cl

Matrox USB3 Vision driver (Update 19)

Matrox RadientPro-CL (Update 7)

Matrox Radient eV-CL (Update 27 or 74)

Matrox Iris GTR (Update 28 or Update 68)

Matrox Clarity UHD (Update 36 or 76)

Matrox GenTL driver (Update 34)

Matrox Indio (Update 53 or Update 68)

Matrox Rapixo CXP (Update 75 or Update 84)

Matrox Concord PoE with ToE (Update 82)

Matrox Rapixo CL Pro (Update 96)

As Tooltip

Value descriptions: Detailed Summarized

Save Settings

| Customize Help

| Save Settings

MimArithMultiple

See also

User Guide:

Averaging an input sequence Porting a 32-bit MIL application to MIL 64-bit

Reference:

MbufAlloc2d MbufInquire MbufSetRegion

Availability

Availability

Available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Not supported on:

Not supported on Matrox Indio (Update 53 or Update 68) (w)

Not supported on Matrox Concord PoE with ToE (Update 82) (z)

Fully supported on:

Fully supported on Host system (a)

Fully supported on Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)* (c)

Fully supported on Matrox Morphis (g)

Fully supported on Matrox Morphis QxT (h)

Fully supported on Matrox Orion HD (i)

Fully supported on Matrox Radient eCL (j)

Fully supported on Matrox Radient eV-CXP (MIL 10 or Update 29)* (k)

Fully supported on Matrox Solios eA/XA (l)

Fully supported on Matrox Solios ecl/xcl/ev-cl (m)

Fully supported on Matrox USB3 Vision driver (Update 19) (o)

Fully supported on Matrox RadientPro-CL (Update 7) (p)

Fully supported on Matrox Radient eV-CL (Update 27 or 74) (r)

Fully supported on Matrox Iris GTR (Update 28 or Update 68) (t)

Fully supported on Matrox Clarity UHD (Update 36 or 76) (u)

Fully supported on Matrox GenTL driver (Update 34) (v)

Fully supported on Matrox Rapixo CXP (Update 75 or Update 84) (y)

Fully supported on Matrox Rapixo CL Pro (Update 96) (aa)

* Refer to the MIL system-specific information
in the MIL Reference for the minimum update required.

For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP/GPm

Available on Matrox Supersight

function map

Function map

Examples

adaptivethresholder.cpp
alphablending.cpp
mechanicalpartscan.cpp
processingfpga.cpp

Function Map

- Src1ImageBufId

- Src2ImageBufIdOrConst

- Src3ImageBufIdOrConst

- DstImageBufId

- OperationFlag

Parameter Associations

Table:	For the Operation, Src1ImageBufId, Src2ImageBufId, Src3ImageBufId, Src4ImageBufId, and Src5ImageBufId parameters
+ combination:	For the Operation parameter

Compilation information

Synopsis

Perform a point-to-point arithmetic operation using multiple source images.

Syntax

void MimArithMultiple(

MIL_DOUBLE Src1ImageBufId,	//in
MIL_DOUBLE Src2ImageBufIdOrConst,	//in
MIL_DOUBLE Src3ImageBufIdOrConst,	//in
MIL_DOUBLE Src4Const,	//in
MIL_DOUBLE Src5Const,	//in
MIL_ID DstImageBufId,	//in
MIL_INT64 Operation,	//in
MIL_INT64 OperationFlag	//in

)

Description

This function performs the specified point-to-point operation using multiple images, images and constants, or constants, storing results in the specified destination image buffer. Note that this function does not take 1-bit buffers in any of its parameters.

You can limit this function's results to a region of an image buffer using a region of interest (ROI) set using MbufSetRegion(). The ROI must be defined in raster format (M_RASTER or M_VECTOR_AND_RASTER). An error is generated if the ROI is only in vector format (M_VECTOR). If you specify multiple image buffers with an ROI, results are limited to the portion of the ROIs that intersect.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.

Parameters

This function is not supported on the selected boards.

This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.

Parameters

Src1ImageBufId

Specifies the data source of the first operand; this parameter must be given an image buffer identifier. If you specify an image buffer that has an ROI associated with it, the ROI must be in raster format; otherwise, you will get an error.

See the Parameter associations section for possible values that can be specified.

Src2ImageBufIdOrConst

Specifies the data source of the second operand; this parameter can be given an image buffer identifier or a constant. If you specify an image buffer that has an ROI associated with it, the ROI must be in raster format; otherwise, you will get an error.

See the Parameter associations section for possible values that can be specified.

Src3ImageBufIdOrConst

Specifies the data source of the third operand; this parameter can be given an image buffer identifier or a constant. If you specify an image buffer that has an ROI associated with it, the ROI must be in raster format; otherwise, you will get an error.

See the Parameter associations section for possible values that can be specified.

Src4Const

Specifies the data source of the fourth operand; this parameter must be given a constant.

Set this parameter to M_NULL if not used.

See the Parameter associations section for possible values that can be specified.

Src5Const

Specifies the data source of the fifth operand; this parameter must be given a constant.

Set this parameter to M_NULL if not used.

See the Parameter associations section for possible values that can be specified.

DstImageBufId

Specifies the identifier of the destination of the results; this parameter must be given an image buffer identifier. If you specify an image buffer that has an ROI associated with it, the ROI must be in raster format; otherwise, you will get an error.

Operation

Specifies the operation to perform.

See the Parameter associations section for possible values that can be specified.

OperationFlag

Reserved for future expansion. Must be set to M_DEFAULT.

Parameter associations

The table below lists possible values for the Src1ImageBufId, Src2ImageBufIdOrConst, Src3ImageBufIdOrConst, Src4Const, Src5Const, and Operation parameters.

For the Operation, Src1ImageBufId, Src2ImageBufId, Src3ImageBufId, Src4ImageBufId, and Src5ImageBufId parameters

Note that any unused parameters should be set to M_NULL.

For the Operation, Src1ImageBufId, Src2ImageBufId, Src3ImageBufId, Src4ImageBufId, and Src5ImageBufId parameters
Operation		Description
	Src1ImageBufId
	Src2ImageBufIdOrConst
	Src3ImageBufIdOrConst
	Src4Const
	Src5Const
M_MULTIPLY_ACCUMULATE_1 +		Performs a point-to-point multiply and accumulate 1 operation using the equation that follows. (summarize) Performs a point-to-point multiply and accumulate 1 operation using the equation that follows. (more details...)
	Src1ImageBufId	Specifies the image buffer identifier required for the first operand. (summarize) Specifies the image buffer identifier required for the first operand. (more details...)
	Src2ImageBufIdOrConst	Specifies the constant required for the second operand. Note that the constant is cast to the same type as the buffer specified for the first operand. (summarize) Specifies the constant required for the second operand. (more details...)
	Src3ImageBufIdOrConst	Specifies the constant required for the third operand. Note that the constant is cast to the same type as the buffer specified for the first operand. (summarize) Specifies the constant required for the third operand. (more details...)
	Src4Const	Specifies the constant required for the fourth operand; this constant must be a power of 2.
M_MULTIPLY_ACCUMULATE_2 +		Performs a point-to-point multiply and accumulate 2 operation using the equation that follows. (summarize) Performs a point-to-point multiply and accumulate 2 operation using the equation that follows. (more details...)
	Src1ImageBufId	Specifies the image buffer identifier required for the first operand. (summarize) Specifies the image buffer identifier required for the first operand. (more details...)
	Src2ImageBufIdOrConst	Specifies the constant required for the second operand. Note that the constant is cast to the same type as the buffer specified for the first operand. (summarize) Specifies the constant required for the second operand. (more details...)
	Src3ImageBufIdOrConst	Specifies the image buffer identifier required for the third operand. Note that the image buffer's data type must either match that of the first operand, or it must be of type M_FLOAT. (summarize) Specifies the image buffer identifier required for the third operand. (more details...)
	Src4Const	Specifies the constant required for the fourth operand. Note that the constant is cast to the same type as the buffer specified for the third operand. (summarize) Specifies the constant required for the fourth operand. (more details...)
	Src5Const	Specifies the constant required for the fifth operand; this constant must be a power of 2.
M_OFFSET_GAIN +		Performs a per-pixel gain and offset correction operation using the equation that follows. (summarize) Performs a per-pixel gain and offset correction operation using the equation that follows. (more details...)
	Src1ImageBufId	Specifies the image buffer identifier required for the first operand. (summarize) Specifies the image buffer identifier required for the first operand. (more details...)
	Src2ImageBufIdOrConst	Specifies the image buffer identifier required for the second operand. (summarize) Specifies the image buffer identifier required for the second operand. (more details...)
	Src3ImageBufIdOrConst	Specifies the image buffer identifier required for the third operand. (summarize) Specifies the image buffer identifier required for the third operand. (more details...)
	Src4Const	Specifies the constant required for the fourth operand; this constant must be a power of 2.
M_WEIGHTED_AVERAGE +		Performs a weighted average operation using the equation that follows. (summarize) Performs a weighted average operation using the equation that follows. (more details...)
	Src1ImageBufId	Specifies the image buffer identifier required for the first operand. (summarize) Specifies the image buffer identifier required for the first operand. (more details...)
	Src2ImageBufIdOrConst	Specifies the constant required for the second operand; this constant must be a power of 2.
	Src3ImageBufIdOrConst	Specifies the image buffer identifier required for the third operand. Note that the image buffer's data type must either match that of the first operand, or it must be of type M_FLOAT. (summarize) Specifies the image buffer identifier required for the third operand. (more details...)

Combination value for the values listed in For the Operation, Src1ImageBufId, Src2ImageBufId, Src3ImageBufId, Src4ImageBufId, and Src5ImageBufId parameters.

You can add the following value to the above-mentioned values to specify that the operation result should be saturated if necessary.

For the Operation parameter
Combination value	Description
M_SATURATION	Forces the operation to saturate any resulting pixel values that overflow or underflow the possible range of the destination buffer. The pixel values are clipped to fit within the buffer's range, rather than wrapped around the range. If you do not specify M_SATURATION and there is an overflow or underflow, the resulting pixel values are either clipped (saturated) or wrapped around the buffer's range (not saturated), depending on which is faster for your hardware. (summarize) Forces the operation to saturate any resulting pixel values that overflow or underflow the possible range of the destination buffer. (more details...)

Remark

Optimized in-place processing is supported (source equals destination), but the source and destination image buffers cannot partially overlap (a situation that can only occur when using child buffers).

Compilation information

Header	Include mil.h.
Library	Use mil.lib; milim.lib.
DLL	Requires mil.dll; milim.dll.

PROC VECTOR MULTIPLY ACCUMULATE 1 PROC VECTOR MULTIPLY ACCUMULATE 2 PROC VECTOR FLOAT PROC VECTOR OFFSET GAIN PROC VECTOR PROC VECTOR PROC VECTOR WEIGHTED AVERAGE PROC VECTOR FLOAT PROC VECTOR SATURATION