AdeptVision Keyword Quick Reference

The following table summarizes the keywords for the AdeptVision option listing the arguments and basic functions for each keyword. To view the complete documentation for a keyword, double-click on the keyword or description. 

Table 1-2. AdeptVision Keyword Summary
Keyword

Description

V.2ND.MOMENTS

Enable computation of the best-fit ellipse for each region in the image.

V.2ND.THRESH

Set a second threshold for use during binary image processing.

VABORT

Abort any active vision processing and all pending vision operations associated with the given task number.

VADD

Add two binary or grayscale images.

VAUTOTHR

Determine good thresholds for binary image processing based on the gradients in a grayscale frame store.

V.BACKLIGHT

Define which color (black or white) is to be considered the background.

V.BINARY

Enable or disable automatic edge-image generation at VPICTURE time.

V.BORDER.DIST1

Define an image border reduction (in pixels) to mask out regions clipped by the image border.

V.BOUNDARIES

Enable or disable boundary analysis by the vision system.

V.CENTROID

Enable computation of the centroid of each region in the image.

VCONVOLVE

Perform an image convolution on a grayscale frame, possibly storing the result in a different frame store.

VCOPY

Copy the image from one image buffer region to another.

VCORRELATE

Perform a normalized grayscale or binary correlation, comparing a predefined template with a rectangular image window, or searching for a closest match within the window to a predefined template.

VDEF.AOI

Define an area-of-interest (AOI). Areas-of-interest are used by most vision tools to specify the tool placement within an image.

VDEF.CONVOLVE

Define an image convolution.

VDEF.FONT2

Define, replace, or modify an Optical Character Recognition (OCR) font.

VDEFGRIP1

Define the shape and position of a robot gripper for clear-grip tests.

VDEF.LUT

Define a grayscale and binary look-up table for mapping graylevel and binary values during a VCOPY operation.

VDEF.MORPH

Define a binary morphological operation.

VDEF.SUBPROTO2

Define a subprototype.

VDEF.TRANS

Define a transformation to apply to the location of all vision tools placed until the next VDEF.TRANS instruction.

VDELETE

Delete a specified prototype, subprototype, Optical Character Recognition (OCR) font, or correlation template in the vision system.

V.DISJOINT1

Determine whether or not prototypes may be matched to multiple disjoint regions.

VDISPLAY

Select the current vision display mode or the display mode to be used when the vision system performs its normal image processing functions.

V.DRY.RUN

Enable graphics-only mode for various vision operators.

VEDGE

Compute edges in the grayscale image and threshold the edges, replacing the binary image, using either a cross-gradient or Sobel algorithm. If your system is equipped with an AVI board, the Roberts and Quick Sobel algorithms may also be used. For details on the edge algorithms, see V.EDGE.TYPE.

VEDGE.INFO2

Retrieve information about the edges and corners of a prototype or of a region in the image.

V.EDGE.INFO

Enable saving of information about edges in the image for recall via the VEDGE.INFO instruction.

V.EDGE.STRENGTH

Set the edge threshold for grayscale image processing and fine-edge rulers.

V.EDGE.TYPE

Determine the type of edge operator to use, cross-gradient or Sobel, when a VPICTURE instruction is performed.

VFEATURE2

Return specified information about the object most recently VLOCATEd or the ObjectFinder or prototype model most recently displayed by the VSHOW program instruction.

VFIND.ARC

Fit a circular arc to an image edge bounded by a window that is shaped like a ring or a ring segment.

VFIND.ARC.MULTI

Estimates the center of a wafer by using data on the initial wafer state and data gathered from multiple images of the wafer captured as the wafer is rotated on a platform.

VFINDER

This instruction performs ObjectFinder recognition using the planning associated with the given virtual camera.

VFIND.LINE

Fit a straight line to an image edge within a window.

VFIND.POINT

In a search window, find the edge point that is nearest to one side of the window.

V.FIRST.COL1

Set the number of the first column of pixels to be processed.

V.FIRST.LINE1

Set the number of the first line of pixels to be processed.

V.FIT.ARCS

Enable or disable the fitting of circular arcs when performing boundary analysis.

V.GAIN

Set the gain for the incoming video (camera) signal. The operation of this parameter depends on whether your system is equipped with an EVI or AVI vision board

VGAPS1

Find the unverified gaps in a match with a prototype or subprototype.

VGET.AOI

Return the definition of an area-of-interest.

VGETCAL

Ask the system to fill in arrays with the previously defined vision calibration data for a given virtual camera.

VGETPIC

Read all or part of an image into a string array.

VGET.TRANS

Return the value of the current vision transformation.

VHISTOGRAM

Compute the histogram for a grayscale frame store.

V.HOLES

Enable or disable the accounting of interior features in all objects.

V.IO.WAIT

Enable the synchronization of taking pictures (VPICTUREs) with an external event that triggers the fast digital-input interrupt line.

VISION

Enable the entire vision system.

V.LAST.COL1

Set the number of the last column of pixels to be processed.

V.LAST.LINE1

Set the number of the last line of pixels to be processed.

V.LAST.VER.DIST1

Enable an extra verification of prototype-to-image matches and specify the pixel tolerance to use when determining boundary coincidence.

VLOAD2

Load vision models (ObjectFinder models, prototypes, Optical Character Recognition fonts, or correlation templates) from a disk file.

VLOCATE2

Identify and locate an object in the scene.

V.MAX.AREA

Set the maximum area above which the vision system ignores regions.

V.MAX.PIXEL.VAR

During a VFIND.LINE or VFIND.ARC operation, this parameter specifies the maximum pixel distance from the fit edge beyond which edge points may be filtered out.
During boundary analysis, this parameter sets the maximum pixel deviation allowed when fitting lines and arcs to region edges.

V.MAX.SD

Set the distance (in units of standard deviation) from the fit line or arc beyond which edge points should be filtered out.

V.MAX.TIME

Set the maximum time allowed for the vision system to analyze a region during object finding, prototype recognition, or OCR. A value of 0 means that there is no time limit.

V.MAX.VER.DIST1

Set the pixel tolerance for determining boundary coincidence during the verification of prototype-to-image matches.

V.MIN.AREA

Set the minimum area below which the vision system ignores regions.

V.MIN.HOLE.AREA

Set the minimum area below which the vision system ignores holes.

V.MIN.LEN

Set the minimum length of features to be used for feature pairs.

V.MIN.MAX.RADII

Enable the feature that, for each region in the image, finds the two points on the perimeter that are closest to and farthest from the region centroid.

VMORPH

Perform a morphological transform on a binary image frame.

VOCR2

Perform Optical Character Recognition (OCR) or text verification in a rectangular image window.

V.OFFSET

Set the offset for the incoming video signal (that is, program the zero reference for the A/D converter). On AVI-equipped vision systems, this parameter controls the black reference value for the A/D section of the AVI board.

V.OVERLAPPING1

Determine whether or not objects may be overlapping in the image.

VPATTERN

Performs pattern recognition using a pattern plan model.

V.PERIMETER

Enable computation of the lengths of region perimeters.

VPICTURE

Acquire an image into a frame store and/or initiate processing.

VPLAN.FINDER

Set up the type of planning used by the ObjectFinder when locating models.

VPLAN.PATTERN

Builds the internal pattern matching strategy based on a specified pattern model which is created using the VTRAIN.PATTERN function

VPUTCAL

Load vision calibration data from 1 to 3 arrays.

VPUTPIC

Store into a frame store an image saved previously with VGETPIC.

VQUEUE (monitor command)

Display object information for any objects queued in the vision system awaiting retrieval by VLOCATE instructions.

VQUEUE (program instruction)

Return the number of objects in the vision system queue.

V.RECOGNITION1

Enable or disable prototype recognition by the vision system.

VRENAME

On AdeptVision AVI-equipped systems, rename an ObjectFinder model, pattern model/plan, or custom camera model.

On AdeptVision EVI-equipped systems, rename a prototype or subprototype.

VRULERI

Obtain edge information or graylevels along a line or circular arc in the current image.

VSELECT

Select a virtual frame buffer for processing or display and, optionally, select a virtual camera and its calibration to be associated with the frame buffer.

VSET.ARC.MULTI

Allocates and stores edge points from a number of VFIND.ARC program instructions for multi-frame estimation using the program instruction VFIND.ARC.MULTI. The VSET.ARC.MULTI program instruction also stores additional information required to perform multi-frame estimation.

VSHOW2 (monitor command)

For AdeptVision EVI systems, this command lists the defined prototypes or display a vision prototype, a subprototype, or a specific prototype edge in the Vision display window. Edge numbers are optionally shown.

For AdeptVision AVI systems, this monitor command lists the ObjectFinder models and custom camera models that are currently loaded into the AdeptVision system.

VSHOW (program instruction)

Display a vision model (ObjectFinder, prototype, or subprototype) and make information about it available through the VFEATURE real-valued function.

V.SHOW.BOUNDS

Enable the special display of the lines and arcs fit to the boundaries of regions.

V.SHOW.EDGES

Enable the special display of edges-both the primitive edges that are fit to the boundaries of regions, and the edge points that are found by the finders VFIND.LINE, VFIND.ARC, and VFIND.POINT.

V.SHOW.FEATS1

Enable the special display of features used for ObjectFinder recognition.

V.SHOW.GRIP1

Enable the special display of clear-grip tests.

VSHOW.MODEL2

Display a model-either a correlation template or an Optical Character Recognition (OCR) font-and return information about it, or return information about all the defined templates or OCR fonts. Also, accept the name of an ObjectFinder model and return data from the model in the array provided as an argument.

V.SHOW.RECOG

Enable the special display of the objects recognized.

V.SHOW.VERIFY1

Enable the special display of the verification step in the recognition process.

VSTATUS2 (monitor command)

Display vision system status information in the Monitor display window.

VSTATUS2 (program instruction)

Return vision system status information in a real array.

VSTORE2 (program instruction)

Store in a disk file selected (or all) vision prototypes (and their subprototypes), Optical Character Recognition (OCR) fonts, or correlation templates.

VSTORE2 (monitor command)

Store in a disk file selected (or all) vision prototypes (and their subprototypes), Optical Character Recognition (OCR) fonts, or correlation templates.

V.STROBE

Enable the firing of a strobe light in synchronization with taking pictures (VPICTUREs).

VSUBPROTO1

Determine the percentage of an edge or subprototype that was verified during recognition. Also, this instruction can have the prototype position refined, based on only a subprototype or a single edge, producing an adjusted location for the prototype.

VSUBTRACT

Subtract two binary or grayscale images.

V.SUBTRACT.HOLE

Determine whether or not hole areas are to be subtracted from region areas.

V.SYNC.STROBE

Select synchronous or asynchronous firing of a strobe light when a picture is taken (that is, when a VPICTURE is executed).

VTHRESHOLD

Threshold a grayscale image, producing a binary image.

V.THRESHOLD

Set the camera grayscale value that separates black pixels from white pixels.

V.TOUCHING1

Determine whether or not objects may be touching in the image.

VTRAIN2 (monitor command)

Initiate training of the prototype whose name is specified.

VTRAIN2 (program instruction)

Initiate training of the prototype whose name is specified.

VTRAIN.FINDER (for EVI-equipped systems)

Initiate training of the specified ObjectFinder model.

VTRAIN.FINDER (for AVI-equipped systems)

Initiate training of the specified ObjectFinder model.

VTRAIN.MODEL2

Train on a vision model-a correlation template or an Optical Character Recognition (OCR) font. For correlation, this instruction defines the template. For OCR, this instruction trains the vision system to recognize characters in a font, or causes the vision system to plan the recognition strategy for a fully trained font.

VTRAIN.PATTERN

Creates a pattern model to be used for pattern matching during recognition. 

Delay program execution until processing of a VPICTURE or VWINDOW operation is complete.

Perform processing (blob finder, prototype recognition, or ObjectFinder) within a rectangular window in the image.

Extract image information from within a rotatable, rectangular window.

Extract image information from within a window with any of the following shapes: rectangle, circle, pie cut, ring, or ring segment.

1 If your system uses AdeptVision AVI, this keyword is no longer relevant.
2 Prototype and Optical Font Recognition functionality is no longer supported on systems using AdeptVision AVI.