about summary refs log tree commit diff
path: root/pbmtextps.html
blob: c6ef6acecec70e0cf7f948f9a0bc69de3f6f9ecb (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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><title>Pbmtextps User Manual</title></HEAD>
<BODY>
<H1>pbmtextps</H1>
Updated: 09 December 2007
<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>fontsize</I>]
[<B>-resolution</B> <I>resolution</I>]
[<B>-stroke</B> <I>strokesize</I>]
<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>
<DD>
By default, <b>pbmtextps</b> uses TimesRoman.

<P>You can specify the font to use with the <B>-font</B> option.
This is the name of any valid postscript font which is installed on your
system.

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

<p>Default is 24 points.

<DT><B>-resolution</B>
<DD>
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>Default is 150 dpi.

<DT><B>-stroke</B>
<DD>
Width of line to use for stroke font.  There is no default stroke width
because the characters are solid by default.
</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>