National Instruments NI-IMAQdx - Manuals

Contents © National Instruments Corporation vii NI-IMAQdx User Manual Chapter 5Using NI-IMAQdx in C and .NET Using NI-IMAQdx for C ............................................................................................... 5-1Using NI-IMAQdx for Microsoft Visual Studio .NET.........................

© National Instruments Corporation 1-1 NI-IMAQdx User Manual 1 Introduction to NI-IMAQdx This chapter describes the NI-IMAQdx driver software, lists the supported application development environments (ADEs), describes the fundamentals of creating applications using NI-IMAQdx, describes the files use...

Chapter 1 Introduction to NI-IMAQdx NI-IMAQdx User Manual 1-2 ni.com Application Development Environments This release of NI-IMAQdx supports the following ADEs for Windows Vista/XP/2000: • LabVIEW version 7.1.1 and later • LabVIEW Real-Time Module version 7.1.1 and later • LabWindows ™ /CVI ™ versio...

Chapter 1 Introduction to NI-IMAQdx © National Instruments Corporation 1-3 NI-IMAQdx User Manual Fundamentals of Building Applications with NI-IMAQdx Architecture Figure 1-1 illustrates the NI-IMAQdx driver architecture. Figure 1-1. NI-IMAQdx Architecture The architecture uses a hardware abstraction...

Chapter 1 Introduction to NI-IMAQdx NI-IMAQdx User Manual 1-4 ni.com NI-IMAQdx Libraries The NI-IMAQdx function libraries are dynamic link libraries (DLLs), which means that NI-IMAQdx routines are not linked into the executable files of applications. Only the information about the NI-IMAQdx routines...

© National Instruments Corporation 2-1 NI-IMAQdx User Manual 2 Basic Acquisition with NI-IMAQdx This chapter contains an overview of the NI-IMAQdx library, a description of the acquisition flow of NI-IMAQdx, and generic programming examples. The chapter also contains flowcharts of high-level and low...

Chapter 2 Basic Acquisition with NI-IMAQdx NI-IMAQdx User Manual 2-2 ni.com Both high-level and low-level functions support snap, grab, sequence, and triggered acquisitions. Using high-level functions, you can write programs quickly without having to learn the details of the low-level API and driver...

Chapter 2 Basic Acquisition with NI-IMAQdx © National Instruments Corporation 2-3 NI-IMAQdx User Manual Camera Name NI-IMAQdx references all camera sessions by a name. The driver creates default names for each camera in your system in the order that the cameras are connected. The names observe the c...

Chapter 2 Basic Acquisition with NI-IMAQdx NI-IMAQdx User Manual 2-4 ni.com When you open a camera session with the Camera Open function, the camera with the unique serial number described by the interface file cam n.iid opens, where n is the reference to the camera. If the camera is not present and...

Chapter 2 Basic Acquisition with NI-IMAQdx © National Instruments Corporation 2-5 NI-IMAQdx User Manual acquisition. National Instruments recommends one-shot acquisition for applications that do not require real-time acquisition or processing. Use a continuous acquisition to start an acquisition, co...

Chapter 2 Basic Acquisition with NI-IMAQdx NI-IMAQdx User Manual 2-6 ni.com transferred from the camera to system memory. In all video modes, the ROI specifies the amount of data decoded by the driver while acquiring into a user buffer. By default, the driver transfers the entire image. Specify a sm...

Chapter 2 Basic Acquisition with NI-IMAQdx © National Instruments Corporation 2-7 NI-IMAQdx User Manual Buffer Number Mode Specify one of the following options for the buffer number mode. • Buffer Number—Gets the exact buffer number specified in the Buffer Number parameter. • Last—Gets the most rece...

Chapter 2 Basic Acquisition with NI-IMAQdx NI-IMAQdx User Manual 2-8 ni.com The default overwrite mode for all types of acquisition is to get the newest valid buffer. This option, which National Instruments recommends for most applications, enables you to process the most recent image. If you need t...

Chapter 2 Basic Acquisition with NI-IMAQdx © National Instruments Corporation 2-9 NI-IMAQdx User Manual Decoding images requires CPU resources. However, many of the decoding algorithms have been optimized in the driver. If you do not want decoded image data, you can use NI-IMAQdx to get a copy of th...

Chapter 2 Basic Acquisition with NI-IMAQdx NI-IMAQdx User Manual 2-10 ni.com Note If you do not have a valid session, a temporary session is created using cam0 . Then, the snap acquires the next incoming image into a user buffer. After the image is acquired, the program calls image processing and an...

Chapter 2 Basic Acquisition with NI-IMAQdx © National Instruments Corporation 2-11 NI-IMAQdx User Manual Calling the Configure Grab function opens a session for a grab acquisition. During acquisition, each successive grab copies the last acquired internal buffer into a user buffer where you can proc...

Chapter 2 Basic Acquisition with NI-IMAQdx NI-IMAQdx User Manual 2-12 ni.com Snap The low-level snap examples set up a one-shot, single-image acquisition and start the acquisition. The program acquires an image and processes it. Finally, the program stops the acquisition, unconfigures the acquisitio...

© National Instruments Corporation 3-1 NI-IMAQdx User Manual 3 Advanced Programming with NI-IMAQdx This chapter contains information about setting camera attributes, broadcasting acquired images to multiple machines, using scale to define the size of transferred images, and triggering. Camera Attrib...

Chapter 3 Advanced Programming with NI-IMAQdx NI-IMAQdx User Manual 3-2 ni.com Attribute Type The attribute type determines how a camera attribute is stored in the driver and the camera. Use the Get Attribute Type function to query the type of a given attribute. Each attribute is represented as one ...

Chapter 3 Advanced Programming with NI-IMAQdx © National Instruments Corporation 3-3 NI-IMAQdx User Manual The following value types are compatible for any given attribute type. The bolded compatible value type indicates the native value type. For example, use a 32-bit unsigned integer value type wh...

Chapter 3 Advanced Programming with NI-IMAQdx © National Instruments Corporation 3-5 NI-IMAQdx User Manual Figure 3-1. One Camera Broadcasting to Multiple Host Computers The camera broadcasts video data on the camera bus and all the connected host computers receive the same image data. In this scena...

Chapter 3 Advanced Programming with NI-IMAQdx NI-IMAQdx User Manual 3-6 ni.com For GigE Vision cameras, you can configure the camera to broadcast or multicast image data to all nodes on the network. Broadcast is not routable, and everyone on the same network sees the data, even if they are not liste...

Chapter 3 Advanced Programming with NI-IMAQdx © National Instruments Corporation 3-7 NI-IMAQdx User Manual The Increment values are camera-specific. Refer to the camera documentation or query the Increment attributes for width and height to obtain the actual values. Figure 3-2. Partial Image Size Fo...

Chapter 3 Advanced Programming with NI-IMAQdx NI-IMAQdx User Manual 3-8 ni.com • TriggerParameter —Certain trigger modes require an additional parameter. Refer to the following sections to see if the optional parameter is required. Trigger Mode 0 With trigger mode 0, the camera starts frame integrat...

Chapter 3 Advanced Programming with NI-IMAQdx © National Instruments Corporation 3-9 NI-IMAQdx User Manual Trigger Mode 2 With trigger mode 2, the camera starts frame integration when the external trigger input changes to an active value. The same frame is exposed for multiple triggers. The number o...

Chapter 3 Advanced Programming with NI-IMAQdx NI-IMAQdx User Manual 3-10 ni.com Trigger Mode 4 With trigger mode 4, the camera starts frame integration when the external trigger input changes to an active value. Multiple frames are exposed before the camera transfers the image to the host computer. ...

Chapter 3 Advanced Programming with NI-IMAQdx © National Instruments Corporation 3-11 NI-IMAQdx User Manual Trigger Modes for GigE Vision Cameras Note All triggering modes and parameters for GigE Vision cameras are subject to camera vendor implementation. Refer to your camera documentation for trigg...

© National Instruments Corporation 4-1 NI-IMAQdx User Manual 4 Using NI-IMAQdx in LabVIEW This chapter describes how to use NI-IMAQdx VIs in LabVIEW. Introduction The NI-IMAQdx VI library—part of the NI-IMAQdx software—is a group of virtual instruments (VIs) that enable you to use LabVIEW with your ...

Chapter 4 Using NI-IMAQdx in LabVIEW © National Instruments Corporation 4-2 NI-IMAQdx User Manual The Vision and Motion»NI-IMAQdx»NI-IMAQdx Low Level palette contains VIs for more advanced applications. Refer to the NI-IMAQdx VI Reference Help for more information about using these VIs. Common VI Pa...

Chapter 4 Using NI-IMAQdx in LabVIEW NI-IMAQdx User Manual 4-3 ni.com Acquisition VIs Two types of acquisition VIs are available in LabVIEW: high-level and low-level. High-Level Use the high-level acquisition VIs for basic image acquisition applications. VIs are included for snap, grab, and sequence...

Chapter 4 Using NI-IMAQdx in LabVIEW © National Instruments Corporation 4-6 NI-IMAQdx User Manual Figure 4-4 shows a simplified block diagram for using IMAQdx Configure Grab and IMAQdx Grab. Figure 4-4. Acquiring Images Using Grab Sequence Use the IMAQdx Sequence VI for sequence applications. IMAQdx...

Chapter 4 Using NI-IMAQdx in LabVIEW NI-IMAQdx User Manual 4-7 ni.com Image Display Many image acquisition applications require that one or more images be displayed. You have several options for displaying images in LabVIEW. You can display an image directly on the front panel using an Image Display...

Chapter 4 Using NI-IMAQdx in LabVIEW © National Instruments Corporation 4-8 NI-IMAQdx User Manual If you have LabVIEW RT, you can use IMAQ RT Video Out, located at Vision and Motion»Vision Utilities»IMAQ RT , to display an image on the monitor connected to your RT device. Use IMAQ Video Out Display ...

Chapter 4 Using NI-IMAQdx in LabVIEW NI-IMAQdx User Manual 4-9 ni.com Figure 4-9 shows how to set camera attributes with the property nodes in NI-IMAQdx. Figure 4-9. Setting Camera Attributes with Property Nodes Error Handling Every NI-IMAQdx VI contains an error in input cluster and an error out ou...

Chapter 4 Using NI-IMAQdx in LabVIEW © National Instruments Corporation 4-10 NI-IMAQdx User Manual You can use the Simple Error Handler VI, located on the Functions» Dialog & User Interface palette, to check for errors that occur while executing a VI. If you wire an error cluster to the Simple E...

© National Instruments Corporation 5-1 NI-IMAQdx User Manual 5 Using NI-IMAQdx in C and .NET This chapter briefly describes how to use NI-IMAQdx functions in Microsoft Visual C and Microsoft Visual Studio .NET. Using NI-IMAQdx for C This section outlines the process for developing NI-IMAQdx applicat...

Chapter 5 Using NI-IMAQdx in C and .NET © National Instruments Corporation 5-2 NI-IMAQdx User Manual You can use the additional Image functions installed with NI-IMAQdx. These functions use the NI Vision memory management feature, which automatically allocates the memory for your image. To use these...

Chapter 5 Using NI-IMAQdx in C and .NET NI-IMAQdx User Manual 5-3 ni.com 4. Select Tools»Add/Remove Toolbox Items . 5. Under the .NET Framework Components tab, select the CWIMAQViewer control. When the Viewer control is in the toolbox, you can add it to your forms by clicking on the tool and drawing...

© National Instruments Corporation A-1 NI-IMAQdx User Manual A Register-Level Programming This appendix explains how to access and program register locations using the NI-IMAQdx software, and discusses the caveats involved in programming registers. Introduction All cameras communicate to the host co...

Appendix A Register-Level Programming © National Instruments Corporation A-3 NI-IMAQdx User Manual The NI-IMAQdx software provides the following register-level primitives: • Read Register—Reads 32-bits of data from a specified memory location • Write Register—Writes 32-bits of data to a specified me...

Appendix A Register-Level Programming NI-IMAQdx User Manual A-4 ni.com Advanced Example The advanced feature described in this example is specific to Basler IEEE 1394 cameras. The advanced feature replaces the live video feed with a static test pattern. According to the user documentation for the Ba...

Appendix A Register-Level Programming © National Instruments Corporation A-5 NI-IMAQdx User Manual endian data. To correct for this discrepancy, NI-IMAQdx byte-swaps every quadlet that is read or written with low-level register primitives. Byte Array Many cameras allow register-level access to more ...

© National Instruments Corporation B-1 NI-IMAQdx User Manual B Technical Support and Professional Services Visit the following sections of the National Instruments Web site at ni.com for technical support and professional services: • Support —Online technical support resources at ni.com/support incl...

© National Instruments Corporation I-1 NI-IMAQdx User Manual Index A advanced programming examples grab using low-level functions, 2-13sequence using low-level functions, 2-14snap using low-level functions, 2-12 application development, 1-3 C, 5-1environments, 1-2LabVIEW, 4-1LabVIEW Real-Time Module...