DOS command-line options

-n = Skip introductory screen in 8-bit modes.

-vesa = forces tnimage to use VESA BIOS even for Trident or Tseng Labs cards.

-oldvesa = forces tnimage to use functions for version 1.0 VESA BIOS (slightly slower, but required on some cards).

-trident = Forces tnimage to use Trident-specific calls, even if VESA BIOS is present.

-tseng = Forces tnimage to use Tseng-specific calls, even if VESA BIOS is present.

-diamond = Forces tnimage to use Tseng-specific calls, even if VESA BIOS is present and sets the program to use Diamond Speedstar mode. This option is experimental and will be subsumed under the ``Tseng'' option after we obtain a Tseng-based Diamond card for testing. Feedback as to whether this option actually works will be appreciated.

-w32 = Forces tnimage to use Tseng-specific calls, even if VESA BIOS is present and sets the program to use W32 chip mode. This option is experimental and will be subsumed under the ``Tseng'' option after we obtain a card with the Tseng ET4000W32 chip for testing. Feedback as to whether this option works will be appreciated.

-S3, -ATI, -XGA = Force tnimage to control these chips directly, even if VESA BIOS is present. S3 and ATI are not currently implemented. XGA mode currently only works in 640 x 480 mode.

-diag , -diagnose = Diagnostic mode (Prints status messages at each stage of setting your video mode). Useful if you have difficulty starting tnimage on your computer. At each step, you need to press a key to continue. Please report this information when requesting technical assistance.

-fyu = This option is for debugging use only.

-macro macro_file = Automatically runs the specified macro file. See ``Batch mode processing'' -files file_list = Specifies a list of image files to be automatically loaded. Using a text editor, create an ordinary text file containing a list of the files to be read, with one filename on each line, for example:

t*.tif

c: $\backslash$ images $\backslash$ abc.bmp

hubble.img

Then start tnimage with the command:

tnimage -files test.lst substituting the name of your list for ``test.lst''. Do not put a dash before the filename of the list file. Wildcard characters such as '*' or '?' are also permissible. Up to 512 images can be loaded from the list file (if you have the Registered version). If you only need to load a few files, it may be easier to use the filename option (below) instead. filename filename ... = Reads the specified file(s). You can load as many files as you can cram onto the command line. If you have a large number of files, it may be easier to use the ``-files'' option (above). Do not precede the filename with a dash (``-''). Filenames may contain path specifications and wild cards (* or ?).

Examples:

tnimage my.gif = Loads my.gif

tnimage *.tif = Loads all TIF files in current directory.

tnimage c: $\backslash$images $\backslash$*.tif b: $\backslash$abc.img = Loads all TIF files from the C: $\backslash$images directory, then file abc.img from drive B.

tnimage -mode 103 *.tif -files file.lst -vesa

Any combination of command line options is also acceptable. See Screen modes supported (below) for a list of screen modes.

-mode xxx = Start up in screen mode xxx, where xxx is a hexadecimal number indicating the desired screen mode (see below). Some monitors cannot handle the highest resolution modes and will fail to `sync' or display a white screen. If this happens, press Alt-X two or three times to escape from the program. You can determine which screen modes your computer can handle by checking in the manual that came with your video card and monitor. Read the warning below before using this option.

Example: tnimage -mode 111

-xres xxx

= Start up in a VESA screen mode with x resolution of xxx, where xxx is the no. of horizontal pixels to display per scan line. 8 bits/pixel is automatically selected unless specified with the -bpp option. Some monitors cannot handle the highest resolution modes and will fail to `sync' or display a white screen. If this happens, press Alt-X two or three times to escape from the program. You can determine which screen modes your computer can handle by checking in the manual that came with your video card and monitor. Read the warning below before using this option.

-bpp xxx = Start up in a VESA screen mode of xxx bits/pixel. (Used in conjunction with the -xres option).

? or -? = List the available screen modes.

The options can be in any order, except that if a parameter is needed, it must follow the option. The arguments must be separated by spaces.

Examples: To run tnimage in VESA 1024x768 mode, type:

tnimage -vesa -mode 105 Enter or

tnimage -mode 105 (The word ``Vesa'' is only required if you happen to have a Tseng or Trident chip and you want to bypass direct chip addressing).

If you have an old card, specifying ``-vesa'' will cause display problems. If problems occur, use:

tnimage -oldvesa or

tnimage -oldvesa -mode 105 to select 1024x768 mode.

To run tnimage on a computer equipped with a Trident card, in 640 x 480 mode, type:

tta tnimage -mode 5d

or

tnimage -trident -mode 5d To run tnimage on a computer equipped with a card containing a Tseng Labs ET4000 chip, in 800 x 600 mode, type:

tnimage -mode 30 or tnimage -tseng -mode 30

To run tnimage and automatically load and display the image ``test.img'', type

tnimage test.img or tnimage -file test.img

To run tnimage in a 1600 x 1200 resolution at 8 bits/pixel, type:

tnimage -xres 1600 or tnimage -xres 1600 -bpp 8

To run tnimage in a 1600 x 1200 resolution at 24 bits/pixel (true color), type:

tnimage -xres 1600 -bpp 24

The command line options are stored in the file tnimage.INI, so the next time you start tnimage, it is not necessary to specify the screen mode.