1Libnetpbm PBM Font FunctionLMiabnruaarly(3F)unctioLnisbnMeatnpubamlPBM Font Function Manual(3)
2 Table Of Contents ⟨#toc⟩
6
8 libnetpbm_font \- Libnetpbm PBM Font Function Manual
9
11 This reference manual covers functions in the libnetpbm library for ac‐
12 cessing fonts to draw text characters, using the PBM image format and
13 the libnetpbm in-memory image formats.
14 We actually have very little information here; this is mainly a frame‐
16 work for adding documentation later if someone becomes interested in
17 this facility.
18 Note that the primary known user of this library is the Netpbm program
20 pbmtext. You can use that program's source code as an example.
21
25 libnetpbm represents a font with an object of type struct font. The
26 library provides functions to create these objects.
27 The object these functions create is in newly allocated memory and you
30 can't actually free it. The memory may be in multiple pieces, pointing
31 to each other, and libnetpbm provides no destroy function. (This is
32 only because of implementation laziness).
33
37 The functions are all declared in the pbmfont.h header file.
38 pbm_defaultfont
41 Synopsis
42 struct font *
44 pbm_defaultfont(const char * which);
45 Description
48 This returns a font object representing a font built in to libnetpbm.
50 which is the name of the desired built-in font. There are two:
52 bdf
55 A proportional font similar to Adobe's timR12 font
57 fixed
59 A fixed space font
61 Copyright
64 The provenance of the built-in fonts are not known for sure, but in
66 2018, the bdf font was almost identical to a font on which Adobe and
67 Digital Equipment Corporation once claimed copyright. That font was
68 available in the X.org source code
69 ⟨ftp://ftp.x.org/pub/current/src/font/⟩ in a collection named 'font-
70 adobe-75dpi', in a file named timR12.pcf.gz.
71 Ergo, it is likely that the font was copied into Netpbm from that font
73 in 1991.
74 You may need a copyright license from the copyright owners of that
76 original font not only to copy the libnetpbm code, but to execute it,
77 thus generating copies of the glyphs of the font.
78 The X.org files in 2018 indicate the following copyright claims, along
81 with a license to the public to copy them:
82 Copyright 1984-1989, 1994 Adobe Systems Incorporated.
84 Copyright 1988, 1994 Digital Equipment Corporation.
85 Permission to use, copy, modify, distribute and sell this
87 software
88 and its documentation for any purpose and without fee is
89 hereby
90 granted, provided that the above copyright notices appear in
91 all
92 copies and that both those copyright notices and this permis‐
93 sion
94 notice appear in supporting documentation, and that the names
95 of
96 Adobe Systems and Digital Equipment Corporation not be used in
97 advertising or publicity pertaining to distribution of the
98 software
99 without specific, written prior permission. Adobe Systems and
100 Digital Equipment Corporation make no representations about
101 the
102 suitability of this software for any purpose. It is provided
103 'as
104 is' without express or implied warranty.
105 pbm_dissectfont
109 pbm_loadfont
110 This function returns a font object for a font described in a file.
111 The file may be either a special PBM file or a BDF file. The function
112 determines which it is and behaves as either pbm_loadpbmfont or
113 pbm_loadbdffont accordingly.
114 pbm_loadpbmfont
117 pbm_loadbdffont2
118 pbm_loadbdffont
119 This is obsolete. New programs should use pbm_loadbdffont2 instead.
120 pbm_expandbdffont
123 pbm_dumpfont
125 This manual page was generated by the Netpbm tool 'makeman' from HTML
126 source. The master documentation is at
127 http://netpbm.sourceforge.net/doc/libnetpbm_font.html
129netpbm documentation April 20L1i8bnetpbm PBM Font Function Manual(3)