MATLAB IMAGE ACQUISITION TOOLBOX 3 Betriebsanweisung

Image AcquisitionToolbox 3User’s Guide

Retrieving Event Informa tion ... 7-7Introduction... 7-7Event Structures...

4 Connecting to HardwareBy default, the video input object makes the first video source object in thearray the selected source. To use another video s

Configuring Image Acquisitio n Object PropertiesConfiguring Image Acquis ition Object PropertiesIn this section.. .“About Image Acquisition Object Pro

4 Connecting to HardwareNote Three video input object trigger properties require the use of a specialconfiguration function. For more information, see

Configuring Image Acquisitio n Object PropertiesType = videoinputUserData = []VideoFormat = M_RS170VideoResolution = [64 0 48 0]Callback Functio n Set

4 Connecting to HardwareNote The video source object for your device might not include device-specificproperties. For example, devices a ccess ed with

Configuring Image Acquisitio n Object Propertiesvid.Previewingans =offGetting Information About Object PropertiesTo get information about a p articula

4 Connecting to HardwareNote Because some properties are read only, on ly a subset of all video inputand video source properties can be set.This examp

Configuring Image Acquisitio n Object PropertiesSetting Trigger PropertiesThe values of certain trigger properties, TriggerType, Trigg erCondition,and

4 Connecting to HardwareStar ting and Stopping a Video Input ObjectWhen you create a video input object, y ou establish a connection betweenMATLAB and

Startin g and Stopping a Video Input ObjectThe following figure illustrates how an object moves from a running to astopped state.Tra nsitions from Run

Adding Support for Additional Hardware9Overview ... 9-2For More Information... 9-3Tro

4 Connecting to HardwareConfigure an acquisition that takes several seconds so that you can see thevideo input in logging state.vid.FramesPerTrigger =

Startin g and Stopping a Video Input ObjectAfter it acquires the specified number of frames, the video input objectstops running.isrunning(vid)ans =07

4 Connecting to HardwareDeleting Image Acquisition ObjectsWhen you finis h usi ng you r image acquisition obj ects, use the delete functionto remove t

Deleting Image Acquisition ObjectsYou can also delete all the video input objects that currently exist i nmemory in one call todelete by using the ima

4 Connecting to HardwareSaving Image Acquisition ObjectsIn this section.. .“UsingthesaveCommand”onpage4-30“Using the obj2mfile Command” on page 4 -30U

5Acquiring Image DataThe core of any image acquisitio n ap p lication i s th e d ata acquired from theinput device. A trigger is th e event that initi

5 Acqu iring Image DataManaging Memory Usage (p. 5-35)Describes how to use theimaqmemfunction to monitor toolbox memoryusageLogging Image Data to Disk

Data LoggingData LoggingIn this section.. .“Overview” on page 5-3“Trigger Properties” on page 5 -4OverviewWhen a trigg er occurs, the toolbox sets the

5 Acqu iring Image DataThe fol lowing figure il lustrates a group of frame s being acquired from thevideo stream and being logg ed to m emory a nd dis

Data LoggingProperty DescriptionTriggerConditionSpecifies the condition that m ust be met fora trig ge r to be executed. This property isalways set to

Troubleshooting Q Im aging Hardware ... 10-19Troubleshooting QImaging Devices... 10-19Determining the Driver Version for Q

5 Acqu iring Image DataSetting the Values of Trigger PropertiesIn this section.. .“About Trigger Properties” on page 5-6“Specifying Trigger Type, S ou

Setting the Va lues of Trigger Proper tiesDetermining Valid ConfigurationsTo find all the valid configurations of the TriggerType, TriggerSource,andTr

5 Acqu iring Image DataIf you are specifying a manual trig ger, you only need to specify the trig gertype value as an argument.triggerconfig(vid,&apos

Specifying the Trigger TypeSpecifying the Trigger TypeIn this section.. .“Comparison o f Trigger Types” on page 5-9“Example: Using an Immediate Trigge

5 Acqu iring Image DataComparison of Trigger Types (Continued)TriggerTypeValueTriggerSourceandTriggerConditionValues Description'manual'Alwa

Specifying the Trigger TypeExample: Using an Immediate TriggerTo use an immediate trigger, simply create a video input o bj ect. Imm ed iatetriggering

5 Acqu iring Image DataVe rify that the o bject has not acquired any frames.get(vid,'FramesAcquired')ans =02 Configure properties — To use a

Specifying the Trigger TypeTo execute anothe r immediate trigger, you must restart the object. Note,however, that this deletes the data acquired by th

5 Acqu iring Image Datayour image acquisition device and substitute that syntax for the followingcode.vid = videoinput('win video',1);Ve rif

Specifying the Trigger Type0Verify that the object has still not acquired any frames.get(vid,'FramesAcquired')ans =04 Execute the manual tri

Functions — Alphabetical List12Properties — By Category13Video Input Objects ... 13-2General...

5 Acqu iring Image DataExample: Using aHardware TriggerTo use a hardwaretrigger,createavideoinputobjectandsetthevalueoftheTriggerType property to&apos

Specifying the Trigger Typeyour image acquisition device and substitute that syntax for the followingcode. The device mu st support hardware triggers.

5 Acqu iring Image Data4 Start the image acquisition object —Callthestart function to startthe image acquisition object.start(vid)The object is runnin

Specifying the Trigger Typeexecute multiple triggers, specify a value for the TriggerRep eat property.See “Specifying Multiple Triggers” on p age 5-29

5 Acqu iring Image DataControlling Logging ParametersIn this section.. .“Data Logging” on p age 5-20“Specifying Logging Mode” on page 5-20“Specifying

Controlling Logging Parametersmemory buffer. For more information, see “Bringing Image Data into theMATLAB Workspace” on page 6-3.Yo u can also log da

5 Acqu iring Image DataSpecifying the Amount of Data to LogNote W h ile you can specify any size acquisition, the number of framesyou can acquire is l

Controlling Logging ParametersThe following figu re illu stra tes how the F rame GrabInterval property affectsan acquisition.Impact of FrameGrabInterv

5 Acqu iring Image Data2 Configure properties — Specify the amount of data you want to acquireas the number of frames per trigger. By default, a video

Controlling Logging ParametersDetermining HowMany Frames Are AvailableThe FramesAcqu iredproperty tells how many frames the object has loggedsince it

Acquiring Image Data ... A-3Working with Acquired Data... A-3Events and Callbacks...

5 Acqu iring Image DataThe object executes an immediate trigger and begins acquiring frames ofdata. Thestart function returns control to the command l

Controlling Logging Parameters5 Remove frames from the memory buffer —Whenyouremoveframes from the memory buffer, the o bject d ecrements the value of

5 Acqu iring Image DataContents of Memor y Buffer Before and After Removing Frames6 Clean up — Always rem ove image acquisition objects from mem ory,

Controlling Logging ParametersSpecifying a Delay Before Data Logging Begi n sSpecifying Multiple TriggersWhen a trigger occurs, a video input object a

5 Acqu iring Image DataExecuting Multiple Triggers5-30

Waiting for an Acquisitio n to FinishWaiting for an Acquisition to FinishIn this section.. .“Using the wait Function” on page 5-31“Example: Blocking t

5 Acqu iring Image DataUsingwaittoBlocktheMATLABCommandLineExample: Blocking the Command Line Until anAcquisition CompletesThe following example illus

Waiting for an Acquisitio n to Finish1 Create an im age acquisition object — Th i s example creates a videoinput o bj ect for a M atrox ima ge acquisi

5 Acqu iring Image Data4 Start the image acquisition object —Callthestart function to startthe image acquisition object.start(vid)The start function s

Managing Memory UsageManaging Memory UsageIn this section.. .“Memory Usage” on page 5-35“Monitoring Memo ry Usage” on page 5-35“Modifying the Frame Me

1Getting StartedThe best way to learn about the capabilities of Image Acquisition Toolboxis to look at a simple example. This chapter introduces the t

5 Acqu iring Image Dataout = imaqmem;mem_left = out.FrameMe moryLimit - out.FrameMe moryUsed;To see a n example of using a callback function to monito

Managing Memory UsageFreeing MemoryAt times, while acquiring image data, you m ight want to delete some or allof the frames that are stored in memory.

5 Acqu iring Image DataTo verify that the object acquired data, view the value of theFramesAvailable property. This property reports how m any frames

Managing Memory Usage5 Empty the entire memory buffer —Callingflushdata withoutspecifying the m ode deletes all the frames s tored in memory.flushdata

5 Acqu iring Image DataLogging Image Data to DiskIn this section.. .“Logging Data to Disk” on page 5-40“Creating an AV I File Object for Logging” on p

Logging Image Data to DiskLogging Data to a Disk FileCreating an AVI File Object for LoggingTocreateanAVIfileintheMATLABenvironment,usetheavifile func

5 Acqu iring Image DataLogging Grayscale ImagesWhen logging images in grayscale format, such a s RS170, you must set thevalue of the AVI object’sColor

Logging Image Data to DiskNote When you log frames to disk, the video input object queues the framesfor writing but the operating system might not per

5 Acqu iring Image Datato a midlevel value. By low ering the qual ity, the AVI file object createssmaller log file s.aviobj.Quality = 50;Because this

Logging Image Data to Diskvid.DiskLoggerFrameCountans =40Note Becauseittakeslongertowriteframestoadiskfilethantomemory,the value of theDiskLoggerFrame

1 Getting StartedWhat Is Image Acquisition Toolbox?In this section.. .“Overview” on page 1-2“Installation and Configuration Notes” o n page 1-3“Relate

5 Acqu iring Image Data5-46

6Working with AcquiredImage DataWhen you trigger an acquisition, the toolbox stores the image data in amemory buffer, a disk file, or both. To work wi

6 Working with Acquired Image DataOver viewWhen a trigger occurs, the toolbox acquires frames from the video stream andlogs the frames to a buffer in

Bringing Image Data into the MATL AB WorkspaceBringing Image Data into the MATLAB WorkspaceIn this section.. .“Overview” on page 6-3“Moving M ultiple

6 Working with Acquired Image Datathe value of the FramesAvailable property. For more information, see“Bringing a Single Frame into the Workspace” on

Bringing Image Data into the MATL AB Workspacegetdata Blocks Until Frames Become AvailableExample: Acquiring 1 0 Seconds of Image DataThis example sho

6 Working with Acquired Image Dataset(vid,'FramesPerTrigger',300)3 Start the image acquisition object —Callthestart function to startthe ima

Bringing Image Data into the MATL AB Workspacethe frames returned by peekdata at each call. (peekdata returns frameswithout removing them from the mem

6 Working with Acquired Image Datatriggerconfig(vid,'manual')In addition, configure a large enough acquisition to allow several calls topeek

Bringing Image Data into the MATL AB WorkspaceName Size Bytes Classpdata 96x128x3 36864 uint8 arrayvid 1x1 1060 videoinput obje ctVe rify that the o b

What Is Image Acquisition Toolbox?Installation and Configuration NotesTo determine if Image Acquisition Toolbox is installed on your system, typethis

6 Working with Acquired Image Data7 Clean up — Always rem ove image acquisition objects from mem ory, andthe variables that re ference them, when you

Bringing Image Data into the MATL AB WorkspaceNote that the frame returned by getsnapshot is not rem ov ed from thememory buffer, if frames are stored

6 Working with Acquired Image DataWorking with Image Data in the MATLAB WorkspaceIn this section.. .“Understanding Image Data” on page 6-12“Determinin

Working with Image Data in the MATLAB Workspace• Determines the color space of the dataThis section also describes several ways to view acquired image

6 Working with Acquired Image Dataimage data being provided by the device; the ROIPosition property specifiesthe dimensions of the image frames being

Working with Image Data in the MATLAB Workspace3 View the video format and video resolution properties — The toolboxcreates the object with t h e defa

6 Working with Acquired Image Data6 Bring multiple fram es into the w orksp ace —Callthegetdatafunction to bring multiple image frames into the MATLAB

Working with Image Data in the MATLAB Workspacevid = videoinput('mat rox',1);2 Bring a single frame into the work space —Callthegetsna psho

6 Working with Acquired Image DataMathWorks product, Image Processing Toolbox, includes functions thatconvert Y CbCr data to RGB data, and v ice versa

Working with Image Data in the MATLAB Workspace4 Clean up — Always rem ove image acquisition objects from mem ory, andthe variables that re ference th

1 Getting StartedThe Image Acquisition Tool (GUI)In Version 2.0 of the toolbox, the functional ity of Image Acquisition Toolbox isavailable in a deskt

6 Working with Acquired Image DataRetrieving Timing InformationIn this section.. .“Introduction” on page 6-20“Determining When a Trigger Executed” on

Retrieving Timing InformationInitialTriggerTime Records First Trigge r ExecutionThe trigger timing information is stored in MATLAB clock vector format

6 Working with Acquired Image DataTo see an example, see “Example: Determining the Frame Delay D uration”on page 6-22.Getting the Absolute Acquisition

Retrieving Timing Informationimaqhwinfo function to get the object constructor for your image acquisitiondevice and substitute that syntax for the fol

6 Working with Acquired Image Data6.05446.21436.34245 Clean up — A lways rem ove image acquisition objects from mem ory, andthe variables that re fere

7Using Events and CallbacksYou can enhance the power and flexibility of your image acquisitionapplication by using event callbacks. An event is a spec

7 Using Events and CallbacksExample: Using the Default Callback FunctionTo illustrate how to use callbacks, this section presents a s imple example th

Example: Using the Default Callback FunctionTrigger event occurred at 14:38:46 for video inpu t object: M_RS170-matrox-1.Stop event occurred at 14:38:

7 Using Events and CallbacksEvent TypesImage Acquisition Toolbox supports several different types of events. Eachevent type has an associated video in

Event TypesEvents and Callback Function Properties (Continued)Event Callback Proper ty D es criptionStartStartFcnThe toolbox generates a start event w

Basic Image Acquisition ProcedureBasic Image Acquisition ProcedureIn this section.. .“Overview” on page 1-5“Step 1: Install Your Image A cquisition De

7 Using Events and CallbacksEvents and Callback Function Properties (Continued)Event Callback Proper ty D es criptionTimerTimerFcnThe toolbox generate

Retrieving Event InformationRetrieving Event InformationIn this section.. .“Introduction” on page 7-7“Event Structures” on page 7-7“Example: Accessing

7 Using Events and Callbacksoccurred. For information about the information associated with specificevents, see the following sections:• “Data Fields

Retrieving Event InformationField Name DescriptionAbsTimeAbsolute time the event occurred, returned inMATLABclock format[year month day hour minut e s

7 Using Events and CallbacksThe toolbox adds event structures to the EventLog arrayintheorderinwhichthe events occur. The first event structure reflec

Retrieving Event InformationTo list the events that are recorded in the EventLog property, examine thecontents of theType field.{events.Type}ans =&apo

7 Using Events and CallbacksCreating and Executing Callback FunctionsIn this section.. .“Introduction” on page 7-12“Creating C allback Functions” on p

Creating and Executing Callback FunctionsM-file callback functions require at least two input arguments:• The image acquisition object• The event stru

7 Using Events and Callbacksfunction display_f rame (obj,event)sample_frame = peekdat a(obj,1);imagesc(sample_frame);drawnow; % force an update of the

Creating and Executing Callback FunctionsUsing a Text String to Specify Callback FunctionsYou can specify the callback function as a string. For examp

How to Contact The MathWorkswww.mathworks.comWebcomp.soft-sys.matlab Newsgroupwww.mathworks.com/contact_TS.html Technical [email protected]

1 Getting StartedTo use Image Acquisition Toolbox to acquire imag e data, you mu st performthe following basic steps:Step DescriptionStep 1: Install a

7 Using Events and CallbacksIf you a re executing a local callback function from within an M-file, you mustspecify the callback as a function handle.S

Creating and Executing Callback Functionsvid = videoinput('mat rox', 1);2 Configure property values — This example sets the Frame sPerTrigge

7 Using Events and Callbacksfunction mem_mon(o bj,e vent)out = imaqmem;mem_left = out.FrameMe moryLimit - out.FrameMe moryUsed;msg = 'Memory left

Creating and Executing Callback Functions3 Acquire data — Start the video input object. E very 5 seconds, the objectexecutes the callback function ass

7 Using Events and Callbacks7-20

8Using the From VideoDeviceBlockinSimulinkImage Acquisition To olbox includes a block that can be used in Simulinkto bring live video data into models

8 Using the From Video Device Block in S imulinkOver viewThis chapter describes how to use the Image A cquisition Toolbox block library.The toolbox bl

Opening the B l ock LibraryOpening the Block Librar yIn this section.. .“Using the imaqlib Command” on page 8-3“Using the Simulink Library Browser” on

8 Using the From Video Device Block in S imulinkTo start the Sim ulin k Library Brow ser, entersimulinkat the MATLAB prompt. MATLAB opens the browser

Example: Saving Video Data to a FileExample: Saving Video Data to a FileIn this section.. .“Introduction” on page 8-5“Step 1: Open the Image Acquisiti

Basic Image Acquisition ProcedureStep 2: Retrieve Hardware InformationIn this step, you get seve ral pieces of information that the toolbox needs toun

8 Using the From Video Device Block in S imulinkStep 2: Open a Model or Create a New ModelTo use a block, you must add it to an existing model or crea

Example: Saving Video Data to a FileStep 3: Drag the From Video Device Block into theModelTo use the From Video Device block in a model, click the blo

8 Using the From Video Device Block in S imulinkStep 4: Drag Other Blocks to Complete the ModelTo illustrate using the block, this example creates a s

Example: Saving Video Data to a FileDrag Output Block to Model Window8-9

8 Using the From Video Device Block in S imulinkStep 5: Connect the BlocksConnect the three outputs from the From Video Device block to the threecorre

Example: Saving Video Data to a Filebox for the From Video Device block, shown in t he following figure. Use thevarious fie lds in the dialog box to d

8 Using the From Video Device Block in S imulinkStep 7: Run the SimulationTo run the simulation, click the Start simulation buttononthemodelwindow too

9Adding Support forAdditional HardwareImage Acquisition Toolbox supports connections with hardware from manycommonvendorsbutitmightnotsupportthehardwa

9 Adding Suppor t for Additional HardwareOver viewThe Image Acquisition Toolbox Adaptor Kit i s a C++ fram ework t hat you canuse to implement an adap

For More InformationFor More InformationTo build an adaptor requires familiarity with C++, knowledge of theapplicatio n programm ing interface (API) p

1 Getting StartedDetermining the Adaptor NameTo determine the name of the adaptor, enter the imaqhwinfo function at theMATLAB prompt without any argum

9 Adding Suppor t for Additional Hardware9-4

10TroubleshootingThis chapter provides information about solving common problems you mightencounter with Image Acquisition Toolbox and the video acqui

10 TroubleshootingTroubleshooting HamamatsuHardware (p. 10-16)Provides some helpful tips ondiagnosing problems you mightencounter using the toolbox wi

OverviewOver viewIf, after installing Image Acquisition Toolbox and using it to establish aconnection to your image acquisition device, you areunablet

10 TroubleshootingTroubleshooting DALSA Coreco IFC HardwareIn this section.. .“Troubleshooting DALSA Coreco IFC Devices” on page 10-4“Determining the

Troubleshooting DALSA Coreco IFC Ha rd w areIf you discover that y ou are using an unsupported driver version, visit theDALSA C oreco Web site (www.im

10 TroubleshootingTroubleshooting DALSA Coreco Sapera HardwareIn this section.. .“Troubleshooting DALSA Coreco Sapera Devices” on page 10-6“Determinin

Troubleshooting DALSA Coreco Sapera Hardware• Ve rify that the version is compatible with Image Acquisition Toolbox.For the correct driver information

10 TroubleshootingTroubleshooting Data Translation HardwareIf you are having trouble using Image Acquisition Toolbox with a supportedData Translation

Troubleshooting DCAM IEEE 1 394 (FireWire) Ha rd w areTroubleshooting DCA M IEEE 1394 (FireWire) H ardwareIn this section.. .“Troubleshooting DCAM IEE

Basic Image Acquisition ProcedureDeviceInfo: [1x1 stru ct]Determining the Supported Video FormatsTodeterminewhichvideoformatsanimage acquisition devic

10 Troubleshooting3 Verify that your IEEE 1394 (FireWire) camera is using the Carnegie MellonUniversity (CMU) DCAM driver version 6.4.4.Note The toolb

Troubleshooting DCAM IEEE 1 394 (FireWire) Ha rd w areNote The CM U DCAM driver is the only DCAM driver supported by thetoolbox. You cannot use vendor

10 Troubleshooting3 From the Camera Demo application, select Camera > Check L ink.Thisoption causes the demo application to loo k for DCAM-compatib

Troubleshooting DCAM IEEE 1 394 (FireWire) Ha rd w areNote If you are using 1394b, select Camera > 1394b Support,and then checkthe Maximum Speed op

10 Troubleshooting10-14

Troubleshooting DCAM IEEE 1 394 (FireWire) Ha rd w areThe demo application starts displaying live video in the window.7 To exit,select Stop Camera fro

10 TroubleshootingTroubleshooting Hamamatsu HardwareIf you are having trouble using Image Acquisition Toolbox with a Hamamatsudigital camera, follow t

Troubleshooting Matrox HardwareTroubleshooting Matrox H ardwareIn this section.. .“Troubleshooting Matrox Devices” on page 10-17“Determining the D riv

10 TroubleshootingDetermining the Driver Version for Matrox DevicesTo determine the Matrox Imaging Library version you are using, run theMatrox MIL Co

Troubleshooting QImaging HardwareTroubleshooting Q Imaging H ardwareIn this section.. .“Troubleshooting QImaging Devices” on page 10-19“Determining th

1 Getting StartedObjectConstructor field. For mo re information the device informationstructure, see “Determining the Supported Video Formats” on page

10 TroubleshootingIf you discover that y ou are using an unsupported driver version, visit theQImaging Web site (www.qimaging.com) to dow nload the co

Troubleshooting National Instr uments HardwareTroubleshooting N ational Instruments HardwareIn this section.. .“Troubleshooting National Instruments D

10 TroubleshootingNote Image Acquisition Toolbox is compatible only with specific driverversions provided with the National Instruments software and i

Troubleshooting Windows Video HardwareTroubleshooting Windows Video HardwareIn this section.. .“Troubleshooting Windows Video Devices” on page 10-23“D

10 TroubleshootingIf you discover that y ou are using an unsupported driver version, visit thehardware manufacturer’s Web site for the correct drivers

Troubleshooting Windows Video HardwareIn the DirectX Diagnostic Tool, the Microsoft DirectX version is listed on theSystem tab under the System Inform

10 TroubleshootingTroubleshooting a Video Preview WindowWhen pre view ing the video stream , if you enco unter a problem, try one ofthe following solu

Contacting The Math Works and Using the imaq s upport FunctionContacting The MathWorks and Using the imaqsupportFunctionIf you need support from The M

10 Troubleshooting10-28

11Functions — By CategoryObjects General Purpose ( p. 11-2)Functions re lated to objectsTriggering (p. 11-3)Functions related to triggeringData (p. 11

Basic Image Acquisition Procedure'Y8_1024x768' video data to be logged upon START.Grabbing first of every 1 frame(s).Log data to 'memor

11 Functions — By C atego ryObjects G eneral PurposeVideo i nput objects have one or more video source objects associated withthem. In this table, fun

TriggeringstopStop video input objectvideoinputCreate video input objectwaitWait until image acquisition objectstops running or loggingTriggeringtrigg

11 Functions — By C atego ryToolsclosepreviewClose Video Preview windowimaqhelpImage acquisition object functio nand property helpimaqhwinfoInformatio

Getting Command-Line Function HelpGetting Command-Line Function HelpTo get command-line function help, you can use the MATLAB help function.For exampl

11 Functions — By C atego ryYo u can also use this function to get help on image acquisition objectproperties. For more information on overloaded func

12Functions — AlphabeticalList

clearPurpose Clear image acquisition object from MATLAB workspaceSyntax clear objDescription clear obj removes the image acquisition object obj from t

closepreviewPurpose Close Video Preview windowSyntax closepreview(obj)closepreviewDescription closepreview(obj) stops the image acquisition object obj

deletePurpose Remove image acquisition object from memorySyntax delete(obj)Description delete(obj) removes obj, an image acquisition object or array o

dispPurpose Display method for image acquisition objectsSyntax objdisp(obj)Description obj displays summary information for im age acquisition object

1 Getting StartedThe follow ing figure shows the Video P review window for the e xample.Video Preview WindowToclosetheVideoPreviewwindow,clicktheClose

dispThis example shows the summary information dis played for an array ofvideo input objects.vid2 = videoinput('wi nvideo');[vid vid2]Video

flushdataPurpose Remove data from memory buffer used to store acquired image framesSyntax flushdata(obj)flushdata(obj,mode)Description flushdata(obj)

getPurpose Image acquisition object propertiesSyntax get(obj)V = get(obj)V = get(obj,Property Name)Description get(obj) displays all property names an

getdataPurpose AcquiredimageframestoMATLABworkspaceSyntax data = getdata(obj)data = getdata(obj,n )data = getdata(obj,n ,type)data = getdata(obj,n ,ty

getdataType String Data Type'uint8'Unsigned 8-bit integer'uint16'Unsigned 16-bit integer'uint32'Unsigned 32-bit integer&

getdatais measured continuously with respect to 0 until the acquisition stops.When the acquisition stops, the o bject’sRunning property is set to &apo

getdatadata = getdata(obj);Display each image frame acquired.imaqmontage(data);Remove the video input object from memory.delete(obj);See Also getsnaps

getselectedsourcePurpose Currently selected video source objectSyntax src = getselectedsou rce(obj)Description src = getselectedsou rce(obj) searches

getsnapshotPurpose Immediately return single image frameSyntax frame = getsnapshot( obj)Description frame = getsnapshot( obj) immediately returns one

getsnapshotAcquire an d display a single frame of data.frame = getsnapshot(o bj);image(frame);Remove the video input object from memory.delete(obj);Se

Basic Image Acquisition ProcedureStep 5: Configure Object Properties (Optional)After creating the video input object and previewing the video stream,

imaqfindPurpose Find image acquisition objectsSyntax imaqfindout = imaqfindout = imaqfind(Prope rtyName, Value, Proper tyNa me2, Value2,...)out = imaq

imaqfindNote When searching for properties with specific values, imaqfindperforms cas e-s ensitive searches. For example, if the value of an object’sN

imaqhelpPurpose Image acquisition object function and property helpSyntax imaqhelpimaqhelp(Name)imaqhelp(obj)imaqhelp(obj,Name)out = imaqhelp(...)Desc

imaqhelpvid = videoinput('dt' , 1) ;src = getselectedsourc e(vid);imaqhelp(vid, 'Tri gger Type')imaqhelp(src, 'Fra meRa te&ap

imaqhwinfoPurpose Information about available image acquisition hardwareSyntax out = imaqhwinfoout = imaqhwinfo(ada ptorname)out = imaqhwinfo(ada ptor

imaqhwinfois an array o f device objects, then out is a 1-b y-n cell array of s tructureswheren is the length of obj.out = imaqhwinfo(obj ,field) retu

imaqhwinfoThis example returns informatio n about a specific device accessiblethrough a particular adaptor. You identify the device by its device ID.d

imaqhwinfowinvideoSee Also imaqhelp, im aqreset12-23

imaqmemPurpose Limit memory or display memory usage for Image A cquisition ToolboxSyntax mem = imaqmemimaqmem(field)imaqmem(limit)Description mem = im

imaqmemimaqmem(field) returns information for the field specified by the textstringfield.imaqmem(limit) configures the fram e memory limit, in bytes,

1 Getting Startedget(vid)The get fun c tion lists all the properties of the object with their current values.General Settings:DeviceID = 1DiskLogger =

imaqmemSpecify the amount of memory available for the toolbox to log imag eframes (FrameMemoryLimit).imaqmem(30000000)ans =MemoryLoad: 85TotalPhys: 26

imaqmontagePurpose Sequence of im age frames as montageSyntax imaqmontage(frames)imaqmontage(obj)imaqmontage(...,CLIM)imaqmontage(..., 'CLim&apos

imaqmontageCreate an axes object.a = axes;Display each image frame acquired on axes a.imaqmontage(data, 'Parent', a);Remove the video input

imaqresetPurpose Disconnect and delete all image acquisition objectsSyntax imaqresetDescription imaqreset deletes any image acquisition objects that e

imaqtoolPurpose Launch Image Acquisition ToolSyntax imaqtoolimaqtool(file)Description imaqtool launches an inte ractive GU I to allo w you to ex plore

isloggingPurpose Determine w hether video input object is loggingSyntax bool = islogging(obj )Description bool = islogging(obj ) returns true if th e

isloggingStart one of the video input o bjects again, such as vid,anduseislogging to determine w hich of the two objects is logging.start(vid)bool = i

isrunningPurpose Determine w hether video input object is runningSyntax bool = isrunning(obj )Description bool = isrunning(obj ) returns true if th e

isrunningPropertiesRunning12-34

isvalidPurpose Determine whether image acquisition object is as sociated with imageacquisition deviceSyntax bool = isvalid(obj)Description bool = isva

Basic Image Acquisition ProcedureNote Video source object pro perties are d ev ice specific. The list o f propertiessupported by the device connected

loadPurpose Load image acquisition object into MATLAB workspaceSyntax load filenameload filename obj1 obj2 ...S = load(filename,ob j1,obj2,...)Descrip

obj2mfilePurpose Convert video input objects to MATLAB codeSyntax obj2mfile(obj,filename)obj2mfile(obj,filename,syntax)obj2mfile(obj,filename,syntax,m

obj2mfileobj2mfile(obj,filename,syntax) converts obj to the equivalentMATLAB code wheresyntax specifies how ob j2mf ile assigns valuesto properties of

obj2mfileString Description{'reuse'}Findand modify an existing objec t, if the existing objectis associated with the same adaptor and the va

obj2mfiledelete(vidobj);clear vidobj;Execute the M-file to recreate the object. N ote that obj 2mfile createsand configures the associated video sourc

peekdataPurpose Most recently acquired image dataSyntax data = peekdata(obj, frames)Description data = peekdata(obj, frames) returns data containing t

peekdataThe behavior of peekdata depends on the settings of the Running andtheLogging properties.Running Logging Object State ResultOn Off The object

previewPurpose Preview of live video dataSyntax preview(obj)preview(obj,himage)himage = preview(... )Description preview(obj) creates a Video Previe w

previewThe Video Preview wind ow remains acti ve until it is either stoppedusingstoppreview or closed using closeprevi ew.Ifyoudeletetheobject, by cal

previewObject State Preview Window BehaviorRunning=onIf Trigge rType is set to immedia te or manual,theVideo Preview window continues to update the im

Revision HistoryMarch 2003 First printing New for Version 1.0 (Release 13+)September 2003 Online only Revised for Version 1.1 (Release 13SP1)June 2004

1 Getting Startedby referencing the property as you would reference a field in a MATLABstructure.vid.FrameGrabInterval = 5;To set the value of a video

previewThe event structure contains the following fields:Field DescriptionDataCurrent image frame specified as an H- by-W-by-Bmatrix where H and W are

propinfoPurpose Property characteristics for image acquisition objectsSyntax out = propinfo(obj)out = propinfo(obj,P ropertyName)Description out = pro

propinfoarray of strings, propinfo returns a structure for each property, storedin a cell array.Examples Create the video input object vid.vid = video

savePurpose Save image acquisition objects to MAT-fileSyntax save filenamesave filename obj1 obj2 ...save(filename,obj1,obj2,...)Description save file

setPurpose Configure or display image acquisition object propertiesSyntax set(obj)prop_struct = set(ob j)set(obj,PropertyName)prop_cell = set(obj, Pro

setobjects, in which case set configures the prope rty values for all theimage acquisition objects specified.set(obj,S) configures the properties of o

star tPurpose Obtain exclusive use of image a cquisition deviceSyntax start(obj)Description start(obj) obta ins exclusiv e u se of the image a cquisit

startAn image acquisition object stops running when one of the followingconditions is met:• Thestop function is issued.• The requested number of frame

stopPurpose Stop video input objectSyntax stop(obj)Description stop(obj) halts an a cquisition associated with the video input objectobj. obj can be e

stoppreviewPurpose Stop previewing video dataSyntax stoppreview(obj)Description stoppreview(obj) stops the previewing of video d ata from imageacquisi

Basic Image Acquisition ProcedureIn the example, because the TriggerTy pe property is set to 'immediate'(the default) and the Trigge rRepeat

triggerPurpose Initiate data loggingSyntax trigger(obj)Description trigger(obj) initiates data logging for the video input object obj. objcan be eithe

triggerconfigPurpose Configure video input object trigger propertiesSyntax triggerconfig(obj,type)triggerconfig(obj,type,condit ion)triggerconfig(obj,

triggerconfiginput object obj using co nfi g, a MATLAB structure with field namesTriggerType, TriggerCondit ion,andTrigge rSource,eachcontainingthe d

triggerconfigdelete(vid);See Also imaqhelp, trigger, trig geri nfo, videoinput12-59

triggerinfoPurpose Provide i nformation abo ut available trigger configurationsSyntax triggerinfo(obj)triggerinfo(obj,type)config = triggerinfo (...)D

triggerinfo2 Get information about the available trigger configurations for thisobject.config = triggerinfo( vid)config =1x2 struct array with fiel ds

videoinputPurpose Create video input objectSyntax obj = videoinput(ada ptorname)obj = videoinput(ada ptorname,deviceID)obj = videoinput(ada ptorname,d

videoinputThe property name and property value pairs can be in any formatsupported by theset function, i.e., parameter/value string pairs,structures,

videoinputSee Also delete, imaqfind, isvalid, preview12-64

waitPurpose Wait until image acquisition object stops running or loggingSyntax wait(obj)wait(obj,waittime)wait(obj,waittime,state)Description wait(obj

1 Getting StartedNote The example uses functions in Image Processing Toolbox.% Create video input obje ct.vid = videoinput('dcam ',1,'Y

waitAn image a cquisition object stops running or logging when one of thefollowing conditions is met:• Thestop function is issued.• The requested numb

13Properties — By CategoryThis chapter contains brief descriptions of all the properties of the video inputobject and the properties of the video sour

13 Properties — By CategoryVideo Input ObjectsGeneral (p. 13-2)General image acquisition propertiesCallback (p. 13-3)Properties related to callback e

Video Input ObjectsNameSpecify name of image acquisit ionobjectNumberOfBandsIndicate number of color bands indata to be acquiredPreviewingIndicate w h

13 Properties — By CategoryFramesAcquiredFcnCountSpecify number of frames that mustbe acquired before frames acquiredevent is g eneratedStartFcnSpecif

Video Input ObjectsAcquisition SourceSelectedSourceNameSpecify name of currently selectedvideo sourceSourceIndicate video source objectsassociated wit

13 Properties — By CategoryVideo Source ObjectsVideo input objects create one or more video s ource objects that representtheimageacquisitiondatasourc

14Properties — AlphabeticalList

BayerSensorAlignmentPurpose Specify sensor alignment for Bayer demosaicingDescription If the ReturnedColorSpace property is set to 'b ayer',

BayerSensorAlignmentThe value of this property is only used if the ReturnedColorSpaceproperty is set to 'bayer'.CharacteristicsAccess R ead/

Basic Image Acquisition ProcedureThe follow ing figure show s how the exam ple di splays detected m otion. In thefigure, areas representing movement a

DeviceIDPurpose Identify image acquisition device represented by video input objectDescription The DeviceID property identifies the device represented

DeviceIDUse the imaqhwinfo function again, specifying the name of the adaptor,to find out how many devices are available through that adaptor. Theimaq

DiskLoggerPurpose Specify MATLAB AVI file object us ed to log dataDescription The DiskLogger property specifies the AVI file object u sed to log dataw

DiskLoggerExamples Create and configure an AV I file object.file = avifile('logfi le.avi');file.Quality = 50;Create and co nfigure a video i

DiskLoggerFrameCountPurpose Specify number of frames written to diskDescription The DiskLoggerFra meCount property indicates the current number offram

ErrorFcnPurpose Specify M-file callback function to execute when run-time error occursDescription The ErrorFcn property specifies the function to exec

EventLogPurpose Store information about eventsDescription The EventLog property is an array of structures that stores informationabout events. Each st

EventLogCharacteristicsAccess Read onlyData typeStructure arrayValues Default is empty structure array.Examples Create a video input o bject.vid = vid

FrameGrabInter valPurpose Specify how often to acquire frame from video streamDescription The FrameGrab Interval property specifies how often the vide

FrameGrabIntervalCharacteristicsAccess Read only while runningData typedoubleValuesAny positive integer. The default value is1 (acquireevery frame).Se

1 Getting StartedThe third dimension represents the number of color bands in the image.Because the example data is a grayscale image, the third dimens

FramesAcquiredPurpose Indicate total number of frames acquiredDescription The Fr amesAcquired property indicates the total number of framesthat the ob

FramesAcquiredFcnPurpose Specify M-file e xecuted when spe cified number of frames have beenacquiredDescription The FramesAcquir edFcn specifies the M

FramesAcquiredFcnCountPurpose Specify number of frames tha t must be acquired before frames acquiredevent is generatedDescription The FramesAcquiredFc

FramesAvailablePurpose Indicate number of frames available in m emory bufferDescription The FramesA vailable property indicates the total number of fr

FramesPerTriggerPurpose Specify number of frames to acquire per trigg er using selected videosourceDescription The Fram esPerTrigger property specifie

InitialTriggerTimePurpose Record absolute time of first triggerDescription The InitialTriggerTi me property records the absolute time of the firsttrig

InitialTriggerTimesprintf('%d:%d:%d', t(4),t(5),t(6))ans =13:26:20See Also Functionsclock, getdataPropertiesEventLog, Logging, Trigg erTy pe

LoggingPurpose Indicate whether object is currently logging dataDescription The Logging property indicates whether the video input object iscurrently

LoggingModePurpose Specify destination for acquired d ataDescription The Loggi ngMode property specifies w here you want the video inputobject to stor

LoggingModePropertiesDiskLogger, Logging14-23

2IntroductionThis chapter describes Image Acquisition Toolbox and its components.Overview (p. 2-2)Provides an overview of ImageAcquisition ToolboxSett

NamePurpose Specify name of image acquisition objectDescription The Name property specifies a descriptive name for the image acquisitionobject.Charact

NumberOfBandsPurpose Indicate number of color bands in data to be acquiredDescription The NumberOfBands property indicates the number of color bands i

NumberOfBandsIf you retrieve the value of the VideoForm at property, you can see thatthe video data is in R GB format.get(vid,'VideoFormat')

ParentPurpose Identify video input object that is pare nt of video source objectDescription The Parent property identifies the video input object that

PreviewingPurpose Indicate whether o bject is currently previewing data in separate windowDescription The Previewing property indicates whether the ob

ReturnedColorSpacePurpose Specify color space used in MATLABDescription The ReturnedColorSpace property specifies the co lo r space youwantthetoolboxt

ROIPositionPurpose Specify region-of-interest (ROI) windowDescription The ROIPositi on property specifies the region-of-interest acquisitionwindow. Th

ROIPositionCharacteristicsAccess Read only while runningData type1-by-4 element vector of doublesValues Default is [ 0 0 width height ] where width an

RunningPurpose Indicate whether video input object is ready to a c qu ire dataDescription The Running property indicates if the video input object is

SelectedPurpose Indicate whether video source object will be used for acquisitionDescription The Selected property indicates if the video source objec

2 IntroductionOver viewIn this section.. .“Introduction” on page 2-2“Toolbox Components” on page 2-3“The Image Acquisition Tool (GUI )” on page 2-3“Su

Selectedsrc = getselectedsour ce(vid);View its Name and Sel ect ed properties.src.SourceNameans =input1src.Selectedans =onSee Also Functionsgetselecte

SelectedSourceNamePurpose Specify name of currently selected video sourceDescription The SelectedSour ceNa me property specifies the name of the video

SourcePurpose Indicate video source objects associated with vide o input objectDescription The Source property is a vector of video source objects tha

SourceExamples Create an image acquisition object.vid = videoinput('mat rox');To access all the video source objects associated with a video

SourceNamePurpose Indicate name of video source objectDescription The SourceName property indicates the name of a video source object.SourceName is on

Star tFcnPurpose Specify M-file executed when start event occursDescription The StartFcn property specifies the M-file function to execute when astart

StopFcnPurpose Specify M-file executed w hen stop e vent occursDescription The StopFcn property specifies the M-file function to execute when astop ev

TagPurpose Specify descriptive text to associate with i mage acquisition objectDescription The Ta g property specifies any descriptive tex t t hat y o

TimeoutPurpose Specify how long to wait for image dataDescription The Timeout property specifies the amount of time (in seconds) that thegetdata and g

TimerFcnPurpose Specify M-file callback function to e xecute when timer event occursDescription The TimerFcn property specifies the M-file callback fu

OverviewToolbox ComponentsThe toolbox usescomponents called hardware device adaptors to connect todevices throughtheir drivers. The toolbox includes a

TimerPeriodPurpose Specify number of seconds between timer ev entsDescription The Tim erPeriod property specifies the amount of time, in seconds,that

TriggerConditionPurpose Indicate required condition before trigger event occursDescription The TriggerCond ition property indicates the condition that

TriggerConditionPropertiesTriggerSource, Tr iggerType14-46

TriggerFcnPurpose Specify M-file callback function to execute when trigger event occursDescription The Trigger Fcn pr operty specifies the M-file call

TriggerFrameDelayPurpose Specify number of frames to skip before acquiring frames after triggeroccursDescription The Tri ggerFrameDelay property speci

TriggerFrameDelayPropertiesFramesPerTrigger14-49

TriggerRepeatPurpose Specify numbe r of add itio n al times to execute triggerDescription The TriggerRepea t property specifies the number of addition

TriggersExecutedPurpose Indicate total number of e xecuted triggersDescription The TriggersExecuted property indicates the total number of triggerstha

TriggerSourcePurpose Indicate hardware source to monitor for trigger conditionsDescription The TriggerSource property indicates the hardware source th

TriggerTypePurpose Indicate typ e of trigger used by video in put objectDescription The T riggerType property indicates the type of trigger used by th

2 Introductiondata. You can log the data to MATLAB in several formats, and also generatean AVI file, right from the tool.To open the tool, select Star

TriggerTypePropertiesTriggerCondition, TriggerSource14-54

TypePurpose Identify type of image acquisition objectDescription The Type property identifies the type of image acquisition object. Animage acquisitio

UserDataPurpose StoredatatoassociatewithimageacquisitionobjectDescription The UserDat a property specifies any data that you want to associatewith an

V ideoFormatPurpose Specify video format or name of device configuration fileDescription The VideoFo rmat property specifies the video format used by

VideoFormatAdaptorDllName: [1 x73 char]AdaptorDllVersion: '2.1 (R2007a)'AdaptorName: 'winv ideo 'DeviceIDs: {[1]}DeviceInfo: [1x1

VideoResolutionPurpose Indicate width and height of incoming video streamDescription The VideoResolu tion property is a two-element vector indicatingt

VideoResolution14-60

15Blocks — Alphabetical List

From Video DevicePurpose AcquireliveimagedatafromimageacquisitiondeviceLibrary Image Acquisition ToolboxDescriptionThe From Video Device block lets yo

From Video D eviceFor more information on these features, see the Simulinkdocumentation.Note For a n in-depth example of using this block, see Using t

Setting Up Image Acquisition HardwareSetting Up Image Acquisition HardwareIn this section.. .“Introduction” on page 2-5“Setting Up Frame Grabbers” on

From Video Device15-4

From Video D eviceThe second diagram illustrates the options that may appear if yourdevice supports using either one output port or multiple output po

From Video Deviceconnected to your system. All video capture devices supported byImage Acquisition Toolbox are supported by the block.Video formatShow

From Video D eviceROI positionUse this field to input a row vector that specifies the region ofacquisition in the video image. The format is [row, col

From Video Devicecorresponding to the uncompressed red, green, and blue colorbands. Note that some devices will use Y CbCr for the separatecolor signa

Video Input (Obsolete)Purpose Connect to image acquisition deviceLibrary Image Acquisition ToolboxDescription The Video Input block is obsolete. It ma

Video Input (Obsolete)Device nameThe image acquisition device to which you want to connect. Theitems in the list vary, depending on which devices you

AExamplesUse this list to find examples in the documentat ion.

A ExamplesFundamentals“Basic Image Acquisition Procedure” on page 1-5“Determining the Device Adapto r Name” on page 4-3“Determining the Device ID ” o

Acquiring Image DataAcquiring Image Data“Specifying Trigger Type, Source, and Condition” on page 5-6“Example: Using an Immediate Trigger” on page 5-11

2 IntroductionSetting Up Generic Windows V ideo AcquisitionDevicesIEEE 1394 (FireWire) and generic Windows v ideo acquisition devices that useWindows

A ExamplesA-4

IndexIndexAacquiring data 3-21acquiring imagesbasic procedure 1-5connecting to devices 4-1overview 5-3specifying a delay 5-28specifying the amount 5-2

Indextroubleshooting 10-4DALSA Coreco Sapera devicesdetermining driver version 10-7troubleshooting 10-6dark frames 3-24Data Translation devicestrouble

IndexFirewire (IE EE 1394) Digital Camera (DCAM)specificationsupport for 2-4flushdata function 12-7using 5-37frame delayspecifying 14-48frame grabbers

Indexspecifying a delay 14-48specifying the timeout value 14-42time-based acquisition 6-5using timers with 14-43image acquisition devices 2-2adaptors

Indeximaqcallback functionusing default callback function 7-2imaqfind function 12-16using 4-28imaqhelp function 12-18getting prope rty information 4-2

IndexPreview window 3-19previewingclosing the preview window 2-11creating custom preview GUIs 2-11opening the Video Pre view window 2-9performing cust

Indexspecifying period of 14-44specifying with image acquisition 14-43timing of acquisitionretrieving 6-20trigger eventsdefinition 7-6information re t

Indexopening 2-9stopping the p review video s tre a m 2-10troubleshooting 10-26video source objectsarray of 14-36currently selected source 14-33displa

Setting Up Image Acquisition HardwareTherateatwhichImageAcquisitionToolbox can process images depends onthe processor speed, the complexity of the pro

2 IntroductionPreviewing DataIn this section.. .“Introduction” on page 2-8“Opening a Video Preview Window” on page 2-9“Stopping the P review Video Str

Previewing Data• “Performing C ustom Processing of Previewed Data” on page 2-13Opening a Video Preview WindowTo open a Video Preview window, use the p

2 IntroductionStoppingthe Preview Video StreamWhen youuse thepreview function to start previewing image data, the VideoPreviewwindow displays a view o

Previewing DataTo restart the video stream in the Video Preview window, call preview againon the same v id eo input object.preview(vid)Closing a Video

2 Introduction% Create a video input object .vid = videoinput('winv ideo');% Create a figure window. Thi s ex ampl e tu rns off the default%

Previewing DataPerforming Custom Processing of Previewe d DataWhen you specify an image object to the preview function (see “Preview ingData in Custom

2 IntroductionArgument DescriptionA data structure containing the following fields:DataCurrent image frame specified as anH-by-W-by-B array, where H i

Previewing Dataht = getappdata(himage ,'HandleToTimestamp Label');% Set the value of the text label .set(ht,'String',tstampstr);%

ContentsGetting Started1What Is Image Acquisition Toolbox?...1-2Overview... 1-2Installation and Con

2 Introduction% Set up the push buttonsuicontrol('String', 'Start Preview',...'Callback', 'previ ew( vid)',...

Previewing Data% Make handle to text label available to update function.setappdata(hImage,'HandleToTimesta mpLabel',hTextLabel);preview(vid,

2 Introduction2-18

3Using the Image AcquisitionTool GUIThe Image Acquisit ion Tool Desktop(p. 3-2)Describes opening the tool andall the parts of the desktop userinterfac

3 Using the Image Acquisition Tool GUIThe Image Acquisition Tool DesktopIn this section.. .“Opening the Tool” on page 3-2“Parts of the Desktop” on pag

The Image Acquisition Tool Desktop• Hardware Browser – Shows the image acquisition devices currentlyconnected to your system. Each device is a separat

3 Using the Image Acquisition Tool GUISee “Selecting Your Device” on page 3-5 for more information about usingthe Hardware Browser.• Preview window –

Selecting Your DeviceSelecting Your DeviceIn this section.. .“Selecting a Device and Format” on p age 3-5“Adding New Hardware” on page 3-6“Using a Cam

3 Using the Image Acquisition Tool GUISelectthedeviceformatorcamerafileyouwanttousefortheacquisitionbyclicking its name in the tree. When the format i

Selecting Your DeviceAcqu isition Har dware to display the new device in the HardwareBrowser.Using a Camera FileIf y our device supports the use of a

Setting Up DCAM Devices ... 2-6Resetting Your Image Acquisition Hardware... 2-6A Note About Frame Rates and Processing

3 Using the Image Acquisition Tool GUISetting Acquisition Para m ete rsIn this section.. .“Using the A cquisition Parameters Pane” on page 3-8“Setting

Setting Acquisition ParametersSetting Frames Per TriggerThe Frames Per Trigger field on the General tabisusedtosetthenumberof frames per trigger you w

3 Using the Image Acquisition Tool GUINote Some devices need a few frames to warm up, or may a lways skip thefirst frame. If your device does that, ch

Setting Acquisition Parameters3 Start your acquisition using those settings.Setting Device-Specific Param etersUse the Device Properties tabtovieworch

3 Using the Image Acquisition Tool GUIUse the properties table to view or edit properties:• If a property has a pencil icon in the value column of the

Setting Acquisition ParametersLogging Your DataUse the Logging tab to set up logging options. T his determines where yourdata is logged to when you d

3 Using the Image Acquisition Tool GUIMemory LoggingIf you select Memory or Disk and M em ory in the Logging To fiel d, theMemory Limit fie ld will di

Setting Acquisition Parameters4 Set your Frame Rate, which is the rate in frames per second that thelogged AVI file is displayed when you play it back

3 Using the Image Acquisition Tool GUItriggers, you stop the acquisition manually by clicking the Stop AcquisitionbuttoninthePreview window.Selecting

Setting Acquisition ParametersTo perform hardware triggering:1 Select your device format and optionally click Start Preview to previewthe device.2 Opt

Exporting Data ... 3-26Saving Image Acquisition Tool Configurations... 3-28Exporting Hardware Configurations to M

3 Using the Image Acquisition Tool GUI6 Click the Start Acquisition button to ge t live feed from the device.7 When the Trigger Condition is met, the

Previewing and Acquiring DataPreviewing and A cquiring DataIn this section.. .“The Preview Window” on page 3-19“Previewing Data” on page 3-21“Acquirin

3 Using the Image Acquisition Tool GUIUse the buttons in the Preview window to:• Preview your image. See “Previewing Data” on page 3-21 for moreinform

Previewing and Acquiring Data• Export data. See “Exporting Data” on page 3-26 for more information.Below the area that displays the frames you will se

3 Using the Image Acquisition Tool GUIThenodeslistedunderthedevicenamearetheformatsthedevicesupports.They may correspond to the different resolutions

Previewing and Acquiring DataFor more information about logging, see “Logging Your Data” on page 3-13.6 Start the acquisition by clicki ng t he Start

3 Using the Image Acquisition Tool GUIIf Images Are Blurry or DarkIf the first one or more frames of your acquisition are blurry, black, or of lowqual

Previewing and Acquiring DataYou can allow for device warm-up by using manual trigge ring. This allowsyou to start the acquisition after the device ha

3 Using the Image Acquisition Tool GUIExpor ting DataYou can export the data tha t has been acquired in memo ry to a MAT-fileor the MATLAB Workspace.T

Exporting Data4 If yo u exported to the MATLAB Workspace, the dialog box closes and thedata will be saved to the MATLAB Workspace.If you are exporting

Using the obj2mfile C ommand ... 4-30Acquiring Image Data5Data Logging ... 5-3Overview...

3 Using the Image Acquisition Tool GUISaving Image Acquisition Tool ConfigurationsYou can save the configuration information abo ut any of y our devic

Saving Image Acquisition Tool ConfigurationsThe configuration is saved to an Image Acquisition Tool (IAT) file in thelocation you specified.Yo u can t

3 Using the Image Acquisition Tool GUIExpor ting Hardware Configurations to M AT LABYo u can export the video input objects and their configured param

Expor ting Hardware Configurations to MATLAB3 Decide what object configuration(s) to export.The Object Ex porter dialog box lis ts the currently selec

3 Using the Image Acquisition Tool GUI3-32

4Connecting to HardwareTo connect to an image acquisition device from w ithin MATLAB, you mustcreate a video input object. This object represents the

4 Connecting to HardwareDeleting Image Acquisition Objects(p. 4-28)Describes how to delete the imageacquisition obje c ts you createSaving Image Acqui

Getting Hardware Inform ationGetting Hardware InformationIn this section.. .“Getting Hardware Information” on page 4-3“DeterminingtheDeviceAdaptorName

4 Connecting to Hardwarevisit the Image Acquisition Toolbox product page at the MathWorks Web site(www.mathworks.com/products/imaq).To determin e whic

Getting Hardware Inform ationinfo = imaqhwinfo('ma trox');info =AdaptorDllName: [1 x73 char]AdaptorDllVersion: '2.1 (R2007a)'Adapt

Logging Image Data to Disk ... 5-40Logging Data to Disk... 5-40Creating an AVI File Object for Logging

4 Connecting to HardwareDefaultFormat: 'M_ RS17 0'DeviceFileSupported: 1DeviceName: 'Orion 'DeviceID: 1ObjectConstructor: 'vi

Getting Hardware Inform ationImage acquisition devices typically support multiple v ideo formats. You canspecify the video format when you create the

4 Connecting to HardwareM_RS170_VIA_RGBans{3} =M_CCIRans{4} =M_CCIR_VIA_RGBans{5} =M_NTSCans{6} =M_NTSC_RGBans{7} =M_NTSC_YCans{8} =M_PALans{9} =M_PAL

Creating Image Acquisition ObjectsCreating Image Acquisition ObjectsIn this section.. .“Types of Objects” on page 4-9“Video Input Objects” on page 4-9

4 Connecting to HardwareAt any one time, only one of the video source objects, called the selectedsource, can be active. This is the source used for a

Creating Image Acquisition Objectsdefault videoinput syntax in the ObjectConstructor field of the d e vi ceinformation structure.vid = videoinput(&apo

4 Connecting to Hardwareformat, the toolbox creates a video source object for each connection. Foranexampleshowingthevideosourceobje cts created with

Creating Image Acquisition ObjectsThe following sections describe these options. If you do not specify a videoformat, thevideoinput function uses one

4 Connecting to HardwareNote For Matrox devices, the M_NTSC_ RGB format string represents acomponent video format.This example creates a video input o

Creating Image Acquisition ObjectsThis example creates a video input object specifying a Matrox deviceconfiguration file as an argument.Specifying the