Stars of Shareware: DFÜ und Kommunikation/SOS-DFUE.ISO/programm/best_66/gds3c/gds.txt

Text File | 1994-09-28 | 177.9 KB | 4,725 lines

GDS.TXT - This is a data file.  DO NOT modify it.

Copyright (c)1991-95 Photodex Corporation.  All rights reserved.



Tampering with this file is a violation of federal copyright laws and
international treaties.  Violators will be prosecuted to the fullest
extent of the law.



:::catRes

(press 'Esc' to cancel)


Select Catalog Image Resolution:

A- 320x200
B- 640x400
C- 640x480 (default)
D- 800x600
E- 1024x768
F- 1280x1024

Which? :::catFType
Select Catalog File Type

G- GIF (16 to 256 colors)
J- JPEG (24 bit/16M colors)

Which? :::catDepth
GIF89a

Select GIF Catalog Bit Depth

A- 4 bit / 16 colors
B- 8 bit / 256 colors

Which? :::cat24


There are 24 bit files in this batch. Palette optimization requires more
processing.  JPEG files require 5-10 seconds more per file to process
because of redundant decompression.


Select Palette Quality

A- Lame (fast, but image quality is not great)
B- Best possible palette (a bit slower, but the wait is worth it)

Which? :::catStyle

Select GDS Catalog Style

A- Black, no borders
B- Black with borders
C- White, no borders
D- White with borders
E- Gray, no borders
F- Gray, 3D borders (default)

Which? :::catLay

Select GDS Catalog Layout (%d files)

:::catNoVirt

Not enough memory for virtual screen file.  Catalog cannot be generated.

Press any key to continue.
:::catFinal



If you have not seen a recent copy of GDS, you should!  GDS has been given
a new look and overhauled by Photodex, and is now the most complete graphics
file viewer/cataloger in the world.  It has the fastest viewing capabilities
and user interface of any mainstream graphics programs.  Better yet, GDS out-
does just about every other file viewer, file cataloger, or file converter!
GDS is now used by professionals worldwide to manage thousands of graphics
files every day.  Become a graphics professional -- Discover GDS.

Search this system for GDS*.ZIP or GDS*.EXE to get the best file viewer ever.
GDS is shareware, affordable, and registration help is always included.

Generating GDS catalog, this takes a minute or two...(Press 'Esc' to cancel)

:::vidType


Ready to attempt detection of video hardware.  NOTE: Some notebooks crash
during video detection.  If the screen locks up after you press [Enter]
(give it 10-20 seconds), simply reboot and use one of the numbers or letters
here. See the help system for more information, or the end of GDS.TXT if
you are familiar with low level video hardware.
(Video types marked with '*' may not be 100%% detectable on all machines.)

 1-HERC  *5-AHEAD    *9-CIRRUS    D-F1280   H-SS24X    *L-TSENG    P-ST64
 2-CGA    6-AHEADB   *A-CL54      E-GENOA   I-STEALTH  *M-TSENG4
 3-EGA    7-ATI      *B-EVEREX   *F-OAK     J-STPRO    *N-VESA
*4-VGA    8-CHIPS     C-EV634    *G-PARA   *K-TRIDNT    O-VIDEO7

Press [Enter] for automatic detection,
or select the video type number from the above list. :::selfCfg
GDS %s SELF CONFIGURATION

If the machine locks up, reset and try GDS /VESA
:::vBIOSChg


Attention:  The video BIOS has changed since the file CONFIG was created.
GDS checks the video BIOS to detect new video hardware.  If you are using
a 'smart' extended memory manager (like QEMM), this may happen every time
you start GDS.  You can disable this message by inserting the following
command in the file GDSUSER.CFG:

    auto,/OK


Press [Enter]    to use existing CONFIG file
Press   'R'      to Reconfigure GDS

Which? :::selfCfg2
GDS %s SELF CONFIGURATION

Video type set to %s

Some video cards lock the machine up when asked about VESA support.
Do you want to try to detect VESA support (Y/N)? :::svDet

Stealth VRAM detected.  Make sure you have run SMODE MONITOR
Press [Enter] to continue.:::vDet

Viper detected.  Make sure you have run VPRMODE VESA
Press [Enter] to continue.:::sDet

Stealth Pro detected.  Make sure you have run STLMODE VESA
Press [Enter] to continue.:::s64Det

Stealth 64 detected.
Make sure you have S64MODE in your AUTOEXEC.BAT file.
Press [Enter] to continue.:::noIdea


                      Oh NO!  /NOIDEA specified!


If you are having technical problems with GDS, we want to know about it!
Give us a call at [phone].  We'll be happy to figure out why things
aren't going well with your copy of GDS.  If you can't get a hold of us
(like if it's Sunday morning at 4:00AM), try sending a FAX.  We'll get back
to you as soon as possible.

Photodex Corporation
1781 Barcelona Street
Livermore, CA  94550

[phone] - Voice
[phone] - FAX

Thank you for your support.
:::falo
WARNING: Files found before /~L%d!  Max files left unchanged.

Try specifying the /~L<n> parameter near the top of the GDSUSER.CFG file.

Press a key.:::virt
Virtual screen must be 1, 4, 8, 15, 16, or 24 bits
:::noVirt
Can't create virtual file
:::noVidType
Unable to detect video type
:::prob

If you have problems configuring GDS, try
giving us a call at [phone].
:::detect
Detecting video hardware...:::ckVesa

Checking for VESA support...
:::modeTst
VIDEO MODE TEST FOR %s
───────────────────────────
%s Mode: %dx%d, %ld colors

Press: [Enter] to test this graphics mode.
       [Y] to accept mode without testing.
       [N] to remove mode.

       [Esc] to cancel.

** If the screen goes crazy, press [Enter] quickly. **:::modeOver
VIDEO CONFIGURATION COMPLETE

Press [Enter] to save the configuration
as default, or [Esc] to cancel without
making any changes.:::modeOverwrite
An existing CONFIG file already exists.
Do you want to overwrite it?

Press [Y] or [N], or [Esc] to cancel.:::modeNo
Ok.  The changes you have made will not be
saved to the permanent configuration file,
but they will remain active for the rest of
your current GDS session.

Press any key to exit.:::palLock
  The palette has been locked to the
 best fit for the currently selected
files.  To unlock the palette, choose
  the 'Lock Palette' option again.

     Press any key to continue.:::help
ABOUT GDS/PHOTODEX
GDS %s- Copyright (c)1991-94 Photodex Corporation.  All rights reserved.
──────────────────────────────────────────────────────────────────────────────
   Photodex Corporation        CompuServe:  74274,3222 (GO GRAPHSUP)
   1781 Barcelona Street         Internet:  [e-mail]
   Livermore, CA  94550
   [phone] Voice        Order Line:  [phone]  9AM-5PM PST
   [phone] Fax                        GDS is $39.95 (US funds)
──────────────────────────────────────────────────────────────────────────────
Usage:    GDS [options] [files]

   [options] can be any command line options (see "Help" menu for details.)
             Any command line parameters can be put into a configuration
             file (see "Configuration Options" in the "Help" menu.)

     [files] can be any number of file and/or path specifications
──────────────────────────────────────────────────────────────────────────────
Examples:
          GDS                       -start GDS normally

          GDS /S /Z150              -do slideshow with 1.5 second delay
                                     between frames

          GDS c:\gifs c:\jpegs      -start GDS using files from the c:\gifs
                                     and c:\jpegs directories:::NoPrt
This GDS trial version does not print graphics.
The registered version prints 300dpi graphics
fitted to an 8½x11" page in both portrait and
landscape modes.  GDS supports all 300dpi HP and
compatible PCL printers (HP LaserJet II, III, 4,
deskjet and inkjet printers.)

             Photodex
Order Line:  [phone]   GDS is $39.95
                             VISA/MC/AMEX OK
FAX Orders:  [phone]
  (please use printed form for FAX orders):::Free25
This GDS trial version will not put more than
25 files in the file list, does not print, and
does not save color reduced true color pictures.
To get these features, buy the enhanced version
of GDS, and enjoy all of it's useful features.

             Photodex
Order Line:  [phone]   GDS is $39.95 + s/h
                             VISA/MC/AMEX Ok
FAX Orders:  [phone]
  (please use printed form for FAX orders):::NoShell
This version of GDS does not allow shelling to
DOS.  The enhanced version is required.

             Photodex
Order Line:  [phone]   GDS is $39.95 + s/h
                             VISA/MC/AMEX Ok
FAX Orders:  [phone]
  (please use printed form for FAX orders):::Free25
This GDS trial version will not put more than
25 files in the file list, does not print, and
does not save color reduced true color pictures.
To get these features, buy the enhanced version
of GDS, and enjoy all of it's useful features.

             Photodex
Order Line:  [phone]   GDS is $39.95 + s/h
                             VISA/MC/AMEX Ok
FAX Orders:  [phone]
  (please use printed form for FAX orders):::NoValConv
No graphics files selected to convert.

Put the file cursor on a file, or
select files to convert by using the
mouse or spacebar.:::NoBatch
This GDS trial version will not handle more than
25 files in the file list or batch conversions.
The registered (paid for) version of GDS can
easily convert up to 2,848 in one batch.  To get
these features and many more, buy GDS.

             Photodex
Order Line:  [phone]   GDS is $39.95 + s/h
                             VISA/MC/AMEX Ok
FAX Orders:  [phone]
  (please use printed form for FAX orders):::NoReduce
This GDS trial version will not color reduce
true color pictures, or convert pictures to
JPEG format.  To get the best color reduction
available, buy the registered version of GDS,
and process up to 2,848 files per batch!

             Photodex
Order Line:  [phone]   GDS is $39.95 + s/h
                             VISA/MC/AMEX Ok
FAX Orders:  [phone]
  (please use printed form for FAX orders):::conNoV
Unable to create virtual file.

(name=%s)

Press any key.:::conNoVText
Unable to create virtual file (%s).

:::conAb
Aborted by pressing [ESC].

Press any key.:::conAbText
Aborted by pressing [ESC].
:::batchFile
You have files selected for a batch
file operation.  This trial version
only processes one file at a time.

For more information about getting the
enhanced version of GDS, see "How to
Order GDS" in the "Help" menu.

Press any key.:::manDead
:::manMaster
hlConfTop
 hlConfPU
 hlConfInst
 hlConfLaptop
 hlConfVideo
 hlConfRept
 hlConfCrash
 hlConfDiamond
 hlConfOrchid
 hlConfTest
 hlConfFile
hlFileList
hlHowToSelect
hlHowToView
 hlViewModeCommands
  hlVMCZoomOMatic
  hlVMCColorLevel
  hlVMCContrast
  hlVMCBrightness
  hlVMCHue
  hlVMCScale
  hlVMCArrow
  hlVMCKeyboardPan
  hlVMCSharp
  hlVMCQuote
hlHowToSlideshow
 hlHowToCLSlideshow
hlHowToCatalog
 hlHowToCLCatalog
 hlBBS
hlHowToConvert
 hlFileConvert
 hlViewWrite
 hl/@C
manMenus
 hlFileMenu
  hlFileMenuCopy
  hlFileMenuMove
  hlFileMenuRename
  hlFileMenuHide
  hlFileMenuDelete
  hlFileMenuSubdirs
  hlFileMenuJump
  hlFileMenuPrint
  hlFileMenuShell
  hlFileMenuExit
 hlViewMenu
  hlViewMenuSlideshow
  hlViewMenuCatalog
  hlViewMenuDithering
  hlViewMenuAntialias
  hlViewMenuBeep
  hlViewMenuComment
  hlViewMenuCatalogStyle
  hlViewMenuCenterSlideshow
 hlDisplayMenu
  hlDisplayMenuShow
  hlDisplayMenuSort
 hlConvMenu
  hlConvBMP1
  hlConvBMP4
  hlConvBMP8
  hlConvBMP24
  hlConvGIF1
  hlConvGIF4
  hlConvGIF8
  hlConvLBM1
  hlConvLBM4
  hlConvLBM8
  hlConvPCX1
  hlConvPCX4
  hlConvPCX8
  hlConvRIX4
  hlConvRIX8
  hlConvTGA15
  hlConvTGA24
  hlConvTIF1
  hlConvTIF4
  hlConvTIF8
  hlConvTIF24
  hlConvJPG24
  hlConvANSI
 hlScanMenu
 hlSetupMenu
  hlSetupMenuConf
  hlSetupMenuSystem
  hlSetupMenuPrintColor
  hlSetupMenuPrintPort
  hlSetupMenuText
 hlHelpMenu
 hlResMenu
 hlAutoLockMenu
 hlMouseMenu
 hlPaletteMenu
  hlLimitPal
  hlFetchPal
  hlLockPal
hlViewModeMenu
 hlViewModeMenuFile
  hlVMMFSaveANS
  hlVMMFSaveGIF
  hlVMMFSaveLBM
  hlVMMFSavePCX
  hlVMMFSaveBMP
  hlVMMFSaveRIX
  hlVMMFSaveTIF
  hlVMMFSaveTGA
  hlVMMFSaveJPG
  hlVMMFSetCrop
  hlVMMFResetCrop
  hlVMMFFileInfo
  hlVMMFQuit
 hlViewModeMenuEdit
  hlVMMERotate
  hlVMMEFlipHorz
  hlVMMEFlipVert
  hlVMMEPan
  hlVMMEReset
 hlViewModeMenuColor
  hlVMMCGray
  hlVMMCMax
  hlVMMCInvert
  hlVMMCResetColor
  hlVMMCResetAll
 hlViewModeMenuSize
  hlVMMSFit
  hlVMMSSetZoom
  hlVMMSDoubleX
  hlVMMSDoubleY
  hlVMMSDoubleXY
  hlVMMSHalfX
  hlVMMSHalfY
  hlVMMSHalfXY
  hlVMMSCenter
  hlVMMSReset
 hlViewModeMenuPrint
  hlVMMPPrint
 hlViewModeMenuRes
manAppendix
 hlTrialVer
  hlDiff
 hlViewTheory
 hlCmdAlpha
  hl/!
  hl/A
  hl/B
  hl/C
  hl/D
  hl/E
  hl/F
  hl/G
  hl/H
  hl/I
  hl/I
  hl/K
  hl/L
  hl/LAPTOP
  hl/M
  hl/N
  hl/NOCGA
  hl/NOEGA
  hl/NOHERC
  hl/NOMONO
  hl/NOVESA
  hl/NOIDEA
  hl/O
  hl/OK
  hl/P
  hl/Q
  hl/QUIET
  hl/R
  hl/S
  hl/T
  hl/U
  hl/V
  hl/W
  hl/X
  hl/Z
  hl/#
  hl/=
  hl/~A
  hl/~B
  hl/~E
  hl/~F
  hl/~G
  hl/~J
  hl/~K
  hl/~L
  hl/~M
  hl/~O
  hl/~R
  hl/~T
  hl/~Z
  hl/<vid>
  hl/512
  hl/1M
  hl@<file>
  hl/@C
 hlCmdVH
 hlRev
 hlGlossary
:::manMenus
Using GDS File List Menus

The file display of GDS has pull-down menus at the top of the text screen as
well as the bottom.  The most used menus are at the top and the less
commonly used (and more intricate) menus are at the bottom.

To activate a menu, simply click on the menu name with a mouse and drag the
mouse down (or up) until the desired menu option is highlighted).  Release
the mouse button to select the menu option.

If you are using a keyboard, you can use an "Alt" key combination to activate
each menu.  Each menu has a highlighted letter, which can be typed as an "Alt"
key combination to activate the menu.  Use the arrow keys to move the
selection bar up and down until the desired option is highlighted.  Press the
[Enter] key to select the menu option.
:::manAppendix
APPENDICES
:::helpTop
GDS Hypertext Help System

  Quick Reference
  hlHowToViewHow to View Images        Welcome to GDS's built-in hypertext help
  hlHowToSlideshowHow to Play Slideshows    system.  Use the [Tab] and [Shift-Tab] keys
  hlHowToCatalogHow to Create Catalogs    or the mouse to highlight words and phrases
  hlHowToConvertHow to Convert Images        displayed in bright white.
  hlTrialVerGDS Trial Version
                For instructions on how to use this help
  Detailed Information        system, press the hlHelpF1] key or hlHelpclick here.
  hlFileListHow the File List Works
  hlHowToSelectHow to Select Files
  hlViewTheoryHow GDS Processes Images
  hlConfTopGDS Configuration Info

  Menus & Commands            Other Information
  hlMenusMain File Menus            hlLegalCopyright and Legal Info.
  hlViewModeMenuView Mode Menus            hlPhotodexPhotodex Corporation
  hlViewModeCommandsView Mode Commands            hlOrderOrdering GDS
                    hlOFrmOrder Form
  Lists and Tables            hlUpgradeGDS Upgrades
  hlCmdTopCommand Line Parameters
  hlRevGDS Revision History
  hlGlossaryGlossary of Computer Terms
:::hlLegal
Copyright and Legal Information

Copyright (c)1991-95 Photodex Corporation.  All rights reserved.

The GDS program, overlay files, help files, documentation, configuration
files, graphics files and all other files are the property of Photodex
Corporation.

If you have the shareware hlTrialVertrial version, you can use the product for a
reasonable trial period of up to 21 days, after which time you must not use
GDS unless you have purchased an enhanced version.

Related Topics
    hlTrialVerGDS Trial Version
    hlOrderOrdering GDS
    hlPhotodexPhotodex Corporation

:::hlFileList
Using GDS File List

The center section of the screen is the File List.  The first items in the
File List are normally the directories that can be reached from the current
directory.  Directories are noted by the name being enclosed in pointed
brackets: <dir> The parent directory is: <..>.  The current directory is not
listed.  In some cases directories may not appear in the File List.  If you
start GDS with a number of paths specified on the command line GDS will not
display the directory tree in the File List.

After the directories GDS lists graphics files in the current directory (or
specified path) that can be displayed.  Double click on a filename to enter
View Mode and display the image.

The file display of GDS has pull-down menus at the top of the text screen as
well as the bottom.  The most used menus are at the top and the less
commonly used (and more intricate) menus are at the bottom.

To activate a menu, simply click on the menu name with a mouse and drag the
mouse down (or up) until the desired menu option is highlighted).  Release
the mouse button to select the menu option.

If you are using a keyboard, you can use an "Alt" key combination to activate
each menu.  Each menu has a highlighted letter, which can be typed as an "Alt"
key combination to activate the menu.  Use the arrow keys to move the
selection bar up and down until the desired option is highlighted.  Press the
[Enter] key to select the menu option.

Related Topics
    hlHowToSelectSelecting Files
    hlMenusMain File MenusmanMenus

:::hlUpgrade
GDS Upgrades

Special upgrade pricing is available for all registered GDS users.

Upgrade
 Price        If you purchased GDS...
-------        -----------------------
$29.95+s/h    ...1.XX

$10.00        ...2.XX within the last calandar year.
$29.95+s/h    ...2.XX more than one year ago.

$10.00        ...3.XX within the last six months.
$29.95+s/h    ...3.XX within the last six months.

(call)        ...any version of GDS Professional

Shipping/handling charges are $3.00 for First Class Mail within the
continental United States.  Other shipping charges apply for ALL OTHER
SHIPPING DESTINATIONS.  For specific shipping prices, please call
hlPhotodexPhotodex at [phone].

$10.00 upgrade prices include First Class Mail within the continental
United States.  Other shipping charges apply for other destinations.
Please call for exact shipping amounts.


:::hlOrder
How to Order GDS

If you have already purchased a copy of GDS, you are eligible to receive
special upgrade pricing.  See hlUpgradeGDS Upgrades.

By ordering GDS you get an enhanced version on 3.5" disk, a brief manual, the
right to use GDS as much as you want, and special low upgrade rates for
future versions of GDS.

To order GDS with a VISA, MasterCard or American Express, just call hlPhotodexPhotodex
at [phone] and have your card number handy.

The standard user version of GDS costs $39.95 plus shipping/handling and
California state tax (if you are within California).

NOTE: We use your FULL NAME and VOICE PHONE NUMBER as your customer ID.  Your
name and number will appear in your copy of GDS, but will NOT be used for any
other purpose.  THERE ARE NO EXCEPTIONS.

To order GDS via mail or FAX, print out the hlOFrmPurchase Order/Registration Form
and fill it out.  If ordering by FAX, please FAX the completed order form
including the appropriate shipping amounts to hlPhotodex(510) 449-3519 -- no cover page
is necessary.

If you prefer mailing, put the order form in a stamped envelope including a
check or money order made payable to hlPhotodexPhotodex, and mail to hlPhotodexPhotodex:

      Photodex Corporation
      1781 Barcelona Street
      Livermore, CA  94550

Orders are usually processed within one business day except major holidays.
UPS Ground shipping or mail is included.  Expedited and international shipping
is extra.  Check orders must be drawn on a United States bank in U.S. funds.
Orders received without proper international shipping charges will be returned
postage due.

IF YOU ARE NOT IN THE UNITED STATES:  Call, FAX, E-Mail or write us to find
out what you should be charged for shipping.  If the shipping amount is not
correct on your order, your order will be returned postage due.


:::hlPhotodex
Photodex Corporation Information

Photodex has been a software developer and publisher since 1987.  The
information in this section is subject to change without notice.

Mailing Address:
    Photodex Corporation
    1781 Barcelona Street
    Livermore, CA  94550

Phone Numbers:
    Voice    [phone]    (order line)
    FAX    [phone]

E-Mail Address:
    Internet    [e-mail]
    CompuServe    74274,3222    (GO PHOTODEX)
    America Online    Photodex
    Prodigy        --
:::hlAbout
About GDS

GDS - Copyright(c)1991-95 hlPhotodexPhotodex Corporation.  All rights reserved.

GDS is a file viewer and cataloger.  It helps you manage image files.  It
is "ShareWare", not "FreeWare", which means you must pay for it if you
want to keep using it.  When you buy GDS, you also get the right to use it
for as long as you like, a printed manual, several enhanced features, and
the option to upgrade to future releases at greatly reduced rates.

See also
    helpTopHypertext Help
    hlOrderOrdering GDS


:::hlExmp
Example of Hyptertext Link

This reference is an example of the hypertext linking in GDS's on-line
Hypertext Reference.  Any time you see a highlighted word, you can click on
it to get more information.

Press the [Esc] key on the keyboard to exit back to the previous screen.


:::hlCmdTop
Command Line Parameters

  hlCmdAlphaAlphabetical List
  hlCmdVHSpecifying Video Hardware
  hlCmdCatCatalog Parameters


:::hlCmdCat
Catalog Parameters

The following is a list of command line parameters which are especially
useful for creating catalogs from the command line.  If you wish to fully
understand the capabilities of GDS's command line catalogs, look through
these command line parameters.

    hl/A/A    Antialiasing level
    hl/D/D    Dithering level
    hl/G/G    Graphics resolution
    hl/L/L    Catalog label control
    hl/M/M    Optimized palette color limit
    hl/N/N    New file name template
    hl/O/O    Sort yes/no switch
    hl/P/P    Set number of thumbnails across/start auto catalog
    hl/Q/Q    Catalog logo placement control
    hl/U/U    Catalog border control
    hl/W/W    Set first file number to write
    hl/~A/~A    Set catalog style
    hl/~G/~G    Force optimized grayscale palettes
    hl/~M/~M    Set JPEG quality level
    hl/~O/~O    Set file sort type
    hl/~R/~R    Force 1:1 aspect ratio
    hl/~T/~T    Set catalog output file format
    hl@<file>@<file>    Read file list from file

Related Topics
    hlHowToCLCatalogCatalogs from the Command Line
    hlBBSCataloging a BBS

:::hlCmdVH
Video Hardware Parameters

The following is a list of valid video hardware types to be used to force
GDS to assume it has certain video hardware.  See hl/<vid>/<vid>.

 /AHEAD        Ahead Systems 'A' chipset
 /AHEADB    Ahead Systems 'B' chipset
 /ATI        ATI VGA Wonder
 /CGA        CGA
 /CHIPS        Early Chips & Technologies chipsets
 /CIRRUS    Early Cirrus Logic chipsets
 /CL54        Cirrus Logic 54xx chipsets
 /EGA        Standard EGA
 /EVEREX    Early Everex SVGA's
 /EV634        Everex Viewpoint Premium VGA
 /F1280        Orchid Farenheit 1280
 /GENOA        Genoa 6600 series (6100, 6200, 6300, 6400, 6600)
 /HERC        Hercules mono only
 /OAK        Oak Technologies
 /PARA        Paradise (Western Digital) chipsets
 /SS24X        Diamond Speedstar 24X (NOT Speedstar 24!)
 /ST64        Diamond Stealth 64
 /STEALTH    Diamond Stealth VRAM
 /STPRO        Diamond Stealth PRO
 /TRIDNT    Trident TVGA / ATI Prism Elite
 /TSENG        Tseng Laboratories ET-3000 chipsets
 /TSENG4    Tseng Laboratories ET-4000 chipsets
 /VESA        VESA (avoids autodetection)
 /VGA        Standard VGA
 /VID7        Video 7 VEGA Deluxe, 1024i, VRAM VGA

Related Parameters
    hl/<vid>/<vid>    Force Video Hardware Type
    hl/LAPTOP/LAPTOP    Use on some laptops to avoid standard modes
    hl/NOCGA/NOCGA    Ignore CGA modes (useful for laptops/notebooks)
    hl/NOEGA/NOEGA    Ignore EGA modes (useful for laptops/notebooks)
    hl/NOHERC/NOHERC    Ignore Hercules mono (useful for laptops/notebooks)
    hl/NOMONO/NOMONO    Ignore all mono modes (restricts modes to color)
    hl/NOVESA/NOVESA    Do NOT trust manufacturer's VESA BIOS information


:::hlCmdAlpha
Alphabetical Command Line Parameter List

    *NOTE:  Command line parameters to specify video hardware are not
        shown here. See hlCmdVH/<vid> for more information.

hl/! /!     Beep when image view complete
hl/A /A     Antialiasing level
hl/B /B     Text mouse cursor mode
hl/C /C     Palette DAC chip control (SuperEGA's may need this)
hl/D /D     Dithering level
hl/E /E     Image fit mode
hl/F /F     Default file display options
hl/G /G     Default graphics resolution
hl/H /H     Help
hl/I /I     Interlaced GIF fill mode
hl/K /K     Display GIF comments after view
hl/L /L     Catalog label control
hl/LAPTOP /LAPTOP Use on some laptops to avoid certain video modes
hl/M /M     Optimized palette color limit
hl/N /N     New file name template
hl/NOCGA /NOCGA     Ignore CGA modes
hl/NOEGA /NOEGA     Ignore EGA modes
hl/NOHERC /NOHERC Ignore Hercules mono mode
hl/NOMONO /NOMONO Ignore all mono modes
hl/NOVESA /NOVESA Do NOT trust manufacturer's VESA BIOS information
hl/NOIDEA /NOIDEA Prints phone number to call when you're confused
hl/O /O     Sort order control
hl/OK /OK     Prevent recurring configuration
hl/P /P     Create catalogs from command line
hl/Q /Q     Catalog logo placement control
hl/QUIET /QUIET     Disable opening screen
hl/R /R     Resolution 'Lock' mode
hl/S /S     Play slideshow
hl/T /T     Text mode control
hl/U /U     Catalog border control
hl/V /V     File list vertical presentation option
hl/W /W     Set first file number to write
hl/X /X     Exit to DOS after slideshow
hl/Z /Z     Slideshow delay
hl/# /#     Set printer's filename
hl/@C /@C     Convert files from command line
hl/= /=     Control default palette gamma/process levels
hl/~A /~A     Set catalog background style
hl/~B /~B     Set slideshow centering mode
hl/~E /~E     Disable slideshow mode change for similar modes
hl/~F /~F     Color reduction proximity elimination level
hl/~G /~G     Force optimized grayscale palettes
hl/~J /~J     Print in color
hl/~L /~L     Set dynamic file list cache size
hl/~M /~M     Set JPEG quality level
hl/~O /~O     Set file sort mode
hl/~R /~R     Assume aspect ratio of all catalog files to 1:1
hl/~T /~T     Catalog output format control
hl/~Z /~Z     Catalog output path control
hl/<vid>/<vid>    Force Video Hardware Type
hl@<file> @<file> Read file list from file


:::hlRev
Revision History

GDS is updated constantly in response to the changing environment of the
computer industry.  Photodex intends to inform existing users of significant
upgrades to GDS as an ongoing process.

This revision history is not intended to be extremely complete, but should
indicate some of the major advances in the GDS functionality.  This list
starts with the most recent revisions and continues backward in time.

Items marked with '■' are additions, improvements or changes which are
better or comparable to previous versions.  Items marked with 'X' are known
bugs in the listed version which may have been corrected in later versions.

GDS 3.1c - minor release
------------------------
NEW!  ■ ANSI text file support.  ANSI files are emulated as if they were
    graphics files, except for normal viewing, which is done in the
    current text mode.  When GDS does slideshows or catalogs, ANSI files
    are rendered into character mapped graphics files on the fly.  You
    can view a character mapped graphics rendition of an ANSI file by
    locking the resolution to a graphics mode and double clicking on the
    ANSI file in the file list.  Writing to ANSI files is a feature of
    GDS Professional and is not available in standard versions of GDS.
    Contact Photodex for more information.

NEW!  ■ GRASP and .FLI file support -- without previous memory limitations.
    GDS now flushes itself out to EMS, XMS and/or disk when playing .GL
    and .FLI files.  Make sure to put GRASPRT.EXE and QUICKFLI.EXE in the
    GDS directory and GDS will automatically view .GL and .FLI files with
    a double click.

NEW!  ■ Integrated hypertext help system -- you are looking at it.

NEW!  ■ Introduced complete on-line manual.  This first release has 74 pages
    with 199 separate sub-sections.

NEW!  ■ Automatically detects and supports Diamond Stealth 64 in all video
    resolutions.  Added hlCmdVH/ST64 to the available command line parameters,
    but since the Stealth 64 should remain very detectable, using hlCmdVh/ST64
    should never be necessary.

NEW!  ■ Configuration greatly improved.  The configuration process has been
    changed significantly, and should be capable of detecting modes which
    earlier versions of the configuration would have automatically
    rejected.  The operation of the configuration process is the same,
    except that GDS may support quite a few new video modes.

NEW!  ■ "DOS Shell" function added to registered version.  GDS swaps out of
    memory during DOS shell functions, using only a 7K for itself.  This
    enables you to do just about anything from within GDS.

      ■ Configuration file tag changed.  This will cause a reconfiguration on
    all systems, regardless of the state of the video hardware.  The
    reason for this is the improved video mode support and instant video
    memory test in this version.

      ■ Corrected problem deleting batches of files in registered version.

      ■ Corrected problem writing 16 color TIFF files.

      ■ Cirrus Logic: Added non-VESA video modes back into GDS.  This allows
    GDS to support non-VESA Cirrus Logic video BIOS's, even if the VESA
    support does not work reliably.

      X Fixed DOS error when logging to drive with unreadable disk.

      X Fixed memory leak when converting files requiring color reduction.

GDS 3.1b - minor release
------------------------
NEW!  ■ XMS support added for virtual files.  Virtual file operations are now
    almost as fast as direct screen functions, but can be done in any
    output resolution, regardless of the available video hardware.

NEW!  ■ 3-D style catalog screens possible.  Note that this changes the
    definition of the hl/~A/~A command line parameter.

      ■ Corrected problem reading certain grayscale JPEG files.

      ■ Corrected problem reading certain sized 24 bit images when reducing
    size.  This fix enables GDS to read files which are up to 3072 pixels
    wide, which is the same as horizontal PhotoCD resolution images.

      ■ Introduced undocumented "Quote-O-Matic" into view mode.

      ■ Removed REGISTER.PRN from GDS in order to keep the size of GDS
    distribution files down.  REGISTER.PRN was an HP LaserJet version of
    the registration form.

      ■ Added FILE_ID.DIZ and READ.ME to GDS distribution files.  FILE_ID.DIZ
    is used by many BBS systems to automatically describe ZIP files.

      X Some problems with XMS virtual file caching have been corrected in
    v3.1c.  Some file conversions could cause GDS to hang the machine, or
    cause color artifacts during color reduction.

      X Photodex has received reports of intermittent color artifacts when
    converting large batches of JPEG files into GIF format using the
    normal interface.  This may have been corrected with the XMS virtual
    file bug fix.  Please bring any color artifacting you experience
    to our attention.

GDS 3.1a - minor release
------------------------
      ■ Fixed problem with JPEG file list handling.  All JPEG files should

      ■ Configuration now allows swapping of the red and blue color bars for
    24 bit video modes.  When modes are displayed during configuration,
    the message "[S]wap Red & Blue" is displayed, with a red background
    behind the word "Red" and a blue background behind the word "Blue",
    so the user can tell if red and blue need to be swapped.

      ■ Added skew modification to configuration so video modes which have
    non-standard screen widths can be manually corrected.  If a video
    mode is radically skewed but displayed without flicker, then use the
    left and right arrow keys to try adjusting the skew.

      X Problems reading certain grayscale JPEG files corrected in v3.1b.

GDS 3.1  - significant release
------------------------------
NEW!  ■ GDS now reads and writes JPEG files.  Registered versions support a
    command line parameter to adjust the compression level for writing
    JPEG files.

      X Problem deleting batches of files correct in v3.1c.

GDS 3.0  - MAJOR RELEASE
------------------------
NEW!  ■ Radically improved user interface.  GDS just got simpler and easier
    to use.

NEW!  ■ New "View Mode Pull-down Menus" allow switching resolutions without
    exiting to the file list.

NEW!  ■ On-line help menu and registration form printout.

NEW!  ■ GDS is now distributed by Photodex.  Photodex is owned by the author
    of GDS, and has assumed control of all distribution of GDS.  Please
    direct your inquiries regarding GDS to:

        Photodex            [phone] - Voice
        1781 Barcelona Street        [phone] - FAX
        Livermore, CA  94550       [e-mail] - internet

      ■ Cirrus Logic 54xx chipset video hardware now detected and supported.

      X Problems writing 16 color TIFF files corrected in v3.1c.

      X Problems reading large 24 bit images and size reducing corrected in
    v3.1b.

*NOTE:    Versions earlier than listed here are not officially tracked by this
    revision history.  If you have a version of GDS earlier than 3.0,
    then it is safe to assume that the product has changed so much that
    it might as well be a different product.


:::hlGlossary
Glossary

"antialiasing"
    The process of smoothing color values together when an image is
    resized.  Most graphics viewers do not bother antialiasing images
    because the code is much easier to write.

"bit"
    The smallest element of logic, which is either a 1 or a 0.  Bits are
    combined together to represent larger numbers, like bytes.

"bork"
    A bork (or borking) is when you say something that you weren't
    supposed to say while logged into an on-line chat system.
    For Example: "I borked."

"byte"
    A set of eight bits which can represent 256 different values.  If used
    to represent a number which starts at 0 and cannot be less than zero
    (unsigned), a byte can represent a value from 0 to 255.  If signed, a
    byte represents a value from -128 to 127.  Characters can be thought
    of as bytes since each character takes one byte to store without
    specialized compression.

"chipset"
    A set of microchips integrated into a piece of computer hardware
    which is used to accomplish some standardized task.  Video chipsets
    are integrated into common video cards in order to generate the video
    signals required to drive a monitor.  Video card manufacturers rarely
    design their own chipsets anymore, but instead design their video
    cards around generalized chipsets available from companies like
    Cirrus Logic, Oak Technologies, S3, Tseng Laboratories and Weitek.
    Most of the video detection in GDS is specific to chipset detection
    rather than video card detection, since the chipset is usually the
    same across many video cards.

"color reduction"
    The process of reducing the number of colors used to display a digital
    image.  The term "color reduction" is usually used to describe the
    process used to convert images from 15, 16 or 24 bits per pixel to
    eight or fewer bits per pixel.  This is usually done because most
    color computer systems have either 16 or 256 color displays, which
    provide 4 and 8 bits per pixel, respectively.  GDS uses Photodex's
    proprietary color reduction technology (developed for the professional
    photography industry), and produces the best color reduction
    available.  If you have doubts, please benchmark GDS color reduction
    against other software and prepare to be surprised.

"diffusion dither"
    See "Floyd/Steinberg dither" below.

"Floyd/Steinberg dither"
    A method of dithering (developed by Floyd and Steinberg) which
    approximates midtones over areas of pixels by choosing colors which
    equal the sum total of the immediate area's color value.  This
    specific type of dither is used in GDS because it is extremely fast.
    This dithering method is sometimes referred to as a "diffusion
    dither", although the term "stochastic dither" is more precise.

"GDS"
    This program; acronym for "Graphics Display System."

"pel"
    See "pixel".

"pixel"
    Dot in a digital image.  The term comes from graphics experts
    abbreviating the term "picture cell" into this shorter slang term.
    Also- "pel".

"stochastic dither"
    See "Floyd/Steinberg dither" above.

"thumbnail"
    A small rendition of a larger graphics image.  GDS creates catalogs
    by creating arrays of thumbnails which are labeled with the filename
    and resolution of the original graphics image file.

"TIGA"
    A library standard which provides access Texas Instruments 32000 and
    34000 series graphics co-processors.  TIGA is nearly extinct since
    the recent release of many of the modern video co-processors.

"virtual file"
    A pool of memory or disk storage used to hold a large amount of
    temporary information.  In GDS, virtual files are used to create
    "virtual screens," which allow GDS to operate on graphics data even
    if the data cannot be displayed.  For example, virtual files make it
    possible for a monochrome machine with no graphics capabilities to
    perform image file conversions from the command line.

"virtual screen"
    A virtual file (see above) which contains data which is thought of
    as a screen because the data is in the same format as it would appear
    in memory on a video adapter.

"VRAM"
    Video RAM.  VRAM is specialized video RAM which can provide a very
    fast stream of data to the video output generator and still be used
    at the same time as if it were normal RAM.  This allows the computer
    to read and write from the video memory while the graphics image is
    being output to the monitor with very little performance loss.


:::hlTrialVer
GDS Trial Version

The Trial Version of GDS is Shareware.  It is not free software.  It is
intended to be used for a trial period of up to 21 days.  This allows users
to test software for a reasonable time and pay only for what they use.

The GDS Trial Version may only be distributed in its original form, and at
no charge for the GDS software itself.  Modifying any of the program files
without permission from Photodex voids any right to redistribute copies.  The
Registered Version of GDS may not be redistributed without a written
distribution agreement with hlPhotodexPhotodex.

If you have been using the Trial Version for an extended period of time,
please register your copy today.

Related Topics
    hlDiffDifferences in GDS Versions
    hlOrderOrdering GDS
    hlOFrmGDS Order Form
    hlLegalCopyright and Legal Info.


:::hlDiff
Differences in GDS Versions

All versions of GDS do most functions that GDS users find valuable.  It is
somewhat unfair to consider GDS "cripple-ware" if you consider that what it
does do is more than most graphics viewers and converters do in the complete
versions.

The following table illustrates the significant differences between versions
of GDS as of this release:

    GDS Trial Version        hlOrderGDS ($39.95)
    -----------------        -----------------
    Limited to 25 files        2,848 files
                    Supports Printing
                    Supports Batch Operations
                    Saves Color Reduced Files
                    Converts to JPEG Format
                    JPEG Compression Control
                    Provides DOS Shelling
                    Command Line Format Conversion

In addition, GDS Professional also provides hlScanMenuscanning, conversion of
any graphics file format into ANSI color text files, and some very powerful
command line parameters for batch functions including automatic logo and text
insertion into catalogs.

Related Topics
    hlOrderOrdering GDS
    hlOFrmGDS Order Form
    hlLegalCopyright and Legal Info.
    hlTrialVerGDS Trial Version


:::hlMenus
Menu Options

hlFileMenuFile   hlViewMenuView   hlDisplayMenuDisplay   hlConvMenuConvert   hlScanMenuScan:Color   hlSetupMenuSetup   hlHelpMenuHelp

    Click on the menu you would like help with, or choose from the
    following list:

        hlFileMenuFile Menu
        hlViewMenuView Menu
        hlDisplayMenuDisplay Menu
        hlConvMenuConvert Menu
        hlScanMenuScan Menu (GDS Pro. Only)
        hlSetupMenuSetup Menu
        hlHelpMenuHelp Menu

        hlResMenuResolution Menu
        hlAutoLockMenuAuto/Lock Toggle Button
        hlPaletteMenuPalette Menu
        hlMouseMenuMouse Bits/Boxy Toggle Button
        hlViewMenuSlideshowQuick Slideshow Button


                            hlViewMenuSlideshow+-----Click Here----+
                            hlViewMenuSlideshow+---For Slideshow!--+
hlResMenuRes:####x###x###   hlAutoLockMenuAuto Selection   hlPaletteMenuPalette   hlMouseMenuMouse:Bits
:::hlFileMenu
File Menu

The following options are available in the File List File Menu:

    hlFileMenuCopyCopy File(s) to...    Ctrl-C
    hlFileMenuMoveMove File(s) to...    Ctrl-T
    hlFileMenuRenameRename File(s)...    Ctrl-R
    hlFileMenuHideHide File(s)        Ctrl-H
    hlFileMenuDeleteDelete File(s)        Ctrl-D
    ------------------------------
    hlFileMenuSubdirsSearch All Subdirs
    hlFileMenuJumpJump to Path...        Ctrl-F
    ------------------------------
    hlFileMenuPrintPrint Portrait
    hlFileMenuPrintPrint Landscape
    ------------------------------
    hlFileMenuShellDOS Shell        Alt-J or Z
    ------------------------------
    hlFileMenuExitExit GDS           Esc


:::hlFileMenuCopy
File Menu: Copy Files

This menu item will copy a file or group of files to a different directory
while leaving the original files intact. hlHowToSelectSelect a file or group of files
from the File List and select Copy Files (or hit [Ctrl-C]) to start the
process. GDS will open a dialog box where the destination path for the
file(s) must be typed in.


:::hlFileMenuMove
File Menu: Move Files

This menu item will move a file or group of files to a different directory
and delete the original files. hlHowToSelectSelect a file or group of files from the File
List and select Move Files (or type [Ctrl-M]) to start the process. GDS will
open a dialog box where the destination path for the file(s) must be typed.


:::hlFileMenuRename
File Menu: Rename Files

This menu item will allow the name of a file to be changed. hlHowToSelectSelect a file
then select Rename Files (or type [Ctrl-R]) to start the process. GDS will
open a dialog box where the new filename must be entered.


:::hlFileMenuHide
File Menu: Hide Files

This menu item will remove a file or group of files from the File List
without deleting them. hlHowToSelectSelect a file or group of files from the File
List and select Hide Files (or type [Ctrl-H]) to hide the files. The hidden
files will not appear in the File List while working in the directory.


:::hlFileMenuDelete
File Menu: Delete Files

This menu item will delete a file or group of files from your drive or disk.
hlHowToSelectSelect a file or group of files from the File List and select Delete Files
(or type [Ctrl-D]) to start the process. GDS will open a dialog box for
confirmation of the Delete process.  Type "Y" to delete the file or "N" to
cancel the process.  NOTE: If you are deleting a batch of files and you are
absolutely sure you want them gone you can hold down the "Y" key to speed the
process.


:::hlFileMenuSubdirs
File Menu: Search Subdirectories

This menu item will start a search for graphics files in all subdirectories
of the current directory.  All valid files will be added to the File List.
By selecting this command you can scan an entire hard drive (make sure you
are in the root directory) or CD-ROM disc. You can easily catalog an entire
CD-ROM by using this command in conjunction with View Menu: Create Catalog.


:::hlFileMenuJump
File Menu: Jump to Path

Selecting Jump to Path from the File menu will open a window allowing any
number of paths to be entered. Wildcard characters (*) can be used in the
filenames but not the paths. Multiple paths can be entered but must be
separated by spaces.

This command can be particularly useful for CD-ROM catalogs, for limiting
file types displayed in the File List, or for adding files from another
directory to the File List.


:::hlFileMenuPrint
File Menu: Print Portrait or Landscape

These menu options will print the currently hlHowToSelectselected file in either portrait
(10" tall) or landscape (10" wide) mode on HP LaserJets, DeskJets and 100%
compatible PCL printer language printers.  Additionally, GDS will print in
color on the DeskJet 500C, 550C, 560C, and 1200C.  The correct port must be
selected in the Setup Menu: Printer On... section.


:::hlFileMenuShell
File Menu: DOS Shell

This menu will exit to a DOS shell while leaving GDS in its current state.
[Alt-Z] and [Alt-J] will also exit to a DOS Shell. To return to GDS from
the DOS Shell type "exit".


:::hlFileMenuExit
File Menu: Exit GDS

Exits the fantastic world of GDS and leaves you wanting more!


:::hlViewMenu
View Menu

The following options are available in the File List View Menu:

    hlViewMenuSlideshowView Slideshow
    hlViewMenuCatalogCreate Catalog
    -------------------------
    hlViewMenuDitheringNo Dithering
    hlViewMenuDithering:2 Dithering
    hlViewMenuDithering:4 Dithering
    -------------------------
    hlViewMenuAntialiasAntialiasing Enabled
    hlViewMenuBeepBeep For View Complete
    hlViewMenuCommentAuto Show Comment Records
    hlViewMenuCatalogStyleBlack Catalogs
    hlViewMenuCatalogStyleWhite Catalogs
    hlViewMenuCatalogStyleGray/3D Catalogs
    hlViewMenuCenterSlideshowCenter Slideshow Images


:::hlViewMenuSlideshow
View Slideshow

This menu option starts a slideshow of the hlHowToSelectselected files.  If no files
are selected, a slideshow of all files in the file list is played.  You can
also start a slideshow by clicking in the rectangle at the lower left of the
main GDS file list screen labeled "Click here for SlideShow!"

Related Topics
    hlHowToSlideshowHow to Play a Slideshow
    hlHowToCLSlideshowSlideshows from the Command Line

Related Parameters
    hl/S/S    Play Slideshow
    hl/Z/Z    Set default delay between slides
    hl/E/E    Fit images to screen


:::hlViewMenuCatalog
Create Catalog

Selecting this menu option begins the catalog creation process for all
hlHowToSelectselected files.  If no files are selected, then all files in the file list
appear in the catalog.

Related Topics
    hlHowToCatalogHow to Create Catalogs
    hlHowToCLCatalogCatalogs from the Command Line
    hlBBSCataloging a BBS

:::hlViewMenuDithering
Dithering Method

This set of menu items sets the level of dithering when the number of colors
is reduced.  The default is 1:4 Dithering - the best available.  There may be
circumstances when a different level of dithering is preferred.

To change GDS's default dithering method, add hl/D/D<n> to hlConfFileGDSUSER.CFG.

Related Parameters
    hl/D/D    Change default dithering


:::hlViewMenuAntialias
Antialiasing

This menu item will toggle the antialiasing function on or off when
displaying images.  The default setting is on. NOTE: Horizontal-Only
antialiasing is available by using the hl/A/A option, but is not available using
menus from within GDS.

To change GDS's default antialiasing method, add hl/A/A<n> to hlConfFileGDSUSER.CFG.

Related Parameters
    hl/A/A    Change default antialiasing method


:::hlViewMenuBeep
Beep for View Complete

This menu item will toggle the beep on or off when GDS finishes displaying an
image on the screen.  The default setting is on.

To change GDS's default beep setting, add hl/!/!<n> to hlConfFileGDSUSER.CFG.

Related Parameters
    hl/!/!    Change default beep setting


:::hlViewMenuComment
CompuServe GIF89a Comments

This menu item will toggle automatic display of GIF89a Comments on or off.
The default state is on (hl/K/K1).

To change GDS's default "comment show" state, add hl/K/K<n> to hlConfFileGDSUSER.CFG.

Related Parameters
    hl/K/K    Change default "comment show" state


:::hlViewMenuCatalogStyle
Catalog Background/Style

These menu items will set the style of GDS catalogs.  Black and gray catalogs
tend to look better on video monitors, while white catalogs are preferable for
printed output because they use less toner (or ink).  The default style is
white backgrounds (hl/~A/~A1).

To change GDS's default catalog style, hl/~A/~A<n> to
hlConfFileGDSUSER.CFG.

Related Parameters
    hl/~A/~A    Change catalog style
    hl/U/U    Turn catalog image borders on and off
    hl/L/L    Turn catalog image labels on and off


:::hlViewMenuCenterSlideshow
Center Slideshow Images

This menu item will toggle centering of slideshow images on or off. When on,
GDS will center each slideshow image on the screen. When off GDS will place
upper left corner of the image in the upper left corner of the screen.

To change GDS's default slideshow centering mode, add hl/~B/~B<n> to
hlConfFileGDSUSER.CFG.

Related Parameters
    hl/~B/~B    Turn slideshow centering on and off


:::hlDisplayMenu
Display Menu

The following options are available in the File List Display Menu:

    hlDisplayMenuShowShow Extensions
    hlDisplayMenuShowShow Resolution
    hlDisplayMenuShowShow Pixel Bit Depth
    hlDisplayMenuShowShow File Size
    --------------------
    hlDisplayMenuSortSort: Name, Extn
    hlDisplayMenuSortSort: Size, Resl
    hlDisplayMenuSortSort: Bits, Resl
    hlDisplayMenuSortSort: Resl, Name
    hlDisplayMenuSortSort: Extn, Name

This menu allows you to change the appearance of the File List by toggling
file information on or off and sorting files in a variety of orders.


:::hlDisplayMenuShow
Display Menu: Show Options

These menu items control which information GDS displays for each file in the
File List. The information is displayed in the following order:

        PICTURE .GIF  640x480x256 250k

         (1)     (2)  (3) (4) (5) (6)


        (1) Filename
        (2) Three-character extension denoting file format
        (3) Width of file (in hlGlossarypixels)
        (4) Height of file (in pixels)
        (5) Number of colors in file (32k = 32,768)
                         (65k = 65,536)
                         (16M = 16.7 million)
        (6) File size

The default setting shows the extension and the file size. To change the
GDS's defaults, add hl/F/F... to hlConfFileGDSUSER.CFG.

Related Parameters
    hl/F/F    Default file display options


:::hlDisplayMenuSort
Display Menu: Sort Order Options

The display menu has five "Sort" options, each of which controls how files
are sorted in the GDS file list.  By default, GDS sorts filenames first by
the name of the file, and then the file extension.  You can change this sort
order at any time by selecting one of the "Sort: ..." options in the
"Display" menu (or by using the hl/~O/~O command line parameter.)

   Sort: Name, Extn
    Sort by the name of the file, and then the extension.  This is the
    default sort order of GDS.

 * Sort: Size, Resl
    Sort by the size of the file, and then the resolution of the file if
    two or more files have the same size.

 * Sort: Bits, Resl
    Sort by the number of bits per pixel, and then by the resolution of
    each file, followed by the file name and extension.

 * Sort: Resl, Name
    Sort by the resolution of each file (horizontal dimension first,
    followed by vertical), then by the name and extension of each file.

   Sort: Extn, Name
    Sort by the extension of the name first, then the name and size of
    each file.  This option is very useful when doing a lot of file
    conversions.

      * These options require GDS to have read the file headers from every
    file in the file list before the list can be properly sorted.
    Choosing any of these sort orders may cause a significant delay
    while GDS is reading through all of the graphics files.


:::hlConvMenu
Convert Menu

File conversions in GDS are most simply done using the Convert Menu.  This
menu allows you to select an output file format for one or more hlHowToSelectselected
files.

The options in the Convert Menu are as follows:

    hlConvBMP1BMP monochrome        hlConvLBM1LBM monochrome        hlConvTGA15TGA 32K colors
    hlConvBMP4BMP 16  colors        hlConvLBM4LBM 16  colors        hlConvTGA24TGA 16M colors
    hlConvBMP8BMP 256 colors        hlConvLBM8LBM 256 colors        hlConvTIF1TIF monochrome
    hlConvBMP24BMP 16M colors        hlConvPCX1PCX monochrome        hlConvTIF4TIF 16  colors
    hlConvGIF1GIF monochrome        hlConvPCX4PCX 16  colors        hlConvTIF8TIF 256 colors
    hlConvGIF4GIF 16  colors        hlConvPCX8PCX 256 colors        hlConvTIF24TIF 16M colors
    hlConvGIF8GIF 256 colors        hlConvRIX4RIX 16  colors        hlConvJPG24JPG 16M colors
                hlConvRIX8RIX 256 colors        hlConvANSIANSI 80x25 txt

If there is no currently selected file in the file list, GDS assumes that the
single file that the file cursor is highlighting is to be converted.  If there
are any files hlHowToSelectselected in the file list, GDS assumes that all hlHowToSelectselected files
should be converted as a batch.  (Note that only registered versions of GDS
support batch conversions.)

When files are converted, GDS tries to name the files with the same file name,
but with the new extension.  If the extension is the same as the original
file, or if a file with the same name exists, GDS will follow the same naming
procedure as for catalog files.  By default this will cause GDS to write files
called GDS000, GDS001, GDS002, and so on.

Also note that unregistered versions of GDS do not support conversions which
would result in a 24 bit to 8 bit color reduction, and do not support
conversion to JPEG formats.  Conversions to ANSI format supported in GDS
Professional only.  Contact Photodex for more information.

Related Parameters
    hl/@C/@C    Convert files from the command line


:::hlConvBMP1
Converting to Monochrome BMP

This process generates hlGlossaryFloyd/Steinberg dithered monochrome files with black
and white as the two colors.  GDS does not support conversion to monochrome
formats with other than black and white as the output colors.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to monochrome data.  BMP output data is not
compressed, and is written from bottom to top (standard BMP.)


:::hlConvBMP4
Converting to 16 Color BMP

This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
optimal palette is used, then the 16 colors chosen will be set to an optimal
16 color palette for the image.  If a fixed palette is used, then GDS uses a
standard Windows 16 color palette and dithers the source image.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 16 color data, unless it is possible to do a
direct conversion without modifying the color content at all.  BMP output data
is not compressed, and is written from bottom to top (standard BMP.)


:::hlConvBMP8
Converting to 256 Color BMP

This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
An optimal palette is used regardless of the Fixed/Optimal setting in the
conversion window, unless the conversion does not require hlGlossarycolor reduction.
In this case, the image is converted directly with no modification of color
content.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 256 color data, unless it is possible to do
a direct conversion without modifying the color content at all.  BMP output
data is not compressed, and is written from bottom to top (standard BMP.)


:::hlConvBMP24
Converting to 24 Bit Color BMP

This process generates a 24 bit image from any image.  Since 24 bit data has
a fixed palette, the Fixed/Optimal flag in the conversion window is ignored.

GDS normally reads input files into a 24 bit virtual buffer and then writes
it out without modifying the color content at all.  BMP output data is not
compressed, and is written from bottom to top (standard BMP.)  Note that 24
bit BMP files are very large because they are stored as raw 24 bit data.


:::hlConvGIF1
Converting to Monochrome GIF

This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
and white as the two colors.  GDS does not support conversion to monochrome
formats with other than black and white as the output colors.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to monochrome data.  GIF output data is
compressed and more efficient than most other monochrome image file formats.

GDS does not write comment records to GIF files.


:::hlConvGIF4
Converting to 16 Color GIF

This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
optimal palette is used, then the 16 colors chosen will be set to an optimal
16 color palette for the image.  If a fixed palette is used, then GDS
uses a standard EGA/VGA 16 color palette and dithers the source image.
Photodex has found that it is often better to convert to a standard EGA fixed
palette than to try to use an optimized palette, because 16 colors is
sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
well suited for conversion purposes.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 16 color data, unless it is possible to do a
direct conversion without modifying the color content at all.  GIF output data
is compressed and more efficient than most 16 color image file formats.

GDS does not write comment records to GIF files.


:::hlConvGIF8
Converting to 256 Color GIF

This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
An optimal palette is used regardless of the Fixed/Optimal setting in the
conversion window, unless the conversion does not require hlGlossarycolor reduction.
In this case, the image is converted directly with no modification of color
content.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 256 color data, unless it is possible to do
a direct conversion without modifying the color content at all.  GIF output
data is compressed and more efficient than most 256 color image file formats.

GDS does not write comment records to GIF files.


:::hlConvLBM1
Converting to Monochrome LBM/IFF

This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
and white as the two colors.  GDS does not support conversion to monochrome
formats with other than black and white as the output colors.

GDS also writes a Deluxe Paint II preview image into the LBM file, which looks
far better than Deluxe Paint II can produce.  When using Deluxe Paint to open
an LBM file written with GDS, you will notice this preview in the "Open"
dialog.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to monochrome data.  IFF output data is
compressed and more efficient than raw monochrome image file formats, but the
compression is not as good as GIF or other LZ compression formats.


:::hlConvLBM4
Converting to 16 Color LBM/IFF

This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
optimal palette is used, then the 16 colors chosen will be set to an optimal
16 color palette for the image.  If a fixed palette is used, then GDS
uses a standard EGA/VGA 16 color palette and dithers the source image.
Photodex has found that it is often better to convert to a standard EGA fixed
palette than to try to use an optimized palette, because 16 colors is
sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
well suited for conversion purposes.

GDS also writes a Deluxe Paint II preview image into the LBM file, which looks
far better than Deluxe Paint II can produce.  When using Deluxe Paint to open
an LBM file written with GDS, you will notice this preview in the "Open"
dialog.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 16 color data, unless it is possible to do a
direct conversion without modifying the color content at all.  IFF output data
is compressed and more efficient than raw 16 color image file formats, but the
compression is not as good as GIF or other LZ compression formats.


:::hlConvLBM8
Converting to 256 Color LBM

This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
An optimal palette is used regardless of the Fixed/Optimal setting in the
conversion window, unless the conversion does not require hlGlossarycolor reduction.
In this case, the image is converted directly with no modification of color
content.

GDS also writes a Deluxe Paint II preview image into the LBM file, which looks
far better than Deluxe Paint II can produce.  When using Deluxe Paint to open
an LBM file written with GDS, you will notice this preview in the "Open"
dialog.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 256 color data, unless it is possible to do
a direct conversion without modifying the color content at all.  IFF output
data is compressed and is supposed to be more efficient than raw 256 color
image file formats, but falls short because the IFF compression was designed
for monochrome and 16 color data.  256 color IFF files can sometimes be even
larger than the raw 256 color data.


:::hlConvPCX1
Converting to Monochrome PCX

This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
and white as the two colors.  GDS does not support conversion to monochrome
formats with other than black and white as the output colors.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to monochrome data.  PCX output data is
compressed and sometimes more efficient than raw monochrome image file
formats, but the compression is not as good as GIF or other LZ compression
formats.


:::hlConvPCX4
Converting to 16 Color PCX

This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
optimal palette is used, then the 16 colors chosen will be set to an optimal
16 color palette for the image.  If a fixed palette is used, then GDS
uses a standard EGA/VGA 16 color palette and dithers the source image.
Photodex has found that it is often better to convert to a standard EGA fixed
palette than to try to use an optimized palette, because 16 colors is
sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
well suited for conversion purposes.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 16 color data, unless it is possible to do a
direct conversion without modifying the color content at all.  PCX output data
is compressed and sometimes more efficient than raw 16 color image file
formats, but the compression is not as good as GIF or other LZ compression
formats.


:::hlConvPCX8
Converting to 256 Color PCX

This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
An optimal palette is used regardless of the Fixed/Optimal setting in the
conversion window, unless the conversion does not require hlGlossarycolor reduction.
In this case, the image is converted directly with no modification of color
content.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 256 color data, unless it is possible to do
a direct conversion without modifying the color content at all.  256 color
PCX output data uses an RLE compression method which usually falls apart with
256 color files because of dithering.  The only time that 256 color PCX data
will be smaller than raw image file data is when there are runs of solid
colors in the 256 color image.


:::hlConvRIX4
Converting to 16 Color ColorRIX

This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
optimal palette is used, then the 16 colors chosen will be set to an optimal
16 color palette for the image.  If a fixed palette is used, then GDS
uses a standard EGA/VGA 16 color palette and dithers the source image.
Photodex has found that it is often better to convert to a standard EGA fixed
palette than to try to use an optimized palette, because 16 colors is
sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
well suited for conversion purposes.

ColorRIX files use no compression.

ColorRIX files use the file extension to denote the resolution of the file.
This is a huge problem if the image size is not a standard EGA or VGA file
size.  Because of this problem, the ColorRIX file format is rarely used.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 16 color data, unless it is possible to do a
direct conversion without modifying the color content at all.

:::hlConvRIX8
Converting to 256 Color ColorRIX

This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
An optimal palette is used regardless of the Fixed/Optimal setting in the
conversion window, unless the conversion does not require hlGlossarycolor reduction.
In this case, the image is converted directly with no modification of color
content.

ColorRIX files use no compression.

ColorRIX files use the file extension to denote the resolution of the file.
This is a huge problem if the image size is not a standard EGA or VGA file
size.  Because of this problem, the ColorRIX file format is rarely used.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 256 color data, unless it is possible to do
a direct conversion without modifying the color content at all.
:::hlConvTGA15
Converting to 32K Color Targa

This process generates 32,768 color (15 bit) TGA files.  If the source input
image file is more than 15 bits (16 or 24 bit), then the image is hlGlossaryFloyd-
hlGlossarySteinberg dithered down to 15 bits, in order to simulate the 24 bit
data as accurately as possible.  The result is better 15 bit images than most
common software generates.

GDS normally reads input files into a 24 bit virtual buffer, which it then
converts into 15 bit data, unless it is possible to do a direct conversion
without modifying the color content at all.  TGA files are stored from bottom
to top.


:::hlConvTGA24
Converting to 24 Bit Color Targa

This process generates 16.7 color (24 bit) TGA files.  If the input data has
less than 24 bits of color information, the color information is padded out
to 24 bits.

GDS normally reads input files into a 24 bit virtual buffer and writes it
directly out in uncompressed form.  TGA files are stored from bottom to top.


:::hlConvTIF1
Converting to Monochrome TIFF

This process generates hlGlossaryFloyd-Steinberg dithered monochrome files with black
and white as the two colors.  GDS does not support conversion to monochrome
formats with other than black and white as the output colors.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to monochrome data.  TIF output data is
not compressed, but is compatible with most imaging software.  Compressed
formats (such as hlGIF1GIF are more space efficient).


:::hlConvTIF4
Converting to 16 Color TIF

This process generates hlGlossaryFloyd-Steinberg dithered 16 color files.  If an
optimal palette is used, then the 16 colors chosen will be set to an optimal
16 color palette for the image.  If a fixed palette is used, then GDS
uses a standard EGA/VGA 16 color palette and dithers the source image.
Photodex has found that it is often better to convert to a standard EGA fixed
palette than to try to use an optimized palette, because 16 colors is
sometimes not enough to get a "rich" looking image.  The EGA palette is fairly
well suited for conversion purposes.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 16 color data, unless it is possible to do a
direct conversion without modifying the color content at all.  TIF output data
is not compressed, but is compatible with most imaging software.  Compressed
formats (such as hlGIF4GIF are more space efficient).


:::hlConvTIF8
Converting to 256 Color TIF

This process generates hlGlossaryFloyd-Steinberg dithered 256 color (8 bit) files.
An optimal palette is used regardless of the Fixed/Optimal setting in the
conversion window, unless the conversion does not require hlGlossarycolor reduction.
In this case, the image is converted directly with no modification of color
content.

GDS normally reads input files into an 8 or 24 bit virtual buffer, which it
then analyzes and dithers down to 256 color data, unless it is possible to do
a direct conversion without modifying the color content at all.  TIF output
data is not compressed, but is compatible with most imaging software.
Compressed formats (such as hlGIF8GIF are more space efficient).


:::hlConvTIF24
Converting to 24 Bit TIFF

This process generates 16.7 color (24 bit) TIFF files.  If the input data has
less than 24 bits of color information, the color information is padded out
to 24 bits.  TIFF compression is not used in the output data stream.

GDS normally reads input files into a 24 bit virtual buffer and writes it
directly out in uncompressed form.


:::hlConvJPG24
Converting to 24 Bit JPEG/JFIF

*Note:    The trial version of GDS does not support conversion to JPEG format.

This process reads input data into a 24 bit virtual screen file and converts
it into a JPEG format output file confirming to the JFIF file format
specification.  Because JPEG is a lossy compression mechanism, the output
file will rarely be exactly the same as the input file, but the differences
are usually so small that they are very difficult to see.  You can adjust
the quality level (compression level) by using the hl/~M/~M<n> command line
parameter.hl/~M

JPEG compression is best suited for continuous tone (photographic) images,
and does not do a good job with computer generated images with sharp or high
contrast (artificial looking) edges.

JPEG is probably the best thing to happen with 16.7 million color images,
and should be looked at seriously by professionals in the computer industry
for most 24 bit imaging applications.

Special thanks go to the Independent JPEG group for their support of the
JPEG format through the widespread distribution of their sample source code
libraries.


:::hlConvANSI
Converting to ANSI 16 Color Text

*Note:    The trial version of GDS does not support conversion to ANSI format.
    Writing ANSI text files is supported by GDS Professional.  Contact
    hlPhotodexPhotodex for specific information about GDS Pro.

This process reads the input image into a virtual buffer and then analyzes it
to find the best way to represent the image using 79 characters wide and as
many characters tall as necessary to represent the image.  This process is
complex and generates a better ANSI image than any other software we have yet
seen or heard of.

It is impossible to represent a photographic image very well using ANSI
because of the huge limitations on color and character cell size.  However,
GDS has become an important tool to create color ANSI files for BBS system
operators because it is one of the only programs which offers ANSI export
capability.
:::hlScanMenu
Scan Menu

The Scan Menu is only available in the Professional version of GDS (GDS
Pro.)  GDS Pro. supports the following scanners:

    Epson ES-300C Color Scanner
    Epson ES-600C Color Scanner
    Microtek MSF-300G
    Microtek MSF-300Z
    Microtek MSF-600G
    Microtek MSF-600Z
    Microtek Scanmaker 1850
    Jovian VIA 320x200 Video Capture Board
    Jovian SVIA 640x480 Video Capture Board

If you have one of these devices and are interested in GDS Pro please contact
Photodex directly at [phone] for more information.


:::hlSetupMenu
Setup Menu

The Setup Menu allows you to make minor modifications in your video setup,
allows you to get the status of GDS, allows you to setup your printer, and
allows you to alter the default text color scheme.

    hlSetupMenuConfConfigure Video Modes
    ------------------------
    hlSetupMenuSystemSystem Info    [Ctrl-S]
    ------------------------
    hlSetupMenuPrintColorPrint In Color
    hlSetupMenuPrintPortPrinter On PRN
    hlSetupMenuPrintPortPrinter On LPT1
    hlSetupMenuPrintPortPrinter On LPT2
    hlSetupMenuPrintPortPrinter On LPT3
    ------------------------
    hlSetupMenuTextText Colors    [Ctrl-P]


:::hlSetupMenuConf
Setup Menu: Reconfiguring Video Modes

Selecting this menu item will run the automatic configuration for video modes
that have previously been configured. It allows the removal of modes on the
system, changing the skew, and flipping RGB order for 24 bit color modes.  It
will not allow the addition of new video modes, but will allow the omission
of modes which are not working correctly.

If a system is improperly configured with less modes than available the only
way to regain them is to delete the file called CONFIG (with no extension)
and restart GDS with the proper parameters. This will recreate the CONFIG
file from scratch.
:::hlSetupMenuSystem
Setup Menu: System Information

Selecting this menu item or pressing [Ctrl-S] will open a window showing
detailed information about GDS, the hardware, and the current state of the
system.  If you talk to a Photodex support person, they may ask you to do
this in order to diagnose any problems.

Near the top of the display is a block of information containing the version
number of this copy of GDS, the name and telephone number (registration
number) of the registered user and the date of registration.

Below that is a listing of the total and available space on the current
drive.  GDS will always list the space available on the drive where GDS is
currently logged. Selecting a valid drive (even if no graphics files are
available) will display the space on the drive.

Below the Drive Space is a block showing a number of paths used by GDS.

Below the path lists is a block showing the current amount of memory GDS has
to work with. Some GDS functions will reduce the amount of memory available.
If the amount of DOS System RAM and High DOS RAM start getting low it may be
a good idea to exit the program and restart it to free up memory.

Near the bottom of the window GDS lists the current Printer Port, the default
slideshow image display time and a code for the type of video hardware
detected by GDS.


:::hlSetupMenuPrintColor
Print in Color

This menu item controls whether or not GDS will attempt to print in color.
GDS supports color printing on the HP 500C, 550C, 560C, and 1200C. The
default setting is off.

To change GDS's default color printing setup, add hl/~J/~J<n> to hlConfFileGDSUSER.CFG.

Related Parameters
    hl/~J/~J    Set color or grayscale printing
    hl/#/#    Configure printer's port


:::hlSetupMenuPrintPort
Print to Port

This set of menu items controls which port GDS sends printing information to.
Select the port specific to your system. If GDS gives an error message when
printing is attempted the wrong port may be specified. The default printer
port is PRN.

To change the default printer port, add the hl/#/# parameter to hlConfFileGDSUSER.CFG.

Related Parameters
    hl/~J/~J    Set color or grayscale printing
    hl/#/#    Configure printer's port


:::hlSetupMenuText
Text Colors

Selecting this item from the Setup Menu or hitting [Ctrl-P] opens a window
that allows modification of the colors used on text screens (mainly the File
List.)  A number of presets are available or the colors can be individually
modified.  Use the left and right arrow keys to select a color and the
[F1]-[F6] keys to adjust the RGB value for that color. You can save your
custom palette as the default by hitting S.


:::hlHelpMenu
Help Menu

The help menu gives you the ability to find out more about GDS.  GDS does so
much that the help system has become an invaluable part of GDS.


:::hlResMenu
Resolution Menu

This menu will display a complete list of text and graphics modes available
to GDS. The default resolution is listed on the bottom menu bar. Select the
desired resolution and it will replace the default in the bottom menu bar.

The default resolution is the resolution in which GDS catalogs are created.

*Note:  You can force GDS to use a specific video mode by setting the
    Auto/Lock Toggle Button into the "Lock" state.  When in this state,
    GDS will ONLY use the mode listed in the Resolution Menu.

Text modes can also be changed from the Resolution Menu, but cannot be locked
using the Auto/Lock Toggle Button.  The available text modes are listed after
all available graphics modes in the Resolution Menu.

To change GDS's startup default graphics mode, you can add the hl/G/G option
to hlConfFileGDSUSER.CFG.

Related Parameters
    hl/G/G    Set default graphics mode
    hl/R/R    Set default Auto/Lock state


:::hlAutoLockMenu
Auto/Lock Toggle Button

This toggle button displays Auto or Lock. In auto mode GDS will attempt
to choose a display mode that best represents the specific image to be
displayed. In some cases it is desirable to display only in a specific mode.
Toggling the Auto/Lock button will force GDS to use the graphics mode
currently selected from the Resolution Menu. The default setting of the
Auto/Lock button is Auto.

To change the default setting of the Auto/Lock toggle button, add hl/R/R<n>
to hlConfFileGDSUSER.CFG.

Related Parameters
    hl/G/G    Set default graphics mode
    hl/R/R    Set default Auto/Lock state


:::hlMouseMenu
Mouse Cursor Style

Toggling the Mouse Bits/Boxy toggle changes the style of the mouse cursor from
a bitmapped arrow shape (Bits) to a square (Boxy) style.  Some video cards do
not support the programmable VGA character set properly, and some distortion
may appear around the mouse.  You can use this toggle to change the mouse
cursor into a solid character box.

Related Parameters
    hl/B/B    Set default mouse cursor mode


:::hlPaletteMenu
Palette Menu

If you are not familiar with image processing techniques, this menu is
probably better left alone.  It's functions are very powerful, but can lead
to a lot of confusion if you have misunderstandings about each function.

If you are a developer, you may find GDS to be one of the most powerful tools
you use.

The Palette Menu name always shows the number of colors to be used in optimal
palettes (usually 256).  You can change this number by hlLimitPallimiting the palette.

The Palette Menu is divided into three sections.  Each section serves a unique
purpose.  These sections are as follows:

    hlLimitPalLimiting Optimal Palette Colors
    hlFetchPalGenerating/Fetching Palettes from Image Files
    hlLockPalLocking/Unlocking the Palette

Most GDS customers use GDS to view collections of image files and will never
have a need for these palette functions.  If you are a BBS sysop, or a
software developer of image related software (who isn't these days!) and you
have a specific need for these functions, GDS can be very useful.

If you have other needs related to GDS's abilities, please contact Photodex.
Our optimized palette generation software has been used in many commercial
applications through special arrangements.


:::hlLimitPal
Limiting Optimal Palette Colors

GDS can display just about any picture on any video display.  It does this
through internal palette locking and high speed color translation.  For
example, if GDS needs to display a 256 color image on a 16 color display,
it generates a 16 color palette, locks the palette internally, creates the
necessary tables and then converts the 256 colors into the available 16
colors on the fly.

Occasionally, it is necessary to leave space in a palette for palette entries
which will change or need to be set to specific colors.  You can do this by
choosing the number of colors in the top of the Palette Menu, or by using the
hl/M/M Command Line Parameter.

When one of these top menu items is selected, GDS will limit it's optimal
palette generation to only the number of specified colors, and leave the
remaining entries black.  All colors are moved to the top of the palette, in
other words, they are moved toward the last color in the palette.

There are other undocumented palette functions (like /~S, /~P, /~4) which can
help your application.  Photodex does not normally document these command
line parameters because they are extremely complex.  If you want to know
how they work, you will need to establish a working arrangement with
Photodex.  Contact Photodex at [phone] for more information.

Related Topics
    hlFetchPalGenerating/Fetching Image File Palettes
    hlLockPalLocking/Unlocking the Palette


:::hlFetchPal
Generating/Fetching Image File Palettes

GDS can create an optimal palette from an arbitrary batch of files.  You can
do this by selecting one or more files and choosing "Lock Selected/Unlock"
from the Palette Menu.

Note that the "Lock Selected/Unlock" option has two purposes.  If the palette
is not locked, then a palette is created using the selected files.  If the
palette is locked to something (either through optimal palette generation or
choosing one of the prefabricated palette options), then GDS simply unlocks
the palette.

Once the palette is locked, then GDS will display all pictures using that
locked palette unless a video mode with more than 8 bits per pixel is used.
GDS normally chooses the best video mode to display pictures in, and may
choose a 15, 16 or 24 bit video mode, in which case, the locked palette will
not be used.  You can avoid this by using the hlAutoLockMenuAuto/Lock Resolution Toggle
hlAutoLockMenuButton.

All viewing, hlHowToSlideshowslideshowing, hlHowToCatalogcataloging and hlHowToConvertconversion is subjected to locked
palettes.  You can use this palette before a hlHowToConvertbatch conversion, for example.

It is a good idea to remember to unlock a palette (using the "Lock
Selected/Unlock" option) after you're done with your task.  Things can become
very confusing when using locked palettes, because it may not be apparent
that the palette is locked when working with GDS on other things.

The state of the palette is temporary during each session of GDS, so it is
not necessary to unlock the palette before you exit.  The next time you run
GDS, the palette will not be locked.

Related Parameters
    hl/M/M    Set Optimal Palette Colors


:::hlLockPal
Locking/Unlocking the Palette

Note: For information about locking the internal GDS palette to an image file,
see hlFetchPalGenerating/Fetching Image File Palettes.

GDS has several built-in palettes which can be convenient.  These palettes
are displayed in the lower part of the Palette Menu:

    Lock to 5 color RGB    (b&w + red, green, blue)
    Lock to 8 RGB        (b&w + red, green, blue, cyan, magenta, yellow)
    Lock to 16 EGA
    Lock to 16 Windows
    Lock to 16 RGB
    Lock to 256 RGB
    Lock to CMYK Print    (approximation of CMYK paper output)

When you choose one of these palettes, GDS locks the internal palette to the
colors in the prefabricated palette.  This means that GDS will only use the
colors in the locked palette to display pictures (unless the video mode used
is 15, 16 or 24 bit).

All viewing, hlHowToSlideshowslideshowing, hlHowToCatalogcataloging and hlHowToConvertconversion is subjected to locked
palettes.  You can use this palette before a hlHowToConvertbatch conversion, for example.

To unlock the palette, select "Lock Selected/Unlock" option in the Palette
menu.  Note that this option has two purposes; see hlFetchPalGenerating/Fetching Image
hlFetchPalFile Palettes for more information.


:::hlHowToView
How To View Images

GDS has one of the fastest viewing interfaces for image files available.
Simply double click on a filename with a mouse or press [Enter] with the file
selected, and GDS displays the file.  To exit the view mode, press [Esc] or
click the mouse button.

*Note:    GDS has been tuned to be interruptable in most places.  For example,
    if the [Esc] key is typed even while an image is being displayed, GDS
    exits very quickly to the File List screen.

The view mode is very sophisticated, and a full description of the actual
capabilities GDS offers would seem very intimidating to the average user.  If
your goal is to be able to view pictures, then you already know enough to
have great fun with GDS.  If you want to know everything, read on!

Related Topics
    hlViewModeMenuView Mode Menus
    hlViewModeCommandsView Mode Keyboard Commands
    hlViewTheoryHow GDS Processes Images


:::hlViewTheory
How GDS Processes Images

Many people call us and say "my pictures look better when GDS displays them".
At first, we assumed that this was just the strange rantings of loyal users.
However, after we heard it for the 50th time, we checked it out.  The users
are absolutely right, but the reasons don't really impress us.  It turns out
that most other software is just doing less of a job of it.  GDS doesn't
actually make the graphics look better, it just doesn't make it look worse.

GDS does a lot to make sure that the content of an image file is rendered to
the screen as precisely as possible (we think this should be standard.)  It's
not.  Most other software drops bits in 24 bit data to display 15 and 16 bit
versions, which destroys the images.  Most viewers do not generate optimized
palettes in order to display 256 color versions of 24 bit files.  The
technical discussion that could result out of a comparison of GDS to other
image processing software could go on for days, so we won't bother.

If you're not technical, the following brainstorm may appear to be a mass of
random words that only geeks sitting in front of re-runs of Star Trek would
utter in a heightened argument about Spock's tools.  If you're technical and
can understand this, then you're a geek, and ...welcome to the club!  I hope
this section gives you some insight into the very complex world of GDS guts.

GDS has a monolithic graphics pipeline with many flags and switches which
affect the way image data is processed.  All of the factors involved in what
GDS is attempting to do affect exactly how image information is handled.  The
reason GDS is so fast is because the slow things (most of it) have been hand
coded in assembly language (three or more generations of optimization).
Another reason it is so fast is that about 95% of the usually slow processes
occur almost exclusively in the default data segment.

When GDS displays an image (via double click or [Enter] key), GDS first makes
sure that it can recognize the file, and then decides how the data will be
processed.  If the source file is 24 bits per pixel but the best screen mode
available only has 8 bits per pixel, then GDS goes through the histogram
generation, modified heckbert subdivision algorithm and conversion table
processes necessary to prepare to convert from 24 bits downward.

Things like 24 bit sharpening are done at the tail end of the process, while
things like incoming 15, 16 and 24 bit gamma/contrast/brightness adjustment
are done in the file format drivers, which are built into the code.  GDS is
not based on drivers.

Most of the code does not care if the current operation is happening on a
physically displayed screen, or if it's happening in a virtual file.  This
is what drives most of the command line functionality.

Most command line operations automatically create virtual files (perhaps with
XMS rather than disk files).  XMS is cached into system RAM when needed, and
should behave at or better than 95% of the speed of screen images.


:::hlHowToSlideshow
How To Play a Slideshow

1) Use the mouse or keyboard to hlHowToSelectselect the files you want to show.
   Notice when you hold down the shift key, you can click
   on files to toggle their selection state, and you can also drag the
   mouse to select and deselect ranges.  It's easy to select the exact
   files you want.

2) Click on the box in the lower right corner of the GDS
   file display area labeled "hlMenusClick Here For Slide Show!", or
   choose hlViewMenuSlideshowSlideshow from the hlViewMenuView Menu.

3) You can change the delay in the slideshow by using the
   hl/Z/Z<n> option at the command line.

See Also
    hlHowToCLSlideshowSlideshows from the Command Line
    hlViewMenuSlideshowView Slideshow (View Menu Option)

Related Parameters
    hl/E/E    Fit images
    hl/O/O    Set sort options
    hl/Z/Z    Image delay


:::hlHowToCLSlideshow
Slideshows from the Command Line

Type "GDS hl/S/S" followed by filenames or paths and perhaps some of
the following options:

    hl/E/E    Fit images
    hl/O/O    Set sort options
    hl/X/X    Exit to DOS after last image
    hl/Z/Z    Image delay

Note that these command line options each need a number directly after them
on the command line.  For more information, see the command line reference.

For example, to do a slideshow of all of the files in the C:\PICS directory
with two seconds between the display of each image, use the following
command line:

    GDS hl/S/S C:\PICS hl/Z/Z20

GDS can also be used to simply put a picture on the screen as follows:

    GDS hl/S/S hl/X/X filename.gif

See Also
    hlHowToSlideshowHow to Play a Slideshow

Related Parameters
    hl/E/E    Fit images
    hl/O/O    Set sort options
    hl/X/X    Exit to DOS after last image
    hl/Z/Z    Image delay


:::hlHowToCatalog
How To Create Catalogs

 1) hlHowToSelectSelect all files by clicking on the first desired file in the file list
    and dragging the mouse to the end of the file list.  You can also create
    a catalog of any combination of files.  You can hold down the <Shift> key
    while using the mouse to add and subtract files from being selected.
    Also, if no files are selected, GDS will catalog every listed file.

 2) Next, select hlViewMenuCatalogCreate Catalog from the hlViewMenuView Menu.  Use the "up" and
    "down" arrow keys to increase or decrease the number of thumbnails
    displayed on the screen.

 3) Make sure the "Borders" and "Labels" options are set as you want them.
    Type "L" and "B" to change them, or use the mouse and click on the
    "Labels" and "Borders" buttons.

 4) Press [Enter] to start generating the catalogs.

 5) When each screen is complete, press <Alt-W> or <Alt-J> to write the screen
    out as a GDS catalog .GIF or .JPG file.  GDS names the files sequentially
    like GDS000, GDS001, GDS002, etc.  To change the default naming scheme,
    you may use the hl/N/N command line option.

    *SPECIAL NOTE: If you want to write all remaining catalog screens in one
     batch, you can use <Ctrl-W> or <Ctrl-J> rather than <Alt-W> or <Alt-J>.

 6) You can print the catalog image by pressing 'P' at the prompt after each
    catalog screen is completed.  If you do, GDS prints the catalog image and
    then returns you to the prompt again, in case you want to save the file or
    exit.  GDS supports Hewlett Packard LaserJet II, 3, 4 and compatible
    printers (also see the hl/#/# command line option for printer configuration
    information; the printer must be configured properly using the hlSetupMenuSetup
    hlSetupMenuMenu).

 7) You're done.  When you look at the GIF or JPG files, you will be able to
    click on a picture to see the original, as long as the original file is
    in the current file list.  You can also use <PgUp> and <PgDn> to move
    through multiple screen catalogs while viewing the catalogs.

Some users like to generate catalogs with a black background, rather than a
white one.  Other users like the look of the 3D (Gray) catalogs.  White
backgrounds are the default mode for GDS, and are great for printing.  If
you need to change the style of the catalog, you can change the style using
the hlViewMenuView Menu, or one of the command line parameters
listed below.

See hlCmdCatCatalog Parameters for list of command line parameters related to
creating GDS catalogs.

Related Topics
    hlBBSCataloging a BBS


:::hlHowToCLCatalog
Catalogs from the Command Line

If you are cataloging large numbers of images, you can use the hl/W/W<n> command
hl/Wline option to tell GDS to automatically write catalog images.  Here's how it
works:

  1) Start GDS with the hl/W/W<n> option.  For example, hl/W/W4 would write the
     first catalog as GDS004.GIF.  It is alright to use hl/W/W0 if necessary.

  2) Use GDS to create the first catalog screen (as described above).

  3) When GDS is done creating the catalog, type <Alt-W> to write the image as
     a GIF file and continue making catalog screens.  From this point on, GDS
     will automatically write successive catalog screens to GIF files.

This process can also be automated from the command line, by using the hl/P/P
option.  Just specify the path/file specification of the files to be cataloged
and include the hl/P/P<n> and hl/W/W<n> options.  The hl/P/P option sets the number
of thumbnails across for the catalog screens.  For example, hl/P/P4 creates
catalog screens with four thumbnails across, and probably four high.  Note
that in lower resolutions, it is possible to have the number of thumbnails
across be INEQUAL to the number of thumbnails high (it's rare.)

See hlCmdCatCatalog Parameters for list of command line parameters related to creating
GDS catalogs.

Related Topics
    hlBBSCataloging a BBS


:::hlHowToConvert
Converting Files

There are three methods for converting files with GDS:

    hlFileConvertConverting from the main GDS file list using the menus
    hlViewWriteWriting out a displayed image while viewing an image
    hl/@CConverting files from the command line


:::hlFileConvert
Converting Files in the File List

To convert files from the main GDS File List using the menus:

 1) Select a file or a group of files to convert.  You can select multiple
    files by clicking and holding the mouse button while dragging the pointer
    over a number of files.  You can also select multiple ranges by holding
    down [Shift] while clicking on file names to select or deselect them.

 2) Pull down the "Convert" menu with the mouse (or type [Alt-C]) and then
    select the desired type of file.

 3) GDS will open a dialog box that allows you to ROTATE the image or MIRROR
    (flip) it vertically or horizontally as it writes out the file.  GDS will
    attempt to name the file the same as the source but with the new
    extension.  If the extension is the same, or a file with the name already
    exists, GDS will name the file GDS<n> where <n> is the next available
    number, i.e. GDS000, GDS001, GDS002...

*Note:  The trial version does not support "batch conversions."  It will,
    however, convert non-color reduced files to all formats except
    24 bit JPEG format.


:::hlViewWrite
Writing Images From View Mode

To convert files from the view screen (writes displayed image to file):

 1) (OPTIONAL) To save a portion of the displayed image: move the mouse
    pointer to the "File" menu and highlight "Set Save Rect".  Release the
    mouse button.  Move the mouse pointer to one corner of the rectangular
    area you want to save.  Click and hold the mouse button.  Drag the
    rectangle that appears to the desired size.  Release the mouse button.
    Only the area inside the rectangle will be saved by following the
    remaining steps.  (If you are unhappy with your selection you can return
    the crop rectangle to include the entire screen by selecting "Reset Crop
    Rectangle" from the "File" menu.)

 2) Move the mouse pointer to the top of the view screen; click and hold the
    mouse button down.  The "View Mode Menu Bar" will appear.

 3) Move the mouse pointer to the "File" menu.

 4) Highlight the type of destination file by moving the mouse pointer to it,
    and release the mouse button to select the format.

 5) GDS will write the graphics file, and, if successful, open a dialog box
    so you can rename the file if you like.  If the name GDS picks is
    acceptable, hit [Enter].  Otherwise change the name and hit [Enter].  GDS
    displays a warning message if you try to use a name that already exists,
    and will not overwrite an existing file during the rename function.

 6) If you are writing the same format as the file you are viewing, GDS
    displays a small prompt that asks you if you want to overwrite the file.
    If you choose 'Y' for yes, then GDS will overwrite the file if the image
    and be successfully written.  If you choose 'N', then GDS will write the
    file to a file such as GDS000, GDS001, etc.  Choosing 'Esc' at this prompt
    cancels the write function and no file will be written.


:::hl/!
/! Parameter (View Beep)

 /!<n>  - Enable/disable beep after display of image
    /!0 - Don't beep
    /!1 - Beep (default)
:::hl/A
/A Parameter (Default Antialiasing Mode)

 /A<n>  - Antialiasing level
    /A0 - No antialiasing
    /A1 - Horizontal antialiasing
    /A2 - Two dimensional (default)
:::hl/B
/B Parameter (Default Mouse Cursor State)

 /B<n>  - Default mouse mode
    /B0 - Character mouse pointer
    /B1 - Bitmapped mouse pointer (default)
:::hl/C
/C Parameter (Bits in Color DAC)

 /C<n>  - Set number of bits in DAC chip (or 0 to use BIOS palette calls)
    /C0 - Use BIOS ONLY for palette (also kills screen saver)
    /C6 - Standard VGA DAC (default)
    /C8 - Cool expensive DAC (8 bits per color bar)
:::hl/D
/D Parameter (Default Dithering Mode)

 /D<n>  - Set default dither mode
    /D0 - No dithering
    /D1 - 2x2 two color matrix
    /D2 - 2x2 four color matrix (default)
:::hl/E
/E Parameter (Image/Screen Fit Mode)

 /E<n>  - Set image/screen fit mode (0=norm, 1=fit)
    /E0 - Do not fit viewed images to the screen (default)
    /E1 - Fit all images to the screen
:::hl/F
/F Parameter (Default File Display Options)

 /F#### - Set options for file display

    Each of the four number signs holds the position of each of the
    following single character parameters below.  Specify a '1' or a '0'
    to enable or disable the display of each of these types of data:

    ■ Extension    ■ Resolution    ■ Bits/Pixel    ■ File Size

    For example:  /F0110 enables the resolution and bits per pixel, but
    disables the extension and file size.
:::hl/G
/G Parameter (Default Graphics Resolution)

 /G<X>x<Y>x<B>  - Set default graphics mode:
        <X> - Horizontal Resolution (pixels wide)
        <Y> - Vertical Resolution (pixels high)
        <B> - Number of Colors (or bits per pixel):
        16 - 16 colors
        256 - 256 colors
        32k - 32,768 colors
        64k - 65,536 colors
        16M - 16.7 million colors (24 bit)

    Examples:       /g640x480x256    (640x480 256 colors)
            /g1024x768x16m    (1024x768 16.7 million colors)
:::hl/H
/H Parameter (Display Help)

 /H /?  - Display help screen (or /?)
:::hl/I
/I Parameter (Interlaced Fill Mode)

 /I<n>  - Set interlaced fill mode for GIF images
    /I0 - Disable early filled interlaced GIFs (default)
    /I1 - Enable interlaced filling
:::hl/K
/K Parameter (File Comment Mode)

 /K<n>  - Controls automatic GIF comment display after image read
    /K0 - Disable comments
    /K1 - Enable comments
:::hl/L
/L Parameter (Catalog Label Switch)

 /L<n>  - Control Catalog Labeling
    /L0 - Don't display labels under catalog thumbnails
    /L1 - Display labels under catalog thumbnails
    /L2 - Display labels only, centered under thumbnails
:::hl/LAPTOP
/LAPTOP Parameter (Avoid Older Video Modes)

 /LAPTOP- Use on some laptops to avoid older modes.
            NOTE: This option is the same as using: /NOCGA /NOEGA /NOHERC
:::hl/M
/M Parameter (Maximum Optimal Palette Colors)

 /M<n>  - Maximum colors to use during color reduction

    *Note:    Use values between 16 and 256 for best results.
:::hl/N
/N Parameter (Automatic Filename Template)

 /N<str>- Set "printf" style template for output files (default="GDS%03d")

    If you are not familiar with printf() style formatting, refer to a
    reference text on the 'C' libraries.  In general, the '%03d' holds
    the place of a three digit number.  You can change anything else in
    the string, but you cannot add an extension.

    Examples:    /NABCD%03d    (result="ABCD000")
            /N%08d        (result="00000000")
            /N%02d_SAUCE    (result="00_SAUCE")
:::hl/NOCGA
/NOCGA Parameter (Avoid CGA Modes)

 /NOCGA - Ignore CGA modes (useful for laptops/notebooks).
:::hl/NOEGA
/NOEGA Parameter (Avoid EGA Modes)

 /NOEGA - Ignore EGA modes (useful for laptops/notebooks).
:::hl/NOHERC
/NOHERC Parameter (Avoid Hercules Mono Mode)

 /NOHERC- Ignore Hercules monochrome mode (useful for laptops/notebooks).
:::hl/NOMONO
/NOMONO Parameter (Avoid Mono Modes)

 /NOMONO- Ignore all monochrome modes (useful for people who like color).
:::hl/NOVESA
/NOVESA Parameter (Don't Trust VESA)

 /NOVESA- Do NOT trust VESA for mode configuration information.
:::hl/NOIDEA
/NOIDEA Parameter (Extra Support)

 /NOIDEA- Use just before calling technical support.
:::hl/O
/O Parameter (Slideshow Sort Flag)

 /O<n>  - Set sort flag for slideshow
    /O0 - Don't sort before slideshow
    /O1 - Sort before slideshow (honors hl/~O/~O setting)

Related Topics
    hl/~O/~O    File Sort Mode
:::hl/OK
/OK Parameter (Avoid Video BIOS Check)

 /OK    - Assume CONFIG file is correct and use it.  Note: this switch avoids
          GDS's automatic re-configuration of video hardware.  If you have a
          video card which arbitrarily changes it's own video BIOS contents,
          then put this switch in your hlConfFileGDSUSER.CFG as follows:

            auto,/ok     ;assume CONFIG is ok to use
:::hl/P
/P Parameter (Generate Catalogs)

 /P<n>  - Automatically generate catalogs and write them.  <n> determines how
    many thumbnails will appear across the catalog.  For example, if you
    need four thumbnails across and down, use the following switch:

    /P4

    A special mode has been added which triggers the handy command line
    catalog interface in GDS:

    /P?

    This catalog interface can be used in a BBS if the standard input and
    output streams are directed to the modem.

Related Topics
    hlCmdCatCatalog Parameters
:::hl/Q
/Q Parameter (Specify Catalog Logo File)

 /Q<x>_<y>_<name> Add logo to automatic catalogs (use with hl/P/P<n>)
:::hl/QUIET
/QUIET Parameter

 /QUIET - Prevents GDS from displaying opening screen on startup.


:::hl/R
/R Parameter (Set Auto/Lock State)

 /R<n>  - Set default resolution 'Lock' mode (0=AutO, 1=LOck)
:::hl/S
/S Parameter (Play Slideshow)

 /S     - Slideshow mode (no user interface, just automatic slideshow)
:::hl/T
/T Parameter (Set Default Text Mode)

 /T<h>x<v>  - Set default text mode
        <h> Horizontal resolution
        <v> Vertical resolution

        Example:    GDS /T80x25
:::hl/U
/U Parameter (Catalog Borders On/Off)

 /U<n>  - Control Catalog Borders
    /U0 - No borders around thumbnails
    /U1 - Put borders around thumbnails

Related Topics
    hlCmdCatCatalog Parameters
:::hl/V
/V Parameter (Set Vertical Orientation)

 /V<n>  - Set vertical orientation file display (0=horiz, 1=vert)
:::hl/W
/W Parameter (Set Auto Filename Number)

 /W<n>  - Automatically write catalogs GDS<n++>.GIF after first screen
:::hl/X
/X Parameter (Exit to DOS)

 /X     - Exit to DOS after displaying image, but leave graphics mode up
:::hl/Z
/Z Parameter (Set Slideshow Delay)

 /Z<n>  - Set slideshow delay in 100ths of seconds: Default is 300 (3 seconds)
:::hl/#
/# Parameter (Set Printer Port/Filename)

 /#<lpt#:> - Set filename of printer device (ie:  /#LPT2 ; default is /#PRN)
          NOTE: The printer must be configured correctly to avoid the annoying
          error messages.
:::hl/=
/= Parameter (Set Video Palette Processes)

 /=<bn> - Set default red/green/blue/contrast/brightness/color/sharpness
            /=R<n> - Default red level (+/- 255)
            /=G<n> - Default green level
            /=B<n> - Default blue level
            /=C<n> - Default contrast (+/- 255)
            /=+<n> - Default brightness (+/- 255)
            /=L<n> - Default color level (+/- 255)
            /=S<n> - Default 24 bit sharpening level (0-10+)
            /=H<n> - Default hue setting (0-255)
:::hl/~A
/~A Parameter (Set Catalog Style)

 /~A<n> - Set the style of GDS catalogs.

    <n> must be one of the following values:
        0 = Black background with tan borders
        1 = White background with black borders (Default)
        2 = Gray backgrounds with 3-D looking image borders

    Example:    GDS /~A2    Default to Gray/3D catalogs
:::hl/~B
/~B Parameter (Set Slideshow Centering)

 /~B<n> - Set automatic centering mode of slideshows.
    /~B0 - Do not center slideshow images
    /~B1 - Center slideshow images (default)
:::hl/~E
/~E Parameter (Inhibit Slideshow Screen Erasure)

 /~E<n> - Inhibit slideshow screen erase between similar images
:::hl/~F
/~F Parameter (Color Proximity Elimination)

 /~F<n> - Enable color proximity elimination in color reduction
:::hl/~G
/~G Parameter (Optimal Grayscale Palettes)

 /~G<n> - Generate optimized grayscale palettes (G1, default=G0)
:::hl/~J
/~J Parameter (Color Printing)

 /~J<n> - Print in COLOR.  HP PCL CMY process inkjet printers supported.
    /~J0 - Support black and white printing only (default)
    /~J1 - Support CMYK color PCL
:::hl/~K
/~K Parameter

This option was used in version 3.0 and is no longer needed.
:::hl/~L
/~L Parameter (Dynamic File List)

 /~L<n> - Set initial length of dynamic file list cache size for GDS.  The
          maximum number of files GDS can handle is 2848.  The default for
          this option is 200.  You may save a very small amount of RAM by
          setting this number lower if you use GDS with fewer than 150 files
          at a time.  Setting this number to 50 will save 3450 bytes of RAM.
          As the file list grows, GDS may run out of memory, which will stop
          GDS from adding valid files to the file list.  This should not
          happen unless GDS is trying to deal with thousands of files. Paths
          are handled separately and there is no practical limit to the
          number of concurrent paths GDS can handle.
:::hl/~M
/~M Parameter (JPEG Quality)

 /~M<n> - Set default JPEG quality level

    Use values between 10 and 99.  Higher values result in better image
    quality at the expense of compression.

    /~M75 - Set JPEG Quality to 75 (default)

    *Note:    Not supported in trial shareware version.
:::hl/~O
/~O Parameter (File Sort Mode)

 /~O<n> - Set default file sort mode (0=name/1=size/2=bits/3=res/4=extn)
:::hl/~R
/~R Parameter (Aspect Ratio Handling)

 /~R<n> - Force aspect ratio of all catalog files to 1:1
:::hl/~T
/~T Parameter (Catalog File Output Format)

 /~TJ   - Use JPEG format for automatically written catalogs (with /P above).
          NOTE: Any 'write command' letter can be used here.  For example,
          Since <Alt-T> writes TIFF files, /~TT would write TIFF catalogs,
          /~TG would write GIF catalogs, etc.)
:::hl/~Z
/~Z Parameter (Write to Startup Path)

 /~Z<n> - Always try to write new files to startup path
:::hl/<vid>
/<vid> Parameter (Force Video Type)

This parameter avoids all video hardware autodetection and forces GDS to
assume that there is a certain type of video hardware available.  For more
information, see hlCmdVHVideo Hardware Parameters.
:::hl/512
/512 Parameter

This parameter forced older versions of GDS to assume that the video hardware
had at least 512K of video RAM.  This option is now obsolete because the
automatic configuration reliably detects the validity of individual modes,
including the availability of sufficient video RAM.
:::hl/1M
/1M Parameter

This parameter forced older versions of GDS to assume that the video hardware
had at least one megabyte of video RAM.  This option is now obsolete because
the automatic configuration reliably detects the validity of individual modes,
including the availability of sufficient video RAM.
:::hl@<file>
@<file> Parameter (Read File Spec. List)

 @<file> - Read file list from text file: <file>  (ie:  GDS @file.lst )
:::hl/@C
/@C Parameter (Convert Files)

GDS can perform all file conversion operations from the command line.  GDS
uses either XMS or disk space as a virtual file, so the resolution of the file
is not important.  This makes GDS ideal for use with on-line systems as a
simple means of providing multiple file formats for download.

The /@C command line parameter can be used to carry out a single conversion or
a batch conversion.  Any files which are specified to GDS are assumed to be
converted into the specified format.  If no files are specified on the command
line (or in a configuration file), then GDS assumes that all files in the
current directory are to be converted, so be careful about specifying which
files to convert.

The /@C command line parameter takes two additional values specified directly
after one another.  The first parameter is a letter signifying the destination
format.  The second parameter is the number of bits per pixel.  Note that some
formats do not support certain bit depths, so be sure to specify only those
combinations which are supported.

 /@C<t><c> - Convert files from command line

    <t> Destination File Type
        J = JPEG    P = PCX
        W = GIF        B = BMP
        I = TIF        A = ANSI
        T = TGA

    <c> Destination File Bit Depth (determines number of colors)
        1 = monochrome        15 = 32,768 colors
        2 = 4 colors        16 = 65,536 colors
        4 = 16 colors        24 = 16.7 million colors
        8 = 256 colors

For example, /@CW8 converts all specified files to 256 color GIF files, while
/@CJ24 converts them to 24 bit JPEG files.  Note that /@CJ8 is not legal,
because color JPEG files are always considered to be 24 bits.  The following
combinations are valid:

    hlConvANSI/@CA    (ANSI, bit depth is always 4 bits)
    hlConvBMP1/@CB1    (BMP monochrome)
    hlConvBMP4/@CB4    (BMP 16 colors)
    hlConvBMP8/@CB8    (BMP 256 colors)
    hlConvBMP24/@CB24    (BMP 16.7 million colors)
    hlConvJPG24/@CJ24    (JPEG 16.7 million colors)
    hlConvGIF1/@CW1    (GIF monochrome)
    hlConvGIF4/@CW4    (GIF 16 colors)
    hlConvGIF8/@CW8    (GIF 256 colors)
    hlConvLBM1/@CL1    (LBM/IFF monochrome)
    hlConvLBM4/@CL4    (LBM/IFF 16 colors)
    hlConvLBM8/@CL8    (LBM/IFF 256 colors)
    hlConvPCX1/@CP1    (PCX monochrome)
    hlConvPCX4/@CP4    (PCX 16 colors)
    hlConvPCX8/@CP8    (PCX 256 colors)
    hlConvRIX4/@CR4    (ColorRIX 16 colors)
    hlConvRIX8/@CR8    (ColorRIX 256 colors)
    hlConvTIF1/@CI1    (TIFF monochrome)
    hlConvTIF4/@CI4    (TIFF 16 colors)
    hlConvTIF8/@CI8    (TIFF 256 colors)
    hlConvTIF24/@CI24    (TIFF 16.7 million colors)
    hlConvTGA15/@CT15    (TGA 32K colors)
    hlConvTGA24/@CT24    (TGA 16.7 million colors)

If GDS can write the output files without overwriting a file with the same
name, then the default file name will be preserved.  If files with the same
name are found, then GDS will write out those files with a filename like
GDS000, GDS001, GDS002, etc.

See also: hlConvMenuUsing the Convert Menu, hlHowToConvertConverting Files,
    hlViewWriteConverting via View Menus, hlViewModeMenuView Mode File Menu


:::hlViewModeMenu
View Mode Menus

When viewing an image the following View Mode Menus can be accessed by
clicking the mouse button while the cursor is near the top edge of the
screen.  If you do not select an option when releasing the mouse button,
the view mode menus disappear and you are returned harmlessly to viewing
the current image file.

Note:  There is no way to access View Mode Menus without a mouse.  Most
options in the View Mode Menus have keyboard equivalents which are listed
in each menu.

hlViewModeMenuFile File  hlViewModeMenuEdit Edit  hlViewModeMenuColor Color  hlViewModeMenuSize Size  hlViewModeMenuPrint Print  hlViewModeMenuRes (Resolution)


:::hlViewModeMenuFile
View Mode File Menu

The View Mode File Menu is used to write the displayed image (or a cropped
portion of the image) to an image file, and to set the cropping rectangle,
as well as obtaining file information and exiting View Mode.  (Note that it
is usually much easier to exit View Mode by pressing the [Esc] key.)

    hlVMMFSaveANSSave ANS      Alt-A
    hlVMMFSaveGIFSave GIF      Alt-W
    hlVMMFSaveLBMSave LBM      Alt-L
    hlVMMFSavePCXSave PCX      Alt-P
    hlVMMFSaveBMPSave BMP      Alt-B
    hlVMMFSaveRIXSave RIX      Alt-R
    hlVMMFSaveTGASave TGA      Alt-T
    hlVMMFSaveTIFSave TIF      Alt-I
    hlVMMFSaveJPGSave JPG      Alt-J
    -----------------------
    hlVMMFSetCropSet Crop Rect.      Alt-C
    hlVMMFResetCropReset Crop Rect
    -----------------------
    hlVMMFFileInfoFile Info (?)
    -----------------------
    hlVMMFQuitQuit            Esc


:::hlVMMFSaveANS
Save ANSI 16 Color Text File

Selecting this option from the View Mode File Menu (or hitting [Alt-A]) will
create a file using the entire screen image or a portion of the screen image
selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
be dithered down to the standard 16 color ANSI palette and size (79
characters wide.

This function is supported in GDS Professional

:::hlVMMFSaveGIF
Save GIF (CompuServe GIF89a) File

Selecting this option from the View Mode File Menu (or hitting [Alt-W]) will
create a file using the entire screen image or a portion of the screen image
selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
be dithered down to 256 colors.


:::hlVMMFSaveLBM
Save LBM (Deluxe Paint) File

Selecting this option from the View Mode File Menu (or hitting [Alt-L]) will
create a file using the entire screen image or a portion of the screen image
selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
be dithered down to 256 colors.


:::hlVMMFSavePCX
Save PCX (Paint) File

Selecting this option from the View Mode File Menu (or hitting [Alt-P]) will
create a file using the entire screen image or a portion of the screen image
selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes will
be dithered down to 256 colors.


:::hlVMMFSaveBMP
Save BMP (Windows Bitmap) File

Selecting this option from the View Mode File Menu (or hitting [Alt-B]) will
create a file using the entire screen image or a portion of the screen image
selected with the hlVMFMSetCropSet Crop Rectangle command.


:::hlVMMFSaveRIX
Save RIX (ColorRix) File

Selecting this option from the View Mode File Menu (or hitting [Alt-R]) will
create a file using the entire screen image or a portion of the screen image
selected with the hlVMFMSetCropSet Crop Rectangle command.  Higher resolution modes
will be dithered down to 256 colors.


:::hlVMMFSaveTIF
Save TIF (Tagged Image File Format) File

Selecting this option from the View Mode File Menu (or hitting [Alt-I]) will
create a file using the entire screen image or a portion of the screen image
selected with the hlVMFMSetCropSet Crop Rectangle command.


:::hlVMMFSaveTGA
Save TGA (Targa) File

Selecting this option from the View Mode File Menu (or hitting [Alt-T]) will
create a file using the entire screen image or a portion of the screen image
selected with the hlVMFMSetCropSet Crop Rectangle command.


:::hlVMMFSaveJPG
Save JPG (JPEG) File

Selecting this option from the View Mode File Menu (or hitting [Alt-J]) will
create a file using the entire screen image or a portion of the screen image
selected with the hlVMFMSetCropSet Crop Rectangle command.


:::hlVMMFSetCrop
Set Crop Rectangle

Selecting Set Crop Rect. from the View Mode File Menu (or hitting [Alt-C)
will begin the crop function.  Place the mouse cursor one corner of the area
to be cropped.  Hold down the mouse button and drag the Crop Rectangle that
appears so it contains the desired area. Only the area inside the Crop
Rectangle will be saved by using one of the Save commands from the View Mode
File Menu.


:::hlVMMFResetCrop
Reset Crop Rectangle

Selecting this option from the View Mode File Menu will reset the hlVMMFSetCropCrop
hlVMMFSetCropRectangle to contain the entire screen area.


:::hlVMMFFileInfo
File Information

Selecting File Info From the View Mode File Menu (or hitting [?]) will
display helpful information about the file being viewed including the
filename, extension (file type), resolution, number of colors, and even the
total number of dots (very important!)


:::hlVMMFQuit
Quit View Mode

Selecting Quit form the View Mode File Menu (or hitting [Esc]) will exit View
Mode to the File List.  Also, clicking the mouse button exits except on
Catalog screens.


:::hlViewModeMenuEdit
View Mode Edit Menu
The View Mode Edit Menu provides several image functions, including rotation,
axis flipping, mouse panning and the ability to reset the orientation of the
displayed image file.

    hlVMMERotateRotate 90 Deg.        /
    ---------------------
    hlVMMEFlipHorzFlip Horizontal        H
    hlVMMEFlipVertFlip Vertical        V
    ---------------------
    hlVMMEPanPan Image w/Mouse   P
    ---------------------
    hlVMMEResetReset Orientation


:::hlVMMERotate
Rotate 90 Degrees

Selecting Rotate 90 Deg. (or hitting /) rotates the image on the screen
90 degrees clockwise.


:::hlVMMEFlipHorz
Flip Horizontal

Selecting Flip Horizontal (or hitting H) creates a mirror image of the
file displayed on the screen.


:::hlVMMEFlipVert
Flip Horizontal

Selecting Flip Horizontal (or hitting H) creates a vertical mirror image
of the file displayed on the screen.


:::hlVMMEPan
Pan Image with Mouse

Selecting Pan Image w/Mouse (or hitting P) puts GDS in panning mode. Hold
down the mouse button and move the mouse to pan the image on the screen. When
the mouse button is released GDS will exit panning mode.


:::hlVMMEReset
Reset Orientation

Selecting Reset Orientation undoes all other View Mode Edit Menu commands
restoring an image to its original orientation.


:::hlViewModeMenuColor
View Mode Color Menu

The View Mode Color Menu is used to manipulate the color content of the
current image file.  Note that this menu has no effect in video modes with
15, 16 or 24 bits per pixel (32k, 64k and 16.7 million colors), although
it will still allow the user to select from it.

    hlVMMCGrayGrayscale
    hlVMMCmaxMaximum Color
    -----------------------
    hlVMMCInvertInvert Palette          '
    -----------------------
    hlVMMCResetColorReset Color Intensity <
    hlVMMCResetAllReset All Settings


:::hlVMMCGray
Grayscale

Selecting Grayscale converts a color image into shades of gray. This
command has no effect if using a screen mode supporting more than 256 colors.


:::hlVMMCMax
Maximum Color

Selecting Maximum Color saturates the colors in an image. This command
has no effect if using a screen mode supporting more than 256 colors.


:::hlVMMCInvert
Invert Palette

Selecting Invert Palette (or hitting ~) creates a "negative" version of an
image. This command has no effect if using a screen mode supporting more than
256 colors.


:::hlVMMCResetColor
Reset Color Intensity

Selecting Reset Color Intensity (or hitting <) reverts all View Mode Color
Menu options to their original state.


:::hlVMMCResetAll
Reset All Setting

Selecting Reset All Settings reverts all View Mode options to their original
state. The spacebar also restores an image to its original state.


:::hlViewModeMenuSize
View Mode Size Menu

The View Mode Size Menu provides size alteration and positioning of the
current image file.

    hlVMMSFitFit To Screen     Alt-F
    hlVMMSSetZoomSet Zoom Rect.     Alt-Z
    ----------------------
    hlVMMSDoubleXDouble X
    hlVMMSDoubleYDouble Y
    hlVMMSDoubleXYDouble Both X/Y
    ----------------------
    hlVMMSHalfXHalf X
    hlVMMSHalfYHalf Y
    hlVMMSHalfXYHalf Both X/Y
    ----------------------
    hlVMMSCenterCenter Image     Alt-S
    ----------------------
    hlVMMSResetReset Scale Parameters


:::hlVMMSFit
Fit Image to Screen

Selecting Fit To Screen (or hitting [Ctrl-F]) changes an image smaller or
larger than the current screen mode to match the dimensions of the screen.


:::hlVMMSSetZoom
Set Zoom Rectangle

Selecting Set Zoom Rectangle (or hitting [Alt-Z]) places GDS in zoom mode.
Move the mouse cursor to one corner of the area to be zoomed. Hold down the
mouse button and drag the mouse until the desired area is within the Zoom
Rectangle. Release the mouse button and GDS zoom the selected area to fill
the screen.

Related Topics
    hlVMCZoomOMaticInstant Zoom (Zoom'O'Matic)


:::hlVMMSDoubleX
Double X

Selecting this option will double the width of an image.


:::hlVMMSDoubleY
Double Y

Selecting this option will double the height of an image.


:::hlVMMSDoubleXY
Double X and Y

Selecting this option will double the height and width of an image.


:::hlVMMSHalfX
Half X

Selecting this option will halve the width of an image.


:::hlVMMSHalfY
Half Y

Selecting this option will halve the height of an image.


:::hlVMMSHalfXY
Half X and Y

Selecting this option will halve the height and width of an image.


:::hlVMMSCenter
Center Image

Selecting Center Image (or hitting [Ctrl-S]) places the displayed image in
the center of the screen.


:::hlVMMSReset
Reset Scale Parameters

Selecting Reset Scale Parameters reverts all View Mode Size
Menu options to their original state.


:::hlViewModeMenuPrint
View Mode Print Menu

The print menu allows you to print the currently displayed image file (or a
portion selected with the Alt-C function) directly from the screen.  Note
that graphics printing is supported only by registered versions of GDS.

           hlVMMPPrintPrint Portrait
    hlVMMPPrintPrint Landscape


:::hlVMMPPrint
Print Portrait or Landscape

These menu options will print the currently hlHowToSelectselected file in either portrait
(10" tall) or landscape (10" wide) mode on HP LaserJets, DeskJets and 100%
compatible PCL printer language printers.  Additionally, GDS will print in
color on the DeskJet 500C, 550C, 560C, and 1200C.  The correct port must be
selected in the Setup Menu: Printer On... section.


:::hlViewModeMenuRes
View Mode Resolution Menu

The Viewmode Resolution Menu lists the current video resolution on the menu
bar.  The video mode may be changed by selecting a different video resolution
from this menu.  From top to bottom, the menu is organized into sections of
similar numbers of colors (bit depths), and then by resolution within each
section.

*Note:  GDS does NOT display the current video mode in the resolution menu,
    because doing so would be pointless, and would waste space which
    can be better used for a different possible resolution.

GDS can display up to 25 modes in the resolution menu.  Because they are
sorted by bit depth, the highest (coolest) video modes are nearest to the
top of the menu, making them more convenient to select.


:::hlHowToSelect
How To Select Files

Selecting files is very important because it determines files to be included
in catalogs, slideshows as well as batch conversions and printouts.

File selection is simple; just click with the mouse and a file is selected.
Double clicking on a file initiates viewing the file, which can also be done
with the keyboard by pressing the [Enter] key.

There are several variations of selecting files which make things like
selecting ranges and selecting arbitrary sets of files.  The two major ways
to select files are with a mouse, and with the keyboard.  Mouse selection is
described separately from keyboard selection.

Mouse Selection
───────────────
  To select a single file, move the mouse cursor over the file and click the
  mouse button.  To deselect it, click the button again.  Note that if you
  click twice, you will actually initiate viewing the image, so to deselect,
  make sure there has been about a half-second delay.

  To select a range of files, move the mouse over the first file, click AND
  HOLD the mouse button, and then drag the mouse to the last file and release
  the mouse button.

  Normally, when you click a mouse button on the file list, all currently
  selected files are deselected.  To prevent this, hold down the [Shift] key
  while performing your selections.  The [Shift] key allows you to toggle
  both single and range selections.

Keyboard Selection
──────────────────
  Keyboard selection is simpler but less flexible.  Simply user the arrow
  keys to move the file cursor to the file to select and press the [Space Bar]
  key.  Each time you press the [Space Bar] key, GDS toggles the selection
  state of the highlighted file and then moves the file cursor to the next
  entry.

  To select a range of files, just use the arrow keys to the first file and
  then hold down the [Space Bar] until all of the files are selected.

Quick Letter 'Go To' Function
─────────────────────────────
  This is an obscure function which can be very handy.  Just type a letter or
  number on the keyboard, and GDS will move to the first file in the file
  list which has a filename which begins with the same letter or a letter
  following the typed letter in the alphabet.  This function is somewhat
  defeated when the sort order is not set to hlDisplayMenuSortSort: Name Extn, but is
  useful to be aware of.


:::hlViewModeCommands
View Mode Command Reference

The following keyboard commands are available when viewing images.

    hlVMMFQuit<Esc>- Exit
  hlVMMCResetAll<Space>- Restore Original Image
      hlVMCZoomOMatic<Z>- Zoom'O'Matic
      hlVMMFFileInfo<?>- File information
  hlVMMFSaveBMP<Alt-B>- Write .BMP
  hlVMMFSaveTIF<Alt-I>- Write .TIF
  hlVMMFSaveLBM<Alt-L>- Write .LBM
  hlVMMFSavePCX<Alt-P>- Write .PCX
  hlVMMFSaveSCx<Alt-R>- Write .SCx
  hlVMMFSaveTGA<Alt-T>- Write .TGA
  hlVMMFSaveGIF<Alt-W>- Write .GIF
  hlVMMFSaveJPG<Alt-J>- Write .JPG
  hlVMMFSaveANS<Alt-A>- Write .ANS
    hlVMCColorLevelF1/F2- Red level
    hlVMCColorLevelF3/F4- Green level
    hlVMCColorLevelF5/F6- Blue level
    hlVMCContrastF7/F8- Contrast
   hlVMCBrightnessF9/F10- Brightness
  hlVMCHueF11/F12- Hue
  hlVMCColorLevel','/'.'- Color level
hlVMMERotateslash '/'- Rotate 90 degrees
hlVMMCInverttilde '~'- Invert palette
      hlVMMEFlipHorz'H'- Flip Horizontal
      hlVMMEFlipVert'V'- Flip Vertical
      hlVMMEPan'P'- Pan image with mouse.
 hlVMCScaleplus '+'- Scale image up 5% larger
hlVMCScaleminus '-'- Scale image down 5% smaller
  hlVMMSFit<Alt-F>- Fit image to screen
  hlVMMSCenter<Alt-S>- Center image
  hlVMMFSetCrop<Alt-C>- Set "crop" rectangle
  hlVMMSSetZoom<Alt-Z>- Set "zoom" rectangle
   hlVMCArrowArrows- Resize Image
hlVMCKeyboardPan   <E>
hlVMCKeyboardPan    
hlVMCKeyboardPan<S>-■-<D>- Keyboard panning
hlVMCKeyboardPan    
hlVMCKeyboardPan   <X>
  hlVMCSharp<PgUp> - Increase sharpening
  hlVMCSharp<PgDn> - Decrease sharpening
     hlVMCQuote<'> - Undocumented quote function


:::hlVMCZoomOMatic
Zoom'O'Matic

      [Z]- Zoom'O'Matic for 2-256 color displays.  (Requires XMS)

             While zooming:  * Mouse pans the image in real-time
                             * Up and down arrows increase and decrease zoom
                             * Number keys (1-9) set zoom magnification level
                             * Any other key or mouse button exit zoom mode
:::hlVMCColorLevel
View Mode Color Adjustments

These keys adjust the appearance of an image while viewing.

    F1/F2- Red level    Use <Shift> to reset
    F3/F4- Green level   "
    F5/F6- Blue level    "
    , / .- Color level   "

    *Note:    These keys may not work if the video mode supports more
        than 256 colors.

:::hlVMCContrast
View Mode Contrast Adjustment

These keys adjust the variation between light and dark areas of an image.

    F7/F8- Contrast      Use <Shift> to reset

    *Note:    These keys may not work if the video mode supports more
        than 256 colors.

:::hlVMCBrightness
View Mode Brightness Adjustment

These keys brighten or darken an image.

    F9/F10- Brightness   Use <Shift> to reset

    *Note:    These keys may not work if the video mode supports more
        than 256 colors.

:::hlVMCHue
View Mode Hue Adjustment

These keys alter the hue of an image.

  F11/F12- Hue        Use <Shift> to reset

    *Note:    These keys may not work if the video mode supports more
        than 256 colors.

:::hlVMCScale
View Mode Image Scaling

These keys alter the size of an image either larger or smaller and maintains
the aspect ratio.

 plus '+'- Scale image up 5% larger
minus '-'- Scale image down 5% smaller

Related Topics
    hlVMCArrowArrow Keys (in View Mode)
    hlVMMSDoubleXYDouble X/Y (from hlViewModeMenuSizeView Mode Size Menu)
    hlVMMSHalfXYHalf X/Y (from hlViewModeMenuSizeView Mode Size Menu)


:::hlVMCArrow
View Mode Arrow Keys

Use the arrows to move the lower right corner of the image around.  Hold down
the <Shift> key to move 20 pixels rather than one each. Using these keys will
not maintain the aspect ratio of an image. To maintain the aspect ratio use
the hlVMCScale+ and - keys instead.

Related Topics
    hlVMCScale+ (Plus) and - (Minus) keys (in View Mode)
    hlVMMSDoubleXYDouble X/Y (from hlViewModeMenuSizeView Mode Size Menu)
    hlVMMSHalfXYHalf X/Y (from hlViewModeMenuSizeView Mode Size Menu)


:::hlVMCKeyboardPan
Panning an Image from the Keyboard

These keys pan the image up, down, left, and right.  If the <Shift>
key is held, then they pan the image 20 pixels rather than one.

              Pan Up

               <E>
                
           Pan Left    <S>-■-<D> Pan Right
                
               <X>

             Pan Down

Related Topics
    hlVMMEPanPan Image with Mouse (from hlViewModeMenuEditView Mode Edit Menu)


:::hlVMCSharp
View Mode Sharpening

These keys increase or decrease the level of sharpening on images with more
than 256 colors (15, 16, or 24 bit color)

  <PgUp> - Increase sharpening

  <PgDn> - Decrease sharpening


:::hlVMCQuote
Undocumented Quote Feature

     <'> - Undocumented quote function.  Use with caution.

:::hlBBS
Cataloging a BBS with GDS

GDS is used by hundreds of BBS system operators around the world to manage,
verify, review, categorize and catalog thousands of graphics files.  GDS has
many functions specifically designed for BBS system operators (sysops), which
not only make these tasks easier, but can add features to an existing BBS.

GDS's Special BBS Features
   ■ Instantly view new graphics files, delete junk and move good files.

   ■ Catalog CD's to quickly see if content is worth anything.

   ■ Catalog downloadable graphics files and provide catalogs to callers.
     Note:  BBS users love this offering, see the section below about BBS
     file catalogs for details about how to determine what's right for
     your system.

   ■ Insert your system logo graphic into GDS catalogs automatically.  There
     are even systems which have random batch files which vary the logo and
     placement in order to provide variety.

   ■ Provide on-line tagged file cataloging.  GDS has a special standardized
     user interface designed to insert into an existing BBS.  Several BBS
     developers are putting specific hooks as well.

   ■ Customize system to use GDS as a tool, both for user and system
     functions.  GDS provides hundreds of command line and batch functions
     which can be easily incorporated into an existing BBS.

   ■ GDS Professional instantly converts graphics files to ANSI via command
     line parameters, so users can get an ANSI preview of a graphic file
     within 10 seconds to help them decide to download it.

There are many reasons to provide catalogs of your system.  First, users love
it because they can avoid online time and get to just the graphics files which
look interesting.  This clears your phone lines and allows you to get more
users on the system.

Catalogs give you a competitive edge against text-only systems.  Many users of
BBS systems are frustrated that they do not have a way to preview a large file
before they commit to a download.  With GDS catalogs, they can commit to the
catalog download, and then know roughly what to expect when they commit to a
file download.

There are many ways to provide catalogs, because there are many preferences
and organization structures that BBS systems use to categorize files.  The
methods which work best are as follows:

   ■ Decide on a standard look for your catalogs.  Consistency and uniqueness
     will eventually become a successful BBS's calling card.

   ■ Provide a section which catalogs all areas of the BBS.  Even if you have
     thousands of graphics files in hundreds of areas, users still one to have
     a "one stop shop" type of area on a BBS.  Don't try to make lots of areas
     with lots of catalog runs.

   ■ Use 25 or more pictures per catalog screen, and try to provide both GIF
     and JPEG format.  Users with 15, 16 or 24 bit displays really appreciate
     JPEG catalogs, and JPEG catalogs are much smaller than their GIF cousins.

   ■ Consider providing very dense catalogs for people who want a quick
     overview of a huge amount of files.  For example, you may want to have a
     run of catalogs which has 100 thumbnails per screen at 1024x768 or
     1280x1024.  This gives power users the ability to use the "brute force"
     that makes them feel more powerful.  They appreciate this "high end"
     attention and will rave about your efforts.  Once again, use JPEG to get
     the file size down!

   ■ Provide ANSI conversion of graphics files.  ANSI files are small and can
     be displayed by nearly all text terminal programs with no changes.

   ■ Consider adding options to provide single thumbnail download.  GDS can
     generate a 160x120 JPEG thumbnail of a GIF file in about 4 seconds,
     which can be downloaded to the user in about 7 seconds.  A user could
     select a file and have a thumbnail to review within 15-20 seconds.


:::hlOFrm
GDS PURCHASE ORDER AND REGISTRATION FORM
I would like a copy of GDS!  I understand that I will receive a
personalized copy, registered in my name, that I may freely use for any
personal purpose that I wish.  I also understand that GDS is protected
by Federal Copyright Laws and International Treaty Provisions and will
not copy or distribute GDS or any part of GDS.  I understand that my
correct phone number is required for registration and will be kept
strictly confidential.  Items marked with an asterisk (*) are optional.

Name of user:_________________________________________________________
(PLEASE PRINT CLEARLY)    First Name,  Initial,  Last name

*Company:_____________________________ *Work: (______) ______-________

Addr:_________________________________  Home: (______) ______-________

     _________________________________
                                            *Favorite Pop Star:_______
     _________________________________

City:_____________________________ State/Prov:_________ Zip:__________

READ THE FOLLOWING AND TRUTHFULLY MARK ONE OF THE TWO BOXES BELOW:
[_] I DO control a bulletin board system (BBS).  I understand that any
purchased copy of GDS is not in the public domain, and is not to be
made available for download by users of my or any other BBS.  I
understand that making such files available for download could result
in legal action of up to $100,000 per infraction.  To certify that I
understand this clause, I hereby write my initials:___________________
[_] I DO NOT control a BBS and will not upload purchased software to
any BBS.
------------------------------------------QTY---PRICE----TOTAL---
___GDS Program and Documentation          ___  $39.95  $_________

           Shipping and Handling          _1_   $3.00  $_____3.00

___*Picture Factory for Windows (10% off!)___  $44.95  $_________
   (2,659 full color photos on CD-ROM)

___*Faster shipping (2-day UPS BLUE/48 States)  $5.00  $_________

___International Shipping (call for shipping charge)   $_________
   NOTE: Foreign (non-US) check orders are not accepted.

__VISA __MasterCard __CHECK ENCL.  (8.25% CA Sales Tax)$_________
-----------------------------------------------------------------
________/________/________/________ Ex:____/____  TOTAL$
                                                        =========
Sign:X___________________________*Ship FED/X #:__________________

      ORDERS VIA MAIL                 VISA/MC ORDERS VIA FAX
  Enclose check and mail to:      Fill out completely and FAX to:
                                       +--------------------+
    Photodex Corporation               |[phone] - FAX|
    1781 Barcelona Street              +--------------------+
    Livermore, CA  94550               [phone] - voice
:::hlConf
GDS VIDEO MODE CONFIGURATION

For help with this help message, press hlHelpF1] now.

Welcome to GDS's Video Configuration.  If this is the first time you have
configured GDS, then we recommend you take a minute or two to read about the
configuration process before you begin.

    hlConfTopUnderstanding GDS Configuration  <-- Click for more
    hlConfPUPower User Quick-Start    <-- Power User's Click Here

If you are ready to continue, select the message below.

    kCrStart Configuration    <-- Select to Start Configuration

:::hlConfTop
Configuration Help

The GDS Configuration process tests all available video modes for proper
operation.  Thanks to the this process, GDS does not suffer from the most
common problems other DOS graphics programs exhibit.

If you have trouble configuring GDS, call hlPhotodex(510) 449-9079 for technical help.
If you FAX us at hlPhotodex(510) 449-3519, we will respond as fast as possible.

    hlConfPUPower User Quick-Start

Helpful Information
    hlConfInstHow To Configure GDS
    hlConfTestHow Each Mode is Tested
    hlConfFileGDS Configuration Files

Common Problems
    hlConfVideoVESA, Mode Types, Missing Modes
    hlConfReptRepeated Configurations
    hlConfCrashCrashing Video Modes
    hlConfQuirksConfiguration Quirks
    hlConfLaptopCommon Laptop/Notebook Problems

:::hlConfLaptop
Common Laptop/Notebook Problems

Many laptop and notebook computers have Cirrus Logic chipsets which GDS does
not detect.  Try using /CL54 on the command line.

Some laptop and notebook computers crash when GDS tries to bring up the
configuration because of incompatibility with very old CGA and EGA modes.  If
you have a laptop, try using the following switches:

  /LAPTOP   Disable Herc, CGA and EGA (same as /NOHERC /NOCGA /NOEGA)

  /NOHERC   Disable Hercules monochrome mode
  /NOCGA    Disable all CGA modes
  /NOEGA    Disable all EGA modes

  /NOMONO   Disable all monochrome modes
:::hlConfVideo
VESA, Mode Types & Missing Modes

GDS supports four types of graphics modes: standard video modes, tweeked VGA
modes, VESA modes and other non-standard modes.  Standard modes work on all
VGA cards.  Many video provide VESA support, although we have NEVER seen a
complete VESA implementation, and some video cards require the user to load
VESA drivers in order to actually use the modes.  Most VESA cards work well
enough for GDS to be able to reliably detect and support the available video
modes.

If you have a VESA video card and GDS is not recognizing one or more of the
video modes that the card is supposed to be able to support, you may need to
load a VESA driver.  In particular, Diamond video cards seem to have the most
problems with graphics software, including programs like CSHOW.

You can usually get a VESA driver from your video card or computer
manufacturer.  Many video cards include a software program which supports
VESA when the video card does not support VESA by itself.

There are several VESA drivers available on local BBS systems, CompuServe,
America Online and GEnie, such as UniVESA (UVBE*.ZIP).  UniVESA has been
reported to us to cause incomplete VESA support and some compatibility
problems after running Windows with some video cards.  We have been unable
to determine the extent of UniVESA's support except that it works well for
some video systems.

Standard Modes:
  Hercules 720x348 (Monochrome)
  CGA      640x200 (Monochrome)
       320x200 (4 color)
  EGA       320x200, 640x200, 640x350 (16 color)
  VGA       640x480 (Monochrome)
       640x480 (16 color)
       320x200 (256 color)

Tweeked VGA Modes:
  VGA       320x240, 320x400, 360x480 (256 color)

VESA Modes
  VESA       800x600, 1024x768, 1280x1024 (16 color)
       640x400, 640x480, 800x600, 1024x768, 1280x1024 (256 color)
       320x200, 640x480, 800x600, 1024x768, 1280x1024 (32768 colors)
       320x200, 640x480, 800x600, 1024x768, 1280x1024 (65536 colors)
       320x200, 640x480, 800x600, 1024x768, 1280x1024 (16 million colors)

Other Non-Standard Modes:
  These modes occur on video cards that are detected to have specific support
  capabilities, and the list is really long.  If you are interested, please
  refer to the end of the GDS.TXT file, which should give you a lot of
  information about video modes.

Related Topics
    hlConfDiamondDiamond Video Cards
    hlConfOrchidOrchid Video Cards

:::hlConfFile
GDS Configuration Files

GDS configures runtime defaults using configuration files called GDSUSER.CFG
and GDSLOCAL.CFG.

GDSUSER.CFG is the main configuration file for GDS.  Any command line
parameter GDS is capable of taking can be placed in GDSUSER.CFG by specifying
the parameter on a line preceeded by "auto,".  For example,

    ------- (top of GDSUSER.CFG)

    auto,/QUIET        ;this line disables the opening screen

    ------- (bottom of GDSUSER.CFG)

You can also put more than one command line parameter per line, as follows:

    auto,/QUIET /A0        ;this line disables the opening screen and
                ;disables antialiasing

Any semicolon (';') on a line in a configuration file tells GDS to ignore
everything following the semicolon.  This is handy to remove configuration
options temporarily without deleting the lines:

    ;auto,/QUIET /A0    ;this line now does nothing

Semicolons are great for adding comments to configuration lines (as in the
above examples.)  These Semicolons are sometimes called "comment characters."
You can use comment character to help you switch quickly between differing
configurations, as in the following example:

    auto,/#LPT1 /~J0    ;use the monochrome laser printer
    ;auto,/#LPT2 /~J1    ;use the color inkjet printer

With these two lines, you can switch between two printers by just moving the
semicolons, and commenting out alternate lines:

    ;auto,/#LPT1 /~J0    ;use the monochrome laser printer
    auto,/#LPT2 /~J1    ;use the color inkjet printer

The first example above would print using a monochrome laser printer on LPT1.
The second example would support a color inkjet printer on LPT2.

It may be useful to just put a general comment in the file, which you can do
like this:

;These lines are just ignored
;by GDS when it starts up, and
;it doesn't really waste any time
;at startup.

When GDS starts up, it searches first for video mode information, then for
GDSUSER.CFG, and finally for GDSLOCAL.CFG.  When the same parameter is
encountered more than once, the last parameter takes precedence.
GDSLOCAL.CFG has the "last say" for which parameters are actually used.  It
is common to have configuration options in GDSLOCAL.CFG which override the
parameters in GDSUSER.CFG.

GDS searches for these files by first looking in the directory that DOS was
logged to when GDS was invoked.  This is not necessarily the directory that
GDS is stored in.  You can completely replace GDSUSER or GDSLOCAL by starting
GDS in a directory which contains GDSUSER.CFG and/or GDSLOCAL.CFG

If a configuration file does not exist in the startup directory, then GDS
searches the directory containing GDS.  If the file still cannot be found,
GDS quietly assumes that it doesn't exist.  This is a slick way to force GDS
to use only the static runtime defaults shipped with the program.

Organizations cataloging hundreds (and thousands) of files find it invaluable
to use GDSLOCAL.CFG to store the command line parameters for the catalog
creation.  This way, they can just start GDS from the directory containing the
file and let GDS go.

Related Topics
    hlHowToCLCatalogCatalogs from the Command Line


:::hlConfTest
How Each Video Mode is Tested

GDS performs the following tests to see if a mode works:

1) Set the video mode using standard BIOS INT 10h.

2) Checks several VGA registers to see if the video hardware looks as if it
   is generating graphics rather than text.

3) Checks the bank selection and determines how the bank selection should be
   carried out.  Note that many VESA BIOSes have bugs in the bank selection,
   which prevents some modes from being allowable by GDS.

If ANY Of these automatic tests fails, GDS assumes that the mode cannot work
properly, and the mode is thrown away.  On several cards, there are runs of
modes which do not pass these tests, causing slight flicker on the screen
as GDS throws the modes away.

The raw technicalities of how GDS checks for these things is beyond the scope
of this text.


:::hlConfInst
How to Configure GDS

In order to ensure that each video mode is supported by GDS, each mode must be
tested by GDS and approved by you.  This process ensures that when GDS shows
a picture, you see it properly.

GDS sets each mode and analyzes it to determine if it is functioning properly.
For more information about the technical attributes of the test, see hlConfTestHow Each
hlConfTestMode is Tested.

You may want to read the section called hlConfQuirksConfiguration Quirks section
for help with quirky setups with some specific video hardware.

The configuration process is simple:

1) GDS draws a test pattern for each screen mode and allows you to type [Y] or
   [N] for "Yes" or "No".  If a mode looks ok, then press [Y] after you hear
   the beep.

   If there's no beep for 15-20 seconds, the machine has crashed.  See
   hlConfCrashCrashing Modes.

   If the mode looks good, press [Y].  If not, see hlConfBadModeBad Looking Modes.

2) When you press [Y] or [N], GDS immediately continues on to the next mode.
   This allows you to type [Y] over and over again to whiz through the
   configuration.  It is not a good idea to type [Y] before you hear the beep.

3) The monitor may not be able to synchronize to all of the modes tested.  If
   the video card is capable of higher resolution modes than the monitor
   supports, then the screen may scroll in various directions, shear, move
   around and flicker.

   Check the utilities which come with your video card.  Some cards support
   lower resolution monitors by supporting interlaced video modes.  Older
   video cards may need to have switches set in order to support interlaced
   monitors.

4) The screen may flicker between modes if GDS finds modes that your card
   does not support.  This behavior is normal.

   If this happens, just hit [N] when you hear the beep because the screen is
   "NOT OK TO USE".

When the video modes have all been approved, GDS prompts you to save the
configuration file.  It is best to save it by pressing [Enter] so you don't
have to go through the process again.


:::hlConfQuirks
Configuration Quirks

    hlConfDiamondDiamond Video Cards
    hlConfOrchidOrchid Video Cards

:::hlConfOrchid
Orchid Video Cards

Orchid has produced many cards with BIOS bugs.  Read the section below which
matches your video card.

Orchid Farenheit 1280
    GDS automatically detects the Farenheit 1280 and tries to work around
    the problems with the video BIOS.

    If you are having problems with the F1280, call Orchid and ask for a
    BIOS upgrade.  Make sure that they check the version number of the
    BIOS with the version number printed on the BIOS chip in your card so
    everyone knows if there is a BIOS update available or not.  Some
    Photodex customers with Orchid cards have been told that there is no
    update when there was.

Orchid Kelvin
    GDS should work properly with this card, but there have been some
    reports of problems.  If you encounter trouble, please hlPhotodexcall.

:::hlConfDiamond
Diamond Video Cards

Diamond Computers has produced many cards with BIOS bugs.  Read the section
below which matches your video card.

Diamond Stealth
    GDS automatically detects the Stealth and tries to work around most
    of the problems with the Stealth.  There are known problems with the
    1280x960x16 and 1280x1024x16 modes.  They almost work, but not all of
    the graphics data is displayed in these modes.  Unfortunately, there
    is nothing GDS can do about the BIOS bugs with these two modes.

    Make sure you have run STLMODE before running GDS, or VESA will not
    work and may crash your machine.  We recommend adding the following
    line to your AUTOEXEC.BAT file:

        STLMODE VESA

Diamond Stealth Pro
    GDS automatically detects the Stealth and tries to work around most
    of the problems with the Stealth Pro.

    Make sure you have run STLMODE before running GDS, or VESA will not
    work and may crash your machine.  We recommend adding the following
    line to your AUTOEXEC.BAT file:

        STLMODE VESA

Diamond Stealth 64
    GDS automatically detects the Stealth 64 and tries to work around
    most of the problems with the Stealth 64.

    Make sure you have run S64MODE before running GDS.  Refer to the
    documentation that came with the card.  If you have trouble, contact
    Diamond Computers.

Diamond Viper VLB/PCI
    Make sure you have run VPRMODE before running GDS, or VESA will not
    work and may crash your machine.  We recommend adding the following
    line to your AUTOEXEC.BAT file:

        VPRMODE VESA

:::hlConfBadMode
Bad Looking Modes

Sometimes, GDS will try to display a test screen and give the beep because it
wants to know what you think of the current mode.  The only problem is that
the mode doesn't work right.

There are several reasons why modes don't work ok.  Some are correctable and
some are not.  Use the following list to determine what to do after you hear
the beep, but are not satisfied with the test pattern:

  If you've heard a beep, but see one of the following:

    Nothing:    The mode is dead, type [N] to kill the mode and
            continue.

    Moving Junk:    The monitor can't sync to the mode.  Type [N] quickly
            to kill the mode and continue.

    Solid Junk:    If the screen is not jumping or moving around, the
            mode may be correctable.  Try to use the left and
            right arrow keys to adjust the skew (number of
            logical bytes per line).  If this works, the video
            card's BIOS may have bugs in the VESA support.

    Squished Left:    If the screen looks scrunched a bit to the left and
            has color artifacts, but is generally greenish or
            gray, the mode may be an improperly reported 32bpp
            24 bit color mode.  Try typing '3' to try 32 bit
            mode, or '2' for 24 bit mode.


:::hlConfRept
Repeated Configurations

If GDS keeps putting you through the configuration every time you run GDS,
then remove the semicolon (';') before the following line in hlConfFileGDSUSER.CFG:

  auto,/ok    ;assume CONFIG file is ok

GDS checks the very beginning of the video BIOS to determine if the video
hardware has changed, and automatically reconfigures video modes when it has.
Some very recent video cards change the contents of the video BIOS, which
tricks GDS into thinking they are a new video card.  The "/OK" switch
prevents GDS from automatically reconfiguring the video modes because of a
video BIOS change.

If a BIOS change does occur, GDS prompts to allow you to reconfigure or not.

:::hlConfCrash
Crashing Modes

If GDS crashes immediately after starting the configuration process, try using
the hl/LAPTOP/LAPTOP command line parameter when running GDS.  If this does
not solve the problem, call hlPhotodexPhotodex for help.

IF YOU FIND A CRASHING MODE, call us and tell us.  If we know about it, we may
be able to fix the problem, or at least force GDS to not try that particular
mode with the particular card you have.

Sometimes video cards have such severe bugs that they can crash the entire
machine.  If the machine hangs for more than about 15-20 seconds with no
noticeable screen change, then the video BIOS has probably crashed the system.

The usual case is where the first few modes work ok, and then GDS attempts to
support an SVGA mode via the BIOS, which locks the machine.  You need to
identify the mode BEFORE the offending mode and delete it manually.

Follow these steps carefully to avoid a crashing mode:

1) Start GDS again, and remember the resolution and number of bits displayed
   at the upper left of each screen as you type [Y] to accept it (or [N] to
   reject it.)  This should be a number like 640x480x256, or 1024x768x65536.
   When the machine locks up again, you will now know the mode just before
   the mode to be omitted.

2) Reboot your machine.

3) Start GDS again, and go through the modes until the test screen appears
   for the mode you've remembered from step 1.  Press [Enter] to force GDS
   into text mode.  This prevents GDS from trying to set any graphics modes.

*NOTE:    This text display shows the resolutions in the text window, but never
    attempts to actually set the mode.  Because of this, you are "blind"
    as to whether or not the mode actually works, but this allows you to
    skip over modes which do not work at all.

4) Approve (or disapprove) the mode mentioned in step 1 by pressing [Y] to
   accept the mode (or [N] to reject it).

5) The mode which has a problem will now appear displayed in the text window.
   Press [N] to omit the mode from the mode list.

6) Now you should be looking at a new resolution that you haven't seen before,
   which is the mode AFTER the one which was causing the problem.  If you
   press [Enter], GDS will go into the graphics configuration mode again, and
   attempt to show you a test screen for the mode.

*NOTE:    BEWARE that video cards with bad modes may have more than one bad
    mode, and they could appear one after another.  If the machine locks
    up again, then you need to skip the modes as described above without
    going into graphics mode again.  Using steps 1-6, you can pop in and
    out of text and graphics (test screen) mode as much as you like.

:::hlConfPU
Power User's Configuration Quick-Start

The following points will save you as much time as possible, and assume that
you know basically what you're doing.  DO NOT take anything for granted or
assume that GDS is screwed up.  If you have a strange problem, try
hlPhotodexcalling before giving up.  We'd like to get your feedback.

1) DO NOT hit [Esc] to exit the configuration because you're impatient.  A
   successful configuration usually takes 30-60 seconds to complete.

2) When GDS beeps during configuration, it's waiting for a keystroke after
   displaying a screen.  Don't assume the machine has crashed until 15 seconds
   happens before a noticeable change is seen or beep is heard.  Some video
   cards take a long time to set some video modes.

3) When GDS beeps, it means that the software believes that the current mode
   works, and GDS has drawn a valid test pattern.  If you see:

    Nothing:    The mode is dead, type [N] to kill the mode and
            continue.

    Moving Junk:    The monitor can't sync to the mode.  Type [N] quickly
            to kill the mode and continue.

    Solid Junk:    If the screen is not jumping around, the mode may
            be good.  Try to use the left and right arrow keys to
            adjust the skew (number of logical bytes per line).
            If this works, the VESA BIOS may have bugs.

    Almost Ok:    If the screen looks scrunched a bit to the left and
            has color artifacts but is generally greenish or gray,
            the mode may be an improperly reported 32bpp 24 bit
            color mode.  Try typing '3' to try 32 bit mode, or
            '2' for 24 bit mode.

4) If a mode crashes the machine, refer to hlConfCrashCrashing Modes.

5) Watch to see that 15, 16 and 24 bit modes have RED and BLUE correct in the
   upper left area of the screen.  Type [S] to swap RED and BLUE.

QUICK NOTE:  If you have a VESA compatible SVGA and GDS doesn't recognize all
of the modes the card is supposed to support, delete the file called "CONFIG"
and run GDS again by specifying hlCmdVH/VESA on the command line
(Type: GDS hlCmdVH/VESA).

Related Topics
    hlCmdVHVideo Hardware Parameters
    hlRevRevision History


:::hlHelp
Help With Help

You are using GDS's built-in hypertext help system.  Help is divided into
messages, which may contain text buttons which link to other help messages.
This help system is similar to the Windows help system.

To scroll the screen up and down, you can use the page and arrow keys, or move
the mouse to the top and bottom of the screen.

Text buttons are displayed in bright white, and can be selected by clicking on
them, or by using the [Tab] and [Enter] keys to switch buttons and finally
select one.

To exit a GDS help message, press the [Esc] key or click the mouse at the top
of the help screen.  Note that you can be into help several levels deep, so
exiting multiple help messages may be necessary to get all the way out of
help.


     [Up]    [PgUp]
            Scroll the screen (mouse works also)
    [Down]    [PgDn]
:::GDS.CFG
;VIDEO CONFIGURATION FILE FORMAT:
;
;  This file was created to support GDS.  It is also a great reference
;  of most video modes supported on a lot of cards, but in no way is a
;  "complete" or fully tested list.  Use this list at your own risk.
;  If you use this list in software, please give Paul Schmidt credit
;  for the effort of creating this list.  It's a lot of work.  The
;  author assumes no responsibility for the accuracy of this list.
;
;  If you discover errors, ommissions, or have suggestions, please
;  contact Photodex and specifically reference the GDS.CFG file.
;

;NOTE:  Any ';' will cause GDS to ignore to the end of the line.
;       If a video mode is giving you problems, you can disable it
;       by inserting a ';' in front of the line which describes it.

;auto,/NAME        ;FOR 256K VGA CARDS:  Remove the semicolon just
            ;before "auto", replace "/NAME" with the video
            ;card name matching your VGA card.

;auto,/NAME /512    ;FOR 512K VGA CARDS:  Remove the semicolon just
            ;before "auto", replace "/NAME" with the video
            ;card name matching your VGA card.

;auto,/NAME /1M        ;FOR 1024K VGA CARDS:  Remove the semicolon just
            ;before "auto", replace "/NAME" with the video
            ;card name matching your VGA card.


;Argument Definitions
;<name> is the name of the video display (7 characters MAXIMUM)
;<hRes> and <vRes> are the screen resolution
;<bpix> is the number of bits per pixel
;<ax>, <bx>, <cx>, and <dx> are the processor registers on a call to
;           "int 010h" unless <directFlag> is non-zero
;<dirct> indicates the base address for text modes, and tells if
;           the graphics mode should be initialized by directly
;           accessing the VGA registers. (0, 1, or text base address)
;
;<format> dictates the screen format (0 is normal, 1 is chunky 4-bit)
;
;<name>    <hRes>    <vRes>    <bpix>    <ax>    <bx>    <cx>    <dx>    <dirct>    <dotMode>

;dot modes:
;    0 = standard planar 16 or bytewide 256 color mapping
;    1 = 4 bit chunky
;    2 = planar 256 color (tweeked VGA modes)
;    3 = TIGA modes (automatically detected)
;    5 = Sierra Hi-Color DAC (32,768 colors)
;        NOTE: Sierra DAC Hi-Color modes are automatically queried for
;        BIOS support if the <ax> value is set to 0x10f0.  If you know
;        the mode number of a Hi-Color mode for your card, you may set
;        the values of the <ax> and <bx> registers to something
;        other than 0x10f0, and GDS will assume the mode is supported.
;    6 = RESERVED (DO NOT USE THIS)
;    7 = Hercules monochrome
;    8 = CGA monochrome
;    9 = 4 bit chunky reverse order (BARF)
;    10 = 24 bit DAC (16M colors) Standard order: RGB
;        NOTE: Some 24 bit DAC modes are automatically queried for
;        BIOS support if the <ax> value is set to 0x10e0.  If you know
;        the mode number of a 24 bit mode for your card, you may set
;        the values of the <ax> and <bx> registers to something
;        other than 0x10e0, and GDS will assume the mode is supported.
;    11 = 24 bit DAC (16M colors) Reverse order: BGR
;    12 = 24 bit DAC (16M colors) Standard order: RGBX
;        NOTE: Some 24 bit DAC modes are automatically queried for
;        BIOS support if the <ax> value is set to 0x10e0.  If you know
;        the mode number of a 24 bit mode for your card, you may set
;        the values of the <ax> and <bx> registers to something
;        other than 0x10e0, and GDS will assume the mode is supported.
;    13 = 24 bit DAC (16M colors) Reverse order: BGRX

;HERCULES
HERC,    720,    348,    1,    0,    0,    0,    0,    1,    7    ;hercules

;STANDARD CGA
CGA,    640,    200,    1,    0x6,    0,    0,    0,    0,    8    ;CGA monochrome
CGA,    320,    200,    2,    0x4,    0,    0,    0,    0,    0

;STANDARD EGA
EGA,    80,    25,    0,    0x3,    0,    0,    0,    0xb800,    0    ;default text mode
EGA,    320,    200,    4,    0xd,    0,    0,    0,    0,    0
EGA,    640,    200,    4,    0xe,    0,    0,    0,    0,    0
EGA,    640,    350,    4,    0x10,    0,    0,    0,    0,    0

;STANDARD VGA
VGA,    640,    480,    1,    0x11,    0,    0,    0,    0,    0
VGA,    640,    480,    4,    0x12,   0,    0,    0,    0,    0
VGA,    320,    200,    8,    0x13,    0,    0,    0,    0,    0

;NON-STANDARD VGA (FOR REGISTER COMPATIBLE VGA CARDS ONLY!!!)
VGA,    320,    240,    8,    0,    0,    0,    0,    1,    2    ;works only with register compatible VGAs!
VGA,    320,    400,    8,    0,    0,    0,    0,    1,    2    ;works only with register compatible VGAs!
VGA,    360,    480,    8,    0,    0,    0,    0,    1,    2    ;works only with register compatible VGAs!
;VGA,    704,    528,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
;VGA,    720,    540,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
;VGA,    736,    552,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
;VGA,    752,    564,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
;VGA,    768,    576,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
;VGA,    784,    588,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
;VGA,    800,    600,    4,    0,    0,    0,    0,    1,    0    ;works only with register compatible VGAs!
;VGA,    640,    400,    8,    0,    0,    0,    0,    1,    0    ;works with some register compatible VGAs!
;   NOTE: If you'd like to use these modes (and you have a registered
;    version), we strongly recommended that you move these definitions
;    into GDSUSER.CFG and remove the semicolons (';').  This will prevent
;    new versions from overwriting your preferences.  Unregistered
;    versions of GDS do not read GDSUSER.CFG.

;AHEAD SYSTEMS
AHEAD,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
AHEAD,    132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0
AHEAD,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
AHEAD,    160,    50,    0,    0x2f,    0,    0,    0,    0xb800,    0
AHEAD,    80,    66,    0,    0x34,    0,    0,    0,    0xb800,    0
AHEAD,    1024,    768,    2,    0x75,    0,    0,    0,    0,    0
AHEAD,    640,    400,    8,    0x60,    0,    0,    0,    0,    0
AHEAD,    640,    480,    8,    0x61,    0,    0,    0,    0,    0
AHEAD,    800,    600,    8,    0x62,    0,    0,    0,    0,    0

;AHEAD SYSTEMS
AHEADB,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
;AHEADB, 132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0    ;not on all cards
AHEADB,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
;AHEADB, 160,    50,    0,    0x2f,    0,    0,    0,    0xb800,    0    ;not on all cards
;AHEADB, 80,    66,    0,    0x34,    0,    0,    0,    0xb800,    0    ;not on all cards
AHEADB,    1024,    768,    2,    0x75,    0,    0,    0,    0,    0
AHEADB,    800,    600,    4,    0x6a,    0,    0,    0,    0,    0
AHEADB,    1024,    768,    4,    0x74,    0,    0,    0,    0,    0
AHEADB,    640,    400,    8,    0x60,    0,    0,    0,    0,    0
AHEADB,    640,    480,    8,    0x61,    0,    0,    0,    0,    0
AHEADB,    800,    600,    8,    0x62,    0,    0,    0,    0,    0
AHEADB,    1024,    768,    8,    0x63,    0,    0,    0,    0,    0

;ATI Wonder
ATI,    80,    30,    0,    0x5b,    0,    0,    0,    0xb800,    0
ATI,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
ATI,    132,    44,    0,    0x33,    0,    0,    0,    0xb800,    0
ATI,    1024,    768,    2,    0x67,   0,    0,    0,    0,    1
ATI,    800,    600,    4,    0x54,   0,    0,    0,    0,    0
;ATI,    1024,    768,    4,    0x55,   0,    0,    0,    0,    0    ;bank selection for video reads
                                        ;doesn't seem to work properly in
;ATI,    1024,    768,    4,    0x65,   0,    0,    0,    0,    1
ATI,    640,    400,    8,    0x61,    0,    0,    0,    0,    0
ATI,    640,    480,    8,    0x62,    0,    0,    0,    0,    0
ATI,    800,    600,    8,    0x63,    0,    0,    0,    0,    0
ATI,    1024,    768,    8,    0x64,   0,    0,    0,    0,    0
ATI,    640,    480,    15,    0x72,    0,    0,    0,    0,    5

;CHIPS & TECHNOLOGIES
CHIPS,    132,    25,    0,    0x60,    0,    0,    0,    0xb800,    0
CHIPS,    132,    50,    0,    0x61,    0,    0,    0,    0xb800,    0
CHIPS,    800,    600,    4,    0x70,    0,    0,    0,    0,    0
CHIPS,    1024,    768,    4,    0x72,    0,    0,    0,    0,    0
CHIPS,    640,    400,    8,    0x78,    0,    0,    0,    0,    0
CHIPS,    640,    480,    8,    0x79,    0,    0,    0,    0,    0
CHIPS,    768,    576,    8,    0x7a,    0,    0,    0,    0,    0
CHIPS,    800,    600,    8,    0x7b,    0,    0,    0,    0,    0

;CIRRUS 510,520 - MaxLogic MaxVGA
CIRRUS,    132,    25,    0,    0x1f,    0,    0,    0,    0xb800,    0
CIRRUS,    132,    30,    0,    0x22,    0,    0,    0,    0xb800,    0
CIRRUS,    132,    44,    0,    0x20,    0,    0,    0,    0xb800,    0
CIRRUS,    720,    540,    4,    0x40,    0,    0,    0,    0,    0
CIRRUS,    800,    600,    4,    0x6a,    0,    0,    0,    0,    0
CIRRUS,    640,    400,    8,    0x50,    0,    0,    0,    0,    2
;CIRRUS, 512,    480,    8,    0x51,    0,    0,    0,    0,    0    ;NOTE: use only with the TSR BIOS extension!

;CL54 54xx - Cirrus Logic SVGA Chips
CL54,    132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
CL54,    132,    43,    0,    0x54,    0,    0,    0,    0xb800,    0
CL54,    132,    60,    0,    0x53,    0,    0,    0,    0xb800,    0    ;if you're brave
CL54,    800,    600,    4,    0x58,    0,    0,    0,    0,    0
CL54,    1024,    768,    4,    0x5d,    0,    0,    0,    0,    0
CL54,    1280,    1024,    4,    0x6c,    0,    0,    0,    0,    0
CL54,    640,    480,    8,    0x5f,    0,    0,    0,    0,    0
CL54,    800,    600,    8,    0x5c,    0,    0,    0,    0,    0
CL54,    1024,    768,    8,    0x60,    0,    0,    0,    0,    0
CL54,    1280,    1024,    8,    0x6d,    0,    0,    0,    0,    0
CL54,    640,    480,    15,    0x66,    0,    0,    0,    0,    5
CL54,    800,    600,    15,    0x67,    0,    0,    0,    0,    5
CL54,    640,    480,    16,    0x64,    0,    0,    0,    0,    0
CL54,    800,    600,    16,    0x65,    0,    0,    0,    0,    0
CL54,    1024,    768,    16,    0x74,    0,    0,    2048,    0,    0
CL54,    320,    200,    24,    0x70,    0,    0,    2048,    0,    11
CL54,    640,    480,    24,    0x71,    0,    0,    2048,    0,    11

;EVEREX
EVEREX,    800,    600,    4,    0x70,    0x02,    0,    0,    0,    0
EVEREX,    640,    350,    8,    0x70,    0x13,    0,    0,    0,    0
EVEREX,    640,    400,    8,    0x70,    0x14,    0,    0,    0,    0
EVEREX,    512,    480,    8,    0x70,    0x15,    0,    0,    0,    0
EVEREX,    640,    480,    8,    0x70,    0x30,    0,    0,    0,    0
EVEREX,    800,    600,    8,    0x70,    0x31,    0,    0,    0,    0

;EV634 - EVEREX Viewpoint Premium VGA (EV-634)
EV634,    80,    30,    0,    0x70,    0x16,    0,    0,    0xb800,    0
EV634,    80,    34,    0,    0x70,    0x03,    0,    0,    0xb800,    0
EV634,    80,    60,    0,    0x70,    0x04,    0,    0,    0xb800,    0
EV634,    100,    37,    0,    0x70,    0x18,    0,    0,    0xb800,    0
EV634,    100,    43,    0,    0x70,    0x07,    0,    0,    0xb800,    0
EV634,    100,    75,    0,    0x70,    0x08,    0,    0,    0xb800,    0
EV634,    132,    25,    0,    0x70,    0x0a,    0,    0,    0xb800,    0
EV634,    132,    30,    0,    0x70,    0x40,    0,    0,    0xb800,    0
EV634,    132,    44,    0,    0x70,    0x0b,    0,    0,    0xb800,    0
EV634,    1024,    768,    2,    0x70,    0x60,    0,    0,    0,    0    ;this mode seems to exist only in the documentation...
EV634,    800,    600,    4,    0x70,    0x02,    0,    0,    0,    0
EV634,    1024,    768,    4,    0x70,    0x20,    0,    0,    0,    0
EV634,    1280,    1024,    4,    0x70,    0x21,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
EV634,    1664,    1200,    4,    0x70,    0x23,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
EV634,    640,    400,    8,    0x70,    0x14,    0,    0,    0,    0
EV634,    512,    480,    8,    0x70,    0x15,    0,    0,    0,    0
EV634,    640,    480,    8,    0x70,    0x30,    0,    0,    0,    0
EV634,    800,    600,    8,    0x70,    0x31,    0,    0,    0,    0
EV634,    1024,    768,    8,    0x70,    0x32,    0,    0,    0,    0
EV634,    320,    200,    15,    0x70,    0x62,    0,    0,    0,    5
EV634,    512,    480,    15,    0x70,    0x70,    0,    0,    0,    5
EV634,    640,    480,    15,    0x70,    0x71,    0,    0,    0,    5
EV634,    800,    600,    15,    0x70,    0x63,    0,    0,    0,    5

;ORCHID Farenheit 1280 (S3)
F1280,    132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
F1280,    132,    44,    0,    0x54,    0,    0,    0,    0xb800,    0
F1280,    800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
F1280,    1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
F1280,    1280,    960,    4,    0x4f02,    0x206,    0,    1024,    0,    9
F1280,    1280,    1024,    4,    0x4f02,    0x208,    0,    1024,    0,    1    ;NOTE: Way cool monitors only!
F1280,    640,    480,    8,    0x4f02,    0x201,    0,    1024,    0,    0
F1280,    800,    600,    8,    0x4f02,    0x203,    0,    1024,    0,    0
F1280,    1024,    768,    8,    0x4f02,    0x205,    0,    0,    0,    0
F1280,    640,    480,    15,    0x4f02,    0x301,    0,    2048,    0,    5

;GENOA 6000 series (6100, 6200, 6300, 6400, 6600)
;      THANX: Herman, Steve, and Decker w/Genoa customer support
GENOA,    80,    32,    0,    0x58,    0,    0,    0,    0xb800,    0
GENOA,    80,    60,    0,    0x72,    0,    0,    0,    0xb800,    0
GENOA,    80,    66,    0,    0x74,    0,    0,    0,    0xb800,    0
GENOA,    100,    37,    0,    0x78,    0,    0,    0,    0xb800,    0
GENOA,    132,    25,    0,    0x60,    0,    0,    0,    0xb800,    0
GENOA,    132,    29,    0,    0x61,    0,    0,    0,    0xb800,    0
GENOA,    132,    32,    0,    0x62,    0,    0,    0,    0xb800,    0
GENOA,    132,    44,    0,    0x63,    0,    0,    0,    0xb800,    0
GENOA,    132,    60,    0,    0x64,    0,    0,    0,    0xb800,    0
GENOA,    1024,    768,    2,    0x7f,    0,    0,    0,    0,    0
GENOA,    800,    600,    4,    0x79,    0,    0,    0,    0,    0
GENOA,    1024,    768,    4,    0x5f,    0,    0,    0,    0,    0
GENOA,    640,    400,    8,    0x7e,    0,    0,    0,    0,    0
GENOA,    640,    480,    8,    0x5c,    0,    0,    0,    0,    0
GENOA,    800,    600,    8,    0x5e,    0,    0,    0,    0,    0
;GENOA,    100,    75,    0,    0x79,    0,    0,    0,    0xb800,    0    ;I think these are dead modes from a
;GENOA,    512,    512,    4,    0x7c,    0,    0,    0,    0,    0    ;   beta version of Genoa's BIOS
;GENOA,    720,    512,    4,    0x59,    0,    0,    0,    0,    0
;GENOA,    512,    512,    8,    0x7d,    0,    0,    0,    0,    0
;GENOA,    640,    350,    8,    0x5b,    0,    0,    0,    0,    0
;GENOA,    720,    512,    8,    0x5d,    0,    0,    0,    0,    0

;OAKTECH
OAK,    132,    25,    0,    0x50,    0,    0,    0,    0xb800,    0
OAK,    132,    43,    0,    0x51,    0,    0,    0,    0xb800,    0
OAK,    132,    60,    0,    0x4f,    0,    0,    0,    0xb800,    0
OAK,    800,    600,    4,    0x52,    0,    0,    0,    0,    0
OAK,    1024,    768,    4,    0x56,    0,    0,    0,    0,    0
OAK,    640,    480,    8,    0x53,    0,    0,    0,    0,    0
OAK,    800,    600,    8,    0x54,    0,    0,    0,    0,    0

;PARADISE (Paradise VGA 1024)
;PARA,   800,    600,    8,      0x59,   0,      0,      0,      0,      0 ;Genoa 8500
;PARA,  1024,    768,    8,      0x5a,   0,      0,      0,      0,      0 ;Genoa 8500
PARA,   132,    25,     0,      0x55,   0,      0,      0,      0,      0
PARA,   132,    43,     0,      0x54,   0,      0,      0,      0,      0
PARA,    800,    600,    1,    0x59,    0,    0,    0,    0,    0
PARA,    1024,    768,    1,    0x5a,    0,    0,    0,    0,    0    ;is SMT-1024 mode 0x5c for this?
PARA,    1024,    768,    2,    0x5b,    0,    0,    0,    0,    0    ;is SMT-1024 mode 0x5c for this?
PARA,   800,    600,    4,      0x58,   0,      0,      0,      0,      0
PARA,   1024,   768,    4,      0x5d,   0,      0,      0,      0,      0 ;is SMT-1024 mode 0x5c for this?
PARA,  1280,    960,    4,      0x6C,   0,      0,      0,      0,      0
PARA,  1280,   1024,    4,      0x64,   0,      0,      0,      0,      0
PARA,   640,    400,    8,      0x5e,   0,      0,      0,      0,      0
PARA,   640,    480,    8,      0x5f,   0,      0,      0,      0,      0
PARA,   800,    600,    8,      0x5c,   0,      0,      0,      0,      0
PARA,  1024,    768,    8,      0x60,   0,      0,      0,      0,      0
PARA,   640,    480,   15,      0x62,   0,      0,      0,      0,      5
PARA,   800,    600,   15,      0x63,   0,      0,      0,      0,      5
PARA,   640,    480,   24,      0x72,   0,      0,      0,      0,     10

;Diamond Computer Speedstar 24X (*NOT* Speedstar 24)
SS24X,    80,    34,    0,    0x41,    0,    0,    0,    0,    0
SS24X,    80,    43,    0,    0x67,    0,    0,    0,    0,    0
SS24X,    80,    50,    0,    0x66,    0,    0,    0,    0,    0
SS24X,    132,    25,    0,    0x55,    0,    0,    0,    0,    0
SS24X,    132,    28,    0,    0x47,    0,    0,    0,    0,    0
SS24X,    132,    43,    0,    0x54,    0,    0,    0,    0,    0
SS24X,    132,    44,    0,    0x21,    0,    0,    0,    0,    0
SS24X,    132,    50,    0,    0x69,    0,    0,    0,    0,    0
SS24X,    800,    600,    4,    0x58,    0,    0,    0,    0,    0
SS24X,    1024,    768,    4,    0x5d,    0,    0,    0,    0,    0
SS24X,    1280,    960,    4,    0x6c,    0,    0,    0,    0,    0
SS24X,    1280,    1024,    4,    0x64,    0,    0,    0,    0,    0
SS24X,    640,    400,    8,    0x5e,    0,    0,    0,    0,    0
SS24X,    640,    480,    8,    0x5f,    0,    0,    0,    0,    0
SS24X,    800,    600,    8,    0x5c,    0,    0,    0,    0,    0
SS24X,    1024,    768,    8,    0x60,    0,    0,    0,    0,    0
SS24X,    640,    480,    15,    0x62,    0,    0,    0,    0,    5
SS24X,    800,    600,    15,    0x63,    0,    0,    0,    0,    5
SS24X,    640,    480,    24,    0x72,    0,    0,    0,    0,    10

;Diamond Computer Stealth 64 (S3)
ST64,    640,    480,    24,    0x4f02,    0x112,    0,    4096,    0,    13
ST64,    800,    600,    24,    0x4f02,    0x115,    0,    4096,    0,    13
ST64,    1024,    768,    24,    0x4f02,    0x118,    0,    4096,    0,    13
ST64,    1152,    864,    24,    0x4f02,    0x20b,    0,    4608,    0,    13

;Diamond Computer Stealth VRAM (S3)
STEALTH,132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
STEALTH,132,    43,    0,    0x54,    0,    0,    0,    0xb800,    0
STEALTH,800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
STEALTH,1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
STEALTH,1280,    960,    4,    0x4f02,    0x206,    0,    1024,    0,    9
STEALTH,1280,    1024,    4,    0x4f02,    0x208,    0,    1024,    0,    9
STEALTH,640,    480,    8,    0x4f02,    0x101,    0,    640,    0,    0
STEALTH,800,    600,    8,    0x4f02,    0x103,    0,    1024,    0,    0
STEALTH,1024,    768,    8,    0x4f02,    0x105,    0,    0,    0,    0
STEALTH,640,    480,    15,    0x4f02,    0x301,    0,    2048,    0,    5

;Diamond Computer Stealth PRO (S3)
STPRO,132,    25,    0,    0x55,    0,    0,    0,    0xb800,    0
STPRO,132,    43,    0,    0x54,    0,    0,    0,    0xb800,    0
STPRO,800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
STPRO,1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
STPRO,1280,    960,    4,    0x4f02,    0x206,    0,    1024,    0,    9
STPRO,1280,    1024,    4,    0x4f02,    0x208,    0,    1024,    0,    9
STPRO,640,    480,    8,    0x4f02,    0x201,    0,    1024,    0,    0
STPRO,800,    600,    8,    0x4f02,    0x203,    0,    1024,    0,    0
STPRO,1024,    768,    8,    0x4f02,    0x205,    0,    0,    0,    0
STPRO,1280,    1024,    8,    0x4f02,    0x107,    0,    0,    0,    0
STPRO,640,    480,    15,    0x4f02,    0x301,    0,    2048,    0,    5
STPRO,640,    480,    16,    0x4f02,    0x211,    0,    2048,    0,    5
STPRO,800,    600,    16,    0x4f02,    0x114,    0,    0,    0,    5
STPRO,640,    480,    24,    0x4f02,    0x212,    0,    2048,    0,    10
STPRO,800,    600,    24,    0x4f02,    0x221,    0,    0,    0,    10

;TRIDENT (Trident TVGA / ATI Prism Elite / Everex Viewpoint VGA)
TRIDNT,    80,    30,    0,    0x50,    0,    0,    0,    0xb800,    0
TRIDNT,    80,    43,    0,    0x51,    0,    0,    0,    0xb800,    0
TRIDNT,    80,    60,    0,    0x52,    0,    0,    0,    0xb800,    0
TRIDNT,    132,    25,    0,    0x53,    0,    0,    0,    0xb800,    0
TRIDNT,    132,    30,    0,    0x54,    0,    0,    0,    0xb800,    0
TRIDNT,    132,    43,    0,    0x55,    0,    0,    0,    0xb800,    0
TRIDNT,    132,    60,    0,    0x56,    0,    0,    0,    0xb800,    0
;TRIDNT,132,    25,    0,    0x57,    0,    0,    0,    0xb800,    0    ;these four modes work, but
;TRIDNT,132,    30,    0,    0x58,    0,    0,    0,    0xb800,    0    ;don't seem to be necessary.
;TRIDNT,132,    43,    0,    0x59,    0,    0,    0,    0xb800,    0
;TRIDNT,132,    60,    0,    0x5a,    0,    0,    0,    0xb800,    0
TRIDNT,    1024,    768,    2,    0x60,    0,    0,    0,    0,    0
;TRIDNT, 768,    1024,    4,    0x61,    0,    0,    0,    0,    0    ;use portrait CRT ONLY!!! (Magics 15FP)
TRIDNT,    800,    600,    4,    0x5b,    0,    0,    0,    0,    0
TRIDNT,    1024,    768,    4,    0x5f,    0,    0,    0,    0,    0
TRIDNT,    640,    400,    8,    0x5c,    0,    0,    0,    0,    0
TRIDNT,    640,    480,    8,    0x5d,    0,    0,    0,    0,    0
TRIDNT,    800,    600,    8,    0x5e,    0,    0,    0,    0,    0
TRIDNT,    1024,    768,    8,    0x62,    0,    0,    0,    0,    0

;TSENG LABS ET3000 (STB VGA EM-16)
TSENG,    80,    60,    0,    0x26,    0,    0,    0,    0xb800,    0
TSENG,    100,    40,    0,    0x2a,    0,    0,    0,    0xb800,    0
TSENG,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
TSENG,    132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0
TSENG,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
TSENG,    800,    600,    4,    0x29,    0,    0,    0,    0,    0
TSENG,    1024,    768,    4,    0x37,    0,    0,    0,    0,    0
TSENG,    640,    350,    8,    0x2d,    0,    0,    0,    0,    0
TSENG,    640,    480,    8,    0x2e,    0,    0,    0,    0,    0
TSENG,    720,    512,    8,    0x2f,    0,    0,    0,    0,    0
TSENG,    800,    600,    8,    0x30,    0,    0,    0,    0,    0

;TSENG LABS ET4000
TSENG4,    80,    60,    0,    0x26,    0,    0,    0,    0xb800,    0
TSENG4,    100,    40,    0,    0x2a,    0,    0,    0,    0xb800,    0
TSENG4,    132,    25,    0,    0x23,    0,    0,    0,    0xb800,    0
TSENG4,    132,    28,    0,    0x24,    0,    0,    0,    0xb800,    0
TSENG4,    132,    44,    0,    0x22,    0,    0,    0,    0xb800,    0
TSENG4,    800,    600,    4,    0x29,    0,    0,    0,    0,    0
TSENG4,    1024,    768,    4,    0x37,    0,    0,    0,    0,    0
TSENG4,    640,    350,    8,    0x2d,    0,    0,    0,    0,    0
TSENG4,    640,    400,    8,    0x2f,    0,    0,    0,    0,    0
TSENG4,    640,    480,    8,    0x2e,    0,    0,    0,    0,    0
TSENG4,    800,    600,    8,    0x30,    0,    0,    0,    0,    0
TSENG4,    1024,    768,    8,    0x38,    0,    0,    0,    0,    0
TSENG4,    320,    200,    15,    0x10f0,    0x13,    0,    0,    0,    5    ;queried Sierra Hi-Color modes
TSENG4,    640,    350,    15,    0x10f0,    0x2d,    0,    0,    0,    5
TSENG4,    640,    400,    15,    0x10f0,    0x2f,    0,    0,    0,    5
TSENG4,    640,    480,    15,    0x10f0,    0x2e,    0,    0,    0,    5
TSENG4,    800,    600,    15,    0x10f0,    0x30,    0,    0,    0,    5
TSENG4,    320,    200,    15,    0x10f0,    0x13,    0,    0,    0,    5    ;queried Sierra Hi-Color modes
TSENG4,    640,    350,    15,    0x10f0,    0x2d,    0,    0,    0,    5
TSENG4,    640,    480,    24,    0x10e0,    0x2e,    0,    2048,    0,    10    ;queried 24 bit modes

;VESA (assumes all modes are present, comment out modes here which don't exist)
VESA,    800,    600,    4,    0x4f02,    0x102,    0,    0,    0,    0
VESA,    1024,    768,    4,    0x4f02,    0x104,    0,    0,    0,    0
VESA,    1280,    1024,    4,    0x4f02,    0x106,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
VESA,    640,    400,    8,    0x4f02,    0x100,    0,    0,    0,    0
VESA,    640,    480,    8,    0x4f02,    0x101,    0,    0,    0,    0
VESA,    800,    600,    8,    0x4f02,    0x103,    0,    0,    0,    0
VESA,    1024,    768,    8,    0x4f02,    0x105,    0,    0,    0,    0
VESA,    1280,    1024,    8,    0x4f02,    0x107,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
VESA,    320,    200,    15,    0x4f02,    0x10d,    0,    0,    0,    5
VESA,    640,    480,    15,    0x4f02,    0x110,    0,    0,    0,    5
VESA,    800,    600,    15,    0x4f02,    0x113,    0,    0,    0,    5
VESA,    1024,    768,    15,    0x4f02,    0x116,    0,    0,    0,    5
VESA,    1280,    1024,    15,    0x4f02,    0x119,    0,    0,    0,    5    ;NOTE: Way cool monitors only!
VESA,    320,    200,    16,    0x4f02,    0x10e,    0,    0,    0,    0
VESA,    640,    480,    16,    0x4f02,    0x111,    0,    0,    0,    0
VESA,    800,    600,    16,    0x4f02,    0x114,    0,    0,    0,    0
VESA,    1024,    768,    16,    0x4f02,    0x117,    0,    0,    0,    0
VESA,    1280,    1024,    16,    0x4f02,    0x11a,    0,    0,    0,    0    ;NOTE: Way cool monitors only!
VESA,    320,    200,    24,    0x4f02,    0x10f,    0,    0,    0,    10
VESA,    640,    480,    24,    0x4f02,    0x112,    0,    0,    0,    10
VESA,    800,    600,    24,    0x4f02,    0x115,    0,    0,    0,    10
VESA,    1024,    768,    24,    0x4f02,    0x118,    0,    0,    0,    10
VESA,    1280,    1024,    24,    0x4f02,    0x11b,    0,    0,    0,    10    ;NOTE: Way cool monitors only!

;VIDEO 7 (VEGA Deluxe, 1024i, VRAM VGA
VID7,    80,    43,    0,    0x6f05,    0x40,    0,    0,    0xb800,    0
VID7,    80,    60,    0,    0x6f05,    0x43,    0,    0,    0xb800,    0
VID7,    80,    67,    0,    0x6f05,    0x46,    0,    0,    0xb800,    0    ;may not be present (undocumented)
VID7,    100,    60,    0,    0x6f05,    0x44,    0,    0,    0xb800,    0
VID7,    132,    25,    0,    0x6f05,    0x41,    0,    0,    0xb800,    0
VID7,    132,    28,    0,    0x6f05,    0x45,    0,    0,    0xb800,    0
VID7,    132,    43,    0,    0x6f05,    0x42,    0,    0,    0xb800,    0
VID7,    1024,    768,    1,    0x6f05,    0x63,    0,    0,    0,    0
VID7,    1024,    768,    2,    0x6f05,    0x64,    0,    0,    0,    0
VID7,    720,    540,    4,    0x6f05,    0x61,    0,    0,    0,    0
VID7,    752,    410,    4,    0x6f05,    0x60,    0,    0,    0,    0
VID7,    800,    600,    4,    0x6f05,    0x62,    0,    0,    0,    0
VID7,    1024,    768,    4,    0x6f05,    0x65,    0,    0,    0,    0
VID7,    640,    400,    8,    0x6f05,    0x66,    0,    0,    0,    0
VID7,    640,    480,    8,    0x6f05,    0x67,    0,    0,    0,    0
VID7,    720,    540,    8,    0x6f05,    0x68,    0,    0,    0,    0    ;ONLY exists with V-RAM VGA
VID7,    800,    600,    8,    0x6f05,    0x69,    0,    0,    0,    0    ;ONLY exists with V-RAM VGA
VID7,    1024,    768,    8,    0x6f05,    0x6a,    0,    0,    0,    0    ;ONLY exists with V-RAM2 VGA
:::