ImageGear for C and C++ on Linux v18.8 - Updated
IG_PDF_word_get_quad
API Reference Guide > PDF Component API Reference > PDF Component Objects Reference > General Objects > HIG_PDF_WORD > IG_PDF_word_get_quad

Gets the specified word's quad, specified in user space coordinates.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_PDF_word_get_quad( 
        HIG_PDF_WORD hWord, 
                SHORT nIndex, 
                LPAT_PDF_FIXEDQUAD lpQuad, 
                LPAT_PDF_BOOL lpbHasQuad 
);

Arguments:

Name Type Description
hWord HIG_PDF_WORD The word whose quad is obtained.
nIndex SHORT The index of the quad to obtain. The first quad in a word has an index of zero.
lpQuad LPAT_PDF_FIXEDQUAD Pointer to the word's quad, specified in user-space coordinates.
lpbHasQuad LPAT_PDF_BOOL TRUE if the word has the specified quad; FALSE otherwise.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

See IG_PDF_word_get_quad_count for a description of a quad.

The quad's height is the height of the font's bounding box, not the height of the tallest character used in the word. The font's bounding box is determined by the glyphs in the font that extend farthest above and below the baseline; it often extends somewhat above the top of "A" and below the bottom of "y."

The quad's width is determined from the characters actually present in the word.

As an example, the quads for the words "AWAY" and "away" have the same height, but generally do not have the same width unless the font is a mono-spaced font (a font in which all characters have the same width).