VGETCAL (cam) scalers[i], pmm.to.pix[j,k], pix.to.pmm[l,m], to.cam

Function

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

Parameter s

cam Optional real-valued expression that specifies the virtual camera number.

scalers[] Real array that receives the scaler calibration values.

pmm.to.pix[,] Optional, two-dimensional real array that receives the millimeter-to-pixel transformation matrix. If this array is specified, the array pix.to.pmm[,] must also be specified.

pix.to.pmm[,] Optional, two-dimensional real array that receives the pixel-to-millimeter transformation matrix. If this array is specified, the array pmm.to.pix[,] must also be specified.

i Optional integer values that identify the first array
j,k element to be defined in the respective array. Zero is assumed
l,m for each index that is omitted. If an array is specified that has
more dimensions than needed, only the rightmost indexes are
incremented as the values are assigned.

to.cam Optional variable that receives the vision transformation.

Details

This instruction is used by the calibration programs supplied with the vision system. The calibration programs perform a VGETCAL to determine what calibration data was previously defined via VPUTCAL.

On power-up, the vision system preassigns calibration data for all virtual cameras. Virtual cameras are associated with physical cameras in blocks of four: Virtual cameras 1-4 are associated with physical cameras 1-4; virtual cameras 5-8 are associated with physical cameras 5-8; etc. For each virtual camera, one millimeter is made equal to one pixel, and perspective calibration is not used. This makes the system usable for setup or experimentation. For precision work, however, a calibration procedure should be performed.

Since the calibration arrays are normally filled by an Adept V+ utility program, the programmer should not have to be completely familiar with the individual array elements. However, the contents of the arrays are listed in this manual in the description of the VPUTCAL instruction.

Example

	VGETCAL (3) cal[], mp[,], pm[,] 							;Get cam calibration data
 

Related Keyword

VPUTCAL (camera) scalers[i], pmm.to.pix[j,k], pix.to.pmm[l,m], to.cam (program instruction)

Syntax