National Instruments IEEE 1394 manual

IMAQ TM NI-IMAQ TM for IEEE 1394 Came ras User Manual Image Acquisition Software NI-IMAQ for IEEE 1394 Cameras User Manual Mar ch 2005 370362C-01[...]

Support Worldwide Technical Support and Product Info rmation ni.com National Instruments Corporate Headquarters 11500 North Mopac Expressway Aust in, Texas 78759-3504 USA Tel: 512 683 0100 Worldwide Offices Australia 1800 300 800, Austria 43 0 662 45 79 90 0, Belgium 32 0 2 757 00 20, Brazil 55 11 3262 3599, Canada 800 433 3488, China 86 21 6555 78[...]

Important Information Warranty The media on which you receive Natio nal In struments software are warranted not t o fail to execute pr ogramming instructions, due to defects in materials and workmanship, for a period of 90 days from date of shipment, as eviden ced by receipt s or other documentation. N ational Instruments will , at its option, repa[...]

Conventions The follo wing con v entions are used in this manual: » The » symbol leads you through nested menu items and dial og box options to a final action. The sequence File»Page Setup»Options directs you t o pull down the File menu, select the Page Setup item, and select Options from the last dialog box. This icon denotes a n ote, which al[...]

© National Instruments Corporation v NI-I MAQ for IEEE 1394 Cameras User Manual Contents Chapter 1 Introduction to NI-IMA Q for IEEE 1394 Cameras About the NI-IMAQ Software ............ .............. ........... ............... .............. ........... .......... 1-1 Application Development Environments ...... ...... ........... ............ ..[...]

Contents NI-IMAQ for IEEE 1394 Cameras User Manual vi ni.com Chapter 3 Advanced Programming with NI -IMAQ for IEEE 1394 Cameras Camera Attributes ............... .............. ............ .............. ........... .............. ............ .............. 3-1 Broadcasting ............ ........... .............. ............ ........... ........[...]

Contents © National Instruments Corporation vii NI-I MAQ for IEEE 1394 Cameras User Manual Appendix A Register-Level Programming Appendix B Technical Support and Professional Services Glossary Index[...]

© National Instruments Corporation 1-1 NI-I MAQ for IEEE 1394 Cameras User Manual 1 Introduction to NI-IMAQ for IEEE 1394 Cameras This chapter describes the NI-IMA Q for IEEE 1394 Cameras software, lists the supported application development env ironments (ADEs), describes the fundamentals of crea ting applications using NI-IMAQ for IEEE 1394 Came[...]

Chapter 1 Introduction to NI-IMAQ for IE EE 1394 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manual 1-2 ni.com Application Development Environments This release of NI-IMAQ for IEEE 1 394 Cameras support s the following ADEs for Windows 2000/XP: • LabVIEW version 7.0 and later • LabVIEW Real-Time Module v ersion 7.0 and later • LabW indo ws ?[...]

Chapter 1 Introduction to NI-IMAQ for IEEE 1394 Cameras © National Instruments Corporation 1-3 NI-I MAQ for IEEE 1394 Cameras User Manual Figure 1-1. NI-IMAQ for IEEE 1394 Cameras Architecture The architecture uses a hardware abstraction layer , which separates software API capabilities, such as general acquisition an d control functions, from har[...]

Chapter 1 Introduction to NI-IMAQ for IE EE 1394 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manual 1-4 ni.com information through im port libraries or through fun ction declarations. Y our NI-IMA Q for IEEE 1394 Cameras software contains function prototypes for all routines. Example Programs You can find NI-IMA Q for IEEE 1394 Cameras code example[...]

© National Instruments Corporation 2-1 NI-I MAQ for IEEE 1394 Cameras User Manual 2 Basic Acquisition with NI-IMAQ for IEEE 1394 Cameras This chapter contains an overvi ew of the NI-I MAQ for IEEE 1394 Cameras library, a description of the acquisitio n flow of NI-IMAQ for IEEE 1394 Cameras, and generic programming examples. The chapter also contai[...]

Chapter 2 Basic Acquisition with NI-IMAQ for IEEE 139 4 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manual 2-2 ni.com Both high-level and low-l evel functions supp ort snap, grab, seq uence, and triggered acquisitions. Using high -lev el functions, you can write programs quickly without havin g to learn the details of the low-leve l API and driver.[...]

Chapter 2 Basic Acquisition with NI-IMAQ fo r IEEE 1394 Cameras © National Instruments Corporation 2-3 NI-I MAQ for IEEE 1394 Cameras User Manual Every camera has an .iid interface f ile and an .icd camera fi le. • Interface f iles—Store information about which physical camera is associated with a camera name. Each interf ace fi le can be used[...]

Chapter 2 Basic Acquisition with NI-IMAQ for IEEE 139 4 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manual 2-4 ni.com file ope ns, and all the user attributes are set in the dri ver . If no camera of the same make and model is present, the Initialize function ret urns an error . Camera Control Mode The camera control mode param eter has two options[...]

Chapter 2 Basic Acquisition with NI-IMAQ fo r IEEE 1394 Cameras © National Instruments Corporation 2-5 NI-I MAQ for IEEE 1394 Cameras User Manual the camera and enables you to examine the most current buf fer . National Instruments recommends continuous acquisition for real-time acquisition and processing. Note If CPU acti vity increases during a [...]

Chapter 2 Basic Acquisition with NI-IMAQ for IEEE 139 4 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manual 2-6 ni.com Note Although you can specify an R OI of any size, the NI-IMA Q for IEEE 1394 Cameras software coerces the R OI into one that is mo re compatible for the given camera. Refer to Chapter 3, Advanced Programming with NI-IMAQ for IEEE 1[...]

Chapter 2 Basic Acquisition with NI-IMAQ fo r IEEE 1394 Cameras © National Instruments Corporation 2-7 NI-I MAQ for IEEE 1394 Cameras User Manual Overwrite Mode Ideally, a continuous acquisition acqui res and processes every image that is transferred from the camera. Ho wever, because of processing time fluctuations, some images from the cam era m[...]

Chapter 2 Basic Acquisition with NI-IMAQ for IEEE 139 4 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manual 2-8 ni.com T able 2 -2 lists common video modes and t heir corresponding im age types after being decoded by NI-IMA Q for IEEE 1394 Cameras. Decoding images requires CPU resources . Howe v er , man y of the decoding algorithms have been optimi[...]

Chapter 2 Basic Acquisition with NI-IMAQ fo r IEEE 1394 Cameras © National Instruments Corporation 2-9 NI-I MAQ for IEEE 1394 Cameras User Manual Snap A snap acquires a single image into a user buffer. Figure 2-2 illustrates the typical programming order of a high-level snap acquisi tion. Figure 2-2. High-Level Snap Flowchart Use a snap for lo w-s[...]

Chapter 2 Basic Acquisition with NI-IMAQ for IEEE 139 4 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manu al 2-10 ni.com Grab A grab initiates a continuous high-sp eed acquisition of images to one or more internal bu ffers. Figure 2- 3 illu strates the typical programm ing order of a high-level grab acquisition. Figure 2-3. High-Level Grab Flowchart[...]

Chapter 2 Basic Acquisition with NI-IMAQ fo r IEEE 1394 Cameras © National Instruments Corporation 2-11 NI- IMAQ for IEEE 1394 Cameras User Manual Sequence A sequence acquires a specified number of internal buffers and then stops. Figure 2-4 illustrates the typical programming order of a high-l evel sequence acquisition. Figure 2-4. High-Level Seq[...]

Chapter 2 Basic Acquisition with NI-IMAQ for IEEE 139 4 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manu al 2-12 ni.com Snap The low-level snap examples set up a one-shot, single-image acquisitio n and start the acquisition. The program acquires an image and processes it. Finally, the program stops the acquisi tion, unconfigures the acquisitio n, a[...]

Chapter 2 Basic Acquisition with NI-IMAQ fo r IEEE 1394 Cameras © National Instruments Corporation 2-13 NI- IMAQ for IEEE 1394 Cameras User Manual Grab The low-level grab examples dem onstrate how to perform a g rab acquisition using low-level functi on calls. The program sets up a continuous acquisition into three in tern al buffers and star ts t[...]

Chapter 2 Basic Acquisition with NI-IMAQ for IEEE 139 4 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manu al 2-14 ni.com Sequence The low-level sequence examples dem onstrate how to perform a sequence acquisition using low-level calls. The prog ram sets up a one-shot, multi-image acquisitio n and starts the acquisition. The main loop it erates once [...]

© National Instruments Corporation 3-1 NI-I MAQ for IEEE 1394 Cameras User Manual 3 Advanced Programming with NI-IMAQ for IEEE 1394 Cameras This chapter contains informatio n about setting camera attributes, broadcasting acquired images to multiple mach ines, using Format 7 to define the size of transfer red images, and triggering . Camera Attribu[...]

Chapter 3 Advanced Programming with NI-IMAQ for IEEE 1394 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manual 3-2 ni.com Figure 3-1. One Came ra Broadcasting to Multiple Host Computer s The IEEE 1394 camera broadcasts video data on the IEEE 1394 bus and all the connected host computers recei ve the same image data. In this scenario, one host compute[...]

Chapter 3 Advanced Programming with NI-I MAQ for IEEE 1394 Cameras © National Instruments Corporation 3-3 NI-I MAQ for IEEE 1394 Cameras User Manual Next, start the listener(s). On the listening computer , open your camera interface with the 64-bit unique identifi er of the tar get camera, which you can find in the General tab in MAX. The controll[...]

Chapter 3 Advanced Programming with NI-IMAQ for IEEE 1394 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manual 3-4 ni.com Figure 3-2. Partial Image Size Format (Format 7) T rigger Modes The IIDC 1.31 specification provides several external tri ggering modes for IEEE 1394 cameras. A IEEE 1394 camera may support one or more of the triggering modes. Ref[...]

Chapter 3 Advanced Programming with NI-I MAQ for IEEE 1394 Cameras © National Instruments Corporation 3-5 NI-I MAQ for IEEE 1394 Cameras User Manual T rigger Mode 0 With trigger mode 0, the camera starts frame integration when the external trigger input changes to an active value. The frame is exposed for a duration specified by the shutter attrib[...]

Chapter 3 Advanced Programming with NI-IMAQ for IEEE 1394 Cameras NI-IMAQ for IEEE 1 394 Cameras User Manual 3-6 ni.com T rigger Mode 2 With trigger mode 2, the camera starts frame integration when the external trigger input changes to an active va lue. The same frame is exposed for multiple triggers. The number of triggers is specified by the opti[...]

Chapter 3 Advanced Programming with NI-I MAQ for IEEE 1394 Cameras © National Instruments Corporation 3-7 NI-I MAQ for IEEE 1394 Cameras User Manual T rigger Mode 4 With trigger mode 4, the camera starts frame integration when the external trigger input changes to an active va lue. Multiple frames are exposed before the camera transfers the image [...]

© National Instruments Corporation 4-1 NI-I MAQ for IEEE 1394 Cameras User Manual 4 Using NI-IMAQ for IEEE 1394 Cameras in LabVIEW This chapter describes how to use NI-IMAQ for IEEE 1394 Cameras VIs in LabVIEW. Introduction The NI-IMAQ for IEE E 1394 Cameras VI library—part of the NI-IMAQ for IEEE 1394 Cameras soft ware—is a gr oup of virtual [...]

Chapter 4 Using NI-IMA Q for IEEE 1394 Cameras in La bVIEW NI-IMAQ for IEEE 1 394 Cameras User Manual 4-2 ni.com Location of the NI-IMAQ for IEEE 1394 Cameras VIs You can find the NI-IMAQ for IEEE 1394 Cameras VIs in the LabVIEW Functions palette. From the LabVIEW block diagram, select NI Measurements»Vision»IMAQ IEEE-1394 . The most commonly use[...]

Chapter 4 Using NI-IMA Q for IEEE 13 94 Cameras in La bVIEW © National Instruments Corporation 4-3 NI-I MAQ for IEEE 1394 Cameras User Manual Image Buffer Many acquisition VIs require an imag e buffer to receive the captured image. You can create this image buff er with IMAQ Create. Refer to the Buffer Management section of this chapter for more i[...]

Chapter 4 Using NI-IMA Q for IEEE 1394 Cameras in La bVIEW NI-IMAQ for IEEE 1 394 Cameras User Manual 4-4 ni.com 4. Call IMA Q1394 Get Image to obtain a copy of the requested image data. 5. After an acquisition, call IMA Q1394 Stop Acquisition to stop transferring data from the camera. 6. Call IMA Q13 94 Clear Acquisi tion to release the resources [...]

Chapter 4 Using NI-IMA Q for IEEE 13 94 Cameras in La bVIEW © National Instruments Corporation 4-5 NI-I MAQ for IEEE 1394 Cameras User Manual IMA Q D ispose, shown in Figure 4-2, frees the memory allocated for the image buf fer . Call this VI only after the image is no longer required fo r processing. Figure 4-2. IMAQ Dispose Acquisition T ypes Th[...]

Chapter 4 Using NI-IMA Q for IEEE 1394 Cameras in La bVIEW NI-IMAQ for IEEE 1 394 Cameras User Manual 4-6 ni.com Figure 4-4. Acquiring Images Using Grab Sequence Use the IMAQ1394 Sequence VI for sequence applications. IMAQ1394 Sequence starts, acquires, and releases a sequence acquisition. IMAQ1394 Sequence does not return until the entire sequence[...]

Chapter 4 Using NI-IMA Q for IEEE 13 94 Cameras in La bVIEW © National Instruments Corporation 4-7 NI-I MAQ for IEEE 1394 Cameras User Manual T riggering Often, you may need to link or coordina te a vision acti on or function with events external to the computer, su ch as receiving a strobe pulse for lighting or a pulse from an infrared de tector [...]

Chapter 4 Using NI-IMA Q for IEEE 1394 Cameras in La bVIEW NI-IMAQ for IEEE 1 394 Cameras User Manual 4-8 ni.com Figure 4-7. Displayi ng an Image Using an Image Control If you hav e IMA Q V ision fo r LabVIEW , you can display an im age in an external windo w using IMA Q WindDraw , located at Vision» Vision Utilities»External Display . Use IMAQ W[...]

Chapter 4 Using NI-IMA Q for IEEE 13 94 Cameras in La bVIEW © National Instruments Corporation 4-9 NI-I MAQ for IEEE 1394 Cameras User Manual Camera Attributes To modify camera attributes in La bVIEW, use the IMAQ1394 Property Node. Every camera attribute has th ree parameters: Attribute Key, Attribute Mode, and Attribute Value. • Attribute Key [...]

Chapter 4 Using NI-IMA Q for IEEE 1394 Cameras in La bVIEW NI-IMAQ for IEEE 1 394 Cameras User Manu al 4-10 ni.com Figure 4-11. Error Clusters Y ou can use the Simple Error Handler VI, located on the Functions» Time&Di alog palette, to check for errors th at occur while executing a VI. If you wire an error cluster to the Si mple Error Handle V[...]

© National Instruments Corporation 5-1 NI-I MAQ for IEEE 1394 Cameras User Manual 5 Using NI-IMAQ for IEEE 1394 Cameras in C and .NET This chapter briefly describes how to use NI-IMAQ for IEEE 1394 Cameras function in Microsoft Vi sual C and Microsoft V isual Studio .NET. Using NI-IMAQ for IEEE 1394 Cameras for C This section outlines the process [...]

Chapter 5 U sing NI-IMAQ for IEEE 1394 Cameras in C and .N ET NI-IMAQ for IEEE 1 394 Cameras User Manual 5-2 ni.com include files under the include subdirectory . The import l ibraries for Microsoft V isual C++ are located under the libmsvc subdirectory . If you hav e IMA Q V ision fo r LabW indo ws/CVI installed on your computer , you can use the[...]

Chapter 5 Using NI-IMAQ for IE EE 1394 Cameras in C and .NET © National Instruments Corporation 5-3 NI-I MAQ for IEEE 1394 Cameras User Manual If you need to display acquired images , you also must add an IMA Q V ision V iewer control to your toolbox and to your form. Complete the following steps to add the IMA Q V ision V ie wer control to the Mi[...]

© National Instruments Corporation A-1 NI-I MAQ for IEEE 1394 Cameras User Manual A Register -Level Programming This appendix explains ho w to access an d program re gister locations using the NI-IMA Q for IEEE 1394 Cameras so ftware, and discusses the ca veats in v olved in programming registers. Introduction All IEEE 1394 cameras communicate to [...]

Appendix A Register- Level Programming NI-IMAQ for IEEE 1394 Cameras User Manual A-2 ni.com Figure A-1. Explanation of Split T ransactions NI-IMA Q for IEEE 1394 Cameras 2.0 su pports the 1394 T rade Associa tion IIDC 1.31 register specif ication fo r industrial cameras. Most of the intricacies of re gister -le v el prog rammi ng are abstracted b y[...]

Appendix A Regist er -Level Progr amming © National Instruments Corporation A-3 NI-I MAQ for IEEE 1394 Cameras User Manual • Read Quadlet Block—Reads an arra y of quadlets from a specified memory location and range • Write Quadlet Block—Writ es an ar ray of quadlets to a specif ied memory location Note In LabVIEW , only the quadlet block v[...]

Appendix A Register- Level Programming NI-IMAQ for IEEE 1394 Cameras User Manual A-4 ni.com register (0x480). Add the specified of fset to the base register—0xF0F00000 for most IEEE 1394 cameras. 0xF0F00000 + 0x480 = 0xF0F00480 Read the v alue into storage. read quadlet (0xF0F00480) = <advanced_feature_i nq> where <advanced_fea ture_inq&[...]

Appendix A Regist er -Level Progr amming © National Instruments Corporation A-5 NI-I MAQ for IEEE 1394 Cameras User Manual Quadlet Array Many IEEE 1394 cameras allo w re gister-le v el access to more than 32 bits of data per communicatio n request. In most cases, you can safely write and read a large, contiguous block of data to and from the conne[...]

© National Instruments Corporation B-1 NI-I MAQ for IEEE 1394 Cameras User Manual B T echnical Support and Professional Ser vices Visit the following sections of the National Instruments Web site at ni.com for technical support an d professional services: • Support —Online technical support resources at ni.com/support include the following: ?[...]

© National Instruments Corporation G-1 NI-I MAQ for IEEE 1394 Cameras User Manual Glossar y A acquisition windo w The image size specif ic to a video standard or camera resolution. address V alue that identif ies a specif ic lo cation (or series of locations) in memory . API Application programming interface. area A rectangular portion of an acqui[...]

Glossary NI-IMAQ for IEEE 1 394 Cameras User Manual G-2 ni.com DLL Dynamic Link Library—A so ftware module in Microsoft W indo ws containing ex ecutable code and data that can be called or used by W indo ws applications or other DLLs; function s and data in a DLL are loaded and linked at run time when they are referenced by a W indows application[...]

Glossary © National Instruments Corporation G-3 NI-I MAQ for IEEE 1394 Cameras User Manual hue Represents the dominant color of a pixel. The hue function is a continuou s function that covers all the possible colors generated using the R, G, and B color spectrum. See also RGB . I I/O Input/Output—The transfer of data to/from a computer sy stem i[...]

Glossary NI-IMAQ for IEEE 1 394 Cameras User Manual G-4 ni.com P page-locked bu f fer Memory page that is marked as non-pagable by the virtual file system. Page-locked buffers remain in physical mem ory and do not cause page faults pixel Picture element. The smallest di vi sion that makes up the video scan line. For display on a computer mon itor ,[...]

Glossary © National Instruments Corporation G-5 NI-I MAQ for IEEE 1394 Cameras User Manual S sequence Performs an acquisiti on that acquires a specified number of b uf fers, then stops. snap Acquires a single image to a b uf fer . syntax Set of rules to which statements mu st conform in a particul ar programming language. T timeout Length of time,[...]

Glossary NI-IMAQ for IEEE 1 394 Cameras User Manual G-6 ni.com Y YUV A representation of a color image us ed for the coding of NTSC or P AL video signals. The lu ma information is called Y , while the chroma information is represented by two co mponents, U and V representing the coordinates in a color plane.[...]

© National Instruments Corporation I-1 NI-I MAQ for IEEE 1394 Cameras User Manual Index Symbols .NET programming languag e, 1-4, 3 -1, 5-1, 5-2, 5-3 A adv anced programming examples grab using low-le v el functions, 2-13 sequence using low-le v el functions, 2-14 snap using low-le v el functions, 2-12 application development, 1-2 .NET, 4-1, 5-2 C,[...]

Index NI-IMAQ for IEEE 1394 Cameras User Manual I-2 ni.com exa m pl e s advanced programming examples, 2-11 introductory programming examples, 2-8 location of files, 1-4 examples (NI resources), B-1 F features and ov ervie w, 1-1 Format 7 video mode, 2-5, 3-1, 3-3 figure, 3-4 front panel, LabVIEW, 4 -1, 4-7 G grab high-lev el, 2-1, 2-6, 2-10, 4-5 f[...]

Index © National Instruments Corporation I-3 NI-I MAQ for IEEE 1394 Cameras User Manual NI-IMA Q for IEEE 1394 Cameras acquisition types grab, 4-5 sequence, 4-6 snap, 4-5 acquisition VIs high-lev el VIs, 4-3 low-le v el VIs, 4-3 architecture, 1-2 libraries, 1-3 O ov erwrite mode, 2-7 P Partial Image Size F ormat. See Format 7 video mode programmin[...]

Index NI-IMAQ for IEEE 1394 Cameras User Manual I-4 ni.com V VI parameters, 4-2 video mode decoding, 2-7 table, 2-8 R OI considerations, 2-5 V isual Basic program ming language, 1-2, 3-1 V isual Studio .NET p rogramming language, 1-2 V isual Studio .NET . See .NET W W eb resources, B-1 Y YUV, 1-1, 2-7, 2-8[...]