1Prima::PS::Fonts(3) User Contributed Perl Documentation Prima::PS::Fonts(3)
2
3
4
6 Prima::PS::Fonts - PostScript device fonts metrics
7
9 use Prima;
10 use Prima::PS::Fonts;
11
13 This module primary use is to be invoked from Prima::PS::Drawable
14 module. Assumed that some common fonts like Times and Courier are
15 supported by PS interpreter, and it is assumed that typeface is
16 preserved more-less the same, so typesetting based on font's a-b-c
17 metrics can be valid. 35 font files are supplied with 11 font
18 families. Font files with metrics located into 'fonts' subdirectory.
19
20 query_metrics( $fontName)
21 Returns font metric hash with requested font data, uses
22 $defaultFontName if give name is not found. Metric hash is the same
23 as Prima::Types::Font record, plus 3 extra fields: 'docname'
24 containing font name ( equals always to 'name'), 'chardata' - hash
25 of named glyphs, 'charheight' - the height that 'chardata' is
26 rendered to. Every hash entry in 'chardata' record contains four
27 numbers - suggested character index and a, b and c glyph dimensions
28 with height equals 'charheight'.
29
30 enum_fonts( $fontFamily)
31 Returns font records for given family, or all families perpesented
32 by one member, if no family name given. If encoding specified,
33 returns only the fonts with the encoding given. Compliant to
34 Prima::Application::fonts interface.
35
36 files & enum_families
37 Hash with paths to font metric files. File names not necessarily
38 should be as font names, and it is possible to override font name
39 contained in the file just by specifying different font key - this
40 case will be recognized on loading stage and loaded font structure
41 patched correspondingly.
42
43 Example:
44
45 $Prima::PS::Fonts::files{Standard Symbols} = $Prima::PS::Fonts::files{Symbol};
46
47 $Prima::PS::Fonts::files{'Device-specific symbols, set 1'} = 'my/devspec/data.1';
48 $Prima::PS::Fonts::files{'Device-specific symbols, set 2'} = 'my/devspec/data.2';
49 $Prima::PS::Fonts::enum_families{DevSpec} = 'Device-specific symbols, set 1';
50
51 font_pick( $src, $dest, %options)
52 Merges two font records using Prima::Drawable::font_match, picks
53 the result and returns new record. $variablePitchName and
54 $fixedPitchName used on this stage.
55
56 Options can include the following fields:
57
58 - resolution - vertical resolution. The default value is taken from
59 font resolution.
60
61 enum_family( $fontFamily)
62 Returns font names that are presented in given family
63
64
65
66perl v5.30.0 2019-08-21 Prima::PS::Fonts(3)