CImage:GetImageScaleXy

The GetImageScaleXy method returns the scale in distance units per pixel independently for both image axes.

Syntax

nScaleX, nScaleY = CImage:GetImageScaleXy()

x and y are in distance units per pixel.
On success, this method returns 2 numbers.
On failure, this method returns the default values 1,1.

Remarks

If the image has a WCS calibration, this returns WCS distance units per pixel. If there is no WCS calibration, measurements it returns 1,1. If the image has a different scale in each axis, use the GetImageScale method.

Example

Assume a displayed image has a WCS calibration giving 45.2 microns per pixel in the column axis and 42.4 microns per pixel in the row axis. The following script fragment returns the image scales:

I = V:GetImage()	-- load the image from a display window
x, y = I:GetImageScaleXy()	-- return the scale as a number
Printf("Scale= %lg, %lg",x,y)	-- result: Scale= 45.2, 42.4.