Acquire Image (IEEE 1394 or GigE) Controls

NI Vision Builder

Acquire Images Tab

Acquire Image (IEEE 1394 or GigE) Controls

The following controls are available on all tabs.

Control Name Description
Acquires and displays a single image from an IEEE 1394 or Gigabit Ethernet (GigE) camera. When you click this button, the step acquires and displays the next image provided by the camera. If the camera is in a triggered mode, the step waits for the next trigger signal to acquire and display an image.
Performs a continuous acquisition, or a triggered grab if the camera is in a triggered mode, and displays the image. When you click this button, the step starts the continuous acquisition and display of images. If the camera is in a triggered mode, 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.
Refreshes the Devices list on the Main tab.

Main Tab

The following controls are available on the Main tab.

Control Name Description
Step Name Name to give the step.
Devices List of image acquisition devices installed on the computer and associated with the NI-IMAQdx driver software. Use Measurement & Automation Explorer (MAX) to associate the camera with the NI-IMAQdx driver software if the camera does not appear in the list.
IEEE 1394 Video Mode Displays a list of available video modes for the IEEE 1394 camera currently selected in Devices.
Camera Control Mode Displays a list of available control modes for the GigE camera currently selected in Devices. The following options are available:
  • Controller: Only this machine receives images—Allows Vision Builder AI to control the camera and no other computers or remote targets can access images from the camera. The Destination Mode camera attribute is set to Unicast.
  • Controller: Multiple machines receive images—Allows Vision Builder AI to control the camera and other computers or remote targets can access images from the camera. The Destination Mode camera attribute is set to Multicast. The Destination Mode attribute can also be set to Broadcast.
  • Listener: Only receive images from camera—Allows Vision Builder AI to access images from a camera that is already acquiring in broadcast or multicast mode. You can not change the camera acquisition settings while in Listener mode.
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.

Attributes Tab

The following controls are available on the Attributes tab.

Control Name Description
Show All Attributes When enabled, all of the attributes available on the selected camera are displayed in the Attribute tree, including attributes that cannot be configured.
Show Attribute Help When enabled, information about the selected attribute is displayed. The attribute descriptions are returned by the camera and are camera-specific.
Attribute List of the attributes for the selected camera.
Attribute Help Displays information about the selected attribute returned by the camera.
Value Specifies the value for the currently selected attribute.
Reset to Defaults Resets all of the attributes to the default values configured in MAX.