National InstrumentsメーカーNI-IMAQdxの使用説明書/サービス説明書
ページ先へ移動 of 65
NI-IMAQdx TM NI-IMAQdx User Manual Image Acquisition Software NI-IMAQdx User Manual February 2007 371970B-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 O.
Important Information Warranty The media on which you receive Natio nal In struments software are warranted not to fail to execute programming instructi ons, due to defects in materials and workmanship, for a period of 90 days from date of shipment, as eviden ced by receipts or other documentat ion.
Conventions The follo wing con ve ntions 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 yo u to pull down the File menu, select the Page Setup item, and select Options from the last dialog box.
© National Instruments Corpor ation v NI-IMAQdx User Manual Contents Chapter 1 Introduction to NI-IMAQdx About the NI-IMAQdx Software .............. .............. .............. ................. .............. .......... 1-1 Application Development Environments .
Contents NI-IMAQdx User Manual vi ni.com Chapter 3 Advanced Programming with NI-IMAQdx Camera Attributes ............... .............. ............... .............. ................. .............. .............. ... 3-1 Attribute Name .............
Contents © National Instruments Corpor ation vii NI-IMAQdx User Manual Chapter 5 Using NI-IMAQdx in C and .NET Using NI-IMAQdx for C ....................... .............. .............. .............. .............. .............. .. 5-1 Using NI-IMAQdx for Microsoft Visual Studio .
© National Instruments Corpor ation 1-1 NI-IMAQdx User Manual 1 Introduction to NI-IMAQdx This chapter describes the NI-IMAQdx driver software, li sts the supported application development enviro nme.
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 v ersion 7.
Chapter 1 Introduction to NI-IMAQdx © National Instruments Corpor ation 1-3 NI-IMAQdx User Manual Fundamentals of Building Applications with NI-IMAQdx Architecture Figure 1-1 illustrates the NI -IMAQdx dri ver architecture.
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 routi nes are not linked into the executable files of applications.
© National Instruments Corpor ation 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 programmin g examples. The chapter also contains flowcharts of high-level and low-l evel snap , grab , and sequence operati ons.
Chapter 2 Basic Acquisition with NI-IMAQdx NI-IMAQdx 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-lev el API and driver.
Chapter 2 Basic Acquisition w ith NI-IMAQdx © National Instruments Corpor ation 2-3 NI-IMAQdx User Manual Camera Name NI-IMAQdx references all camera sessi ons by a name. The driver creates default names for each camera in your sy stem in the order that the cameras are connected.
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.
Chapter 2 Basic Acquisition w ith NI-IMAQdx © National Instruments Corpor ation 2-5 NI-IMAQdx User Manual acquisition. Nationa l Instruments recommends one-shot acqu isition for applications that do not require real-time acquisition or processing.
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 mo des, the ROI specifies the amount of data decoded by the driver while acquiring into a user buffer. By default, the dri ver transfers the en tire image.
Chapter 2 Basic Acquisition w ith NI-IMAQdx © National Instruments Corpor ation 2-7 NI-IMAQdx User Manual Buffer Number Mo de Specify one of the following opt ions for the buffer number mode. • Buffer Number—Gets the e xact buff er number specified in the Buf fer Number parameter .
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 b uffer . This option, which National Instruments recommends for most applications, enables you to process th e most recent image.
Chapter 2 Basic Acquisition w ith NI-IMAQdx © National Instruments Corpor ation 2-9 NI-IMAQdx User Manual Decoding images requires CPU resources . Howe ver , many of the decoding algorithms have been optimized in the driver . If you do not want decoded image data, you can use NI-IMA Qdx to get a copy of the raw camera output.
Chapter 2 Basic Acquisition with NI-IMAQdx NI-IMAQdx User Manual 2-10 ni.com Note If you do not hav e a va lid session, a temporary session is created using cam0 . Then, the snap acquires the ne xt incomi ng image into a user b uffer . After the image is acquired, the program ca lls image processing and analysis functions.
Chapter 2 Basic Acquisition w ith NI-IMAQdx © National Instruments Corporat ion 2-11 NI-IMAQdx User Manual Calling the Configure Grab function opens a session for a grab acquisition. During acquisition, each successi ve grab copies the last acquired internal buf fer into a user buf fer wh ere you can process the image.
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 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, and closes the session.
Chapter 2 Basic Acquisition w ith NI-IMAQdx © National Instruments Corporat ion 2-13 NI-IMAQdx 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 the acquisition.
Chapter 2 Basic Acquisition with NI-IMAQdx NI-IMAQdx User Manual 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.
© National Instruments Corpor ation 3-1 NI-IMAQdx User Manual 3 Advanced Programming with NI-IMAQdx This chapter contains informatio n about setting camera attributes, broadcasting acquired images to multiple mach ines, using scale to define the size of transferred images, and triggering.
Chapter 3 Advanced Pr ogra mming w ith NI-IMAQdx NI-IMAQdx User Manual 3-2 ni.com Attribute T ype The attribute type determines how a came ra attribute is stor ed in the driver and the camera. Use the Get Attribut e Type function to query the type of a given attribute.
Chapter 3 Advanced Progra mming with NI-IMAQdx © National Instruments Corpor ation 3-3 NI-IMAQdx User Manual The following v alu e type s are compatible for any gi ven attrib ute type. The bolded compatible value type indicates the native v alue type.
Chapter 3 Advanced Pr ogra mming w ith NI-IMAQdx NI-IMAQdx User Manual 3-4 ni.com The follo wing range is appli cable for any gi ven attrib ute. Broadcasting Many machine vision applications involv e a single host computer acquiring data from a single industrial cam era.
Chapter 3 Advanced Progra mming with NI-IMAQdx © National Instruments Corpor ation 3-5 NI-IMAQdx User Manual Figure 3-1. One Came ra Broadcasting to Multiple Host Computer s The camera broadcasts video data on the camera bus and all the connected host computers recei ve the same image data.
Chapter 3 Advanced Pr ogra mming w ith NI-IMAQdx NI-IMAQdx User Manual 3-6 ni.com For GigE V ision cameras, you can conf igure the camera to broadcast or multicast image data to all nodes on the network. Broadcast is not routable, and ev eryo ne on the same network sees the data, ev en if they are not listening.
Chapter 3 Advanced Progra mming with NI-IMAQdx © National Instruments Corpor ation 3-7 NI-IMAQdx User Manual The Increment values are camera-specif ic. Refer to the camera documentation or query th e Increment attrib utes for width and height to obtain the act ual values.
Chapter 3 Advanced Pr ogra mming w ith NI-IMAQdx NI-IMAQdx User Manual 3-8 ni.com • TriggerParameter —Certain trigger mod es require an additional parameter .
Chapter 3 Advanced Progra mming with NI-IMAQdx © National Instruments Corpor ation 3-9 NI-IMAQdx User Manual 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.
Chapter 3 Advanced Pr ogra mming w ith NI-IMAQdx NI-IMAQdx User Manual 3-10 ni.com 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 to the host computer.
Chapter 3 Advanced Progra mming with NI-IMAQdx © National Instruments Corporat ion 3-11 NI-IMAQdx User Manual T rigger Modes for Gi gE Vision Cameras Note All triggering mo des and parameters for Gi gE V ision cameras are subject to camera vendor implementation.
© National Instruments Corpor ation 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) th at enable you to use LabVIEW with your camera.
Chapter 4 Using NI-IMAQd x in LabVIEW © National Instruments Corpor ation 4-2 NI-IMAQdx User Manual The Vision and Motion»NI-IMAQ dx»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.
Chapter 4 U sing NI-I MAQdx in LabVIEW NI-IMAQdx User Manual 4-3 ni.com Acquisition VIs Two types of acquisition VIs are ava ilable in LabVIEW: high-l evel and low-level. High-Level Use the high-level acquisition VIs for ba sic image acquisiti on appli cations.
Chapter 4 Using NI-IMAQd x in LabVIEW © National Instruments Corpor ation 4-4 NI-IMAQdx User Manual Buffer Management The IMAQ Create VI and IMAQ Dispose VI manage image buffers in LabVIEW. IMA Q Create, shown in Figure 4-1, allocates an image buf fer .
Chapter 4 U sing NI-I MAQdx in LabVIEW NI-IMAQdx User Manual 4-5 ni.com Acquisition T ypes The following sections describe snap , grab, and sequen ce acquisitions in LabVIEW and give examples. Snap Use the IMAQdx Snap VI for snap applications. Figure 4-3 shows a simplified block diagram for using IMAQdx Snap.
Chapter 4 Using NI-IMAQd x in LabVIEW © National Instruments Corpor ation 4-6 NI-IMAQdx User Manual Figure 4-4 shows a simplif ied block diagram for using IMA Qdx Configure Grab and IMA Qdx Grab. Figure 4-4. Acquiring Images Using Gr ab Sequence Use the IMAQdx Sequence VI for sequence applications.
Chapter 4 U sing NI-I MAQdx in LabVIEW NI-IMAQdx User Manual 4-7 ni.com Image Display Many image acquisition applicatio ns require that one or more images be displayed.
Chapter 4 Using NI-IMAQd x in LabVIEW © National Instruments Corpor ation 4-8 NI-IMAQdx User Manual If you hav e LabVIEW R T , you can use IMA Q R T V ideo Out, located at Vision and Motion»Vision Utiliti es»IMAQ RT , to display an image on the monitor connected to your R T device.
Chapter 4 U sing NI-I MAQdx in LabVIEW NI-IMAQdx User Manual 4-9 ni.com Figure 4-9 sho ws ho w to set camera attr ib u tes with the p roperty nodes in NI-IMA Qdx. 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 output cluster.
Chapter 4 Using NI-IMAQd x in LabVIEW © National Instruments Corporat ion 4-10 NI-IMAQdx User Manual Y ou can use the Simple Error Handler VI, located on the Functions» Dialog & User Interface palette, to check for errors that occur while ex ecuting a VI.
© National Instruments Corpor ation 5-1 NI-IMAQdx User Manual 5 Using NI-IMAQdx in C and .NET This chapter briefly describes how to use NI-IMAQdx fu nctions in Microsoft Visual C and Microsoft Visual Studio .NET. Using NI-IMAQdx for C This section outlines the process for developing NI-IMAQdx appl ications using C.
Chapter 5 Using NI-IMAQdx in C and .NET © National Instruments Corpor ation 5-2 NI-IMAQdx User Manual Y ou can use the additional Image functions installed with NI-IMA Qdx. These functions use the NI V ision memory manageme nt feature, which automatically allocates the memory for your image.
Chapter 5 U sing 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 CWIMA QV iewer control. When the V iewer control is in the toolbox, you can add it to your form s by clicking on the tool and drawing an area on the form.
© National Instruments Corpor ation A-1 NI-IMAQdx User Manual A Register -Level Programming This appendix explains ho w to access an d program register locations using the NI-IMA Qdx software, and disc usses the ca veats in volv ed in programming registers.
Appendix A Register- Level Programming NI-IMAQdx User Manual A- 2 ni.com Figure A-1. Explanation of Split T ransactions NI-IMA Qdx supports the 1394 T rade Association IIDC 1.31 register specification and the GigE V ision 1.0 specification for industrial cameras.
Appendix A Regist er -Level Progr amming © National Instruments Corpor ation A-3 NI-IMAQdx User Manual The NI-IMA Q dx software provides the following register-le vel primitives: • Read Register—.
Appendix A Register- Level Programming NI-IMAQdx User Manual A- 4 ni.com Advanced Example The adv anced feature described in th is e xample is specif i c to Basler IEEE 1394 cameras. The advanced feature replaces the li ve video feed with a static test pattern.
Appendix A Regist er -Level Progr amming © National Instruments Corpor ation A-5 NI-IMAQdx User Manual endian data. T o correct for this discrepancy , NI-IMA Qdx byte-swaps e very quadlet that is read or writt en with low-le vel register primitiv es.
© National Instruments Corpor ation B-1 NI-IMAQdx 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.
© National Instruments Corpor ation G-1 NI-IMAQdx User Manual Glossar y A acquisition windo w The image size specific to a video standard or camera resolution. address V alue that identif ies a specific lo cation (or series of locations) in memory . API Application programming interface.
Glossary NI-IMAQdx User Manual G-2 ni.com D default setting A default parameter value record ed in the driv er . In many cases, the default input of a control is a certain v alue (often 0).
Glossary © National Instruments Corpor ation G-3 NI-IMAQdx User Manual GigE V ision A camera interface standard dev eloped using the Gigabit Ethernet communication protocol.
Glossary NI-IMAQdx User Manual G-4 ni.com M MAX Measurement & Auto mation Explor er—A controlled, centralized configuration en vironm ent that allows you to conf ig ure all of your NI de vices. N NI-IMA Q Dri ver software for National Instruments image acquisition hardware.
Glossary © National Instruments Corpor ation G-5 NI-IMAQdx User Manual R real time A property of an ev en t or system in which data is processed as it is acqu ired instead of being accumulated and processed at a later time. resolution (1) The number of ro ws and co lumns of pixels.
Glossary NI-IMAQdx User Manual G-6 ni.com U user buf fer A memory buf fer created by th e user as a destination for the image. In LabVIEW , this is created with the IMA Q Create VI.
© National Instruments Corpor ation I-1 NI-IMAQdx User Manual Index A adv anced programming examples grab using low-le vel functions, 2-13 sequence using low-le vel functions, 2-14 snap using low-le vel functions, 2-12 application development, 1-3 C, 5-1 en vironments, 1-2 LabVIEW, 4-1 LabVIEW Real-T ime Module, 4-1 .
Index NI-IMAQdx User Manual I-2 ni.com F features and ov ervie w, 1-1 Format 7 video mode, 3-1, 3-6 front panel, LabVIEW, 4 -1, 4-7 G grab high-lev el, 2-1, 2-7, 2-10, 4-5 flo wchart, 2-10 in LabVIEW (figure), 4-6 low-le vel, 2-13 flo wchart, 2-13 H help, technical support, B-1 high-lev el functions, when to use, 2-1 I image buf fer .
Index © National Instruments Corpor ation I-3 NI-IMAQdx User Manual architecture, 1-3 libraries, 1-4 O ov erwrite mode, 2-7 P programming guidelines for C, 5-1 high-lev el functions, 2-1 introduction.
Index NI-IMAQdx User Manual I-4 ni.com V VI parameters, 4-2 video mode decoding, 2-8 table, 2-8 R O I considerations, 2-6 V isual Basic programming language, 1-2 V isual Studi o .
デバイスNational Instruments NI-IMAQdxの購入後に（又は購入する前であっても）重要なポイントは、説明書をよく読むことです。その単純な理由はいくつかあります：
National Instruments NI-IMAQdxをまだ購入していないなら、この製品の基本情報を理解する良い機会です。まずは上にある説明書の最初のページをご覧ください。そこにはNational Instruments NI-IMAQdxの技術情報の概要が記載されているはずです。デバイスがあなたのニーズを満たすかどうかは、ここで確認しましょう。National Instruments NI-IMAQdxの取扱説明書の次のページをよく読むことにより、製品の全機能やその取り扱いに関する情報を知ることができます。National Instruments NI-IMAQdxで得られた情報は、きっとあなたの購入の決断を手助けしてくれることでしょう。
National Instruments NI-IMAQdxを既にお持ちだが、まだ読んでいない場合は、上記の理由によりそれを行うべきです。そうすることにより機能を適切に使用しているか、又はNational Instruments NI-IMAQdxの不適切な取り扱いによりその寿命を短くする危険を犯していないかどうかを知ることができます。
ですが、ユーザガイドが果たす重要な役割の一つは、National Instruments NI-IMAQdxに関する問題の解決を支援することです。そこにはほとんどの場合、トラブルシューティング、すなわちNational Instruments NI-IMAQdxデバイスで最もよく起こりうる故障・不良とそれらの対処法についてのアドバイスを見つけることができるはずです。たとえ問題を解決できなかった場合でも、説明書にはカスタマー・サービスセンター又は最寄りのサービスセンターへの問い合わせ先等、次の対処法についての指示があるはずです。
