plucky (3) libnetpbm_font.3.gz
NAME
libnetpbm_font \- Libnetpbm PBM Font Function Manual
DESCRIPTION
This reference manual covers functions in the libnetpbm library for accessing fonts to draw text
characters, using the PBM image format and the libnetpbm in-memory image formats.
We actually have very little information here; this is mainly a framework for adding documentation later
if someone becomes interested in this facility.
Note that the primary known user of this library is the Netpbm program pbmtext. You can use that
program's source code as an example.
Font Object
libnetpbm represents a font with an object of type struct font. The library provides functions to create
these objects.
The object these functions create is in newly allocated memory and you can't actually free it. The
memory may be in multiple pieces, pointing to each other, and libnetpbm provides no destroy function.
(This is only because of implementation laziness).
The Functions
The functions are all declared in the pbmfont.h header file.
pbm_defaultfont
Synopsis
struct font *
pbm_defaultfont(const char * which);
Description
This returns a font object representing a font built in to libnetpbm.
which is the name of the desired built-in font. There are two:
bdf
A proportional font similar to Adobe's timR12 font
fixed
A fixed space font
Copyright
The provenance of the built-in fonts are not known for sure, but in 2018, the bdf font was almost
identical to a font on which Adobe and Digital Equipment Corporation once claimed copyright. That font
was available in the X.org source code ⟨ftp://ftp.x.org/pub/current/src/font/⟩ in a collection named
'font-adobe-75dpi', in a file named timR12.pcf.gz.
Ergo, it is likely that the font was copied into Netpbm from that font in 1991.
You may need a copyright license from the copyright owners of that original font not only to copy the
libnetpbm code, but to execute it, thus generating copies of the glyphs of the font.
The X.org files in 2018 indicate the following copyright claims, along with a license to the public to
copy them:
Copyright 1984-1989, 1994 Adobe Systems Incorporated.
Copyright 1988, 1994 Digital Equipment Corporation.
Permission to use, copy, modify, distribute and sell this software
and its documentation for any purpose and without fee is hereby
granted, provided that the above copyright notices appear in all
copies and that both those copyright notices and this permission
notice appear in supporting documentation, and that the names of
Adobe Systems and Digital Equipment Corporation not be used in
advertising or publicity pertaining to distribution of the software
without specific, written prior permission. Adobe Systems and
Digital Equipment Corporation make no representations about the
suitability of this software for any purpose. It is provided 'as
is' without express or implied warranty.
pbm_dissectfont
pbm_loadfont
This function returns a font object for a font described in a file. The file may be either a special PBM
file or a BDF file. The function determines which it is and behaves as either pbm_loadpbmfont or
pbm_loadbdffont accordingly.
pbm_loadpbmfont
pbm_loadbdffont2
pbm_loadbdffont
This is obsolete. New programs should use pbm_loadbdffont2 instead.
pbm_expandbdffont
pbm_dumpfont
DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML source. The master documentation
is at
http://netpbm.sourceforge.net/doc/libnetpbm_font.html