Acquire Input Data VI

Owning Palette: Input Device Control VIs

Requires: Base Development System (Linux, Windows)

Returns data about the device connected to the computer. Wire data to the device ID input to determine the polymorphic instance to use or manually select the instance.

(Windows) You must have DirectX 8.0 or later to use this VI.

Example

Use the pull-down menu to select an instance of this VI.

Select an instance joystickAcquirekeyboardAcquiremouseAcquire

Add to the block diagram

Find on the palette

joystickAcquire

	device ID identifies which device to acquire data from.
	error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
	device ID identifies which device you acquired data from.
	axis info contains numeric values for the axes. The number of axes depend on the specific joystick. When you use this VI on a myRIO target, the value of axis info is the raw data value this VI acquires from the joystick. X axis is the numeric value of the x-axis. Y axis is the numeric value of the y-axis. Z axis is the numeric value of the z-axis. X axis rotation is the numeric value of the x-axis rotation. Y axis rotation is the numeric value of the y-axis rotation. Z axis rotation is the numeric value of the z-axis rotation (rudder). U axis is the numeric value of the u-axis. V axis is the numeric value for the v-axis.
	button info contains Boolean values for up to 32 buttons. A TRUE value indicates that the button was pressed when the VI ran.
	direction info contains numeric values for up to four points of view.
	error out contains error information. This output provides standard error out functionality.

keyboardAcquire

	device ID identifies which device to acquire data from.
	error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
	device ID identifies which device you acquired data from.
	keys pressed indicates which keys were pressed when the VI ran. This parameter returns values associated only with US keyboards.
	error out contains error information. This output provides standard error out functionality.

mouseAcquire

	device ID identifies which device to acquire data from.
	key mode determines the key mode to use. 0 Relative—Defines the mouse coordinates as relative to the last time you called the VI. 1 Absolute—Defines the mouse coordinates (axis info) as absolute coordinates relative to the upper left hand corner of the screen.
	error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
	device ID identifies which device you acquired data from.
	axis info contains the numeric value for axes. Horizontal is the numeric value of the horizontal axis. Vertical is the numeric value of the vertical axis. Scrolling is the numeric value of the scrolling axis if the mouse supports it.
	button info contains Boolean values for up to four buttons. A TRUE value indicates that the button was pressed when the VI ran.
	error out contains error information. This output provides standard error out functionality.

Example

Refer to the Monitoring Keyboard and Mouse Activity VI in the labview\examples\Connectivity\Input Device Control directory for an example of using the Acquire Input Data VI.

 Open example  Find related examples