VCOPY (cam, scale, dmode, lut) dest_ibr = src

VCOPY (cam, scale, dmode, lut) dest_ibr = src_ibr
 
Function

Copy the image from one image buffer region to another.

Usage Considerations

The scaling, subsampling, look-up table (LUT), and access to the display frame features require the AdeptVision Enhanced Vision Interface (EVI) board.

VCOPY is a 9ms operation.

See the Details section when using the Pulnix TM-1001 camera.

Parameter s

cam Optional integer value specifying a virtual camera. The V.THRESHOLD and V.2ND.THRESH values associated with the virtual camera are used when the scale parameter is 0.5 (see Details).

scale Optional real-valued expression specifies magnification of the copy. The acceptable values are 0.5, 1, and 2. The default is 1. This feature requires the AdeptVision VXL option.

dmode Optional real-valued expression specifying the display mode for this operator. The choices are: -1 = no draw, 0 = erase, 1 = draw solid, 2 = complement, 3 = draw dashed, and 4 = complement dashed. The default is 1 (draw solid).

lut Optional integer in the range 1 to 133 maximum (the actual maximum value is set with the DEVICE instruction) that specifies a defined look-up table. (The default value is 0, which indicates normal operation.) The table is defined with a VDEF.LUT instruction and specifies a replacement value for each possible graylevel value. See the description of VDEF.LUT. This feature requires the AdeptVision VXL option.

dest_ibr Integer value specifying the image buffer region to receive the copied image. Image buffer regions specify both a size and a frame store (see the description of VDEF.AOI).

src_ibr Integer values specifying the image buffer region to copy. The image buffer region's AOI must have been defined with a VDEF.AOI instruction.

NOTE: If only one image buffer region is specified, both image buffer regions default to the specified image buffer region. If neither image buffer region is specified, both default to the currently selected full frame that is selected with a VSELECT or VPICTURE instruction-for example, VPICTURE (1,,1011).

Details

VCOPY copies one image buffer region to another and optionally zooms the image. Both the grayscale and binary images are copied.

If the scale parameter is 0.5, the image is averaged with a 2x2 convolution. The result is then subsampled and thresholded using the threshold parameters for the virtual camera specified in cam.

If the scale parameter is 2, the source frame store must be the display frame store (src_ibr must have the form nnn009). The result is zoomed by 2x.

NOTE: VCOPY is the only instruction that can copy to or from the display frame store.

If lut is specified, the output image is piped through that user LUT prior to output. If subsampling or zooming, thresholding is not performed when using the user LUT.

NOTE: User LUTs are defined with the instruction VDEF.LUT. See the description of VDEF.LUT for more details.

After a frame is copied, the destination frame assumes some attributes of the source frame. In particular, the virtual camera that was associated with the source frame becomes associated with the destination frame. This affects subsequent measurement or inspection operations on the frame, such as VRULERI or VWINDOW, because conversion of pixel units to millimeters is determined by the camera calibration.

NOTE: When copying from one area to another within the same frame buffer, do not copy areas of interest that would overlap areas that will be copied out of later in the operation. Specifically, you cannot VCOPY a 100x100 pixel region down 10 pixels. By the time the tenth row is read out from the source area of interest, it has already been written over by line 1 of the source area of interest.

Considerations when using 1K x 1K frame stores:

There is a design restriction that does not allow zooming 0.5 out of the display frame buffer-doing so will cause an image processing board failure.
There is a design restriction that does not allow zooming 0.5 with a LUT-the system ignores the LUT.
There is a design restriction that does not allow zooming by 0.5 into the display frame buffer-doing so causes an invalid argument.

Example s

Copy one image buffer region in virtual frame store 11 to another image buffer region in the same virtual frame store:
	VCOPY 4011 = 5011	
 
Related Keyword s

VADD (program instruction)

VDEF.AOI (program instruction)

VDEF.LUT (program instruction)

VSELECT (program instruction)

VSUBTRACT (program instruction)

Syntax

VFEATURE-R