National-instruments Image Acquisition Software User Manual

IMAQNI-IMAQ™ User ManualImage Acquisition SoftwareNI-IMAQ User ManualJune 1998 EditionPart Number 371443A-01™UM.book Page 1 Monday, July 13, 1998 9

© National Instruments Corporation 1-1 NI-IMAQ User Manual1Introduction to NI-IMAQThis chapter describes the NI-IMAQ software and lists the applicatio

Chapter 1 Introduction to NI-IMAQNI-IMAQ User Manual 1-2© National Instruments CorporationApplication Development EnvironmentsThis release of NI-IMAQ

Chapter 1 Introduction to NI-IMAQ© National Instruments Corporation 1-3 NI-IMAQ User ManualCreating an ApplicationThis section outlines the process fo

Chapter 1 Introduction to NI-IMAQNI-IMAQ User Manual 1-4© National Instruments CorporationSample ProgramsPlease refer to the readme.txt file located i

© National Instruments Corporation 2-1 NI-IMAQ User Manual2Software OverviewThis chapter describes the classes of NI-IMAQ functions and briefly descri

Chapter 2 Software OverviewNI-IMAQ User Manual 2-2© National Instruments CorporationGeneric FunctionsUse generic functions in both high-level and low-

Chapter 2 Software Overview© National Instruments Corporation 2-3 NI-IMAQ User ManualimgGrabArea Performs a transfer from a continuous acquisition. Ca

Chapter 2 Software OverviewNI-IMAQ User Manual 2-4© National Instruments CorporationimgSessionWaitSignalAsyncMonitors for a signal to be asserted and

Chapter 2 Software Overview© National Instruments Corporation 2-5 NI-IMAQ User ManualLow-Level FunctionsUse low-level functions when you require more

Chapter 2 Software OverviewNI-IMAQ User Manual 2-6© National Instruments CorporationAttribute FunctionsUse attribute functions to examine and change N

Internet SupportE-mail: [email protected] Site: ftp.natinst.comWeb Address: http://www.natinst.comBulletin Board SupportBBS United States: 512 79

Chapter 2 Software Overview© National Instruments Corporation 2-7 NI-IMAQ User ManualimgGetBufferElement Gets an element of a specific type from a buf

© National Instruments Corporation 3-1 NI-IMAQ User Manual3Programming with NI-IMAQThis chapter contains an overview of the NI-IMAQ library, a descrip

Chapter 3 Programming with NI-IMAQNI-IMAQ User Manual 3-2© National Instruments CorporationLow-Level FunctionsThe low-level function set supports all

Chapter 3 Programming with NI-IMAQ© National Instruments Corporation 3-3 NI-IMAQ User ManualBefore you can acquire image data successfully, you must o

Chapter 3 Programming with NI-IMAQNI-IMAQ User Manual 3-4© National Instruments CorporationThis example opens an interface to img0 and then creates a

Chapter 3 Programming with NI-IMAQ© National Instruments Corporation 3-5 NI-IMAQ User Manualattribute value is a numeric value of type integer. Float

Chapter 3 Programming with NI-IMAQNI-IMAQ User Manual 3-6© National Instruments CorporationFigure 3-1 illustrates the values of the signals during a t

Chapter 3 Programming with NI-IMAQ© National Instruments Corporation 3-7 NI-IMAQ User ManualHigh-Level Snap FunctionsA snap acquires a single image in

Chapter 3 Programming with NI-IMAQNI-IMAQ User Manual 3-8© National Instruments CorporationThe sample then calls a process function to analyze the ima

Chapter 3 Programming with NI-IMAQ© National Instruments Corporation 3-9 NI-IMAQ User ManualFigure 3-3. Grab Programming FlowchartThe hlgrab.c exampl

Important InformationWarrantyThe media on which you receive National Instruments software are warranted not to fail to execute programming instructio

Chapter 3 Programming with NI-IMAQNI-IMAQ User Manual 3-10© National Instruments CorporationHigh-Level Sequence FunctionsSequence functions include im

Chapter 3 Programming with NI-IMAQ© National Instruments Corporation 3-11 NI-IMAQ User ManualThe HLSeq.c example demonstrates how to perform a sequenc

Chapter 3 Programming with NI-IMAQNI-IMAQ User Manual 3-12© National Instruments CorporationFigure 3-5. Ring Programming FlowchartThe HLRing.c exampl

Chapter 3 Programming with NI-IMAQ© National Instruments Corporation 3-13 NI-IMAQ User Manualthe most recent video image. This process will continue u

Chapter 3 Programming with NI-IMAQNI-IMAQ User Manual 3-14© National Instruments CorporationFigure 3-6. Signal I/O Function Programming FlowchartAdva

Chapter 3 Programming with NI-IMAQ© National Instruments Corporation 3-15 NI-IMAQ User Manualfor you when you acquire an image with it, you must perfo

Chapter 3 Programming with NI-IMAQNI-IMAQ User Manual 3-16© National Instruments CorporationThe main processing loop of the code shows how to process

Chapter 3 Programming with NI-IMAQ© National Instruments Corporation 3-17 NI-IMAQ User ManualFigure 3-7. Composite StillColor Snap Programming Flowch

© National Instruments Corporation A-1 NI-IMAQ User ManualAStillColorThis appendix describes the different methods you can use to acquire a color imag

Appendix A StillColorNI-IMAQ User Manual A-2© National Instruments CorporationStillColorStillColor is a technique you can use to acquire color images

© National Instruments Corporation v NI-IMAQ User ManualContentsAbout This ManualHow to Use the NI-IMAQ Manual Set...

Appendix A StillColor© National Instruments Corporation A-3 NI-IMAQ User ManualAll of the traditional ways to separate the two signals result in visua

Appendix A StillColorNI-IMAQ User Manual A-4© National Instruments CorporationFigure A-1. Classical DecodingFigure A-2. StillColor DecodingNoteYou c

Appendix A StillColor© National Instruments Corporation A-5 NI-IMAQ User ManualWhy StillColor?StillColor is optimized for single-frame acquisition. A

Appendix A StillColorNI-IMAQ User Manual A-6© National Instruments CorporationStillColor RGBRGB cameras output a color image using three lines. StillC

Appendix A StillColor© National Instruments Corporation A-7 NI-IMAQ User ManualFigure A-3. White Light and the Visible SpectrumWhite light is a combi

Appendix A StillColorNI-IMAQ User Manual A-8© National Instruments CorporationImage RepresentationsColor images can be represented in several differen

Appendix A StillColor© National Instruments Corporation A-9 NI-IMAQ User Manualused if you are performing averaging on your image. For example, averag

© National Instruments Corporation B-1 NI-IMAQ User ManualBCustomer CommunicationFor your convenience, this appendix contains forms to help you gather

NI-IMAQ User Manual B-2© National Instruments CorporationFax-on-Demand SupportFax-on-Demand is a 24-hour information retrieval system containing a lib

Technical Support FormPhotocopy this form and update it each time you make changes to your software or hardware, and use the completed copy of this fo

ContentsNI-IMAQ User Manual vi© National Instruments CorporationChapter 3Programming with NI-IMAQIntroduction ...

NI-IMAQ Hardware and Software Configuration FormRecord the settings and revisions of your hardware and software on the line to the right of each item.

Documentation Comment FormNational Instruments encourages you to comment on the documentation supplied with our products. This information helps us pr

© National Instruments Corporation G-1 NI-IMAQ User ManualGlossaryPrefix Meanings Valuep- pico 10–12n- nano- 10–9µ- micro- 10–6m- milli- 10–3k- kilo-

GlossaryNI-IMAQ User Manual G-2© National Instruments Corporationactive line region the region of lines actively being stored; defined by a line start

Glossary© National Instruments Corporation G-3 NI-IMAQ User Manualblack reference level the level that represents the darkest an image can get. See al

GlossaryNI-IMAQ User Manual G-4© National Instruments CorporationDD/A digital-to-analogDAC digital-to-analog converter; an electronic device, often an

Glossary© National Instruments Corporation G-5 NI-IMAQ User Manualdynamic range the ratio of the largest signal level a circuit can handle to the smal

GlossaryNI-IMAQ User Manual G-6© National Instruments Corporationfunction a set of software instructions executed by a single line of code that may ha

Glossary© National Instruments Corporation G-7 NI-IMAQ User ManualIIC integrated circuitID identificationIEEE Institute of Electrical and Electronics

GlossaryNI-IMAQ User Manual G-8© National Instruments CorporationKk kilo—the standard metric prefix for 1,000, or 103, used with units of measure such

Contents© National Instruments Corporation vii NI-IMAQ User ManualFiguresFigure 3-1. NI-IMAQ Status Signals ...

Glossary© National Instruments Corporation G-9 NI-IMAQ User Manualmemory buffer See buffer. memory window continuous blocks of memory that can be acce

GlossaryNI-IMAQ User Manual G-10© National Instruments CorporationPCLKIN pixel clock in signalPFI programmable function inputPGIA programmable gain in

Glossary© National Instruments Corporation G-11 NI-IMAQ User Manualresolution the smallest signal increment that can be detected by a measurement syst

GlossaryNI-IMAQ User Manual G-12© National Instruments Corporationsyntax the set of rules to which statements must conform in a particular programming

Glossary© National Instruments Corporation G-13 NI-IMAQ User ManualVSYNC vertical sync signal—the synchronization pulse generated at the beginning of

© National Instruments Corporation I-1 NI-IMAQ User ManualIndexAacquisition functions, 2-5application development, 1-2 to 1-4creating applications, 1-

IndexNI-IMAQ User Manual I-2© National Instruments CorporationFfax and telephone support numbers, B-2Fax-on-Demand support, B-2files required for appl

Index© National Instruments Corporation I-3 NI-IMAQ User Manualsequence functions, 3-15 to 3-16snap functions, 3-14 to 3-15attribute functions, 2-6buf

IndexNI-IMAQ User Manual I-4© National Instruments Corporationsession functionslist of functions, 2-4programming considerations, 3-3 to 3-4signal I/O

© National Instruments Corporation ix NI-IMAQ User ManualAbout This ManualNI-IMAQ software is a powerful application programming interface (API) betwe

About This ManualNI-IMAQ User Manual x© National Instruments Corporation• Appendix B, Customer Communication, contains forms you can use to request he

About This Manual© National Instruments Corporation xi NI-IMAQ User ManualNational Instruments DocumentationThe NI-IMAQ User Manual is one piece of th