SetPageCalibration

image\bltlrgss.gif Editions  image\bltlrgss.gif Related Transactions  image\bltlrgss.gif Example

The SetPageCalibration transaction defines a scale factor for the page to be used when measuring lines and regions on that page. Calibration is used when measurements returned based on the image resolution are not accurate. For example, you may know that an image line is 1.5 inches long, but the value returned when you use the Measure tool on it is 3 inches. In that case you could calibrate the page by a scale factor of 0.5.

Type XTYP_EXECUTE

Syntax [SetPageCalibration(docwinID, pageID, scaleFactor, units)]

Parameter

Data type

Values

Meaning

docwinID

DWORD

0 | docwinID

active | specific

pageID

DWORD

0 | pageID

current | specific

scaleFactor

float

calibrated scale factor of page

units

WORD

1

inches

 

 

2

cm

 

 

3

pixels

 

 

4

feet

 

 

5

mm

 

 

6

m

 

 

7

points

 

 

8

twips

 

 

9 | 10 | 11

custom 1 | 2 | 3. See Remarks.

Remarks

To be used, custom units must be defined in Imagenation (through the Units category or dialog box).

Release information

Added in Release 4.31.

See also

Calibrating measurements