- -/+mono
- Forces the image to be displayed in greyscale. This is
        most useful when you are using certain greyscale X
        displays. While xv attempts to determine if it's
        running on a greyscale display, many X displays lie,
        and claim to be able to do color. (This is often because
        they have color graphics boards hooked up to b/w
        monitors. The computer, of course, has no way of knowing
        what type of monitor is attached.) On these displays, if
        you don't specify -mono , what you will see is a
        greyscale representation of one of the RGB outputs of the
        system. (For example, you'll see the 'red' output on
        greyscale Sun 3/60s.) The -mono option corrects
        this behavior. 
- (Resource name: mono . Type: boolean)
-  
- -/+rv
- Makes xv display a 'negative' of the loaded image.
        White becomes black, and black becomes white. Color
        images will have 'interesting' effects, as the RGB
        components are individually reversed. For example, red
        (255,0,0) will become cyan (0,255,255), yellow will
        become blue, and so on. 
-  
- -white color
- Specifies the 'white' color used when the picture is b/w
        stippled. (When '-ncols 0' has been specified,
        or when viewing a b/w image.) 
- (Resource name: white . Type: string)
-  
- -black color
- Specifies the 'black' color used when the picture is b/w
        stippled. (When '-ncols 0' has been specified,
        or when viewing a b/w image.) Try something like: 'xv
        -ncols 0 -bl red -wh yellow <filename>' for
        some interesting, late-60's- style psychedelia
        effects.
- (Resource name: black . Type: string)
-  
- -wait secs
- Turns on a 'slide-show' feature. Normally, if you specify
        multiple input files, xv will display the first
        one, and wait for you to give the Next command (or
        whatever). The -wait option makes xv wait
        for the specified number of seconds, and then go on to
        the next picture, without any user intervention. The
        program still accepts commands, so it's possible to
        'abort' the current picture without waiting the full
        specified time by using the Next command. Note:
        If you are in Use Std. Colormap mode, and you use -wait
        0 , the images will not be dithered (as they
        normally are when you are in Use Std. Colormap
        mode). It's assumed that if you said '-wait 0'
        that you want the images displayed at maximum speed. You
        can still turn the dithering on if you desire by using
        the -dither option. (Resource name: <none>) 
- -/+wloop
- Normally, when running a slide-show with the -wait
        option, xv will terminate after displaying the
        last image. If you also specify the -wloop
        option, the program will loop back to the first image and
        continue the slide-show until the user issues the Quit
        command. 
- (Resource name: <none>)
-  
- -/+random
- Makes xv display multiple image files in a random
        order. Useful for breaking up the monotony of having
        slide-shows always display in the same order. Also, if
        you also use the -quit option, you can have xv
        display a single, random file from a list of files. This
        may be useful if you'd like xv to pick a random
        'background image' from some set of files. 
- (Resource name: <none>)
-  
- -/+loadclear
- If you were on a PseudoColor display, xv used to
        automatically clear the image window (and the root
        window, if using a root mode) whenever you loaded a new
        image. This was to prevent the potentially
        annoying/confusing 'rainbow' effect that happens when
        colormap entries are freed and reallocated with different
        colors. This has changed. By default, xv no longer
        clears the image/root window. This is for two reasons:
        I've decided the rainbow effect is semi-entertaining, in
        that it gives you something to look at while the next
        image is being loaded. Secondly, if you are viewing a
        series of images that have the same colors in them, it's
        possible for xv to animate them (by using the '-wait'
        command line option), albeit no faster than one frame
        every 1-2 seconds. For example, you can go get the
        satellite radar images from vmd.cso.uiuc.edu (in
        the directory wx), run 'xv -wait 0 SA*',
        and voila! Just like the evening news! 
- (Resource name: clearOnLoad Type: boolean)
-  
- -/+nofreecols
- Whenever you load a new image, xv normally frees
        the colors it was using for the previous image, and
        allocates new colors for the new image. This can cause
        'rainbow' effects on PseudoColor displays as the colors
        are changed. You can avoid this problem entirely by using
        the -nofreecols option, which suppresses the
        normal freeing of old colors. This is most useful when
        doing slide-shows. Note, however that there will be fewer
        colors available for 'later' images. These images will
        wind up being displayed with whatever colors were
        allocated for the earlier images. As such, they may or
        may not look that hot... (And allow me to reiterate: xv
        is not an image animator, despite options like
        these that let it do so, albeit poorly.) 
- (Resource name: <none>)
-  
- -/+rgb
- Specifies that, by default, the colormap editing dials in
        the xv color editor window should be in RGB mode.
        This is the normal default behavior. 
- (Resource name: hsvMode . Type: boolean ( false))
-  
- -/+hsv
- Specifies that, by default, the colormap editing dials in
        the xv color editor window should be in HSV mode. 
- (Resource name: hsvMode . Type: boolean ( true))
-  
- -/+lbrowse
- Turns on the Browse checkbox in the xv load
        window. This keeps the window from being automatically
        closed whenever you successfully load an image. 
- (Resource name: loadBrowse . Type: boolean)
-  
- -/+nostat
- Speeds up the performance of the xv load and xv
        save windows. (Which are really the same window...)
        It keeps xv from doing a stat() system
        call for each file in the current directory whenever you
        change directories. This is handy on systems with a lot
        remote files, where doing the stat() calls takes
        too long. One downside: subdirectories will not be shown
        with the little folder icons, as it requires a stat()
        call to determine whether a file is a subdirectory or a
        data file. This will not affect the operation of the
        program, just the 'niceness'. 
- (Resource name: nostat . Type: boolean)
-  
- -visual vistype
- Normally, xv uses the 'best' visual model it can
        get. It looks for a 24 or 32-bit deep TrueColor,
        or DirectColor visual. If it can get one, that's
        what it uses. Otherwise, it will fall back to using the
        'default' visual provided by your X server. You can
        override this bit of cleverness by explicitly selecting a
        visual to use. Valid types are StaticGray, StaticColor,
        TrueColor, GrayScale, PseudoColor, DirectColor,
        and default. All of these modes are not
        necessarily provided on any given X display. Run xdpyinfo
        on your display to find out what visual types are
        supported. You can also specify a specific visual by
        using its numeric visual ID, in the case that you have
        multiple instances of a given visual type available ( xv
        will pick the 'deepest' one by default) 
- (Resource name: visual . Type: string)
-  
- -cursor curs
- Specifies an alternate cursor to use in the image window
        (instead of the normal 'arrow' cursor). curs
        values are obtained by finding the character number of a
        cursor you like in the 'cursor' font. (Run 'xfd -fn
        cursor' to display the cursor font.) For example, a curs
        value of '56' corresponds to the (singularly useless)
        'Gumby' cursor.
- (Resource name: cursor . Type: integer)
-  
- -/+2xlimit
- By default, xv prevents the image window from ever
        getting larger than the screen. Unfortunately, because of
        this, if you load an image that is larger than your
        screen, the image will be shrunk until it fits on your
        screen. Some folks find this undesirable behavior.
        Specifying the -2xlimit option doubles the size
        limitations. The image window will be kept from getting
        larger than 2x the width and height of your screen. Just
        in case you're wondering why there are any size
        limitations: it's fairly easy to accidentally ask for a
        huge image to be generated. Simply Crop a section
        of the image, zoom so you can see the individual pixels,
        and UnCrop . If there were no size limitations,
        the (expanded many times) image could be huge, and might
        crash your X server. At the very least, it would take a
        long time to generate and transmit to your X server, and
        would freeze up your X server during part of it.
        Generally undesirable behavior. (Resource name: 2xlimit . Type: boolean) 
- -/+nolimits
- For the truly daring, this turns off all limitations on
        the maximum size of an image. (Well, there's still an
        X-imposed maximum size of 64K by 64K, but that really
        shouldn't be a problem.) Warning: as mentioned above, it
        is fairly easy to accidentally generate a huge image when
        you do an UnCrop command, and you may well crash xv,
        your X server, the host machine, or all three. Use At
        Your Own Risk!!! 
- (Resource name: nolimits Type: boolean) 
-  
- -/+close
- If specified, iconifying the xv image window will
        automatically close all the other xv windows.
        De-iconifying the xv image window will re-open the
        other xv windows. 
- (Resource name: autoClose . Type: boolean)
-  
- -/+iconic
- Starts xv with its image window iconified. 
- (Resource name: iconic . Type: boolean)
-  
- -icgeometry geom
- Specifies the screen position of the icon (when you use
        the -iconic option). 
- (Resource name: iconGeometry . Type: string)
-  
- -dir directory 
- Specifies an initial directory for xv to switch to
        when run. Also specifies the default directory used for
        the visual schnauzer and the xv load and xv
        save windows.
- (Resource name: searchDirectory . Type: string)
-  
- -flist fname
- Tells xv to read a file fname that consists
        of a list of names of image files to load, one per line.
        This file is in the same format generated by the File
        list checkbox in the xv save window. You can
        use this to get around shell 'command-length' limitations
        (which can hit you if you try 'xv *' in a
        directory with a thousand or two files), or you could
        have find (or whatever) generate this file based
        on some type of criteria (age, size, etc.) 
- (Resource name: fileList . Type: string)
-  
- -drift dx dy
- A kludge. In order to do certain operations, xv
        needs to be able to precisely position the contents of an
        image window on the screen. Unfortunately, window
        managers disagree wildly on exactly how the "where's
        the window" information will be presented to the
        program. The practical upshot is that, despite a sizable
        effort to the contrary, xv may very will have its
        image window 'drift' on the screen as you resize it. This
        option lets you specify correction factors to cancel out
        the drift. If the window drifts down and to the right,
        use negative values to cancel the drifting. If the window
        drifts up and to the left, use positive values to cancel
        the drifting. 
- (Resource name: driftKludge . Type: string)
-  
- -mfn font
- Lets you specify the mono-spaced font used in the TextView
        windows, and a few other places. Be sure you use a
        mono-spaced font, or you may well get 'interesting'
        effects. 
- (Resource name: monofont . Type: string)
-  
- -name string
- Lets you change what string is displayed in the titlebar
        of the image window. Normally, xv will display the
        version number and the filename. If you're calling xv
        from another program, you may prefer to have it print a
        more descriptive string, or perhaps something like
        '<click mouse to quit>' if you're also using the -quit
        option. 
- (Resource name: <none>) 
-  
- -/+viewonly
- For use when calling xv from some other program.
        Forces all user input to be ignored. This keeps the
        untrained (or inquisitive) user from nosing around,
        creating files, or just generally misbehaving. Also note
        that there's no way for the user to quit the program. It
        is up to the calling process to manually kill xv
        when it feels that the image has been displayed long
        enough. 
- (Resource name: <none>)
-  
- -/+grabdelay seconds
- Sets the default 'grab delay' in the Grab dialog
        box. See "The Grab
        Command" . 
- (Resource name: <none>)
-  
- -/+poll
- Turns file polling on. If enabled, xv will notice
        when the currently displayed image file changes (due to
        some other process rewriting it, or something like that),
        and it will automatically reload the image file once it
        appears to have settled down (once the file size stops
        changing for a few seconds). See "Image Reloading"
        for further details. 
- (Resource name: <none>)
-  
- -/+vsperfect
- Normally, the visual schnauzer uses its own
        private colormap. This is necessary in order to get a
        good set of colors to display the image icons, and not
        steal colors away from the actual image window. However,
        you may find the colormap install/deinstall very
        annoying. I do. You can specify this option ( +vsperfect
        ) to turn the 'perfect' behavior off. If you do so, the visual
        schnauzer windows will steal away a small (64-entry)
        part of the colormap (unless you are in Use Std.
        Colormap mode, in which case they will share the
        standard colormap). The downside is that neither the
        schnauzer nor the image will look as good. 
- (Resource name: vsPerfect . Type: boolean)
-  
- -/+vsdisable
- Completely disables the visual schnauzer. This is
        mainly so, if you have vsPerfect turned off, you
        can disable the schnauzer and keep it from stealing any
        colors from the image. In the default setting ( vsPerfect
        is turned on), this option will have no useful effect. 
- (Resource name: vsDisable . Type: boolean)
-  
- -gsdev str
- Sets the 'device' that the ghostscript package
        will generate output for, which is used whenever you read
        a PostScript file in xv. Currently, the default
        device is ppmraw , which means all PostScript will
        be converted to either a 24-bit color PPM file, an 8-bit
        greyscale PGM file, or a 1-bit black- and-white PBM file,
        as appropriate (based on the particular PostScript file
        in question). Note that your copy of ghostscript
        must be configured to support this device, and any other
        values you may wish to set this option to. See the xv
        Makefile for further information. Also note:
        Be very careful when using these options, as it's pretty
        easy to have ghostscript generate enormous
        data files. For example, for normal 8" by 11"
        pages, at 72dpi, a PBM file will require ~60K per page, a
        PGM file will require ~500K per page, and a PPM file will
        require ~1.5M per page. If you have it generate images at
        300 dpi (see below), these sizes explode to roughly 1, 8,
        and 24 megabytes per page. As such, you should forget
        about viewing color pages at 300 dpi, and you may also
        want to forget about viewing multi-page PostScript files
        at 300 dpi. (Resource name: gsDevice . Type: string) 
- -gsres res
- Specifies the resolution of the page files generated by ghostscript,
        in dots per inch. Defaults to 72 dpi. You can set it to
        any value, but be careful about generating enormous
        intermediate datafiles. 
- (Resource name: gsResolution . Type: integer)
-  
- -gsgeom geom
- Sets the page size of the files generated by ghostscript.
        Normally, this defaults to '612x792', which is the size
        of 8" by 11" paper, as measured in 72nds of an
        inch. Note that these numbers are in 72nds of an inch
        regardless of the resolution (dpi) value set by gsResolution
        . 
- (Resource name: gsGeometry . Type: string)
-  
- -/+nodecor
- Turns off certain decorations on the xv image window's
        frame, maybe. Works for mwm, at least. There is no
        way to do this trick with olwm, and twm
        doesn't need it. Anyway, if you turn off the titlebar and
        such on the xv image window, it removes the minimum
        size constraint/problem that I talk about in "Cropping" ,
        and elsewhere. 
- (Resource name: nodecor Type: boolean)
-  
- -RM
- If specified, deletes all files specified on the xv
        command line when xv exits. This can be handy if
        you're using xv as an external viewer, and you'd
        like to hand it a file, have it displayed, and then have
        it go away. 
- (Resource name: <none>)
-  
- -DEBUG level
- Turns on some debugging information. You shouldn't need
        this. If everything worked perfectly, I wouldn't
        need this. 
- (Resource name: <none>)
-  
- -
- Specifying '-' all by itself tells xv to take its
        input from stdin , rather than from a file. This
        lets you put xv on the end of a Unix pipe.