Spatial Calibration  
Top  Previous  Next


Menu:   Measure > Spatial Calibration  
Script   spaceCal, loadSpaceCal, defSpaceCal, setSpaceCal, getSpaceCal  

Use this command to edit and/or apply an existing spatial calibration
scale to an image or to create a new scale. If you choose this command or double-click any ruler in the active image frame, the Spatial Calibration dialog box will appear with the following options:

Input
 
Displays the number of the image frame for spatial calibration. If you want to perform the spatial calibration for another image, type or select the corresponding value.  

Name
 
Displays the name of the spatial calibration scale to be edited and/or applied. If you want to edit and/or apply another spatial calibration scale, select its name from the drop-down list of all of the spatial calibration scales that have been created and saved.  

Define
 
Click this button to perform manual calibration. When you click this button and move the cursor over an image frame, the cursor will take shape of a cross with a straight line segment. To draw a line of a known length, click the left mouse button to set the starting point, move the mouse to extend the line vertically or horizontally, and click the primary button again to set the end point. As you do this, the Length dialog box will appear. Enter the line length in the calibration units that are indicated in the Unit box and click OK. (If you want to draw another line, click Cancel, and ImageWarp will close the Length dialog box.) After you click OK, you will return to the Spatial Calibration dialog box. ImageWarp will calculate the calibration by dividing the number of pixels under the defining line by the number of calibration units that you indicated in the Length dialog box. The result will be placed in both the X and Y boxes under Units/Pixel. When you complete performing spatial calibration, click Done.  

Add
 
Click this button to add a new spatial calibration scale to ImageWarp's list of calibration scales. When you click this button, the Add dialog box will appear. Type the name for the new spatial calibration scale under Enter new scale and click OK. (If you click Cancel, ImageWarp will close the Add dialog box without creating a new spatial calibration scale.) After you click OK, you will return to the Spatial Calibration dialog box.  

Rename
 
Click this button to rename the current spatial calibration scale. When you click this button, the Rename dialog box will appear. Type the new name for the spatial calibration scale under Rename this scale as and click OK. (If you click Cancel, ImageWarp will close the Rename dialog box without renaming the active spatial calibration scale.) After you click OK, you will return to the Spatial Calibration dialog box.  

Delete
 
Click this button to delete the active spatial calibration scale.  

Default
 
Click this button to store the current spatial calibration scale as the default one for all new images acquired with the video device.  

Unit
 
Type the name for the spatial calibration unit. If you do not indicate any calibration unit in this box, ImageWarp will automatically use pixels as the calibration units for the spatial scale being defined.  

Units/Pixel
 
Displays the number of spatial calibration units per pixel in both the horizontal (X) and vertical (Y) directions. Click the Define button to define the units/pixel ratio, or type the horizontal and vertical values in the X and Y boxes respectively.  

Aspect Ratio
 
Displays the proportionately correct relationship between the horizontal (X) and vertical (Y) axes in the active image. The value in the Aspect Ratio box represents the X/Y ratio. It can be used to compensate for an image acquired with a device having an aspect ratio different from that of the displaying device. When the Units/Pixel values change, the Aspect Ratio is recalculated accordingly.  

Lock
 
Select this check box to preserve the current Aspect Ratio. If you know the exact aspect ratio of the active image, you may select this check box and perform only vertical or horizontal spatial calibration; the other value will be recalculated accordingly. If you select Lock, you may also draw the line for calibration in any direction. If you want to constrain the line for calibration to a vertical or horizontal line, hold down the CTRL key while dragging the cursor.  

Origin (Pixels)
 
To set the location of the origin of the active image coordinate system, first click Upper Left, or Center, or Bottom Left depending on where you want the origin of the image coordinate system to be. You can change the direction of the vertical axis (Y) without affecting the origin of the image coordinate system by clicking the arrow on the right. The X and Y boxes let you specify the horizontal and vertical offset of the origin of the image coordinate system relative to the top left corner of the image, in pixels. These values define what will be considered position 0,0 within the image. Type the horizontal and vertical coordinates of the point you want to be considered the origin in the X and Y boxes respectively under Origin (Pixels). Both positive and negative values are allowed. A negative X value will move the origin to the left of the left edge of the image, while the negative Y value will move the origin up above the top line of the image.  

Apply
 
Applies the current spatial calibration scale to the image.  

Save
 
Saves the calibration scale for future references.  

Close
 
Closes the dialog box.