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