Acquire Image Controls

NI Vision Builder

Acquire Images Tab

Acquire Image Controls

The following controls are available on all tabs.

Control Name Description
Acquires and displays a single image from the selected National Instruments image acquisition device. When you click this button, the step acquires and displays the next image provided by the camera. If you enabled the Triggered Acquisition control in the Trigger tab, the step waits for the next trigger signal to acquire and display an image.
Performs a continuous acquisition, or a triggered grab if Triggered Acquisition is enabled, and displays the image. When you click this button, the step starts the continuous acquisition and display of images. If you enabled the Triggered Acquisition control in the Trigger tab, the step waits for the next trigger signal to acquire and display a new image for each iteration. Click this button a second time to stop the continuous image acquisition.

Main Tab

The following controls are available on the Main tab.

Control Name Description
Step Name Name to give the step.
Devices Displays the available NI devices and channels you can use to acquire an image.
Acquisition Mode Specifies whether the step returns the image currently being acquired or the last completely acquired image.
  • Wait for Next Image—Waits for the next available image before transferring an image.
  • Immediate—Immediately transfers the current image if it is newer than the image that was last acquired.
Tip  Set the Acquisition Mode control to Immediate when you want to acquire from multiple cameras triggered simultaneously. The first acquisition step acquiring from camera 1 synchronizes the inspection by waiting for the next trigger signal. In subsequent acquisition steps, set the Acquisition Mode control to Immediate so that the images acquired by other cameras on the same trigger as camera 1 are transferred immediately.

Image Trigger Tab

The following controls are available on the Image Trigger tab.

Control Name Description
Triggered Acquisition When enabled, you can synchronize image acquisition with events external to the computer, such as receiving a pulse from a sensor that indicates the position of an item on an assembly line. The trigger signal must be connected to a trigger input of the NI device.
Trigger Line Specifies which external trigger line receives the incoming trigger signal.
Polarity Specifies whether to start the acquisition of a new image on the rising or falling edge of the trigger signal.
Timeout (ms) Amount of time to wait for the trigger signal before returning a timeout error.
Variable Height Acquisition When enabled, the height of the acquisition is based on the duration of the trigger line assertion. This control is only available for line scan cameras.

Line Trigger Tab

The following controls are available on the Line Trigger tab.

Note Note  The Line Trigger tab is only available for line scan cameras.
Control Name Description
Triggered Acquisition When enabled, you can synchronize line acquisition with events external to the computer, such as receiving a pulse from a quadrature encoder that indicates the position of an item on an assembly line.
Trigger Line Specifies which external trigger line receives the incoming trigger signal.
Polarity Specifies whether to start the acquisition of a new line on the rising or falling edge of the trigger signal.
Skip Trigger Specifies the number of trigger signals to skip before acquiring a line.