MfpgaSetSource

User Guide:

Source and destination image buffers Steps to develop a function that performs an operation using a Processing FPGA

Reference:

MbufAlloc1d MbufAllocColor MfpgaSetLink MfuncInquire

Available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Not supported on:

Host system

Matrox CronosPlus

Matrox GPU processing driver

Matrox GigE Vision driver

Matrox IEEE 1394 IIDC driver

Matrox Iris GT

Matrox Morphis

Matrox Morphis QxT

Matrox Orion HD

Matrox USB3 Vision driver (requires Update 19)

Matrox Vio

Partially supported on:

Matrox Solios eA/XA

Matrox Solios ecl/xcl/ev-cl

Fully supported on:

Matrox Radient eCL

Matrox Radient eV-CXP

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

Available on Matrox Supersight

Function Map

- SrcBuf

Table:

For specifying the rank of the stream input port

- ControlFlag

Compilation information

fdkaddconstantprimitive.cpp
fdkhistogramprimitive.cpp
fdklutmapprimitive.cpp
fdkminmaxprimitive.cpp
fdkoffsetgainlutmapprimitive.cpp
fdkoffsetgainminmaxprimitive.cpp
fdkoffsetgainprimitive.cpp

MfpgaSetRegister

Synopsis

Specify a source buffer for the FPGA processing operation.

Syntax

void MfpgaSetSource(

MIL_FPGA_CONTEXT FpgaCommandContext,	//in
MIL_BUFFER_INFO SrcBuf,	//in
MIL_INT StreamInputNumber,	//in
MIL_INT64 ControlFlag	//in

)

Description

This function specifies a source buffer for the FPGA processing operation. Data from the specified buffer is routed to the specified stream input port of the PU associated with the specified FPGA command context. To obtain the data from another PU, refer to MfpgaSetLink().

All PUs have documented limitations on the types of buffers from which their stream input port(s) can receive data. You must keep these limitations in mind when allocating your source MIL buffer(s). This function will not automatically convert the buffers so that they are appropriate for the operation. For more information, refer to the PU documentation available in the Matrox FPGA Component Reference help file.

Note that in general, child buffers are not supported; only color-band child buffers are supported.

[Matrox Solios eA/XA; Matrox Solios ecl/xcl/ev-cl]

When allocating source buffers on Matrox Solios, special care should be taken regarding the buffer width. The width of buffers allocated in acquisition memory must be a multiple of 64 bytes.

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

FpgaCommandContext

Specifies the handle of the FPGA command context associated with the PU.

SrcBuf

Specifies the handle of the source buffer. Use MfuncInquire() with M_BUFFER_INFO to get the handle. The source buffer can only reside in on-board memory. If allocated on-board, the source buffer must be allocated in on-board, Processing FPGA accessible memory (using MbufAlloc...() with M_FPGA_ACCESSIBLE).

StreamInputNumber

Specifies the stream input port to which to route data from the source buffer. You must set this parameter to the following value:

For specifying the rank of the stream input port
Value	Description	MIL system-specific tooltip (†)
M_INPUTn	Specifies the rank of the stream input port. You can set n to a value between 0 and 9, inclusive. (summarize) Specifies the rank of the stream input port. (more details...)	†	j	k	l	m	p	q	r