1 |
.\" RCSid "$Id: psign.1,v 1.2 2003/12/09 15:59:06 greg Exp $" |
2 |
.TH PSIGN 1 10/9/97 RADIANCE |
3 |
.SH NAME |
4 |
psign - produce a RADIANCE picture from text. |
5 |
.SH SYNOPSIS |
6 |
.B psign |
7 |
[ |
8 |
.B options |
9 |
] |
10 |
[ |
11 |
.B text |
12 |
] |
13 |
.SH DESCRIPTION |
14 |
.I Psign |
15 |
produces a RADIANCE picture of the given |
16 |
.I text. |
17 |
The output dimensions are determined by the character height, aspect |
18 |
ratio, number of lines and line length. |
19 |
(Also the character size if text squeezing is used.)\0 |
20 |
If no |
21 |
.I text |
22 |
is given, the standard input is read. |
23 |
.TP 10n |
24 |
.BI -cb " r g b" |
25 |
Set the background color to |
26 |
.I "r g b" |
27 |
The default is white (1 1 1). |
28 |
.TP |
29 |
.BI -cf " r g b" |
30 |
Set the foreground color to |
31 |
.I "r g b" |
32 |
The default is black (0 0 0). |
33 |
.TP |
34 |
.BR \-dr |
35 |
Text reads to the right (default). |
36 |
.TP |
37 |
.BR \-du |
38 |
Text reads upwards. |
39 |
.TP |
40 |
.BR \-dl |
41 |
Text reads to the left (upside down). |
42 |
.TP |
43 |
.BR \-dd |
44 |
Text reads downwards. |
45 |
.TP |
46 |
.BI -h \ cheight |
47 |
Set the character height to |
48 |
.I cheight. |
49 |
The default is 32 pixels. |
50 |
.TP |
51 |
.BI -a \ aspect |
52 |
Set the character aspect ratio (height/width) to |
53 |
.I aspect. |
54 |
The default value is 1.67. |
55 |
.TP |
56 |
.BI -x \ xsize |
57 |
Set the horizontal image size to |
58 |
.I xsize. |
59 |
Use with |
60 |
.I \-y |
61 |
option (below) in place of the |
62 |
.I \-h |
63 |
specification to control output image size directly. |
64 |
If the character aspect ratio |
65 |
.I (\-a |
66 |
option, above) is non-zero, then one of the specified x or y output |
67 |
dimensions may be reduced to maintain this ratio. |
68 |
If direction is right |
69 |
.I (\-dr) |
70 |
or left |
71 |
.I (\-dl), |
72 |
then it is not necessary to give the |
73 |
.I \-y |
74 |
option, since it can be computed from the character height |
75 |
.I (\-h). |
76 |
.TP |
77 |
.BI -y \ ysize |
78 |
Set the vertical image size to |
79 |
.I ysize. |
80 |
Use with the |
81 |
.I \-x |
82 |
option (described above). |
83 |
If direction is up |
84 |
.I (\-du) |
85 |
or down |
86 |
.I (\-dd), |
87 |
then it is not necessary to give the |
88 |
.I \-x |
89 |
option, since it can be computed from the character height |
90 |
.I (\-h). |
91 |
.TP |
92 |
.BI -s \ spacing |
93 |
Set the intercharacter spacing to |
94 |
.I spacing. |
95 |
The magnitude of this value is multiplied by the character height over |
96 |
the aspect ratio (ie. the character width) to compute the desired |
97 |
distance between characters in the output. |
98 |
The sign of the value, positive or negative, determines how this |
99 |
ideal spacing is used in the actual placement of characters. |
100 |
If |
101 |
.I spacing |
102 |
is positive, then the overall width of the line will not be affected, |
103 |
nor will indentation of textual elements. |
104 |
Thus, the text format will be mostly unaffected. |
105 |
However, spacing between characters will reflect their relative size |
106 |
for a more natural appearance. |
107 |
If |
108 |
.I spacing |
109 |
is negative, characters will be squeezed together to meet the |
110 |
spacing critereon, regardless of how it might affect the format of |
111 |
the output. |
112 |
The default value for |
113 |
.I spacing |
114 |
is zero, which is interpreted as uniformly spaced characters. |
115 |
.TP |
116 |
.BI -f \ fontfile |
117 |
Load the font from |
118 |
.I fontfile. |
119 |
The default font is helvet.fnt |
120 |
.SH EXAMPLE |
121 |
To put a big "Hi!" on the terminal: |
122 |
.IP "" .2i |
123 |
psign \-h 22 \-a 1 \-cb 0 0 0 \-cf 1 1 1 Hi\\! | ttyimage |
124 |
.SH ENVIRONMENT |
125 |
RAYPATH path to search for font files |
126 |
.SH AUTHOR |
127 |
Greg Ward |
128 |
.SH BUGS |
129 |
The entire bitmap is stored in memory, which can be a problem for |
130 |
large and/or high-resolution signs. |
131 |
.SH "SEE ALSO" |
132 |
getinfo(1), pcompos(1), pfilt(1), ttyimage(1) |