DynaPDF Manual - Page 455
Previous Page 454 Index Next Page 456
Function Reference
Page 455 of 839
UI32
DistanceCount; // Number of objects in the array.
float
OriginX;
// X-Origin of the measurement coordinate system.
float
OriginY;
// Y-Origin of the measurement coordinate system.
const char* RA;
// A text string expressing the scale ratio of the drawing.
const UI16* RW;
// A text string expressing the scale ratio of the drawing.
INFM**
Slope;
// Number format array to measure the slope -> GetNumberFormatObj()
UI32
SlopeCount;
// Number of objects in the array.
INFM**
X;
// Number format array for measurement of change along the x-axis and,
// if Y is not present, along the y-axis as well.
UI32
XCount;
// Number of objects in the array.
INFM**
Y;
// Number format array for measurement of change along the y-axis.
UI32
YCount;
// Number of objects in the array.
/* --- Geospatial measure dictionary --- */
float*
Bounds;
// Array of numbers taken pairwise to describe the bounds for which
// geospatial transforms are valid.
UI32
BoundCount;
// Number of values in the array. Should be a multiple of two.
// The DCS coordinate system is optional.
LBOOL
DCS_IsSet;
// If true, the DCS members are set.
LBOOL
DCS_Projected; // If true, the DCS values contains a pojected coordinate system.
SI32
DCS_EPSG;
// Optional, either EPSG or WKT is set.
const char* DCS_WKT;
// Optional ASCII string.
// The GCS coordinate system is required and should be present.
LBOOL
GCS_Projected; // If true, the GCS values contains a pojected coordinate system.
SI32
GCS_EPSG;
// Optional, either EPSG or WKT is set.
const char* GCS_WKT;
// Optional ASCII string.
float*
GPTS;
// Required, an array of numbers that shall be taken pairwise,
// defining points in geographic space as degrees of latitude and
// longitude, respectively.
UI32
GPTSCount;
// Number of values in the array.
float*
LPTS;
// Optional, an array of numbers that shall be taken pairwise to
// define points in a 2D unit square.
UI32
LPTSCount;
// Number of values in the array.
const char* PDU1;
// Optional preferred linear display units.
const char* PDU2;
// Optional preferred area display units.
const char* PDU3;
// Optional preferred angular display units.
};
The function retrieves the properties of a measure dictionary. The parameter Measure must be a
valid pointer of a measure dictionary. Such a pointer can be returned by GetImageObj(),
GetViewport(), ParseContent(), and other functions. The member StructSize must be set to
sizeof(TPDFMeasure).
Two different types of measure dictionaries are available: one for rectilinear coordinate systems and
one for geospatial coordinate systems.
The member IsRectilinear specifies which type was returned. Depending on the type different
members of the structure are set. Take a look at the comments in the structure definition to
determine which values will be present.
The function returns pointers of the original values. Do not modify or free any value!
A rectilinear measure dictionary contains one or more arrays of Number Format dictionaries. These
objects can be accessed with GetNumberFormatObj().
To determine how measure information can be used please have a look into the PDF Reference 2.0,
ISO/DIS 32000-2, Section Measurement properties.
Previous topic: GetMatrix, GetMaxFieldLen, GetMeasureObj
Next topic: GetMetaConvFlags, GetMetadata