File: xloadimage.txt

package info (click to toggle)
xloadimage 4.1-25
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 4,820 kB
  • sloc: ansic: 36,084; asm: 284; makefile: 282; sh: 280
file content (924 lines) | stat: -rw-r--r-- 34,262 bytes parent folder | download | duplicates (10)
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
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924



XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



NAME
     xloadimage, xsetbg, xview - load images into an  X11  window
     or onto the root window

SYNOPSIS
     _x_l_o_a_d_i_m_a_g_e [global_options] {[image_options] image ...}
     _x_l_o_a_d_i_m_a_g_e [global_options] [image_options] stdin < image

DESCRIPTION
     _X_l_o_a_d_i_m_a_g_e displays images in an X11 window, loads them onto
     the  root  window,  or  writes them into a file.  Many image
     types are recognized; use  the  -_s_u_p_p_o_r_t_e_d  option  to  list
     them.

     If the filename _s_t_d_i_n is given,  xloadimage  will  read  the
     image from standard input if this capability is supported by
     the loader for that image type (most types do support  read-
     ing from stdin).

     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  destina-
     tion)  as  appropriate.  This can also be done forcibly with
     the -_h_a_l_f_t_o_n_e, -_d_i_t_h_e_r, and -_c_o_l_o_r_s options.

     A variety of image manipulations can be specified, including
     gamma  correction,  brightening, clipping, dithering, depth-
     reduction, rotation, and zooming.  Most of  these  manipula-
     tions have simple implementations; speed was opted for above
     accuracy.

     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 -_f_u_l_l_s_c_r_e_e_n option.  You may
     move the image around in the window  by  dragging  with  the
     first  mouse  button.  The cursor will indicate which direc-
     tions you may drag, if any.  You may exit the window by typ-
     ing 'q' or '^C' when the keyboard focus is on the window.

     If more than one image file  is  specified  on  the  command
     line, each image will be shown in order (except if -_m_e_r_g_e or
     -_g_o_t_o are being used).

     A wide variety of common image manipulations can be done  by
     mixing  and matching the available options.  See the section
     entitled _H_I_N_T_S _F_O_R _G_O_O_D _I_M_A_G_E _D_I_S_P_L_A_Y_S for some ideas.

     The -_d_u_m_p option causes an image to be  written  to  a  file
     rather  than displayed after processing.  This allows you to
     read an image, perform a number of processing operations  on
     it,   and  save  the  resultant  image.   This  also  allows



Sun Release 4.1      Last change: 8 May 1991                    1






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



     translation from any of the recognized image types into  any
     of the formats that support dumping.

     _X_s_e_t_b_g is equivalent to _x_l_o_a_d_i_m_a_g_e -_o_n_r_o_o_t -_q_u_i_e_t and  _x_v_i_e_w
     is equivalent to _x_l_o_a_d_i_m_a_g_e -_v_i_e_w -_v_e_r_b_o_s_e.

RESOURCE CLASS
     _X_l_o_a_d_i_m_a_g_e uses the resource class name _X_l_o_a_d_i_m_a_g_e for  win-
     dow  managers  which  need  this  resource  set.   This name
     changed in version 2.00 and  2.01;  some  previous  versions
     used the name _X_L_o_a_d_I_m_a_g_e (which was difficult to predict) or
     _x_l_o_a_d_i_m_a_g_e (which conflicted with class naming conventions).

GLOBAL OPTIONS
     The  following  options  affect  the  global  operation   of
     _x_l_o_a_d_i_m_a_g_e.   They  may be specified anywhere on the command
     line.  Additionally the -_g_l_o_b_a_l option can be used to  force
     an image option to apply to all images.

     -border _c_o_l_o_r
             This sets the background portion of the window which
             is not covered by any images to be _c_o_l_o_r.

     -configuration
             Displays the image path, image  suffixes,  and  sup-
             ported  filters  which will be used when looking for
             and  reading  images.    These   are   loaded   from
             ~/.xloadimagerc  and  optionally  from  a systemwide
             file   (normally    /usr/lib/xloadimagerc).     This
             replaces the -path option.

     -default
             Use the default  root  weave  as  the  image.   This
             option  forces  -_o_n_r_o_o_t.  If -_d_e_f_a_u_l_t is used alone,
             it is the same as _x_s_e_t_r_o_o_t with  no  arguments.   If
             used  in  conjunction  with -_t_i_l_e this option can be
             used to place images on the default root weave  (see
             EXAMPLES below).

     -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.

     -delay _s_e_c_s
             Automatically advance to the next image  after  _s_e_c_s
             seconds.

     -display _d_i_s_p_l_a_y__n_a_m_e
             X11 display name to send the image(s) to.

     -dump _i_m_a_g_e__t_y_p_e[,_o_p_t_i_o_n[=_v_a_l_u_e]] _d_u_m_p__f_i_l_e
             Rather than  displaying  the  loaded  and  processed



Sun Release 4.1      Last change: 8 May 1991                    2






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



             image,  dump  it into an image file of the specified
             type.  For a list of image types that can be dumped,
             use  the  -_s_u_p_p_o_r_t_e_d  option.  Some image types have
             options that affect the format of  the  file  that's
             created.   See  DUMP OPTIONS below.  An image can be
             dumped in any supported dump  format  regardless  of
             the original image type, so image file type transla-
             tion is possible using this option.

     -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.

     -fork   Fork xloadimage.  This causes xloadimage to disasso-
             ciate  itself from the shell.  This option automati-
             cally turns on -quiet.

     -fullscreen
             Use the entire screen to display  images.   If  com-
             bined with -onroot, the image will be zoomed to fill
             the entire rootwindow.

     -geometry _W_x_H[{+-_X}{+-}_Y]
             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 reduce the size of the destina-
             tion window.  When loading an image  onto  the  root
             window,  this option controls the size of the pixmap
             which will be loaded onto the root.  If the size  is
             smaller  than that of the display, the image will be
             replicated.

     -goto image_name
             Forces the next image to  be  displayed  to  be  the
             image named _i_m_a_g_e__n_a_m_e.  This is useful for generat-
             ing 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.

     -help [option ...]
             Give information on an option or  list  of  options.
             If  no  option  is  given, a simple interactive help
             facility is invoked.

     -identify
             Identify the supplied  images  rather  than  display
             them.




Sun Release 4.1      Last change: 8 May 1991                    3






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



     -install
             Forcibly install the image's colormap when the  win-
             dow  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.

     -list   List the images which are along the image path.

     -onroot Load image(s) onto the root window instead of  view-
             ing in a window.  This option automatically sets the
             -fit option.  This is the opposite of -_v_i_e_w.  _X_S_e_t_b_g
             has this option set by default.

     -path   Displays miscellaneous information about the program
             configuration.  This option is obsolete and has been
             replaced by -configuration.

     -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.

     -private
             Force the  use  of  a  private  colormap.   Normally
             colors  are  allocated  shared  unless there are not
             enough colors available.

     -quiet  Forces _x_l_o_a_d_i_m_a_g_e and _x_v_i_e_w to be  quiet.   This  is
             the default for _x_s_e_t_b_g, but the others like to whis-
             tle.

     -supported
             List the supported image types.

     -type _t_y_p_e__n_a_m_e
             Forces _x_l_o_a_d_i_m_a_g_e to try to load the image as a par-
             ticular file type rather than trying to guess.  This
             often improves load performance noticably.

     -verbose
             Causes _x_l_o_a_d_i_m_a_g_e to be talkative, telling you  what
             kind of image it's playing with and any special pro-
             cessing that it has to do. This is the  default  for
             _x_v_i_e_w and _x_l_o_a_d_i_m_a_g_e.

     -version
             Print the version number and patchlevel of this ver-
             sion of _x_l_o_a_d_i_m_a_g_e.

     -view   View image(s) in a window.  This is the opposite  of



Sun Release 4.1      Last change: 8 May 1991                    4






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



             -_o_n_r_o_o_t and the default for _x_v_i_e_w and _x_l_o_a_d_i_m_a_g_e.

     -visual _v_i_s_u_a_l__n_a_m_e
             Force the use of a specific visual type  to  display
             an  image.   Normally  _x_l_o_a_d_i_m_a_g_e  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.

     -windowid _h_e_x__w_i_n_d_o_w__i_d
             Sets the background pixmap of  a  particular  window
             ID.  The argument must be in hexadecimal and must be
             preceeded by "0x" (_e_g -windowid 0x40000b.   This  is
             intended  for  setting the background pixmap of some
             servers which use untagged  virtual  roots  (_e_g  HP-
             VUE), but can have other interesting applications.

IMAGE OPTIONS
     The following options may preceed each image.  These options
     are local to the image they preceed.

     -at _X,_Y
          Indicates coordinates to load the image at on the  base
          image.   If  this  is an option to the first image, and
          the -_o_n_r_o_o_t option is  specified,  the  image  will  be
          loaded at the given location on the display background.

     -background _c_o_l_o_r
          Use _c_o_l_o_r  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.

     -brighten _p_e_r_c_e_n_t_a_g_e
          Specify a percentage multiplier  for  a  color  image's
          colormap.   A  value  of more than 100 will brighten an
          image, one of less than 100 will darken it.

     -center
          Center the image on the base image loaded.  If this  is
          an option to the first image, and the -_o_n_r_o_o_t option is
          specified, the image will be centered  on  the  display
          background.

     -clip _X,_Y,_W,_H
          Clip the image before loading it.  _X and _Y  define  the
          upper-left  corner of the clip area, and _W and _H define
          the extents of the area.  A zero value for _W or _H  will
          be interpreted as the remainder of the image.




Sun Release 4.1      Last change: 8 May 1991                    5






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



     -colors _n
          Specify the maximum number of  colors  to  use  in  the
          image.   This  is a way to forcibly reduce the depth of
          an image.

     -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  -_h_a_l_f_t_o_n_e and affects the image
          accuracy but usually looks much better.

     -foreground _c_o_l_o_r
          Use _c_o_l_o_r 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  fore-
          ground and background colors of a monochrome image.

     -gamma _d_i_s_p_l_a_y__g_a_m_m_a
          Specify the gamma  correction  for  the  display.   The
          default  value  is  1.0, a typical display needs 2.0 to
          2.5.

     -global
          Force the following  option  to  apply  to  all  images
          rather  than  one  specific image.  Local image options
          will temporarily override  any  option  specified  with
          -global.

     -gray
          Convert an image to grayscale.   This  is  very  useful
          when displaying colorful images on servers with limited
          color capability.  It can also be  used  to  convert  a
          bitmap  image  into  a  grayscale  image,  although the
          resulting image will be smaller than the original.  The
          optional spelling -_g_r_e_y may also be used.

     -halftone
          Force halftone dithering of a color image when display-
          ing 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
          -_d_i_t_h_e_r option will not blow the image up but will take
          longer to process and will be less accurate.

     -idelay _s_e_c_s
          Set the delay to be used for this image to _s_e_c_s seconds
          (see  -_d_e_l_a_y).  If -_d_e_l_a_y 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.




Sun Release 4.1      Last change: 8 May 1991                    6






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



     -invert
          Inverts a monochrome  image.   This  is  shorthand  for
          -_f_o_r_e_g_r_o_u_n_d _w_h_i_t_e -_b_a_c_k_g_r_o_u_n_d _b_l_a_c_k.

     -merge
          Merge this image onto the base image after  local  pro-
          cessing.   The base image is considered to be the first
          image specified or the last image  that  was  not  pre-
          ceeded  by -_m_e_r_g_e.  If used in conjunction with -_a_t and
          -_c_l_i_p, very complex  images  can  be  built  up.   This
          option  is  on by default for all images if the -_o_n_r_o_o_t
          or -_w_i_n_d_o_w_i_d options are specified.

     -name _i_m_a_g_e__n_a_m_e
          Force the next argument to be treated as an image name.
          This is useful if the name of the image is -_d_i_t_h_e_r, for
          instance.

     -newoptions
          Reset globally-specified options.

     -normalize
          Normalize a color image.

     -rotate _d_e_g_r_e_e_s
          Rotate the image by _d_e_g_r_e_e_s clockwise.  The number must
          be a multiple of 90.

     -shrink
          Shrink an image down to fit on the  display.   This  is
          particularly  useful  with  servers that do not support
          window  sizes  larger  than  the  physical  screen  (eg
          DECWINDOWS servers).

     -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  per-
          form, especially on large images.  You may specify more
          than one -_s_m_o_o_t_h option  per  image,  causing  multiple
          iterations of the smoothing algorithm.

     -tile
          Tile this image (after any necessary merging or tiling)
          to  create a fullscreen image.  This is usually used to
          create a large background image on which to merge other
          images.   -_g_e_o_m_e_t_r_y  can  be  used to set the new image
          size to something other than -fullscreen.

     -title _t_i_t_l_e
          Change the title of the image.  This sets the title bar
          title  if displaying in a window or the NIFF file image



Sun Release 4.1      Last change: 8 May 1991                    7






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



          title if dumping the image.

     -xzoom _p_e_r_c_e_n_t_a_g_e
          Zoom the X axis of an image by  _p_e_r_c_e_n_t_a_g_e.   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 -_y_z_o_o_m are useful for correct-
          ing the aspect ratio of images to be displayed.

     -yzoom _p_e_r_c_e_n_t_a_g_e
          Zoom the Y axis of an image by _p_e_r_c_e_n_t_a_g_e.  See  -_x_z_o_o_m
          for more information.

     -zoom _p_e_r_c_e_n_t_a_g_e
          Zoom both the X and Y axes by _p_e_r_c_e_n_t_a_g_e.   See  -_x_z_o_o_m
          for more information.  Technically the percentage actu-
          ally zoomed is the square of the number supplied  since
          the  zoom  is to both axes, but I opted for consistency
          instead of accuracy.

EXAMPLES
     To load the rasterfile "my.image" onto  the  background  and
     replicate it to fill the entire background:

          xloadimage -onroot my.image

     To center an image on the default root background:

          xloadimage -default -tile my.image

     If using a monochrome display and a  color  image  you  will
     probably want to dither the image for a cleaner (and faster)
     display:

          xloadimage -default -tile -dither my.image

     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):

          xloadimage   -foreground   red   my.image   -at   10,10
     another.image

     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:

          xloadimage -center -clip 10,10,100,0 my.image

     To double the size of an image:

          xloadimage -zoom 200 my.image



Sun Release 4.1      Last change: 8 May 1991                    8






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



     To halve the size of an image:

          xloadimage -zoom 50 my.image

     To brighten a dark image:

          xloadimage -brighten 150 my.image

     To darken a bright image:

          xloadimage -brighten 50 my.image

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 -_x_z_o_o_m  and  -_y_z_o_o_m  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 -_x_z_o_o_m _5_0 or -_y_z_o_o_m _2_0_0 (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.

     When zooming color images up you can reduce blockiness  with
     -_s_m_o_o_t_h.  For zooms of 300% or more, I recommend two smooth-
     ing passes (although this can take  awhile  to  do  on  slow
     machines).   There  will  be  a noticable improvement in the
     image.

     You can perform image processing on a small  portion  of  an
     image  by  loading  the  image  more than once and using the
     -_m_e_r_g_e, -_a_t and -_c_l_i_p 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:

          xloadimage   my.image   -merge    -at    50,50    -clip
     50,50,100,100 -brighten 150 my.image

     If you're using a display with a small colormap  to  display
     colorful  images,  try  using the -_g_r_a_y option to convert to
     grayscale.

PATHS AND EXTENSIONS
     The file ~/.xloadimagerc (and optionally a system-wide file)
     defines  a  number  of  configuration  options  that  affect
     xloadimage.




Sun Release 4.1      Last change: 8 May 1991                    9






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



     This file is split into three section, the _p_a_t_h section, the
     _e_x_t_e_n_s_i_o_n section, and the _f_i_l_t_e_r section.  The sections are
     identified by typing the section name followed by an  equals
     sign, eg "path =".

     The _p_a_t_h statement is used to provide a set of search  paths
     to  use  when  looking  for  an  image  of a specified name.
     Separate each path in the list by whitespace (eg one or more
     spaces,  tabs,  or  newlines).   The path is searched in the
     order it is specified.  For example:

       path = ~/images /usr/local/images ~fred

     will first look for the image name you specified, then  look
     for the name in ~/images (the tilde is expanded to the value
     of $HOME), then in /usr/local/images, then  in  user  fred's
     home directory.  This allows easy use of image repositories.

     The _e_x_t_e_n_s_i_o_n statement is used to provide a set of  default
     extensions  to  use when looking for an image of a specified
     name.  Separate each extension in the  list  by  whitespace.
     The  extensions  are searched in the order in which they are
     specified.  For example:

       extension = .gif .jpg

     If you have a file named _m_y_i_m_a_g_e._g_i_f you could  specify  the
     name  _m_y_i_m_a_g_e and xloadimage would append the ._g_i_f extension
     automatically.

     The _f_i_l_t_e_r statement is used to  describe  filter  programs,
     such as "uncompress", which are to be applied to image files
     automatically.  You  specify  one  filter  program  and  any
     number  of  recognized  extensions following the _f_i_l_t_e_r key-
     word.  For example:

       filter = uncompress .Z

     specifies that the program _u_n_c_o_m_p_r_e_s_s should be  used  as  a
     filter  whenever  an  image  file  has  a  .Z extension.  By
     default filters are provided for compressed (.Z)  files  and
     GNU  zip  (.gz)  files.   See  the  FILTERS section for more
     information on defining your own filters.

     Any text on a line following a hash-mark (#) is ignored;  if
     you  wish to use a hash-mark in a path, extension, or filter
     you can escape it using a backslash (\).

     If you wish to include white-space in a filter program name,
     path,  or  extension  you  can  enclose  the  entire text in
     double-quotes.  For example:




Sun Release 4.1      Last change: 8 May 1991                   10






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



       filter = "gzip -cd" .gz

     Use backslash (\) characters to allow inclusion  of  double-
     quote marks or newlines.

     The following is a sample ~/.xloadimagerc file:

       # paths to look for images in
       path = /usr/local/images        # system image repository
             ~/images                 # personal images
             /usr/include/X11/bitmaps # standard X bitmaps

       # default extensions for images
       extension = .csun .msun .sun .face .xbm .bm

       # invoke GNU zip if a .z or .zip extension is found
       filter = "gzip -cd" .z .zip


IMAGE TYPES
     _X_l_o_a_d_i_m_a_g_e currently supports many common and some  uncommon
     image  types, and can create images in several formats.  For
     a complete list use the -_s_u_p_p_o_r_t_e_d option.

DUMPING IMAGES
     Several image dumpers are  included  that  can  be  used  to
     create  a  new image after loading and processing.  The NIFF
     (Native Image File  Format)  is  the  simplest  and  creates
     images  that  _x_l_o_a_d_i_m_a_g_e  can read the fastest; it is essen-
     tially a copy of the internal image format.

     Some image dumpers allow options that affect the image  out-
     put.  These options are appended to the image type following
     a comma and are separated by commas.  If a value is  desired
     it  can be specified following an equals-sign.  For example,
     to create a monochrome JPEG image file with a quality factor
     of 80, you would use the following command line:

       xloadimage image_name -dump jpeg,quality=80,grayscale new_image.jpg

     Option names can be abbreviated but if the  abbreviation  is
     too  short  to  be  unique  the option which will be used is
     indeterminate.

FILTERS
     Xloadimage supports automatic filtering by recognizing  file
     extensions.   By  default  "compress"  and  "gzip" files are
     recognized and their names passed to appropriate commands to
     decompress them.

     The  xloadimage  distribution  includes  a  special  "smart"
     uudecoder, called _u_u_f_i_l_t_e_r that can be used to automatically



Sun Release 4.1      Last change: 8 May 1991                   11






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



     uudecode files for processing.  _U_u_f_i_l_t_e_r ignores  extraneous
     lines  in the file so it is particularly useful if the uuen-
     coded file was created by concatenating email or news  post-
     ings that had headers or line-break indicators included.

     To make use of _u_u_f_i_l_t_e_r you can add the following to your

       filter = "uufilter -s" .uu .uue
     The filter will be automatically invoked on any file with  a
     .uu or

     For a list of filters automatically recognized by xloadimage
     use the -_c_o_n_f_i_g_u_r_a_t_i_o_n option.

SUPPORTED IMAGE OPTIONS
     The JPEG image dumper supports the following options:

     arithmetic
             Use arithmetic encoding.

     grayscale
             Force a monochrome (grayscale) image to  be  created
             given a color image.

     nointerleave
             Create a non-interleaved file.

     optimize
             Enable entropy parameter optimization.

     quality Adjust the quality of the image to be created.   The
             default  quality  factor  is 75; lower values create
             poorer images.

     restart _i_n_t_e_r_v_a_l
             Set the restart interval in MCU rows, or MCUs if 'b'
             follows the interval value.

     smooth _s_m_o_o_t_h_i_n_g__f_a_c_t_o_r
             Set the smoothing factor.  Value should be between 0
             and 100, inclusive.

     If you are not familiar with the meaning  of  these  options
     you  can  ask  the Independent JPEG Group (IJG) via email at
     jpeg@cs.columbia.edu.

     The PBM image dumper supports the following options:

     normal  Dump a normal (ascii) PBM/PPM file.

     raw     Dump a RawBits format PBM/PPM  file.   This  is  the
             default  and  results in significantly smaller image



Sun Release 4.1      Last change: 8 May 1991                   12






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



             files than when using _n_o_r_m_a_l.

     There is no way to dump a PGM format file or a "compact" PBM
     format file (sorry).

     The TIFF image dumper supports the following options:

     compression
             Image data compression technique.  Can  be  one  of:
             _n_o_n_e  (no compression), _r_l_e (CCITT RLE compression),
             _g_3_f_a_x (CCITT Group 3 FAX compression), _g_4_f_a_x  (CCITT
             Group  4  FAX  compression),  _l_z_w  (Limpel-Ziv-Welsh
             compression, the default), _j_p_e_g (JPEG  compression),
             _n_e_x_t (NeXT run-length compression), _r_l_e_w (CCITT RLEW
             compression), _m_a_c (Macintosh PackBits  compression),
             _p_a_c_k_b_i_t_s  (same  as  _m_a_c),  _t_h_u_n_d_e_r_s_c_a_n (ThunderScan
             compression).

     _X_l_o_a_d_i_m_a_g_e  will  save  using  the  MINISBLACK,  MINISWHITE,
     COLORMAP,  or RGB photometrics as appropriate for its inter-
     nal image format.  There is no way to specify  a  particular
     photometric or any other TIFF fields.

AUTHOR
     Jim Frost
     CenterLine Software
     jimf@centerline.com

     For a  more-or-less  complete  list  of  other  contributors
     (there  are  a  _l_o_t  of  them),  please  see the README file
     enclosed with the distribution.

FILES
          xloadimage              - the image loader and viewer
          xsetbg                  - pseudonym which quietly sets the background
          xview                   - pseudonym which views in a window
          /usr/lib/X11/Xloadimage - default system-wide configuration file
          ~/.xloadimagerc         - user's personal configuration file

COPYRIGHT
     Copyright (c) 1989, 1993 Jim Frost and others.

     _X_l_o_a_d_i_m_a_g_e is copywritten material with a very  loose  copy-
     right  allowing  unlimited  modification and distribution if
     the copyright notices are left intact.  Various portions are
     copywritten by various people, but all use a modification of
     the MIT copyright notice.  Please check the source for  com-
     plete  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.





Sun Release 4.1      Last change: 8 May 1991                   13






XLOADIMAGE(1)            USER COMMANDS              XLOADIMAGE(1)



BUGS
     Zooming dithered images, especially downwards, is UGLY.

     Images can come in a variety of aspect  ratios.   _X_l_o_a_d_i_m_a_g_e
     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.  See  _H_I_N_T_S  _F_O_R  _G_O_O_D  _I_M_A_G_E
     _D_I_S_P_L_A_Y_S for more information.

     The GIF format allows more than one image to be stored in  a
     single GIF file, but _x_l_o_a_d_i_m_a_g_e will only display the first.

     Only GIF87a format is supported.

     One of the pseudonyms for _x_l_o_a_d_i_m_a_g_e,  _x_v_i_e_w,  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.

     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  nor-
     mally 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, _x_l_o_a_d_i_m_a_g_e 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 win-
     dow managers which are cruel enough to ignore such details.






















Sun Release 4.1      Last change: 8 May 1991                   14