Debian Codegraph @

docs/pango-view.rst

raw
1 .. _pango-view(1):
2
3 ==========
4 pango-view
5 ==========
6
7 -----------------
8 Pango text viewer
9 -----------------
10
11 :Version: Pango
12 :Manual section: 1
13 :Manual group: Pango commands
14
15 SYNOPSIS
16 --------
17
18 | **pango-view** [OPTIONS...] FILE
19
20 DESCRIPTION
21 -----------
22
23 ``pango-view`` formats a text using Pango, with options to exercise
24 most of Pango's layout features.
25
26 HELP OPTIONS
27 ------------
28
29 ``-h, --help``
30
31 Show help options.
32
33 ``--help-all``
34
35 Show all help options.
36
37 ``--help-cairo``
38
39 Show help for options understood by the cairo backend.
40
41 ``--version``
42
43 Print the command's version and exit.
44
45 CAIRO BACKEND OPTIONS
46 ---------------------
47
48 ``--annotate=FLAGS``
49
50 Annotate the output. Comma-separated list of gravity, progression, baselines,
51 layout, line, run, cluster, char, glyph, caret, slope
52
53 APPLICATION OPTIONS
54 -------------------
55
56 ``--no-auto-dir``
57
58 No layout direction according to contents.
59
60 ``--backend=cairo/xft/ft2``
61
62 Pango backend to use for rendering (default: cairo).
63
64 ``--background=red/#rrggbb/#rrggbbaa/transparent``
65
66 Set the background color.
67
68 ``-q, --no-display``
69
70 Do not display (just write to file or whatever).
71
72 ``--dpi=number``
73
74 Set the resolution.
75
76 ``--align=left/center/right``
77
78 Set text alignment.
79
80 ``--ellipsize=start/middle/end``
81
82 Set ellipsization mode.
83
84 ``--font=description``
85
86 Set the font description.
87
88 ``--foreground=red/#rrggbb/#rrggbbaa``
89
90 Set the text color.
91
92 ``--gravity=south/east/north/west/auto``
93
94 Set base gravity: glyph rotation.
95
96 ``--gravity-hint=natural/strong/line``
97
98 Set gravity hint.
99
100 ``--header``
101
102 Display the options in the output.
103
104 ``--height=+points/-numlines``
105
106 Set height in points (positive) or number of lines (negative) for ellipsizing.
107
108 ``--hinting=none/auto/slight/medium/full``
109
110 Set hinting style.
111
112 ``--antialias=none/gray/subpixel``
113
114 Set antialiasing.
115
116 ``--hint-metrics=on/off``
117
118 Set hint metrics.
119
120 ``--subpixel-positions``
121
122 Set subpixel positioning.
123
124 ``--subpixel-order=rgb/bgr/vrgb/vbgr``
125
126 Set subpixel order.
127
128 ``--indent=points``
129
130 Set paragraph indentation (in points).
131
132 ``--spacing=points``
133
134 Set line spacing (in points).
135
136 ``--line-spacing=factor``
137
138 Set spread factor for line height.
139
140 ``--justify``
141
142 Stretch paragraph lines to be justified.
143
144 ``--justify-last-line``
145
146 Justify the last line of the paragraph.
147
148 ``--language=en_US/etc``
149
150 Set language to use for font selection.
151
152 ``--margin=CSS-style numbers in pixels``
153
154 Set the margin on the output in pixels.
155
156 ``--markup``
157
158 Interpret text as Pango markup.
159
160 ``-o, --output=file``
161
162 Save rendered image to output file.
163
164 ``--pixels``
165
166 Use pixel units instead of points (sets dpi to 72).
167
168 ``--pango-units``
169
170 Use Pango units instead of points.
171
172 ``--rtl``
173
174 Set base direction to right-to-left.
175
176 ``--rotate=degrees``
177
178 Set angle at which to rotate results,
179
180 ``-n, --runs=integer``
181
182 Run Pango layout engine this many times.
183
184 ``--single-par``
185
186 Enable single-paragraph mode.
187
188 ``-t, --text=string``
189
190 Text to display (instead of a file).
191
192 ``--waterfall``
193
194 Create a waterfall display.
195
196 ``-w, --width=points``
197
198 Width in points to which to wrap lines or ellipsize.
199
200 ``--wrap=word/char/word-char``
201
202 Text wrapping mode (needs a width to be set).
203
204 ``--serialized=FILE``
205
206 Create layout from a serialized file,
207
208 ``--serialize-to=FILE``
209
210 Serialize result to a file.
211