<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<
meta http-equiv="Content-Type" content="text/html; charset=utf-8">
body { font-family: Verdana, Geneva, Arial, Helvetica, serif;
color: #000000;
background: #FFFFFF; }
p { text-align: justify; }
h1 { text-align: center; }
li { text-align: justify; }
td { padding: 0 0.5em 0 0.5em; }
td.left { padding: 0 0.5em 0 0.5em;
text-align: left; }
a:link { color: #0000EF; }
a:visited { color: #51188E; }
a:hover { color: #FF0000; }
span.keyword { font-family: monospace;
text-align: left;
white-space: pre;
color: darkblue; }
pre.colored { color: blue; }
ul.empty { list-style-type: none; }
PFR Fonts
<
table align=center
cellspacing=5 cellpadding=0 border=0>
<
tr><
td><
/td><
td><
a href="#FT_Get_PFR_Metrics">FT_Get_PFR_Metrics<
/a><
/td><
td><
/td><
td><
a href="#FT_Get_PFR_Kerning">FT_Get_PFR_Kerning<
/a><
/td><
td><
/td><
td><
a href="#FT_Get_PFR_Advance">FT_Get_PFR_Advance<
/a><
/td><
/tr>
<
p>This section contains the declaration of PFR-specific functions.<
/p>
<
h4><
a name="FT_Get_PFR_Metrics">FT_Get_PFR_Metrics<
/a><
/h4>
Defined in FT_PFR_H (freetype/ftpfr.h).
<
table align=center
width="87%"><
tr bgcolor="#D6E8FF"><
td><
pre>
FT_EXPORT
( <
a href="ft2-basic_types.html#FT_Error">FT_Error<
/a>
)
<
b>FT_Get_PFR_Metrics<
/b>
( <
a href="ft2-base_interface.html#FT_Face">FT_Face<
/a>
face,
<
a href="ft2-basic_types.html#FT_UInt">FT_UInt<
/a> *aoutline_resolution,
<
a href="ft2-basic_types.html#FT_UInt">FT_UInt<
/a> *ametrics_resolution,
<
a href="ft2-basic_types.html#FT_Fixed">FT_Fixed<
/a> *ametrics_x_scale,
<
a href="ft2-basic_types.html#FT_Fixed">FT_Fixed<
/a> *ametrics_y_scale
);
<
p>Return the outline and metrics resolutions of a given PFR
face.<
/p>
<
table cellpadding=3 border=0>
<
p>Handle to the input
face. It can be a non-PFR
face.<
/p>
<
table cellpadding=3 border=0>
<
tr valign=top><
td><
b>aoutline_resolution<
/b><
/td><
td>
<
p>Outline resolution. This is equivalent to ‘face->units_per_EM’
for non-PFR fonts. Optional
(parameter can be NULL
).<
/p>
<
tr valign=top><
td><
b>ametrics_resolution<
/b><
/td><
td>
<
p>Metrics resolution. This is equivalent to ‘outline_resolution’
for non-PFR fonts. Optional
(parameter can be NULL
).<
/p>
<
tr valign=top><
td><
b>ametrics_x_scale<
/b><
/td><
td>
<
p>A
16.16 fixed-point number used to scale distance expressed in metrics units to device sub-pixels. This is equivalent to ‘face->size->x_scale’, but
for metrics only. Optional
(parameter can be NULL
).<
/p>
<
tr valign=top><
td><
b>ametrics_y_scale<
/b><
/td><
td>
<
p>Same as ‘ametrics_x_scale’ but
for the vertical direction. optional
(parameter can be NULL
).<
/p>
<
p>FreeType error
code.
0 means success.<
/p>
<
p>If the input
face is not a PFR, this function will return an error. However, in all cases, it will return valid values.<
/p>
<
h4><
a name="FT_Get_PFR_Kerning">FT_Get_PFR_Kerning<
/a><
/h4>
Defined in FT_PFR_H (freetype/ftpfr.h).
<
table align=center
width="87%"><
tr bgcolor="#D6E8FF"><
td><
pre>
FT_EXPORT
( <
a href="ft2-basic_types.html#FT_Error">FT_Error<
/a>
)
<
b>FT_Get_PFR_Kerning<
/b>
( <
a href="ft2-base_interface.html#FT_Face">FT_Face<
/a>
face,
<
a href="ft2-basic_types.html#FT_UInt">FT_UInt<
/a> left,
<
a href="ft2-basic_types.html#FT_UInt">FT_UInt<
/a> right,
<
a href="ft2-basic_types.html#FT_Vector">FT_Vector<
/a> *avector
);
<
p>Return the kerning pair corresponding to two glyphs in a PFR
face. The distance is expressed in metrics units, unlike the result of <
a href="ft2-base_interface.html#FT_Get_Kerning">FT_Get_Kerning<
/a>.<
/p>
<
table cellpadding=3 border=0>
<
p>A handle to the input
face.<
/p>
<
p>Index of the left glyph.<
/p>
<
p>Index of the right glyph.<
/p>
<
table cellpadding=3 border=0>
<
p>FreeType error
code.
0 means success.<
/p>
<
p>This function always return distances in original PFR metrics units. This is unlike <
a href="ft2-base_interface.html#FT_Get_Kerning">FT_Get_Kerning<
/a> with the <
a href="ft2-base_interface.html#FT_Kerning_Mode">FT_KERNING_UNSCALED<
/a> mode, which always returns distances converted to outline units.<
/p>
<
p>You can use the
value of the ‘x_scale’ and ‘y_scale’ parameters returned by <
a href="ft2-pfr_fonts.html#FT_Get_PFR_Metrics">FT_Get_PFR_Metrics<
/a> to scale these to device sub-pixels.<
/p>
<
h4><
a name="FT_Get_PFR_Advance">FT_Get_PFR_Advance<
/a><
/h4>
Defined in FT_PFR_H (freetype/ftpfr.h).
<
table align=center
width="87%"><
tr bgcolor="#D6E8FF"><
td><
pre>
FT_EXPORT
( <
a href="ft2-basic_types.html#FT_Error">FT_Error<
/a>
)
<
b>FT_Get_PFR_Advance<
/b>
( <
a href="ft2-base_interface.html#FT_Face">FT_Face<
/a>
face,
<
a href="ft2-basic_types.html#FT_UInt">FT_UInt<
/a> gindex,
<
a href="ft2-basic_types.html#FT_Pos">FT_Pos<
/a> *aadvance
);
<
p>Return a given glyph advance, expressed in original metrics units, from a PFR font.<
/p>
<
table cellpadding=3 border=0>
<
p>A handle to the input
face.<
/p>
<
table cellpadding=3 border=0>
<
p>The glyph advance in metrics units.<
/p>
<
p>FreeType error
code.
0 means success.<
/p>
<
p>You can use the ‘x_scale’ or ‘y_scale’ results of <
a href="ft2-pfr_fonts.html#FT_Get_PFR_Metrics">FT_Get_PFR_Metrics<
/a> to convert the advance to device sub-pixels
(i.e.,
1/64th of pixels
).<
/p>