Back to Aurora Vision Library website

You are here: Start » Function Reference » GigE Vision » AvsFilter_GigEVision_SetDigitalOutputs

AvsFilter_GigEVision_SetDigitalOutputs


This is Filter Equivalent. This function may be present in generated code, but should not be used in hand-written code.

Header: Genicam.h
Namespace: avs
Module: Genicam

Sets user digital outputs state of GigEVision device.

Syntax

void avs::AvsFilter_GigEVision_SetDigitalOutputs
(
	GigEVision_SetDigitalOutputs_State& ioState,
	const avl::GevAddress& inAddress,
	bool inOutput1,
	bool inOutput2,
	bool inOutput3,
	bool inOutput4
)

Parameters

Name Type Default Description
Input will be modified ioState GigEVision_SetDigitalOutputs_State& Object used to maintain state of the function.
Input value inAddress const GevAddress& GigE Vision Device identifying address (IP, MAC or Serial Number)
Input value inOutput1 bool State of user digital output 1
Input value inOutput2 bool State of user digital output 2
Input value inOutput3 bool State of user digital output 3
Input value inOutput4 bool State of user digital output 4

Description

This filter is intended for cooperation with GigE Vision® compliant devices. Its purpose is to set state of device hardware digital outputs.

Device address (inAddress port) is a textual definition of either IP, MAC or serial number. Use Device Manager to select appropriate address of connected device.

This filter will interpret the value of inAddress port only during the first iteration, when the connection to the device is established. During the next iterations the filter will use previously established connection and subsequent changes in the device address will be ignored.

This filter is specialized form of parameter set filters (it is also possible to set output with GigEVision_SetEnumParameter and GigEVision_SetBoolParameter filters). Filter depends on standard "UserOutputValueAll" parameter defined by GenICam standard. When device is not supporting this parameter filter execution will fail.

User outputs may require additional configuration before usage. Usually outputs have multiple possible signal sources, like capture triggers, timers or required for this filter - user output. Refer to device documentation for information about device outputs configuration.

Filter is prepared to set state of up to four different user outputs. Each filter input parameter of type bool will be transferred to its output state. Note that device can be configured to negate this state.

This filter does not require other GigE Vision® filters in program (especially GigEVision_GrabImage is not obligatory), but can be used in any combination with them, including sharing access to single device with other filters. Device also does not have to be a transmitter.

For general information about working with GigE Vision devices, please refer to the following article.

To learn more about camera acquisition thread works please go to this article.