You are here: Start » Function Reference » MATRIX VISION » mvGenTLAcquire_SetDigitalOutput

mvGenTLAcquire_SetDigitalOutput

Header:	ThirdPartySdk.h
Namespace:	fil

Sets matrix vision camera digital outputs.

Syntax

void fil::mvGenTLAcquire_SetDigitalOutput
(
	mvGenTLAcquireState& ioState,
	ftl::Optional<const ftl::String&> inDeviceID,
	int inOutput,
	bool inValue
)

Parameters

Name	Type	Default	Description
ioState	mvGenTLAcquireState&		Object used to maintain state of the function.
inDeviceID	Optional<const String&>	NIL	Device name or serial number of device
inOutput	int		Index of output line
inValue	bool		Logic value of digital output

Remarks

Camera driver software

This filter is intended to cooperate with a camera using its vendor SDK. To be able to connect to a camera, it is required to install mvGenTL Acquire SDK software with camera dedicated drivers.

mvGenTL Acquire SDK software can be downloaded from the following website: www.matrix-vision.com. For FabImage Studio 32-bit, mvGenTL Acquire x86 version is needed. For FabImage Studio 64-bit, mvGenTL Acquire x86_x64 version of SDK is required.

Recommended mvGenTL Acquire SDK version for usage with FabImage Studio is 2.36.0.

Camera identification

When there is only one camera connected to the computer, field inDeviceID can be set to Auto. In such case, first available camera will be found and connected.

inDeviceID can be used to pick one of multiple cameras connected to the computer. inDeviceID can be set to:

serial number - it should be specified on the device casing(e.g. GX001559),
product name - it finds camera by name (might be the same for many cameras). The product name is a bit more specific than the family name, but less specific than the serial number(e.g. mvBlueCOUGAR-X100wG),
product number - it finds camera by family name(e.g. mvBlueCOUGAR).

Multithreaded environment

This function is not guaranteed to be thread-safe. When used in multithreaded environment, it has to be manually synchronized.