File: xli.man

package info (click to toggle)
xli 1.17.0+20061110-5
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 1,540 kB
  • sloc: ansic: 25,840; makefile: 11
file content (674 lines) | stat: -rw-r--r-- 27,568 bytes parent folder | download
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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
.\"	@(#)x11:contrib/clients/xloadimage/xli.man 1.13 94/07/29 Labtam
.\"	
.\" comment out xsetbg and xview (not in Debian package) - jrv
.TH XLI 1 "28 Oct 2002"
.SH NAME
.\"	xli, xsetbg, xview \- load images into an X11 window or onto
xli \- load images into an X11 window or onto
the root window
.SH SYNOPSIS
\fIxli\fR [global_options] {[image_options] image ...}
.br
\fIxli\fR [global_options] [image_options] stdin < image
.SH DESCRIPTION
\fIxli\fR displays images in an X11 window or loads them onto
the root window.  See the \fIIMAGE TYPES\fR section below for
supported image types.
.PP
If the filename \fIstdin\fR is given, xli will read the image
from standard input.
.PP
If the destination display cannot support the number of colors in the
image, the image will be dithered (monochrome destination) or have its
colormap reduced (color destination) as appropriate.  This can also be
done forcibly with the \fI\-halftone\fR, \fI\-dither\fR, and
\fI\-colors\fR options.
.PP
A variety of image manipulations can be specified, including gamma
correction, brightening, clipping, dithering, depth\-reduction,
rotation, and zooming.  Most of these manipulations have simple
implementations; speed was opted for above accuracy.
.PP
If you are viewing a large image in a window, the initial window will
be at most 90% of the size of the display unless the window manager
does not correctly handle window size requests or if you've used the
\fI\-fullscreen\fR or \fI\-fillscreen\fR options.
You may move the image around in the window
by dragging with the first mouse button.  The cursor will indicate
which directions you may drag, if any.
.PP
When the keyboard focus is in the window you can:
.na
.nf
Type 'q' or '^C' to exit xli.
Type space, 'n' or 'f' to move to the next image in the list.
Type 'b' or 'p' to move to the previous image in the list.
Type . to reload the image.
Type l to rotate the image anti\-clockwise.
Type r to rotate the image clockwise.
Type 0 to set the images assumed gamma to your display gamma
       (usually darkens images)
Type 1 to set the images assumed gamma to 1.0
       (usually lightens images)
Type 5\-2 to lighten the image (5 in small steps, up to 2 in large steps)
Type 6\-9 to darken the image (6 in small steps, up to 9 in large steps)
Type > resp. < to zoom in resp. out
.ad
.fi
.PP
A wide variety of common image manipulations can be done by mixing and
matching the available options.  See the section entitled \fIHINTS FOR
GOOD IMAGE DISPLAYS\fR for some ideas.
.PP
.\"\fIXsetbg\fR is equivalent to \fIxli \-onroot \-quiet\fR and
.\"\fIxview\fR is equivalent to \fIxli \-view \-verbose\fR.
.SH RESOURCE CLASS
\fIxli\fR uses the resource class name \fI_XSETROOT_Id\FR for
window managers which need this resource set.
.SH GLOBAL OPTIONS
The following options affect the global operation of \fIxli\fR.
They may be specified anywhere on the command line.
.TP
\-default
Set the root background to the default root weave.  This is the same
as \fIxsetroot\fR with no arguments.
.TP
\-debug
Talk to the X server in synchronous mode.  This is useful for
debugging.  If an X error is seen while in this mode, a core will be
dumped.
.TP
\-dumpcore
Signals will not be trapped, and instead a coredump will occur.
.TP
\-display \fIdisplay_name\fR
X11 display name to send the image(s) to.
.TP
\-dispgamma \fIDisplay_gamma\fR
Specify the gamma correction value appropriate for the display device.
This overrides the value read from the environment variable \fBDISPLAY_GAMMA\fR,
or the default value of 2.2, which is approximately correct for
many displays. A value of between 1.6 and 2.8 is reasonable. If individual
images are too bright or dark, use the \-gamma option.
.PP
There is an image provided with xli called 'chkgamma.jpg' that lets you
set the display gamma reasonably accurately.  This file contains two
grayscale ramps. The ramps are chosen to look linear to the human
eye, one using continuous tones, and the other using dithering.
When the display gamma is correct, then the two ramps should look symmetrical,
and the point at which they look equally bright should be almost exactly half
way from the top to the bottom. (To find this point it helps if you move away
a little from the screen, and de\-focus your eyes a bit.)
.PP
If the equal brightness point is above center increase the
gamma, and decrease it if it is below the center. The value
will usually be around 2.2 Once you've got it right, you can set
the DISPLAY_GAMMA environment variable in your .profile
.TP
\-fillscreen
Use the whole screen for displaying an image. The image will be zoomed
so that it just fits the size of the screen. If \-onroot is also specified,
it will be zoomed to completely fill the screen.
.TP
\-fit
Force image to use the default visual and colormap.  This is useful if
you do not want technicolor effects when the colormap focus is inside
the image window, but it may reduce the quality of the displayed
image.  This is on by default if \-onroot or \-windowid is specified.
.TP
\-forall
Apply \-fillscreen and \-fullscreen options to all images and not just
the first.
.TP
\-fork
Fork xli.  This causes xli to disassociate itself from
the shell.  This option automatically turns on \-quiet.
.TP
\-fullscreen
Use the whole screen for displaying an image. The image will be surrounded by
a border if it is smaller than the screen. If \-onroot is also specified,
the image will be zoomed so that it just fits the size of the screen.
.TP
\-geometry \fIWxH[{+\-X}{+\-}Y]\fR
This sets the size of the window onto which the images are loaded to a
different value than the size of the image.  When viewing an image in
a window, this can be used to set the size and position of the
viewing window.
If the size is not specified in the geometry, (or is set to 0),
then the size will be chosen to be small enough to able to fit
the window in the screen (as usual).
.TP
\-goto image_name
When the end of the list of images is reached, go to image 
\fIimage_name\fR.  This is useful for generating looped slideshows.
If more than one image of the same name as the target exists on the
argument list, the first in the argument list is used.
.TP
\-help [option ...]
Give information on an option or list of options.  If no option is
given, a simple interactive help facility is invoked.
.TP
\-identify
Identify the supplied images rather than display them.
.TP
\-install
Forcibly install the images colormap when the window is focused.
This violates ICCCM standards and only exists to allow operation with
naive window managers.  Use this option only if your window manager
does not install colormaps properly.
.TP
\-list
List the images which are along the image path.
.TP
\-onroot
Load image(s) onto the root window instead of viewing in a window.
This option automatically sets the \-fit option.
This is the opposite of \fI\-view\fR.
.\"\fIXSetbg\fR has this option set by default.
If used in conjunction with \-fullscreen,
the image will be zoomed to just fit. If used with \-fillscreen, the image will
be zoomed to completely fill the screen. \-border, \-at, and \-center also affect the
results.
.TP
\-path
Displays the image path and image suffixes which will be used when
looking for images.  These are loaded from ~/.xlirc and
optionally from a system wide file (normally /usr/lib/xlirc).
.TP
\-pixmap
Force the use of a pixmap as backing\-store.  This is provided for
servers where backing\-store is broken (such as some versions of the
AIXWindows server).  It may improve scrolling performance on servers
which provide backing\-store.
.TP
\-private
Force the use of a private colormap.  Normally colors are allocated
shared unless there are not enough colors available.
.TP
\-quiet
Forces \fIxli\fR and \fIxview\fR to be quiet.
.\"This is the default for \fIxsetbg\fR, but the others like to whistle.
.TP
\-supported
List the supported image types. 
.TP
\-verbose
Causes \fIxli\fR to be talkative, telling you what kind of
image it's playing with and any special processing that it has to do. 
This is the default for \fIxview\fR and \fIxli\fR. 
.TP
\-version
Print the version number and patchlevel of this version of
\fIxli\fR.
.TP
\-view
View image(s) in a window.  This is the opposite of \fI\-onroot\fR and
the default for \fIxview\fR and \fIxli\fR. 
.TP
\-visual \fIvisual_name\fR
Force the use of a specific visual type to display an image.  Normally
\fIxli\fR tries to pick the best available image for a
particular image type.  The available visual types are:  DirectColor,
TrueColor, PseudoColor, StaticColor, GrayScale, and StaticGray.
Nonconflicting names may be abbreviated and case is ignored.
.TP
\-windowid \fIhex_window_id\fR
Sets the background pixmap of a particular window ID.  The argument
must be in hexadecimal and must be preceded by "0x" (\fIeg\fR
\-windowid 0x40000b.  This is intended for setting the background
pixmap of some servers which use untagged virtual roots
(\fIeg\fR HP\-VUE), but can have other interesting applications.
.SH PERSISTENT IMAGE OPTIONS
The following options may precede each image.  They take effect from
the next image, and continue until overridden or canceled with
\fI\-newoptions.\fR
.TP
\-border \fIcolor\fR
This sets the background portion of the window or clipped image which is
not covered by any images to be \fIcolor\fR.
.TP
\-brighten \fIpercentage\fR
Specify a percentage multiplier for a color images colormap.  A value
of more than 100 will brighten an image, one of less than 100 will
darken it. 
.TP
\-colors \fIn\fR
Specify the maximum number of colors to use in the image.  This is a
way to forcibly reduce the depth of an image.
.TP
\-cdither
.TP
\-colordither
Dither the image with a Floyd\-Steinberg dither if the number of colors is reduced.
This will be slow, but will give a better looking result with a restricted color
set. \fI\-cdither\fR and \fI\-colordither\fR are equivalent.
.TP
\-delay \fIsecs\fR
Sets xli to automatically advance to the following image,
\fIsecs\fR seconds after the next image file is displayed.
.TP
\-dither
Dither a color image to monochrome using a Floyd\-Steinberg dithering
algorithm.  This happens by default when viewing color images on a
monochrome display.  This is slower than \fI\-halftone\fR and affects
the image accuracy but usually looks much better.
.TP
\-gamma \fIImage_gamma\fR
Specify the gamma of the display the image was intended to be displayed on.
Images seem to
come in two flavors: 1) linear color images, produced by ray tracers,
scanners etc. These sort of images generally look too dark when displayed
directly to a CRT display. 2) Images that have been processed to look right
on a typical CRT display without any sort of processing. These images have
been 'gamma corrected'. By default, xli assumes that 8 bit images have
been gamma corrected and need no other processing. 24 bit images are assumed
to be linear.
If a linear image is displayed as if it is gamma corrected it will look too
dark, and a gamma value of 1.0 should be specified, so that xli can correct
the image for the CRT display device. If a gamma corrected image is displayed
as if it were a linear image, then it will look too light, and a gamma value of
(approximately) 2.2 should be specified for that image.
Some formats (RLE) allow the image gamma to be embedded as a comment in the
file itself, and the \-gamma option allows overriding of the file comment.
In general, values smaller than 2.2 will lighten the image, and values
greater than 2.2 will darken the image.
In general this will work better than the \-brighten option.
.TP
\-gray
Convert an image to grayscale.  This is very useful when displaying
colorful images on servers with limited color capability.  The
optional spelling \fI\-grey\fR may also be used.
.TP
\-idelay \fIsecs\fR
Set the delay to be used for this image to \fIsecs\fR seconds (see
\fI\-delay\fR).  If \fI\-delay\fR was specified, this overrides it.  If
it was not specified, this sets the automatic advance delay for this
image while others will wait for the user to advance them.
.TP
\-smooth
Smooth a color image.  This reduces blockiness after zooming an image
up.  If used on a monochrome image, nothing happens.  This option can
take awhile to perform, especially on large images.  You may specify
more than one \fI\-smooth\fR option per image, causing multiple
iterations of the smoothing algorithm.
.TP
\-title \fIwindow_title\fR
Set the titlebar of the window used to display the image.
This will override any title that is read from the image
file. The title will also be used for the icon name.
.TP
\-xpm \fIcolor_context_key\fR
Select the preferred xpm colour map. XPM files may contain more than one
color mapping, each mapping being appropriate for a particular visual.
Normally xli will select an appropriate color mapping from that supported
by the XPM file by checking on the default X visual class and depth.
This option allows the user to override this choice.
Legal values of  \fIcolor_context_key\fR are: m, g4, g and c.
m = mono, g4 = 4 level gray, g = gray, c = color ).
.TP
\-xzoom \fIpercentage\fR
Zoom the X axis of an image by \fIpercentage\fR.  A number greater
than 100 will expand the image, one smaller will compress it.  A zero
value will be ignored.  This option, and the related \fI\-yzoom\fR are
useful for correcting the aspect ratio of images to be displayed.
.TP
\-yzoom \fIpercentage\fR
Zoom the Y axis of an image by \fIpercentage\fR.  See \fI\-xzoom\fR for
more information. 
.TP
\-zoom \fIpercentage\fR
Zoom both the X and Y axes by \fIpercentage\fR.  See \fI\-xzoom\fR for
more information.  Technically the percentage actually zoomed is the
square of the number supplied since the zoom is to both axes, but I
opted for consistency instead of accuracy.
.TP
\-zoom auto
Zoom large images to fit the screen; don't zoom small images.
.TP
\-newoptions
Reset options that propagate.  The \fI\-bright, \-colors, \-colordither, \-delay,
\-dither, \-gamma, \-gray, \-normalize, \-smooth, \-xzoom, \-yzoom\fR, and
\fI\-zoom\fR options normally propagate to all following images.
.SH LOCAL IMAGE OPTIONS
The following options may precede each image.  These options are
local to the image they precede. 
.TP
\-at \fIX\fR,\fIY\fR
Indicates coordinates to load the image at \fIX\fR,\fIY\fR on the base image.
If this is an option to the first image, and the \fI\-onroot\fR option is
specified, the image will be loaded at the given location on the
display background. 
.TP
\-background \fIcolor\fR
Use \fIcolor\fR as the background color instead of the default
(usually white but this depends on the image type) if you are
transferring a monochrome image to a color display. 
.TP
\-center
Center the image on the base image loaded.  If this is an option to
the first image, and the \fI\-onroot\fR option is specified, the image
will be centered on the display background. 
.TP
\-clip \fIX\fR,\fIY\fR,\fIW\fR,\fIH\fR
Clip the image before loading it.  \fIX\fR and \fIY\fR define the
upper\-left corner of the clip area, and \fIW\fR and \fIH\fR define the
extents of the area.  A zero value for \fIW\fR or \fIH\fR will be
interpreted as the remainder of the image. 
Note that \fIX\fR and \fIY\fR may be negative, and that \fIW\fR and \fIH\fR
may be larger than the image. This causes a border to be placed around the
image. The border color may be set with the \fI\-border\fR option.
.TP
\-expand
Forces the image (after all other optional processing) to be expanded
into a True Color (24 bit) image. This is useful on systems which support
24 bit color, but where xli might choose to load a bitmap or 8 bit image
into one of the other smaller depth visuals supported on your system.
.TP
\-foreground \fIcolor\fR
Use \fIcolor\fR as the foreground color instead of black if you are
transferring a monochrome image to a color display.  This can also be
used to invert the foreground and background colors of a monochrome
image. 
.TP
\-halftone
Force halftone dithering of a color image when displaying on a
monochrome display.  This option is ignored on monochrome images.
This dithering algorithm blows an image up by sixteen times; if you
don't like this, the \fI\-dither\fR option will not blow the image up
but will take longer to process and will be less accurate.
.TP
\-invert
Inverts a monochrome image.  This is shorthand for \fI\-foreground
white \-background black\fR.
.TP
\-merge
Merge this image onto the base image after local processing.  The base
image is considered to be the first image specified or the last image
that was not preceded by \fI\-merge\fR.  If used in conjunction with
\fI\-at\fR and \fI\-clip\fR, very complex images can be built up.
Note that the final image will be the size of the first image, and that
subsequent merged images overlay previous images. The final image size
can be altered by using the \fI\-clip\fR option on the base image to
make it bigger or smaller.
This option is on by default for all images if the \fI\-onroot\fR or
\fI\-windowid\fR options are specified.
.TP
\-name \fIimage_name\fR
Force the next argument to be treated as an image name.  This is
useful if the name of the image is \fI\-dither\fR, for instance.
.TP
\-normalize
Normalize a color image.
.TP
\-rotate \fIdegrees\fR
Rotate the image by \fIdegrees\fR clockwise.  The number must be a
multiple of 90.
.SH EXAMPLES
To load the rasterfile "my.image" onto the background and replicate
it to fill the entire background:
.sp
.ti +5
xli \-onroot my.image
.PP
To load a monochrome image "my.image" onto the background, using red
as the foreground color, replicate the image, and overlay
"another.image" onto it at coordinate (10,10):
.sp
.ti +5
xli \-foreground red my.image \-at 10,10 another.image
.PP
To center the rectangular region from 10 to 110 along the X axis and
from 10 to the height of the image along the Y axis:
.sp
.ti +5
xli \-center \-clip 10,10,100,0 my.image
.PP
To double the size of an image:
.sp
.ti +5
xli \-zoom 200 my.image
.PP
To halve the size of an image:
.sp
.ti +5
xli \-zoom 50 my.image
.PP
To brighten a dark image:
.sp
.ti +5
xli \-brighten 150 my.image
.PP
To darken a bright image:
.sp
.ti +5
xli \-brighten 50 my.image
.SH HINTS FOR GOOD IMAGE DISPLAYS
Since images are likely to come from a variety of sources, they may be
in a variety of aspect ratios which may not be supported by your
display.  The \fI\-xzoom\fR and \fI\-yzoom\fR options can be used to
change the aspect ratio of an image before display.  If you use these
options, it is recommended that you increase the size of one of the
dimensions instead of shrinking the other, since shrinking looses
detail.  For instance, many GIF and G3 FAX images have an X:Y ratio of
about 2:1.  You can correct this for viewing on a 1:1 display with
either \fI\-xzoom 50\fR or \fI\-yzoom 200\fR (reduce X axis to 50% of
its size and expand Y axis to 200% of its size, respectively) but the
latter should be used so no detail is lost in the conversion.
.PP
When zooming color images up you can reduce blockiness with
\fI\-smooth\fR.  For zooms of 300% or more, I recommend two smoothing
passes (although this can take awhile to do on slow machines).  There
will be a noticeable improvement in the image.
.PP
You can perform image processing on a small portion of an image by
loading the image more than once and using the \fI\-merge\fR, \fI\-at\fR
and \fI\-clip\fR options.  Load the image, then merge it with a
clipped, processed version of itself.  To brighten a 100x100 rectangular
portion of an image located at (50,50), for instance, you could type:
.sp
.ti +5
xli my.image \-merge \-at 50,50 \-clip 50,50,100,100 \-brighten 150 my.image
.PP
If you're using a display with a small colormap to display colorful
images, try using the \fI\-gray\fR option to convert to grayscale.
.SH XLITO
\fIxlito\fR (XLoadImageTrailingOptions) is a separate utility that provides
a file format independent way of marking image files with the appropriate
options to display correctly.  It does this by appending to file a string
specified by the user, marked with some magic numbers so that this string
can be extracted by a program that knows where to look. Since almost all
image files have some sort of image size specifier, the programs that
load or manipulate these files do not look beyond the point at which
they have read the image, so trailing information can safely be appended
to the file. If appending this information causes trouble with other
utilities, it can simply be deleted.
.PP
\fIxli\fR will recognize these trailing options at the end
of the image files, and will treat the embedded string as if it were
a sequence of command line \fIIMAGE OPTIONS\fR. Any \fIGLOBAL OPTIONS\fR
will be ignored, and the \fIIMAGE OPTIONS\fR are never propagated to
other images.
.PP
Trailing options can be examined with:
.sp
.ti +5
xlito image_file ...
.PP
Changed or added with:
.sp
.ti +5
xlito \-c "string of options" image_file
.PP
And deleted with:
.sp
.ti +5
xlito \-d image_file ...
.PP
For example, if you have a gif file fred.gif which is too dark and is the
wrong aspect ratio, then it may need to be viewed with:
.sp
.ti +5
xli \-yzoom 130 \-gamma 1.0 fred.gif
.PP
to get it to look OK. These options can then be appended to the file by:
.sp
.ti +5
xlito \-c "\-yzoom 130 \-gamma 1.0" fred.gif
.PP
and from then on xli will get the appropriate options from the
image file itself.  See the  \fIxlito\fR manual entry for more details
about this utility.

.SH PATHS AND EXTENSIONS
The file ~/.xlirc (and optionally a system\-wide file) defines
the path and default extensions that \fIxli\fR will use when
looking for images.  This file can have two statements: "path=" and
"extension=" (the equals signs must follow the word with no spaces
between).  Everything following the "path=" keyword will be prepended
to the supplied image name if the supplied name does not specify an
existing file.  The paths will be searched in the order they are
specified.  Everything following the "extension=" keyword will be
appended to the supplied image name if the supplied name does not
specify an existing file.  As with paths, these extensions will be
searched in the order they are given.  Comments are any portion of a
line following a hash\-mark (\[sh]).
.PP
The following is a sample ~/.xlirc file:
.PP
.nf
  \[sh] paths to look for images in
  path= /usr/local/images
        /home/usr1/guest/madd/images
        /usr/include/X11/bitmaps

  \[sh] default extensions for images; .Z is automatic; scanned in order
  extension= .csun .msun .sun .face .xbm .bm
.fi
.PP
Versions of \fIxli\fR prior to version 01, patchlevel 03 would
load the system\-wide file (if any), followed by the user's file.  This
behavior made it difficult for the user to configure her environment
if she didn't want the default.  Newer versions will ignore the
system\-wide file if a personal configuration file exists.
.SH IMAGE TYPES
.PP
\fIxli\fR currently supports the following image types:
.sp
.nf
  CMU Window Manager raster files
  Faces Project images
  Fuzzy Bitmap (.fbm) images
  GEM bit images
  GIF images (Including GIF89a compatibility)
  G3 FAX images
  JFIF style jpeg images
  McIDAS areafiles
  MacPaint images
  Windows, OS/2 RLE Image
  Monochrome PC Paintbrush (.pcx) images
  Photograph on CD Image
  Portable Bitmap (.pbm, .pgm, .ppm) images
  Sun monochrome rasterfiles
  Sun color RGB rasterfiles
  Targa (.tga) files
  Utah Raster Toolkit (.rle) files
  X pixmap (.xpm) files (Version 1, 2C and 3)
  X10 bitmap files
  X11 bitmap files
  X Window Dump (except TrueColor and DirectColor)
.fi
.PP
Normal, compact, and raw PBM images are supported.  Both standard and
run\-length encoded Sun rasterfiles are supported.  Any image whose
name ends in .Z is assumed to be a compressed image and will be
filtered through "uncompress". If HAVE_GUNZIP is defined in the
Makefile.std make file, then any image whose name ends in
\&.gz or .Z will be filtered through gunzip.
.PP
Any file that looks like a uuencoded file will be decoded
automatically.
.SH AUTHORS
The original Author is:
.nf
Jim Frost
Saber Software
jimf@saber.com
.fi
.PP
Version 1.16 of xli is derived from xloadimage 3.01 has been brought to you by:
.nf
Graeme Gill
graeme@labtam.oz.au
.fi
.PP
Version 1.17 of xli is derived from xli 1.16 by
.nf
smar@reptiles.org
.fi
.PP
For a more\-or\-less complete list of other contributors (there are a
\fIlot\fR of them), please see the README file enclosed with the
distribution.
.SH FILES
.nf
.in +5
xli	                    \- the image loader and viewer
.\"xsetbg                  \- pseudonym which quietly sets the background
.\"xview                   \- pseudonym which views in a window
xlito                   \- the trailing options utility
/usr/lib/X11/Xli        \- default system\-wide configuration file
~/.xlirc                \- user's personal configuration file
.in -5
.fi
.SH COPYRIGHT
Copyright (c) 1989, 1990, 1991, 1992, 1993 Jim Frost, Graeme Gill and others.
.PP
\fIXli\fR is copyrighted material with a very loose license
allowing unlimited modification and distribution if the copyright
notices are left intact.  Various portions are copyrighted by various
people, but all use a modification of the MIT copyright notice.
Please check the source for complete copyright information.  The
intent is to keep the source free, not to stifle its distribution, so
please write to me if you have any questions.
.SH BUGS
Zooming dithered images, especially downwards, is UGLY.
.PP
Images can come in a variety of aspect ratios.  \fIXli\fR cannot
detect what aspect ratio the particular image being loaded has, nor
the aspect ratio of the destination display, so images with differing
aspect ratios from the destination display will appear distorted.  The solution
to this is to use \fIxlito\fR to append the appropriate options to the
image file. See \fIHINTS FOR GOOD IMAGE DISPLAYS\fR and \fIXLITO\fR for more
information.
.PP
The GIF format allows more than one image to be stored in a single GIF
file, but \fIxli\fR will only display the first.
.PP
One of the pseudonyms for \fIxli\fR, \fIxview\fR, is the same
name as Sun uses for their SunView\-under\-X package.  This will be
confusing if you're one of those poor souls who has to use Sun's
XView.
.PP
Some window managers do not correctly handle window size requests.  In
particular, many versions of the twm window manager use
the MaxSize hint instead of the PSize hint, causing images which
are larger than the screen to display in a window larger than the
screen, something which is normally avoided.  Some versions of twm
also ignore the MaxSize argument's real function, to limit the maximum
size of the window, and allow the window to be resized larger than the
image.  If this happens, \fIxli\fR merely places the image in
the upper\-left corner of the window and uses the zero\-value'ed pixel
for any space which is not covered by the image.  This behavior is
less\-than\-graceful but so are window managers which are cruel enough
to ignore such details.
.PP
The order in which operations are performed on an image is independent
of the order in which they were specified on the command line.
Wherever possible I tried to order operations in such a way as to look
the best possible (zooming before dithering, for instance) or to
increase speed (zooming downward before compressing, for instance).
.PP
Display Gamma should setable in the ~/.xlirc file.
.PP
Embedded trailing options override the command line \fIImage Options.\fR Command
line options should really override trailing options.