Instruction/ maintenance manual of the product NI-IMAQ National Instruments
Go to page of 52
IMAQ ™ NI-IMAQ ™ for IEEE-1394 Cameras User Manual Image Acquisition Software NI-IMAQ for IEEE-1394 Cameras User Manual Mar ch 2001 Edition Part Number 370362 A-01.
Worldwide Technical Support and Product Information ni.com National Instruments Corporate Headquarters 11500 North Mopac Expressway Austin, Texas 78759-3504 USA Tel: 512 794 0100 Worldwide Offices Aus.
Important Information Warranty The media on which you receive Nat ional Instruments software are warranted not to fail to execute programming instructions, due t o defects in materials and workmanship, for a period of 90 days from date of shipment, as evidenced by receipts o r other documentation.
Conventions The follo wing con ventions are used in this manual: » The » symbol leads you through nested menu items and dialog box options to a final action. The sequence File»Page Setup» Options directs you to pull down the File menu, selec t the Pa ge Setup item, and select Options from the last dialog box.
© National Instruments Corporation v NI-IMAQ for IEEE-1394 Cameras User Manual Contents Chapter 1 Introduction to NI-IMAQ for IEEE-1394 Cameras About the NI-IMAQ Software ...... .......................... ......................... ...................
Contents NI-IMAQ for IEEE-1394 Cameras User Manual vi ni.com Introductory Programming Examples .................. .......................... ......................... ...... 3-5 High-Level Snap Functions ..... ......................... ...............
© National Instruments Corporation 1-1 NI-IMAQ for IEEE-1394 Cameras User Manual 1 Introduction to NI-IMAQ for IEEE-1394 Cameras This chapter describes the NI-IM AQ for IEEE-1394 software and lists t.
Chapter 1 Introduction to NI-IMAQ for IEEE-1394 Cameras NI-IMAQ for IEEE-1394 Cameras User Manual 1-2 ni.com Application Development Environments This release of NI-IMAQ for 1394 support s the following Application Development Environmen ts (ADEs) for Windows 2000 and Windows Me/98: • LabVIEW version 5.
Chapter 1 Introduction to NI-IMAQ for IEEE-1394 Cameras © National Instruments Corporation 1-3 NI-IMAQ for IEEE-1394 Cameras User Manual Fundamentals of Building Applications with NI-IMAQ for 1394 Architecture A block diagram of the NI-IMAQ for 1394 architecture shown in Figure 1-1 illustrates the low- and mid-level architecture for IMAQ devices.
Chapter 1 Introduction to NI-IMAQ for IEEE-1394 Cameras NI-IMAQ for IEEE-1394 Cameras User Manual 1-4 ni.com The NI-IMAQ Libraries The NI-IMAQ for 1394 for Windows 2 000/Me/98 function libraries are dynamic link libraries (DLLs), which means that NI-IMAQ fo r 1394 routines are not linked into the executable fi les of applications.
Chapter 1 Introduction to NI-IMAQ for IEEE-1394 Cameras © National Instruments Corporation 1-5 NI-IMAQ for IEEE-1394 Cameras User Manual • When compiling, i ndicate where the com piler can find the NI-IMA Q header files and shared libraries.
© National Instruments Corporation 2-1 NI-IMAQ for IEEE-1394 Cameras User Manual 2 Software Over v iew This chapter describes the classes of NI-IMAQ for 1394 functions and briefly describes each function.
Chapter 2 Software Over view NI-IMAQ for IEEE-1394 Cameras User Manual 2-2 ni.com High-Level Functions Use high-level functions to quickly and easily capture images. If you need more advanced functionalit y, you can mix high-level function s with low-level functions.
Chapter 2 Software Over view © National Instruments Corporation 2-3 NI-IMAQ for IEEE-1394 Cameras User Manual Sequence Functions Sequence functions st art and stop a continuous acquisitio n of multiple frames.
Chapter 2 Software Over view NI-IMAQ for IEEE-1394 Cameras User Manual 2-4 ni.com imaq1394StopAcquisition Stops an asynchronous acquisi tion or synchronous continuous acquisition immediat ely. imaq1394GetBuffer Copies a frame buffer to a user-specified buffer.
Chapter 2 Software Over view © National Instruments Corporation 2-5 NI-IMAQ for IEEE-1394 Cameras User Manual Utility Functions Use utility functions to display an im age in a window, save an image to a file, or to get detailed error info rmation. imaq1394Plot Plots a buffer to a window given a handle to a window.
© National Instruments Corporation 3-1 NI-IMAQ for IEEE-1394 Cameras User Manual 3 Programming with NI-IMAQ for 1394 This chapter contains an overview of the NI-IMAQ for 1394 library, a description of the programmin g flow of NI-IMAQ for 1394, and programming examples.
Chapter 3 Programming with NI- IMAQ for 1394 NI-IMAQ for IEEE-1394 Cameras User Manual 3-2 ni.com Low-Level Functions The low-level function set supports all types of acquisiti on. You can use low-level functio ns to start a sy nchronous or asynchronous acq uisition.
Chapter 3 Programming with NI-IMAQ for 1394 © National Instruments Corporation 3-3 NI-IMAQ for IEEE-1394 Cameras User Manual Before you can acquire image data successfully , you must open a camera with the imaq1394CameraOpen function. imaq1394CameraOpen requires a camera name and returns a handle to this interf ace.
Chapter 3 Programming with NI- IMAQ for 1394 NI-IMAQ for IEEE-1394 Cameras User Manual 3-4 ni.com Scalable Image Size IEEE-1394 digital cameras support a predefined set of image sizes which you can select through the Format and Mode attrib utes in MAX.
Chapter 3 Programming with NI-IMAQ for 1394 © National Instruments Corporation 3-5 NI-IMAQ for IEEE-1394 Cameras User Manual Introductor y Programming Examples This section introdu ces some examples fo r performing the different types of image acquisition.
Chapter 3 Programming with NI- IMAQ for 1394 NI-IMAQ for IEEE-1394 Cameras User Manual 3-6 ni.com When you in voke a snap, it initializes the IMA Q 1394 device and acquires the next incoming video frame to a buf fer . Use a snap for low-speed or single-capture applications where ease of programming is essential.
Chapter 3 Programming with NI-IMAQ for 1394 © National Instruments Corporation 3-7 NI-IMAQ for IEEE-1394 Cameras User Manual Calling imaq1394SetupGrab initializes a session for a grab acquisitio n. After imaq1394SetupGrab , each successi ve grab copies the last acquired buf fer into a user buf fer where you can perform processing on the im age.
Chapter 3 Programming with NI- IMAQ for 1394 NI-IMAQ for IEEE-1394 Cameras User Manual 3-8 ni.com High-Level Sequence Functions Sequence functions include imaq1394SetupSequence .A sequence initiates a variable-length and variable-delay transfer to multiple buffers.
Chapter 3 Programming with NI-IMAQ for 1394 © National Instruments Corporation 3-9 NI-IMAQ for IEEE-1394 Cameras User Manual Advanced Programming Examples Use low-level functions or co mbine high-and low -level functions for more advanced programming techniqu es, including snap, grab, and sequence.
Chapter 3 Programming with NI- IMAQ for 1394 NI-IMAQ for IEEE-1394 Cameras User Manual 3-10 ni.com Performing an Asynchronous Snap Using Low-Level Functions The Low-Level Snap1394 Asyn c example demonstrates how to perform an asynchronous acquisition usi ng low-level calls.
© National Instruments Corporation 4-1 NI-IMAQ for IEEE-1394 Cameras User Manual 4 Programming with NI-IMAQ for 1394 VIs This chapter describes how to use the NI-IMAQ 1394 VIs in LabVIEW.
Chapter 4 Programming with NI-IMAQ for 1394 VIs NI-IMAQ for IEEE-1394 Cameras User Manual 4-2 ni.com Location of NI-IMAQ for 1394 Examples The NI-IMAQ VI for IEEE-1394 Cameras examples illustrate some common applications. You can find t hese examples in the labviewexamplesimaq directory for LabVIEW.
Chapter 4 Programming with NI-IMAQ fo r 1394 VIs © National Instruments Corporation 4-3 NI-IMAQ for IEEE-1394 Cameras User Manual The most commonl y used VIs are on the IMAQ for IEEE-1394 palette. Y ou can find VIs for basic acquisition and changing attributes.
Chapter 4 Programming with NI-IMAQ for 1394 VIs NI-IMAQ for IEEE-1394 Cameras User Manual 4-4 ni.com Buffer Management IMAQ Create and IMAQ Dispose manage image buffers in LabVIEW. IMAQ Create , shown in Figure 4-2, allocates an image buffer. Image Name is a label for the buffer created.
Chapter 4 Programming with NI-IMAQ fo r 1394 VIs © National Instruments Corporation 4-5 NI-IMAQ for IEEE-1394 Cameras User Manual NI-IMAQ for 1394 Acquisition T ypes Three NI-IMAQ image acquisition types are available in LabV IEW — snap, grab, and sequence.
Chapter 4 Programming with NI-IMAQ for 1394 VIs NI-IMAQ for IEEE-1394 Cameras User Manual 4-6 ni.com Figure 4-5 shows a simplif ied block diagram for usin g IMA Q1394 Gra b Setup and IMA Q1394 Grab Acquire . Figure 4-5. Acquiring Images Using Grab Sequence A sequence initiates a variable-leng th and variable-delay transfer to multiple buffers.
Chapter 4 Programming with NI-IMAQ fo r 1394 VIs © National Instruments Corporation 4-7 NI-IMAQ for IEEE-1394 Cameras User Manual Figure 4-6 shows a simplif ied block diagram for using IM A Q1394 Sequence . Place IMA Q Create inside a For Loop to create an array of images for the Image s in input to IMA Q1394 Sequence .
Chapter 4 Programming with NI-IMAQ for 1394 VIs NI-IMAQ for IEEE-1394 Cameras User Manual 4-8 ni.com 4. Call IMA Q1394 Get Image . 5. After an acquisition, release the resources associated with the acquisition using IMA Q 1394 Close . IMA Q1394 Close also stops the acquisition if one is in prog ress.
Chapter 4 Programming with NI-IMAQ fo r 1394 VIs © National Instruments Corporation 4-9 NI-IMAQ for IEEE-1394 Cameras User Manual an image acquired using IMA Q13 94 Snap .
Chapter 4 Programming with NI-IMAQ for 1394 VIs NI-IMAQ for IEEE-1394 Cameras User Manual 4-10 ni.com Y our intensi ty graph no w sh ould appear similar to the image shown in Figure 4-9. For more information on the Intensity G raph, consult your LabVIEW documentation Figure 4-9.
Chapter 4 Programming with NI-IMAQ fo r 1394 VIs © National Instruments Corporation 4-11 NI-IMAQ for IEEE-1394 Cameras User Manual . Figure 4-11. Using a Picture Control to Display an RGB Image Camera Attributes Camera attributes allow you to control camera-specific features such as brightness and shutter speed directly from NI-IMAQ for 1394.
Chapter 4 Programming with NI-IMAQ for 1394 VIs NI-IMAQ for IEEE-1394 Cameras User Manual 4-12 ni.com Error Handling Every NI-IMAQ for 13 94 VI contains an error in input cluster and an error out output cluster, as show n in Figure 4-12.
Chapter 4 Programming with NI-IMAQ fo r 1394 VIs © National Instruments Corporation 4-13 NI-IMAQ for IEEE-1394 Cameras User Manual Error Code Format Error format for all NI-IMAQ for 1394 VIs is the same, as follows: error in (no err or) is a cluster that describes the error status before this V I ex ecutes.
Chapter 4 Programming with NI-IMAQ for 1394 VIs NI-IMAQ for IEEE-1394 Cameras User Manual 4-14 ni.com code is the number identifyin g an error or warning. If status is TR UE, code is a non-zero error code. If status is F ALSE, code can be zero or a warning code.
© National Instruments Corporation A- 1 NI-IMAQ for IEEE-1394 Cameras User Manual A T echnical Support Resources W eb Support National Instruments W eb support is your first stop for help in solving installation, configuration, and application pro blems and questions.
Appendix A T echnical Support Resources NI-IMAQ for IEEE-1394 Cameras User Manual A-2 ni.com W orldwide Support National Instruments has of fices located around the world to help address your support needs. Y ou can access our branch of fice W eb sites from the W orldwide Off ices section of ni.
© National Instruments Corporation G-1 NI-IMAQ for IEEE-1394 Cameras User Manual Glossar y A acquisition window The image size specific to a video standard or camera resolution.
Glossary NI-IMAQ for IEEE-1394 Cameras User Manual G- 2 ni.com chrominance See chroma . compiler A software utility that con verts a source program in a high-level programming language, such as Basic, C, or Pascal, into an object or compiled program in machine language.
Glossary © National Instruments Corporation G-3 NI-IMAQ for IEEE-1394 Cameras User Manual dri ver Software that controls a specific hardw are device, such as an IMA Q or D A Q device. E external trigger A voltage pulse from an external source that triggers an ev ent such as A/D con version.
Glossary NI-IMAQ for IEEE-1394 Cameras User Manual G- 4 ni.com I I/O Input/output. The transfer of data to/from a co mputer system in volving communications channels, operator interface de vices, and/or data acquisition and control interfaces. IEEE Institute of Electrical and Electronics Engineers.
Glossary © National Instruments Corporation G-5 NI-IMAQ for IEEE-1394 Cameras User Manual luma The brightness i nformation in the vi deo picture. The luma sign al amplitude v aries in propo rtion to the brightness of th e video signal and corresponds exactly to the monochrome pictur e.
Glossary NI-IMAQ for IEEE-1394 Cameras User Manual G- 6 ni.com O operating system Base-lev el software that controls a computer , runs programs, interacts with users, and communicates with installed hardware or peripheral de vices. P PCI Peripheral Component Interconnect.
Glossary © National Instruments Corporation G-7 NI-IMAQ for IEEE-1394 Cameras User Manual resolution (1) The number of rows and columns of pixels. An image composed of m rows and n columns has a resolution of . This image has n pixels along its horizontal axis and m pixels along its v ertical axis.
Glossary NI-IMAQ for IEEE-1394 Cameras User Manual G- 8 ni.com V V V olts. VI V irtual Instrument. (1) A com bination of hardware and/or software elements, typically used with a PC, that has the funct.
© National Instruments Corporation I-1 N I-IMAQ for IEEE-1394 Cameras User Manual Index A acquisition fun ctions, 2-3 adv anced programming examples, 3-9 to 3-10 asynchronous grab using low-le vel fu.
Index NI-IMAQ for IEEE-1394 Cameras User Manual I-2 ni.com L low-le vel functions acquisition fun ctions, 2-3 attribute functions, 2-4 utility functions , 2-5 M miscellaneous functions, 2-3 N National.
An important point after buying a device National Instruments NI-IMAQ (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought National Instruments NI-IMAQ yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data National Instruments NI-IMAQ - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, National Instruments NI-IMAQ you will learn all the available features of the product, as well as information on its operation. The information that you get National Instruments NI-IMAQ will certainly help you make a decision on the purchase.
If you already are a holder of National Instruments NI-IMAQ, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime National Instruments NI-IMAQ.
However, one of the most important roles played by the user manual is to help in solving problems with National Instruments NI-IMAQ. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device National Instruments NI-IMAQ along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
