about summary refs log tree commit diff
path: root/pbmtextps.html
blob: b3b4e064717bb7763d731e4217e24c48f469e795 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><title>Pbmtextps User Manual</title></HEAD>
<BODY>
<H1>pbmtextps</H1>
Updated: 21 May 2016
<BR>
<A HREF="#index">Table Of Contents</A>
<H2>NAME</H2>
pbmtextps - render text into a PBM image using a postscript interpreter

<H2 id="synopsis">SYNOPSIS</H2>

<B>pbmtextps</B>
[<B>-font</B> <I>fontname</I>]
[<B>-fontsize</B> <I>n</I>]
[<B>-resolution</B> <I>n</I>]
[<B>-stroke</B> <I>n</I>]
[<b>-verbose</b>]
<I>text</I>

<H2 id="description">DESCRIPTION</H2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<P><b>pbmtextps</b> takes a single line of text from the command line
and renders it into a PBM image.  The image is of a single line of text;
newline characters in the input have no effect.

<P>The image is cropped at the top and the right.  It is not cropped
at the left or bottom so that the text begins at the same position
relative to the origin.  You can use <b>pnmcrop</b> to crop it all the
way.

<p>See <b>pbmtext</b> for a more sophisticated generator of text, but
using less common font formats.  <b>pbmtext</b> can generate multiple
lines of text.

<p>The <b>-plain</b> <a href="index.html#commonoptions">common
option</a> has no effect before Netpbm 10.42 (March 2008).  The output
is always raw PBM.

<H2 id="options">OPTIONS</H2>

<DL COMPACT>
<DT><B>-font=</B><i>fontname</i>
<DD>
<P>This specifies the font to use.  <i>fontname</i> is the name of any valid
postscript font which is installed on the system.

<p>The default is <b>TimesRoman</b>.

<P><strong>Warning:</strong> if <i>fontname</i> does not name a valid font,
<b>pbmtextps</b> just uses the default font.  It does not tell you it is doing
this.

<DT><B>-fontsize=</B><i>n</i>
<DD>
This is the size of the font in points.  See the <b>-resolution</b> option for
information on how to interpret this size.

<p>The default is 24 points.

<DT><B>-resolution=</B><i>n</i>
<DD>
This is the resolution in dots per inch of distance measurements pertaining to
generation of the image.  PBM images don't have any inherent resolution, so a
distance such as "1 inch" doesn't mean anything unless you separately specify
what resolution you're talking about.  That's what this option does.

<p>In particular, the meaning of the font size is determined by this
resolution.  If the font size is 24 points and the resolution is 150 dpi, then
the font size is 50 pixels.

<p>The default is 150 dpi.

<DT><B>-stroke=</B><i>n</i>
<DD>
This is the width of line to use for stroke font.  There is no default stroke
width because the characters are solid by default.

<dt><b>-verbose</b>
<dd>
This option makes <b>pbmtextps</b> display extra information on Standard Error
about its processing.

</DL>

<H2 id="usage">USAGE</H2>

You can generate antialiased text by using a larger resolution than the
default and scaling the image down using <b>pamscale</b>.

<P>See the manual for the similar <B>pbmtext</B> for more advice on
usage.

<H2 id="history">HISTORY</H2>

<p><b>pbmtextps</b> was added to Netpbm in Release 10.0 (June 2002).


<H2 id="seealso">SEE ALSO</H2>

<B><A HREF="pbmtext.html">pbmtext</A></B>,
<B><A HREF="pamcut.html">pamcut</A></B>,
<B><A HREF="pnmcrop.html">pnmcrop</A></B>,
<B><A HREF="pamcomp.html">pamcomp</A></B>,
<B><A HREF="ppmchange.html">ppmchange</A></B>,
<B><A HREF="pnmrotate.html">pnmrotate</A></B>,
<B><A HREF="pamscale.html">pamscale</A></B>,
<B><A HREF="ppmlabel.html">ppmlabel</A></B>,
<B><A HREF="pbm.html">pbm</A></B>

<H2 id="author">AUTHOR</H2>

Copyright (C) 2002 by James McCann

<HR>
<H2 id="index">Table Of Contents</H2>
<UL>
<LI><A HREF="#synopsis">SYNOPSIS</A>
<LI><A HREF="#description">DESCRIPTION</A>
<LI><A HREF="#options">OPTIONS</A>
<LI><A HREF="#usage">USAGE</A>
<LI><A HREF="#history">HISTORY</A>
<LI><A HREF="#seealso">SEE ALSO</A>
<LI><A HREF="#author">AUTHOR</A>
</UL>
</BODY>
</HTML>