home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / GDS107.ZIP / GDS.DOC < prev    next >
Text File  |  1991-02-28  |  63KB  |  1,330 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                      GDS - Graphics Display System
  12.                      -----------------------------
  13.  
  14.                         Written by Paul Schmidt
  15.                  Distributed by Phase II Electronics Inc.
  16.  
  17.  
  18.  
  19.                   Copyright (c) 1990,1991 Paul Schmidt
  20.                           All rights reserved.
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30. i. CONTENTS
  31. -----------
  32.  
  33. Legal Notices.............................................i
  34. Introduction.............................................ii
  35. Note About Use..........................................iii
  36. What GDS Can Do For You..................................iv
  37. What GDS Does NOT Do!.....................................v
  38.  
  39. Getting Started...........................................1
  40. The GDS Text Screen.......................................2
  41. Viewing Commands..........................................3
  42. Slide Shows...............................................4
  43. Antialiasing..............................................5
  44. Dithering.................................................6
  45. Command Line Parameters...................................7
  46. Configuration File Details................................8
  47. Common Problems And Solutions.............................9
  48. Bug Reports..............................................10
  49. Revision History.........................................11
  50.  
  51.  
  52.         GDS will be available in 3 versions...
  53.  
  54.                 1. This "demo" version.
  55.                 2. The ShareWare version for $35.
  56.                 3. The Full Blown Commercial version.
  57.                         (price not set at present.)
  58.  
  59.         Distribution and support will be provided by...
  60.  
  61.                 Phase II Electronics Inc.
  62.                 19 Sands Point Drive
  63.                 Toms River New Jersey 08755-5167
  64.                 Phone (908) 286-0080,  Fax (908) 349-3842
  65.                 Compuserve 76667,1522  Bob Holland
  66.  
  67. i. Legal Notices
  68. ----------------
  69. WARNING! The Author and/or the Distributors of GDS ESPECIALLY DO NOT
  70. ASSUME ANY RESPONSIBILITY FOR ANY LOSS OF SOFTWARE OR ANY OTHER EXPENSE
  71. OR INCONVENIENCE CAUSED BY THE BETA VERSIONS OF GDS.
  72.    This includes all versions up to and including GDS103 which contain
  73. several known serious programming errors.
  74.  
  75.  
  76. GDS107.ZIP may be distributed and used freely without ANY modifications
  77. to the program and/or the included documentation.  Any changes to the
  78. original distribution files will be considered an infringement on the
  79. rights of the author.
  80.  
  81.    Any attempt to disassemble and/or extract code from this product will
  82. be considered copyright infringement and is punishable by law.
  83.  
  84.    Phase II and associates hereby disclaims all warranties relating to
  85. this software, whether express or implied, including without limitation
  86. any implied warranties of merchantability or fitness for a particular
  87. purpose.  Phase II will not be liable for any special, incidental,
  88. consequential, indirect or similar damages due to loss of data/damage to
  89. hardware or any other reason, even if Phase II or an agent of Phase II
  90. has been advised of the possibility of such damages.  In no event shall
  91. Phase II's liability for any damages ever exceed the price paid for the
  92. license to use the software, regardless of the form of the claim.  The
  93. person using the software bears all risk as to the quality and
  94. performance of the software.
  95.  
  96.  
  97.  
  98. ii. INTRODUCTION
  99. ----------------
  100.  
  101.   One day, I was working on a simple card game and needed a variety of
  102. cardback graphics.  I referred to a library of GIF files for some good
  103. scenery to put on the backs of cards and found about 30 files which had
  104. nice scenery and pieces which could be used quite nicely.
  105.  
  106.   First, I converted a set of GIFs into IFF format and loaded them into
  107. Deluxe Paint II Enhanced.  Deluxe Paint is one of the more powerful paint
  108. programs, and I was very surprised to find that the brush size is limited
  109. to 64K (a forgivable programming limit).  After messing around with grids
  110. and reducing chunks of images down in a nice orderly fashion, I did not
  111. get the results that I wanted, I deleted the whole bunch.
  112.  
  113.   I was very happy to find a program called 'GIFDESK' on a bulletin
  114. board.  It seemed to be just what I was looking for, and it solved
  115. another problem for me also.  The documentation said it could reduce
  116. GIFs, but it was designed for cataloging pictures, rather than just image
  117. reduction.  Great!  Now I could get the graphics done, and I could
  118. catalog my 150 megabytes of GIFs!
  119.  
  120. WRONG.  GIFDESK is great for a simple catalog program, but it doesn't do
  121. much for preserving images.  The version I have simply grabs dots from
  122. the original and slaps them in a reduced space.  Although I'm not sure,
  123. it seems to also use a generic palette which further reduces the quality.
  124. In short, all images get stomped on, some are very simply unrecognizable.
  125.  
  126.   Another problem which was mounting in the back of my mind was that
  127. every GIF viewer I've seen either has mounds of technical problems/
  128. quirks/bugs, or a user interface that would scare the average user.
  129.  
  130.   I was disgusted, in between projects, and wired on coffee.  I
  131. downloaded CompuServe's GIF file specifications for encoding and decoding
  132. and got to work.  A day later, GDS 1.00 was a reality.
  133.  
  134.   I make no claims that GDS is everything.  The general outline of the
  135. program is based around a very few simple concepts, and there is
  136. certainly room for improvement.
  137.  
  138.   GDS also overcomes a lot of other problems like "odd aspect ratios" I
  139. have a number of very large or odd shaped GIF's that I have never been
  140. able to see the entire image before GDS.  Then there is the well known
  141. problem of "Oh that picture! You have to use ViewerX to see that one."
  142.  
  143.   The last but not least effort was to support the GIF89a file format.
  144. Reading and writing these files was no problem but we could not find
  145. another program that could view '89a with any reliability so the
  146. GIF "save" function was changed back to '87a.
  147.  
  148.  
  149. iii. NOTE ABOUT USE
  150. -------------------
  151.  
  152. ------------------------------------------------------------------------
  153. THE UNREGISTERED VERSIONS OF GDS DO NOT HAVE ALL OF THE FUNCTIONS LISTED
  154.   IN THIS DOCUMENTATION.  SEE THE END OF THIS FILE FOR A LIST OF WHAT
  155.        FUNCTIONS ARE SUPPORTED ONLY IN THE REGISTERED VERSION!
  156. ------------------------------------------------------------------------
  157.  
  158.   This is a shareware program.  That doesn't mean it's free...but on the
  159. other hand, The "demo" version contains all the functions for viewing and
  160. cataloging that the average user will ever need.
  161.  
  162.   This program was developed using tools and techniques which have taken
  163. me many years to develop, and I hope it shows.  Because of this, the
  164. following points will be taken very seriously:
  165.  
  166. ** DO NOT ** derive benefit from this software professionally in any
  167. manner.  DO NOT sell it.  DO NOT bundle it with any combination of
  168. products sold for money (this does not include shipping charges for
  169. shareware distributors).
  170.  
  171. BBS SYSOPS:  Please use GDS to catalog your GIFs for your users!  I would
  172. like to know you are using it, how you like it, and information about
  173. your setup.  I am very interested in providing good software (like this)
  174. to sysops, but I'm not about to write any more unless you all communicate
  175. with me.
  176.  
  177. PEOPLE WHO COMPLAIN:  Most complaints come from people that want all the
  178. features for free.  Let me explain something here.  Most Shareware
  179. programs warn you that you are very evil if you don't contribute to the
  180. starving author. Whereas we encourage you to freely distribute and use
  181. the demo version for private purposes. If you would like the enhanced
  182. version and future updates or intend to use it for commercial purposes,
  183. then you MUST register.
  184.  
  185.  
  186. iv. WHAT GDS CAN DO FOR YOU
  187. ---------------------------
  188.  
  189. 1) GIF VIEWER
  190.   GDS is a very intuitive graphics file viewer.  It has a (very quickly
  191. implemented) user interface based on many years of GUI experience.  If
  192. you find an easier graphics viewer, please let me know.
  193.  
  194. 2) FILE FORMATS
  195.   GDS reads GIF87a, GIF89a, BBM, LBM, PCX, RIX, and MAC files.  It can
  196. write GIF87a, LBM, PCX, and RIX files directly from the screen.  Other
  197. formats may be added in future versions.  If you really need a format
  198. supported for something, FAX or write me a note.
  199.  
  200. 3) SLIDE SHOWS
  201.   GDS can easily allow you to queue up to 2800 images to show in a
  202. repeated sequence.  At 5 seconds per image, that's just under four hours
  203. without repeating an image.  GDS reads successive images ahead of time
  204. into EMS or system RAM to minimize draw time, increasing the appearance
  205. of the slide show.
  206.  
  207. 4) IMAGE PROCESSING
  208.   GDS can scale images to almost any size.  This capability comes in very
  209. handy if you're trying to reduce, enlarge or correct image scaling.
  210. NOTE: Give system operators a break and don't use GDS to make larger GIF
  211. files for more download credit.
  212.  
  213. 5) ARRAYS
  214.   GDS has a very good image cataloging section which reduces and labels
  215. arrays of images on the screen.  GDS creates spatially optimized
  216. palettes, uses two levels of dithering and two dimensional antialiasing
  217. to reduce color distortion.  GDS can reduce up to 2304 images onto a
  218. single 1024x768 graphics screen.  If you are a system operator of a BBS,
  219. this is a great way to provide previews of many images to your users.
  220.  
  221. 6) SCREEN CONVERSION
  222.   GDS can lock a screen mode, reduce and enlarge images to fit, or scale
  223. and zoom to almost any dimensions.  256 color images can easily be
  224. converted to 16 color images with antialiasing and dithering to ensure
  225. spatial color consistency.
  226.  
  227. 7) MOUSE SUPPORT
  228.   GDS is very mouse supportive (does that make it cheezy?).  Although
  229. almost everything can be done with the keyboard (a couple of things can
  230. ONLY be done with the keyboard), there is extensive mouse support in GDS.
  231. Unless you are writing or rescaling images, GDS is extremely quick with a
  232. mouse.
  233.  
  234.  
  235.  
  236. v. WHAT GDS DOES NOT DO!
  237. ------------------------
  238.  
  239. 1) TIFF FILES
  240.   GDS makes no attempt to read or write TIFF files.  I sat down with some
  241. TIFF documentation one night to support the TIFF file format, and spent
  242. several hours setting up a code skeleton.  After concentrating for quite
  243. a while, I finally realized how the format worked and decided not to
  244. support it.  If you have source or object code to support TIFF, perhaps
  245. some arrangement can be made to include TIFF support in GDS.
  246.  
  247. 2) WRITING FORMATS
  248.   GDS doesn't write BBM or MAC files.  It's quite possible to do, but
  249. there hasn't been a demand for it.  GDS writes GIF87a, LBM, PCX, and RIX
  250. files.  If you really need support for writing a format, FAX or write a
  251. note and we'll discuss it.
  252.  
  253.  
  254.  
  255. 1. GETTING STARTED
  256. ------------------
  257.   Since you can read this, you must have either gotten GDS as a set of
  258. files, or already UNZIPped it out of it's original ZIP file.
  259.  
  260.   GDS can quickly be started by typing 'GDS' followed by 'Enter'.  GDS
  261. should run with no command line options.  GDS can also be started from
  262. any path by specifying it's path on the command line.  It can also be run
  263. if it's in the DOS environment's 'PATH=' parameter.
  264.  
  265.   GDS parses file/path specifications and runtime switches as command
  266. line parameters.  Any number of paths/files may be specified to GDS.
  267. The following command line is typical and completely safe:
  268.  
  269. C>  GDS i:\dp\*.lbm j:\GIFs myimage.gif
  270.  
  271.   The first path specifies all LBM files in the 'DP' directory on drive
  272. 'I'.  The second path specifies all readable files in the 'GIFS'
  273. directory on drive 'J'.  The third path specifies the single file
  274. 'MYIMAGE.GIF' in the currently logged directory.  If no path names are
  275. given, the current directory is used ('*').
  276.  
  277.   If you have problems getting GDS to run, refer to the section entitled
  278. 'Common Problems and Solutions'.
  279.  
  280.  
  281.  
  282. 2. THE GDS TEXT SCREEN
  283. ----------------------
  284.  
  285.   After configuring GDS and getting it to function, the user is presented
  286. with a screen containing a file display consisting of file names,
  287. extensions, and file sizes in a columnar format.  The top line of the
  288. screen always shows the version number and copyright message.
  289.  
  290.   Getting out of GDS is easy.  Just hit 'Esc' or click on the 'Quit'
  291. button.
  292.  
  293.   The user may view images by pressing 'Enter' (or double clicking) on a
  294. file name.  The space bar toggles the selection state of the file under
  295. the file cursor.  Mouse users can drag the mouse from one file to another
  296. to select all files in between.  Mouse users can click on a file, which
  297. will deselect all currently selected files (when in single view mode) and
  298. select the file under the mouse cursor.  When in single view mode, mouse
  299. users may toggle ranges of files by holding down the shift key and
  300. clicking/dragging, just like the Macintosh user interface.  In the slide
  301. show mode, the mouse always acts like the shift key is held.
  302.  
  303.   For keyboard users, pressing the 'Enter' key starts a view in the
  304. current view mode (single or slides).  Pressing 'Enter' does not change
  305. the selection state of ANY of the files in the file list.  Use the space
  306. bar to toggle the selection state of files.  (MOUSE USERS: It's usually
  307. easier to set up fragmented slide shows with the keyboard!)
  308.  
  309.   For mouse users, double clicking on a file will display that file alone
  310. in single view mode, regardless of the current view mode.  Use the
  311. 'Enter' key or view button (see below) to initiate slide shows.
  312.  
  313.   Several buttons and menus are displayed in the second line of the
  314. screen and on the bottom line.  These areas are referred to in this
  315. documentation as 'menu areas'.
  316.  
  317.   In between the file display and the bottom menu area are two lines
  318. displaying detailed information about the 'Current File'.  This is
  319. referred to as the 'file status area'.  As the file cursor is moved
  320. through the file list, GDS displays information about each file under the
  321. file cursor.  This information includes the complete path and file name
  322. of the file, it's screen resolution, number of colors, and the exact file
  323. size in bytes.
  324.  
  325.   On the right side of the file status area, the total number of files
  326. and number of files selected are parenthetically displayed.  The number
  327. of files selected will not be displayed unless files are currently
  328. selected.
  329.  
  330.   Directly to the right of the file status area is a help message which
  331. says "'Enter' views current selection" in a rectangle.  This area is
  332. referred to as the 'view button'.  This button is not important to
  333. keyboard users, except that it tells them what to do to display an image.
  334.  
  335.   The view button gives mouse users added flexibility because clicking it
  336. starts a slide show.  If there is more than one file selected or NO files
  337. selected, the view button starts a slide show regardless of the current
  338. view mode.  If there is one file selected, the view button will do a
  339. single view.  For mouse users, it's easiest to use the 'View:' menu to
  340. change the behavior of single clicks in the file list (see above) and use
  341. the view button to start slide shows.
  342.  
  343.   Using the menus in GDS is simple from a keyboard or mouse.  From the
  344. keyboard, hold down 'Alt' and then hit the key which matches the first
  345. highlighted character in the menu or button you want to change (or click
  346. on it with a mouse).  If the menu or button you have selected has two or
  347. less functions (like the 'MOUSE:' button), then the state of the button
  348. just changes.  If there are more than two choices, then GDS presents the
  349. user with a menu.  When using the keyboard, the default menu selection
  350. will be highlighted.  You are free to use the arrow keys to navigate the
  351. menus and press 'Enter' to select your option.  You may also hit 'Esc' to
  352. cancel selecting from a menu.  With a mouse, just click (or drag and let
  353. go on) your choice.  To cancel selection with a mouse, just click (or let
  354. go) outside of the menu area.
  355.  
  356.   In many cases, it's helpful to have the ability to jump through the
  357. file list to get to a range of images quickly.  When any alphanumeric key
  358. (keys not associated with special 'Ctrl' or 'Alt' commands) is pressed,
  359. GDS looks through the current list of files and moves the cursor to the
  360. first file starting with the same character as the key that was pressed.
  361. If GDS can't find a file that matches, it will put the cursor on the
  362. closest match it can find.
  363.  
  364.   File maintenance has been a problem of other viewers, and something
  365. which is difficult to provide without a lot of complexity.  GDS now
  366. supports five 'Ctrl' key commands which allow the user a great deal of
  367. flexibility with file control.  When the 'Ctrl' key is pressed, GDS
  368. pops up a green window at the bottom of the screen showing which control
  369. keys do what.  These options are as follows:
  370.  
  371.         Ctrl-C  Copy File         duplicates file in another drive/path
  372.         Ctrl-D  Delete File       deletes file forever
  373.         Ctrl-F  New File List     specifies new path/file list
  374.         Ctrl-H  Hide file         removes file from file list
  375.         Ctrl-R  Rename file       changes name of file
  376.         Ctrl-S  System Status     displays free space on disk
  377.         Ctrl-T  Transfer file     moves file to another drive/path
  378.  
  379.   The functions of each menu or button are discussed below:
  380.  
  381. Quit            This button exits the program.
  382.  
  383. AutO/LOck
  384.   This button shows the state of screen mode locking.  The default
  385. graphics mode is normally meaningless unless this button is in the 'LOck'
  386. state.  Locking the screen mode forces images to be displayed in the
  387. graphics mode selected in the 'RES:...' menu.  This is handy when
  388. reducing large images down to fit in smaller screen modes, or reducing
  389. 256 color images down to dithered 16 color images.
  390.  
  391. RES:
  392.   This menu allows the selection of the default graphics and text modes.
  393. The default graphics mode has no effect unless the 'AutO/LOck' button is
  394. in the 'LOck' state.
  395.  
  396. VIEW:
  397.   This menu allows the user to choose between 'Single' images, 'Slides'
  398. (slide shows) and multiple image displays.  When this menu is in 'Single'
  399. mode, any selection of a file will deselect all other files first (unless
  400. the 'Shift' key is held).  When this menu is in 'Slides' mode, mouse
  401. clicks are never globally destructive to selections, but rather always 
  402. modify the selected state of files.  Note that with the mouse, double 
  403. clicking always produces a single view regardless of the state of this 
  404. menu.
  405.  
  406. Alias:
  407.   This menu allows the user to select what level of antialiasing is
  408. performed for reduced images (see 'ANTIALIASING' section below).  Hint:
  409. The default antialiasing (horizontal only) is almost as fast as no
  410. antialiasing at all.  However, high quality image reduction can take as
  411. much as 10 times longer depending on the level of reduction.  In general,
  412. considering the increase in image quality, it's always worth using
  413. horizontal antialiasing, and usually worth using high quality image
  414. reduction.
  415.  
  416. AboUt:
  417.   This menu displays interesting information about GDS.  It has no
  418. function except to entertain you.
  419.  
  420. SORT:
  421.   This menu allows the user to select the sort order for the file
  422. display.  Selecting a new sort order immediately causes the file display
  423. to be rearranged.  Note that selecting sort orders which require the
  424. resolution or number of bits per pixel will force GDS to research this
  425. information before a sort can be done.  This is annoying sometimes, but
  426. hey...you can't sort information you don't have.  Fortunately, GDS
  427. buffers the resolution and number of bits per pixel so that it only has
  428. to read it once.
  429.  
  430. MOUSE:
  431.   This button toggles the mouse between a bitmapped text cursor and a
  432. character cursor.  Some video displays do not conform to the VGA hardware
  433. standard for text character sets and may cause GDS to display a garbled
  434. mouse cursor.  If this happens, click on the 'MOUSE:; button.  Note that
  435. the state of the mouse can be set in the configuration file so you don't
  436. have click the 'MOUSE:' button every time you run GDS.
  437.  
  438. DITHER:
  439.   This menu allows the user to specify the level of dithering to be used
  440. when generating array images.  No dithering means that GDS will not try
  441. to increase color consistency.  Two color dithering generates checker-
  442. board patterns which are functionally imperceptible except in low
  443. resolution graphics modes.  Uneven dithering is more obvious than two
  444. color dithering, but greatly enhances the general look of 16 color
  445. renditions of images which start out with many more colors.  Hint:  There
  446. is almost no speed difference in using dithering.  The biggest delay is
  447. the delay just before the image is read where GDS generates it's
  448. conversion table.  There is almost no speed difference in putting up raw
  449. pixels vs. dithered pixels.  In short, dithering doesn't slow GDS down
  450. perceptibly.
  451.  
  452. FILESHOW:
  453.   This menu allows the user to toggle different elements of the file
  454. display on and off.  Note that these elements can be set on or off in the
  455. configuration file so you don't have to set it every time you run GDS.
  456.  
  457.  
  458.  
  459. 3. VIEWING COMMANDS
  460. -------------------
  461.  
  462.   GDS has some interesting features when images are viewed alone.  Images
  463. can be viewed alone by using 'Enter', or by double clicking a file with a
  464. mouse.
  465.  
  466.   Slide shows will not allow the user to do any of these functions.
  467. Arrays, on the other hand, will allow the user to write GIF87a, LBM, PCX,
  468. and RIX images ('Alt-W', 'Alt-L', 'Alt-P' and 'Alt-R').  Note that these
  469. 'Alt' key commands can be set up with the '/W###' option to automatically
  470. write a run of array images ONLY in the array view mode.  Array images
  471. can also be adjusted with the color controls (F1-F10, <comma>, and
  472. <period> ).
  473.  
  474.   For those of you who realize that the user interface for some of the
  475. extended view functions isn't finely tuned, congratulations.  (Perhaps
  476. over time, GDS's more esoteric keypresses will mature into a defacto
  477. keyboard standard which will live in infamy similar to the 'Wordstar'
  478. editor keys!)
  479.  
  480.   When viewing a single image or a carefully generated array image, it is
  481. sometimes handy to adjust the palette manually.  The F1 through F10, ',',
  482. and ',' keys adjust the red level, green level, blue level, image
  483. contrast, image brightness and color level.  Reset the individual levels
  484. by holding down the shift key and using the same keys.  Every time a
  485. level is changed, the entire palette is recalculated from the original to
  486. prevent eventual palette degradation.
  487.  
  488. Esc     Always exits view mode.
  489. Enter   Exits single view mode.  During slide shows,
  490. 'Enter' exits if a slide is being drawn.
  491.  
  492. Space:
  493.   When viewing a single image, pressing the spacebar exits back to the
  494. file screen unless the scale of the image is not exactly the same as the
  495. original image (Note: sometimes the first image displayed is scaled, use
  496. space to return automatically scaled images to their original scale).  In
  497. array generation mode, the spacebar will stop the display of any images
  498. in progress and skip directly to the next image in the list.
  499.  
  500. Alt-W:
  501.   Immediately starts writing a GIF file titled "GDS###.GIF".  The number
  502. used in place of '###' is either 000 or whatever number was specified
  503. with the '/W###' command line parameter.  This function will not
  504. overwrite existing files.  Note that you can use the '/N<template>'
  505. command line parameter to change the name template for the files which
  506. are written.
  507.  
  508. Alt-L:  Exactly like Alt-W, but writes "LBM" files.
  509. Alt-P:  Exactly like Alt-W, but writes "PCX" files.
  510. Alt-R:  Exactly like Alt-W, but writes "RIX" files.
  511.  
  512.         NOTE:  Alt-R uses the extension ".SC<c>", where <c> is the
  513.               screen resolution indicator as prescribed by RIX Software
  514.               in Irvine, California.  NOTE:  GDS supports RIX's
  515.               "UNCOMPRESSED" format only.  RIX Software is not releasing
  516.               ANY information about it's compressed formats.  If you
  517.               would like to see compressed RIX file support, don't bother
  518.               asking me, and please ask RIX to allow developers to
  519.               support it.
  520.  
  521. Arrow keys:
  522.   The arrow keys adjust the position of the lower right hand corner of
  523. the image rectangle.  Using the arrow keys alone moves the lower right
  524. corner by two pixels at a time.  Holding the shift key down while using
  525. the arrow keys moves it by 20 pixels at a time.  If you manage to get the
  526. image messed up enough to start over, just hit the space bar and the
  527. image will redraw at it's default scale.  This function is useful when
  528. used with Alt-F to fine tune the scale for image reduction.  It's also
  529. very useful for correcting the size of images that are stored with an odd
  530. screen size.
  531.  
  532.   E
  533. S-+-D   These keys pan the viewing area in the direction indicated by the
  534.   X     placement of the keys on the keyboard.  One keypress normally
  535.         moves the image by one dot.  When the shift key is held down,
  536. the image moves by 20 dots at a time, similar to the behavior of the
  537. arrow keys as described above.
  538.  
  539. Alt-Z:
  540.   Start 'zoom' sequence.  THIS FUNCTION WORKS ONLY WITH A MOUSE.  Use
  541. 'Alt-Z' as follows to zoom in on an area of an image:  (1) Press 'Alt-Z'.
  542. (2) Move the mouse pointer to the upper left of the desired zoom
  543. rectangle.  (3) Press and hold down a mouse button.  (4) While holding
  544. down the mouse button, drag the mouse pointer to the lower right of the
  545. desired zoom rectangle.  (5) Let go of the mouse button.  The zoom
  546. function will preserve the current X to Y ratio for scaling in case
  547. you've adjusted it or used 'Alt-F' to fit the image to the screen.  If
  548. you manage to zoom to the wrong place or mess things up beyond
  549. comprehension, just hit the space bar to redraw the image at it's default
  550. scale.
  551.  
  552. Alt-F:
  553.   Fit image to screen.  This function ATTEMPTS to rescale an image to fit
  554. into the full screen.  It is useful for scaling images down from large
  555. screen sizes.  Depending on the dimensions of the image, this may not
  556. produce the desired results.  If the aspect ratio of the graphics mode or
  557. image is not recognizable by GDS, the image may end up distorted.  If
  558. this happens, use the spacebar to redraw the image at it's original
  559. scale and manually adjust the scale of the image using the arrow keys.
  560.  
  561. F1/F2   Reduce/Increase palette red level.
  562. F3/F4   Reduce/Increase palette green level.
  563. F5/F6   Reduce/Increase palette blue level.
  564. F7/F8   Reduce/Increase contrast.
  565. F9/F10  Reduce/Increase brightness.
  566. ','/'.'       Reduce/Increase color.  This function can reduce a
  567. full color image to grey scale by using ',' to completely eliminate all
  568. color content.  The image can further be reduced to a monochrome image by
  569. increasing the contrast to maximum (F8).  This color level control
  570. compensates for the eye's responsiveness to red, green, and blue for
  571. minimal color distortion.
  572.  
  573. Shift-F1/F2     Reset red level to that of original image.
  574. Shift-F3/F4     Reset green level to that of original image.
  575. Shift-F5/F6     Reset blue level to that of original image.
  576. Shift-F7/F7     Reset contrast to that of original image.
  577. Shift-F9/F8     Reset brightness to that of original image.
  578. Shift-','/'.'   Reset color to that of original image.
  579.  
  580.  
  581.  
  582. 4. SLIDE SHOWS
  583. --------------
  584.  
  585. GDS has two separate methods of generating slide shows.  The first is to
  586. select a range of files from within the normal GDS user interface and set
  587. the 'View:' menu to 'Slides'.  When GDS is in set this way, normal
  588. viewing of images results in a slideshow (except mouse double clicks; see
  589. VIEWING COMMANDS).
  590.  
  591.   The second method is to specify the '/S' option on the command line.
  592. GDS will bypass the normal user interface and immediately start a slide
  593. show using any files specified on the command line.
  594.  
  595.   The '/O' option is normally ON (1), which sorts the file list when the
  596. '/S' option is specified.  Specifying '/S0' on the command line will
  597. prevent GDS from sorting the file list.
  598.  
  599.   The '/Z' option specifies the delay in 100ths of seconds between
  600. slides.  Two seconds, for example, would be specified using '/Z200'.  If
  601. '/Z' is not specified, GDS will wait for at least 5 seconds between each
  602. slide.
  603.  
  604.   It is often necessary to give a slideshow on a very specific set of
  605. files which may be inconvenient to enter on the command line.  The
  606. '@<FILE>' option is used to tell GDS to read a list of filenames from
  607. <FILE>.  Using the '@<FILE>' option can save you a lot of time and allow
  608. you to customize your slideshows to your heart's content.  An example of
  609. a typical planned slideshow is as follows:
  610.  
  611. C>  gds /s @filelist /o
  612.  
  613.   The first option ('/s') tells GDS to do an automatic slide show.  The
  614. second option ('@filelist') tells GDS to read the file 'filelist' for a
  615. list of files to show.  The third option prevents GDS from sorting the
  616. file list.
  617.  
  618.  
  619.  
  620. 5. ANTIALIASING
  621. ---------------
  622.  
  623.   Antialiasing is a term used to describe the color correction applied to
  624. pixel hues in order to maintain the overall appearance of an image.  Most
  625. often, antialiasing means adjusting the colors along partially covered
  626. pixels when drawing a line on a bitmapped screen.
  627.  
  628.   GDS uses antialiasing only when reducing an image.  It doesn't smooth
  629. out transitions between enlarged pixels.  Perhaps in a future version,
  630. enlargement smoothing may be supported.
  631.  
  632.   GDS uses a very high performance antialiasing technique which scans
  633. colors from many original image pixels and combines them to form a single
  634. destination pixel.  What this gives you is an extremely accurate
  635. representation of the original image, but using far less dots to do it.
  636.  
  637.   An interesting side effect of antialiasing is that it tends to reduce
  638. the size of the resulting GIF file.  Originally, I expected the file size
  639. to increase, but was fascinated when it dropped by about 9.6% for each
  640. dimension of antialiasing applied.
  641.  
  642.  
  643.  
  644. 6. DITHERING
  645. ------------
  646.  
  647.   GDS normally mixes colors together when appropriate in order to
  648. increase the apparent color resolution.  A good example of this is when
  649. an image has a section which fades evenly from one color (like red) to
  650. another color (like blue).  The result in the middle is purple.  When
  651. images are reduced and combined on the same screen, the demand for colors
  652. is high.  In high resolution GIF images, there are 256 colors per
  653. picture.  If you try to mix 80 pictures together, you would need 20480
  654. colors in order to represent the pictures without any hardware color
  655. distortion.
  656.  
  657.   When GDS doesn't have a color available (like purple from the example
  658. above), it looks for two colors which when displayed closely together
  659. appear to have the color of the original pixels.  This results in an
  660. almost imperceptible change from the original color in 256 color modes.
  661.  
  662.   Almost as interesting as the effect antialiasing has on resulting GIF
  663. file sizes, dithering increases GIF file size by about 9.6% for each
  664. level of dithering applied.
  665.  
  666.  
  667.  
  668. 7. COMMAND LINE PARAMETERS
  669. --------------------------
  670.  
  671.   All command line parameters may be prefaced with a forward slash ('/')
  672. or a dash ('-').  Command line parameters are processed in the order they
  673. are received.  Basically, they act like most other command line scheme.
  674.  
  675. Available command line options are as follows:
  676.  
  677. /A<n>   Set default antialiasing level (0-2)
  678. /B<n>   Set default mouse display mode (0-1)
  679. /D<n>   Set default dithering level (0-2)
  680. /F####  Set default file display options
  681. /G<mode>        Set default graphics display mode
  682. /H or /?        Display help screen with these switches listed
  683. /I<n>   Set early interlaced fill mode
  684. /L<n>   Set default labels on/off switch
  685. /M<n>   Set maximum number of colors in generated palette
  686. /N<temp>        Set template for filename generation
  687. /O<n>   Set sort flag for automatic slide shows (1=sort)
  688. /S<n>   Slideshow mode (no user interface, just slides)
  689. /T<mode>        Set default text display mode
  690. /V<n>   Set vertical orientation mode
  691. /W<n>   Set automatic array stream write after first Alt-W
  692. /Z<n>   Set delay in between slides in slide shows
  693. /<NAME> Force graphics support
  694. /512            Force support for 512K VGA modes
  695. @<FILE> Get list of files from FILE.
  696.  
  697.  
  698. /B<n>   This option sets the mode in which the text mouse cursor is
  699. displayed.  When this option is set to 0, GDS will display a highlighted
  700. character as a text mouse cursor.  When this option is set to 1, GDS will
  701. attempt to remap characters in the EGA/VGA character set to implement a
  702. graphics cursor in text mode.  The default setting of this option is
  703. determined at runtime, and depends on the hardware you have.  If your
  704. cursor doesn't look right, try changing the /B option in your GDS.CFG
  705. file.
  706.  
  707.  
  708. /F####  This option allows the user to specify what information should be
  709. displayed in the file list at startup.  The four number (or pound) signs
  710. each hold a place for a 1 or a 0, indicating whether or not the given
  711. option is on or not.  The list of file options is as follows:
  712.  
  713.         /F1???  Display file extension (default=0)
  714.         /F?1??  Display image resolution (default=0)
  715.         /F??1?  Display number of bits per pixel (default=0)
  716.         /F???1  Display file size (default=1)
  717.  
  718.  
  719. /G<mode>        This option sets the default graphics mode to be used for
  720. display.  The format of <mode> should be <n>x<n>x<n>, where the first
  721. value is the screen width, the second value is the screen height, and the
  722. third number is the number of bits per pixel (or number of colors).  The
  723. number of bits per pixel is optional for this option.  The default
  724. setting for this option is '/G320x200x16'.
  725.  
  726.  
  727. /H or /?        This option displays the runtime help screen.
  728.  
  729.  
  730. /I<n>   This option sets the 'early interlaced GIF fill mode' option.
  731. When interlaced images are drawn, GDS can fill in the breaks in between
  732. interlaced lines so the viewer gets a better image of what the picture 
  733. is as fast as possible.  It appears that this was one of the intended 
  734. uses of interlaced image format in the original GIF specification, but 
  735. no other GIF viewers seem to do this.  When this option is enabled (1), 
  736. interlaced images draw a bit slower overall, but the user can see the 
  737. general content of the picture in about one quarter of the time it takes 
  738. to read the entire image.  The default value of this switch is ON (or 1).
  739.  
  740.  
  741. /M<n>   This option puts a ceiling on the number of colors GDS is allowed
  742. to use when it generates common palettes for combining many GIF images
  743. into arrays of images.  This option is significant because the resulting
  744. file size of GIF files written with one bit less per pixel is about 9.5%
  745. smaller than the original number of bits per pixel.  This means that a
  746. 128 color image will be approximately 91% of the size of the similar 256
  747. color.  The disadvantage to limiting the palette is that the color
  748. resolution drops, and therefore the picture quality suffers.
  749.  
  750.  
  751. /N<template>    This parameter sets the 'printf()' style template for
  752. filenames generated by GDS when array files are written.  If you don't
  753. know what that means, DON'T CHANGE IT.  If you are familiar with
  754. printf(), then go ahead and change the template.  The default string used
  755. by GDS for generating filenames is "GDS%03d", which creates a file such
  756. as "GDS042.GIF".
  757.  
  758.  
  759. /O<n>   This option sets the sort flag for automatic slide shows (/S).
  760. This option has no effect when the '/S' option is not specified.  To sort
  761. the file list before an automatic slide show, specify /O1.  To leave the
  762. file list unsorted, specify /O0.  The default value of this option is ON
  763. (or 0).
  764.  
  765.  
  766. /S      This option specifies automatic slide show mode.  In automatic
  767. slide show mode, no user interface is offered, and a slide show starts
  768. immediately after startup.  See the '@<FILE>' option for a useful way to
  769. specify exactly what files to show.
  770.  
  771.  
  772. /T<mode>        This option sets the default text mode to be used for
  773. display.  The format of <mode> should be <n>x<n>, where the first value
  774. is the number of character columns, and the second value is the number of
  775. screen lines.  The default value for this mode is '/T80x25'.
  776.  
  777.  
  778. /W<n>   This rather quirky option sets the state of a mode wherein GDS
  779. will continue to generate and write array images (GIF, PCX, or RIX) after
  780. the first time you press Alt-W, Alt-P, or ALT-R, respectively.  Using
  781. this option, GDS will run through hundreds of files and generate an image
  782. for each complete array screen.  The default setting for this option is
  783. OFF (or 0).
  784.  
  785.  
  786. /Z<n>   This options specifies the number of 100ths of seconds to delay
  787. in between slides during a slideshow.  The default value is 5 seconds
  788. (91).  The delay between slides can be completely eliminated by setting
  789. this option to 0.
  790.  
  791. /<NAME> This option is used to force GDS to assume it has the named video
  792. card.  Normally, this is not necessary or advisable.  USE THIS OPTION
  793. WITH CARE.  There is no telling what could happen if you force a graphics
  794. card which conflicts with the hardware you actually have.  The following
  795. video cards are currently defined:
  796.  
  797.         /EGA            Standard EGA or 100% compatible
  798.         /VGA            Standard VGA or 100% compatible
  799.         /AHEAD  Ahead Systems Chipset (type A)
  800.         /AHEADB Ahead Systems Chipset (type B)
  801.         /ATI            ATI VGA Wonder
  802.         /CHIPS  Chips and Technologies Chipsets
  803.         /EVEREX Everex Systems
  804.         /GENOA  Genoa 6000 series
  805.         /OAK            Oak Technologies
  806.         /ORCHID Orchid Technologies
  807.         /PARA   Paradise Systems
  808.         /TRIDNT ATI Prism Elite (Trident Chipsets)
  809.         /TSENG  Tseng Laboratories Chipset
  810.         /TSENG4 Tseng Laboratories Chipset (4000 series)
  811.         /VESA   Standard VESA BIOS Interface
  812.         /VID7   Video Seven VRAM or FASTWRITE VGA
  813.         /ZYMOS  Zymos HiRes 512K VGA
  814.  
  815. NOTE: If you have any problems with the video modes listed in GDS.CFG, or
  816. find discrepancies, please FAX or write me a note.  I'm interested in
  817. supporting cards, although my time is limited.
  818.  
  819. /512    Force support for 512K VGA.  If your video card has 512K of
  820. display RAM and you are unable to get GDS to support modes requiring
  821. 512K, try using the '/512' command line switch.  If using this option is
  822. successful, you may wish to place this switch in GDS.CFG so you don't
  823. have to type it every time you run GDS.  The default setting of this
  824. switch is 0 (off), and if /<NAME> is not specified, this switch is set by
  825. GDS when it tries to automatically detect what type of video adapter is
  826. present.
  827.  
  828.  
  829. @<FILE> This option reads a list of image files from
  830. <FILE>.  FILE may be any valid path and filename.  This is usually used
  831. with automatic slide shows (see '/S').
  832.  
  833.  
  834.  
  835. 8. CONFIGURATION FILE DETAILS
  836. -----------------------------
  837.  
  838. Unless you know what you are doing and are familiar with GDS, please stay
  839. away from the configuration file.
  840.  
  841. If you have a registered version of GDS, please leave "GDS.CFG" alone and
  842. put all of your own configuration parameters into "GDSUSER.CFG".  GDS
  843. reads both of these files, and if you refrain from modifying "GDS.CFG",
  844. you will not have to mess with configuration files when you get your next
  845. update to the latest version of GDS.
  846.  
  847. GDS.CFG is set up to define all video modes for all display cards, and to
  848. give the user the ability to specify command line arguments which he
  849. doesn't feel like typing all the time.  GDS.CFG will be read from the
  850. current directory first, and then from the execution path.  If GDS.CFG is
  851. not found in either location, the program will object.
  852.  
  853. Any semicolon (';') found in the input stream is interpreted as a
  854. comment.  The semicolon and anything after it on the same line is
  855. ignored.  It is simple to disable lines in the configuration file by
  856. placing a semicolon in front of it.  Primarily, tabs, spaces, and blank
  857. lines are ignored.
  858.  
  859. There are two types of configuration lines.  The first defines a video
  860. mode, and the second specifies automatic command line options.  The
  861. format of the video modes is as follows:
  862.  
  863. A, B, C, D, E, F, G, H, I, J    ;optional comment
  864.  
  865. A) Name of the video card
  866. B) Horizontal screen resolution (number of columns)
  867. C) Vertical screen resolution (number of lines)
  868. D) Number of bits per pixel (or 0 for text mode)
  869. E) AX register on INT 21h call to set video mode (see I)
  870. F) BX register on INT 21h call to set video mode (see I)
  871. G) CX register on INT 21h call to set video mode (see I)
  872. H) DX register on INT 21h call to set video mode (see I)
  873. I) This option has one of three meanings:
  874.         1) 0 if video mode is a standard graphics mode
  875.         2) 1 if video mode is directly programmed (VGA register
  876. compatible cards only!
  877.         3) The base address of the screen if the video mode is a text
  878. mode (indicated by 0 bits per pixel) J) Dot Mode (0=normal, 1=ATI 16
  879. color chunky)
  880.  
  881. To specify automatic command line options, add a line to GDS.CFG similar
  882. to the following example:
  883.  
  884. AUTO, /m64 /t132x44             ;limit palette to 64 colors
  885.  
  886. This example will behave as if you typed '/m64 /t132x44' on the command
  887. line.  All automatic command line parameters will be processed AFTER the
  888. actual command line parameters.
  889.  
  890. There are examples of each of these two types of command lines in the
  891. included GDS.CFG file.  There are also comments in the file which should
  892. offer more information.
  893.  
  894.  
  895.  
  896. 9. COMMON PROBLEMS AND SOLUTIONS
  897. --------------------------------
  898.  
  899. The following PROBLEM and SOLUTION pairs are included to help you figure
  900. out what's wrong with your setup or GDS.  Each individual entry came from
  901. the experience of supporting people who have problems with GDS.
  902.  
  903. PROBLEM:        After GDS starts, it keeps doing something with the disk
  904. drive which makes me paraniod!  I don't like it and I want it to stop!
  905. SOLUTION:       This inquisitive behavior is perfectly normal for GDS.
  906. Don't worry, it's not a virus deleting your files!  GDS reads the number
  907. of bits per pixel and screen resolution for every file in the file list
  908. whenever you haven't done anything interesting for a few seconds.  It
  909. will read about 15 listings and then pause for a couple of seconds and
  910. repeat this pattern until it has read every file.  It does this so you
  911. don't have to wait for a long time if you want to sort by something which
  912. needs to be read from every file (like number of bits per pixel or screen
  913. resolution).  If you do anything with the user interface or hit any keys,
  914. GDS will stop reading these files instantly, and wait for a while before
  915. it starts up again.
  916.  
  917. PROBLEM:        Some pictures go totally nuts and draw lines all over
  918. the screen.
  919. SOLUTION:       Look at the resolution of the file, it may exceed the
  920. resolution of your display.  First set the resolution to the max that
  921. your system can handle, then set the "AutO" button to the "LOck" state,
  922. and then try viewing the image again.  For a permanent fix, remove the
  923. unsupported video modes in "GDS.CFG" by inserting a semicolon (';') at
  924. the beginning of the line describing the video mode.
  925.  
  926. PROBLEM:        The file cursor flashes on and off very fast on some
  927. files and GDS will not display them.  GDS displays the horizontal
  928. resolution of the file at the bottom of the screen as "-1".
  929. SOLUTION:       GDS does this because GDS believes there is an error in
  930. the file.  If you don't believe there's an error in the header of the
  931. file, try displaying the file with another viewer.  FAX or write me a
  932. note if you find a file that GDS will not display, but other viewers
  933. will.
  934.  
  935. PROBLEM:        GDS won't run, and gives me an error that says it doesn't
  936. know what kind of video card I have.
  937. SOLUTION:       If you're sure you have a video card which is compatible
  938. with the listings in GDS.CFG, then use the '/<NAME>' option to tell GDS
  939. what card to use.  You may also have to use the '/512' option if you
  940. have 512K of video RAM.  If you don't know what kind of video card you
  941. have, then you probably have one which is incompatible with GDS.  If
  942. you'd like to see the card supported, send me the technical reference
  943. information with a brief cover letter.  If you really know what you're
  944. doing, you can add modes to an existing board in the "GDSUSER.CFG" file.
  945.  
  946. PROBLEM:        GDS displays the top part of 256 color images fine, but
  947. the bottom part is either black, white, or garbled.
  948. SOLUTIONS:
  949.         A) Try locking each extended screen mode in the 'Res:' menu and
  950. displaying files with it.  See which ones screw up.
  951.  
  952.         B) Check to see if there is enough RAM on your video card to use
  953. the display mode you're trying to go into.  If not, you can disable the
  954. offending mode using a semicolon (';') in GDS.CFG.
  955.  
  956.         C) Look in GDS.CFG to see if the screen modes which screw up are
  957. actually supported by your video card, and not by a different video card.
  958. You may have to experiment with the GDS configuration file to get a
  959. reliable list of modes to use.
  960.  
  961. PROBLEM:        Some pictures I have are squished to the left of the
  962. screen when I view them with GDS.
  963. SOLUTION:       Yeah.  Some are.  Depending on the graphics mode that the
  964. image was stored on and the different graphics modes GDS supports for
  965. your video board, the aspect ratio of images can be way off.  GDS will
  966. not modify the literal dimensions of a picture unless the picture is TOO
  967. BIG to fit on the largest mode available (in which case, GDS will scale
  968. the image down to fit the largest screen mode).  These squished images
  969. were written with a screen size which has a much greater aspect ratio
  970. horizontally than the screen you have.  Most of the time, you can simply
  971. hit 'Alt-F' to fit the image into the screen.  Sometimes, however, people
  972. (morons) store the images squished into normal screen sizes.  When
  973. "Alt-F" doesn't work, try using the arrow keys (in registered versions,
  974. the 'Shift' key makes the arrows more powerful).  To actually FIX these
  975. images, just manipulate the image until it fits nicely into the screen
  976. and write the image to a new file using one of the file write ('Alt')
  977. commands described in section 3; Viewing Commands.
  978.  
  979. PROBLEM:        I see garbage on the text screen around the mouse pointer
  980. whenever I move the mouse around.  It is very annoying, I hate it, it's
  981. ugly, make it go away.
  982. SOLUTION:       You must have a VGA which isn't supported by the
  983. graphic/text mouse pointer.  You can click the 'MOUSE:...' button on
  984. the file menu to get rid of the problem temporarily, or change "GDS.CFG"
  985. and add the line 'auto, /m0'.  This will force the mouse to be a
  986. character, rather than an arrow in text mode.
  987.  
  988.  
  989. 10. BUG REPORTS
  990. ---------------
  991.  
  992. Like most things, bugs happen.  I would just like to note that I've
  993. taken every reasonable precaution to limit bugs, and I think I've been
  994. thorough in my quest for a bug-free program.  HOWEVER -- bugs are
  995. inevitable.
  996.  
  997. The biggest area I'm suspecting bugs in is video support.  There is
  998. support for some 60 or so super vga cards.  There is code which the
  999. manufacturers say should work.  Unfortunately, I can only test what I
  1000. have.  I would be interested to find out if certain cards do or don't
  1001. work.
  1002.  
  1003. I have tested this software with the Video 7 VRAM VGA, Video 7 1024i,
  1004. ATI Wonder+, Orchid Pro-Designer w/1MB, TVGA (Trident) w/1M, Paradise
  1005. VGA+ w/256K, and Oaktech 256K VGA.  I have not personally tested it with
  1006. other cards, but have heard of much success.  I will shortly know if
  1007. the Genoa boards work properly with GDS as the Genoa technical support
  1008. team has been very responsive with my inquiries.  I have heard of
  1009. bizarre problems with some Paradise boards and am looking for
  1010. information relating to these problems.
  1011.  
  1012.  
  1013. 11. REVISION HISTORY
  1014. --------------------
  1015.  
  1016. 1.00    02-10-91        The "First Release; Hope You Like It" Version
  1017. ----    --------        ---------------------------------------------
  1018. -->     No bugs reported yet.  (I'm plugging my ears.)
  1019.  
  1020.  
  1021.  
  1022. 1.01    02-11-91        The "Wow! that was fast!" Version
  1023. ----    --------        ---------------------------------
  1024. -->     'Sort:' menu in earlier versions could easily lock up GDS when
  1025. used to sort by 'Bits per pixel' or 'Resolution' if GDS had not yet read
  1026. file information for all files in file list.  Although I haven't seen it,
  1027. this bug may cause stack overflows, 386 exceptions, and all sorts of
  1028. other unpredictable stuff.
  1029.  
  1030. -->     Palette generation for array images is much more accurate for
  1031. images with varying numbers of bits per pixel.  In prior versions, images
  1032. with fewer bits per pixel were not represented equally among pictures
  1033. with many bits per pixel.  This problem has been eliminated by padding
  1034. smaller palettes to bias the importance of their individual color ranges.
  1035.  
  1036. -->     When displaying a 2, 4, 8, or 16 color image in single view mode
  1037. and the screen format used to display the image was an EGA mode, some VGA
  1038. boards would handle the EGA palette and VGA color registers
  1039. inconsistently.  This occasionally caused a color or two to be incorrect.
  1040. GDS now resets all EGA palette registers and all VGA color registers
  1041. every time the palette is set, which seems to have corrected the problem.
  1042. NEW!    Changed behavior of mouse clicks in file list when 'View:' mode
  1043. is set to 'slides'.  Users tend to want to point at a file and add it to
  1044. the list rather than deselecting all other entries in favor of the one
  1045. their clicking on.  So from now on, when you're doing slides, remember
  1046. that the mouse toggles files!
  1047.  
  1048. -->     Fixed small moving button click problem in array setup.
  1049.  
  1050.  
  1051.  
  1052. 1.02    02-12-91        The "QUIX RIX FIX" Version
  1053. ----    --------        --------------------------
  1054. NEW!    Added RIX support through the Alt-R command.  Note that GDS can
  1055. only support the 'UNCOMPRESSED' RIX file formats as RIX Software is not
  1056. releasing any information about their compressed file format.  If you
  1057. would really like to see support for compressed RIX files, don't ask me -
  1058. - ask RIX Software.
  1059.  
  1060. -->     Fixed PCX file write for 16 color screen modes.  In previous
  1061. versions, GDS would write odd images with the bits in the bytes flipped
  1062. around, and possibly the plane order reversed.  This bug may be a
  1063. reflection of how much time I spent writing PCX support.  GDS now reads
  1064. and writes PCX files correctly in all screen modes.
  1065.  
  1066.  
  1067.  
  1068. 1.03    02-13-91        The "New and Improved Slideshow" Version
  1069. ----    --------        ----------------------------------------
  1070. -->     Corrected bug in slide shows which could incorrectly display
  1071. images which had been read completely into EMS before being displayed.
  1072. This bug is more common when the user hits the space bar to bypass the
  1073. slide show delay.  Earlier versions of GDS could display slide shows with
  1074. image misalignment/fracturing or even garbage in horizontal bands of
  1075. images.
  1076.  
  1077. -->     Corrected bug in array generation which could crash a system.
  1078. The bug occurs when the individual array images were reduced to less than
  1079. 1:32 of the original image size.  This limitation was not protected
  1080. against in prior versions of GDS.  GDS is now capable of 1:64 image
  1081. reduction and limits the size of array images to prevent users from
  1082. reaching this limitation.
  1083.  
  1084. -->     Corrected many bugs in 'Alt-Z' zoom function during single image
  1085. viewing.  In prior versions, the zoom feature would inversely compensate
  1086. for the aspect ratio of the screen.  This version should handle the zoom
  1087. feature as one would expect.
  1088.  
  1089. -->     Corrected nasty bug in two dimensional antialiasing when
  1090. displaying zoomed areas.  This bug would skew some lines in the display
  1091. to the left of where they should have been drawn.  The severity of the
  1092. display problems depended on the level of zooming, the aspect ratio of
  1093. the original image, and the position of the upper left zoom rectangle
  1094. corner.
  1095.  
  1096. NEW!    Added 'READMAC' file format to list of supported formats.
  1097. Readmac files (.MAC) can be read, but not yet written.  Anybody out there
  1098. want to write these files?  Let me know.  NEW!    Added color control to
  1099. single and array views.  The overall color level in the palette can be
  1100. adjusted with the ',' and '.' keys (normal case of '<' and '>').  To
  1101. reset the color level, just hit Shift-',' or Shift-'.' ('<' or '>').
  1102. This feature, along with the other image palette options gives the user a
  1103. surprising amount of control over problem images.
  1104.  
  1105. NEW!    Added page display compensation when generating arrays and using
  1106. 'Alt-F' to fit an image to the display.  In previous versions, high
  1107. resolution portrait files would just be remapped to the entire screen.
  1108. GDS now looks at the screen resolution and tries to figure out if it's a
  1109. high resolution page display file.
  1110.  
  1111. NEW!    Increased EMS support for read-ahead buffering for slideshows.
  1112. Slideshows now read images of any size while the current image is
  1113. displayed.  This facility will automatically buffer images, provided
  1114. there is enough available system RAM and/or EMS to hold the images.
  1115.  
  1116. NEW!    Increased file table size to 2800 files.  Yes, now you can have a
  1117. slideshow which will last just under four hours (at 5 seconds between
  1118. images) without repeating an image.  Previous versions were limited to
  1119. 2048 files.
  1120.  
  1121. NEW!    Added 'label' and 'border' preference buttons to array preview
  1122. user interface.  The 'Labels:' and 'Borders:' buttons may disappear from
  1123. the text file display screen in future versions.
  1124.  
  1125. NEW!    Changed user interface for selecting array images.  In earlier
  1126. versions, it was necessary to set the 'View:Arrays' and then hit 'Enter'
  1127. or click on the view button in order to start array generation.  GDS now
  1128. starts array generation immediately when the user selects 'Arrays of
  1129. reduced images' from the 'View:' menu.  There is no longer a
  1130. 'View:Arrays' mode in GDS.
  1131.  
  1132. NEW!    Increased image reduction by 100%.  Array images may now be
  1133. displayed reduced down to 0.04% in 1024x768 graphics modes.  With this
  1134. increase, it is now possible to display 2304 reduced images on one
  1135. 1024x768 screen.  I encourage anyone who has that many images accessible
  1136. to one machine to try this.  At 150K per image, that's over 345 megabytes
  1137. of GIF files.  Unfortunately, even with antialiasing off, it should take
  1138. an average of at least 5 seconds per image on a 33Mhz 80386 machine, and
  1139. that works out to about 3 hours and 12 minutes.  I want a copy of the
  1140. result!
  1141.  
  1142.  
  1143.  
  1144. 1.04    02-14-91        The "Quick Change Act" Version
  1145. ----    --------        ------------------------------
  1146. ==>     CORRECTED FOUR MEMORY ALLOCATION ERRORS WHICH COULD TRASH MEMORY.
  1147. The bugs would happen when memory layouts made certain combinations of
  1148. allocations impossible.  The way I spotted this problem is when I did a
  1149. directory and got garbage for files.  I'm not sure if these bugs will
  1150. trash FAT tables or not, but looking at the code, the memory addresses
  1151. being written to could conceivably be any segment, including DOS.
  1152.  
  1153. -->     Bug corrected with arrow keys and shift key.  It should now work
  1154. like the documentation says.
  1155.  
  1156. -->     Corrected bug with screen clear which would very rarely leave one
  1157. dot per 64K dots in the wrong color.
  1158.  
  1159.  
  1160. 1.05    02-15-91        The "Demo" Version
  1161. ----    --------        ------------------
  1162. NEW!    "Almost" fully functional version so that you can try before you
  1163. buy.  Only some of the "high end" functions are not in this version, all
  1164. the normal viewing, modifying, and reduction features are operational so
  1165. that you can enjoy it for personal use at no charge.
  1166.  
  1167.  
  1168.  
  1169. 1.06    02-23-91        The "Apocalypse Now" Version -- GIF89a
  1170. ----    --------        --------------------------------------
  1171. NEW!    Added GIF89a compatability.  GDS will now read GIF89a files, and
  1172. performs all of the user interface functions with the appropriate timing.
  1173. There is one primitive in GIF89a that GDS will read over but not process.
  1174. This primitive is the 'plain text extension' record (ID=0x01).  I'd love
  1175. to support this, but I don't have a file which uses it, and I don't know
  1176. if anyone has even used it yet.  I'd like to see someone use it before I
  1177. release something buggy that claims to support it.  Anybody want to send
  1178. me a file?
  1179.  
  1180. AGH!    A) Added feature to allow users to comment GIF files directly.
  1181.         B) Put out beta copies with this feature.
  1182.         C) Found out that most GIF viewers choke on GIF89a files.
  1183.         D) Spent hours on the phone, telling people to go back to 1.06.
  1184.         E) Removed the feature and changed GDS back to write GIF87a.
  1185.         F) Took several aspirin and went to sleep.
  1186.  
  1187. ACK!    Discovered that most other GIF viewers choke on multiple palette
  1188. GIF files.  All GIF files written by GDS now have only a global palette,
  1189. rather than global and image palettes so other viewers don't get all
  1190. wound up and display the images with an RGB palette. Other viewers would
  1191. see the two palettes in the GIF file and think they should correct for
  1192. differing palettes (which is actually a fair assumption).  Oh well, now
  1193. GDS writes only one palette.  VPIC, CSHOW, PICEM, and most other viewers
  1194. should work fine with images generated with this and future versions of
  1195. GDS.  (Sorry about the glitch, guys!)
  1196.  
  1197. ACK!    Removed "Palette" menu from all versions.  This menu seemed to
  1198. frustrate and confuse most users, and had limited utility besides.  This
  1199. menu may surface in a later "GDS Professional", but for now, its value is
  1200. not really perfected and its utility is difficult to understand.  For all
  1201. of you graphics hackers out there who understand what it does, watch for
  1202. the (as yet undefined) "GDS Professional" (see the end of the file).
  1203.  
  1204. ACK!    Removed the "palette search" menu from all versions.  This menu
  1205. had very little actual value when it came right down to it.  The actual
  1206. use for this menu is valid, but the task it performs is so intricate that
  1207. I couldn't figure out how to explain it to an end user.  For that matter,
  1208. it was difficult explaining it to other programmers...  It sure looked
  1209. neat, though.  Oh well, it's gone, and GDS will now dynamically perform
  1210. the most accurate palette search it can at any given time.
  1211.  
  1212.  
  1213.  
  1214. 1.07    02-27-91        The "Minor Revision" Version
  1215. ----    --------        ----------------------------
  1216. ==>     Added final touches to the now stabilized release version of GDS.
  1217.  
  1218. -->     Corrected problems with PCX files.  I've received a bunch of PCX
  1219. files from a user which have some interesting problems.  One of the
  1220. problems was admittedly mine, and it's fixed.  It had to do with
  1221. monochrome PCX files with no extended palette, which GDS 1.06 and earlier
  1222. would incorrectly display in all black (ahem!).  A few programs, however,
  1223. apparently write PCX files which have incorrect header information.  GDS
  1224. now tries to make an intelligent assessment of what to do with various
  1225. types of PCX file headers...even with files which have obviously been
  1226. written incorrectly.  Some conversion programs (1) write incorrect
  1227. headers and (2) fill the 48 byte palette with zeros (black), even when the
  1228. image is NOT flagged as a greyscale image, AND has more than two colors,
  1229. AND does not have an extended palette in the file.  In this case, GDS
  1230. processes the image using a standard EGA palette.  I hope this addition to
  1231. GDS makes more of your PCX pictures display properly, but I would also
  1232. hope that other programmers obtain the Z-Soft technical specification for
  1233. PCX files (readily available from Z-Soft).
  1234.  
  1235. NEW!    File list specifiable within the program.  Many of you have asked
  1236. for the ability to 'change' paths from within GDS.  Registered copies of
  1237. GDS now allow you to not only 'change paths', but to really change all of
  1238. your paths.  'Ctrl-F' now allows the user to specify a completely new list
  1239. of path/file specifications to create a new file list from.  Handy dandy.
  1240.  
  1241. NEW!    File rename/copy/move functions are now available to registered
  1242. users through the 'Ctrl-R', 'Ctrl-C', and 'Ctrl-M' keys.  No more exiting
  1243. to DOS to do image file housekeeping!  Sorry, these functions only work in
  1244. registered versions.
  1245.  
  1246. NEW!    File delete function is now available in *ALL* GDS versions. This
  1247. function was in such heavy demand, we decided to allow unregistered users
  1248. to have it.
  1249.  
  1250. NEW!    File 'Hide' function now quietly hides a single file when the
  1251. 'Ctrl-H' key is pressed.  This function does not delete the file; it just
  1252. gets removed from the screen.  This is very useful when there are
  1253. 'oddball' images in an otherwise 'clean' list of files.
  1254.  
  1255.  
  1256.  
  1257.  
  1258. CAPABILITIES OF SEPARATE GDS VERSIONS:
  1259. ======================================
  1260.  
  1261. Shareware Distribution Version (you must already have this)
  1262. -----------------------------------------------------------
  1263. Reads GIF87a, GIF89a, BBM, LBM, PCX, RIX, MAC
  1264. Writes GIF87a
  1265. Single View, Slide Show, Multiple Image Tiling
  1266. 'Alt-F' Fit to screen function in single view mode
  1267. Image scaling (x/y separate) to almost any size
  1268. 17 bit optimized palette generation for array images
  1269. Pan feature using E, S, D, and X keys in single view
  1270. Single path specification
  1271. Indexes up to 2800 files at once
  1272. Supports video modes up to 640x480
  1273. Medium quality antialiasing (horizontal only)
  1274. Reads GDS.CFG
  1275.  
  1276.  
  1277. Registered User Version (you should get this)
  1278. ---------------------------------------------
  1279. Reads GIF87a, GIF89a, BBM, LBM, PCX, RIX, MAC
  1280. Writes GIF87a, LBM, PCX
  1281. Handles multiple path specifications, up to 2800 files at once
  1282. Supports most SVGA high res graphics modes
  1283. Copy/Hide/Rename/Delete/Move file functions
  1284. Allows user to toggle labels and borders in array generation
  1285. '+'/'-' increases/decreases image size (preserves aspect ratio)
  1286. 'Alt-Z' zoom function in single view mode
  1287. Enhanced single view image scaling (Shifted arrows)
  1288. Enhanced Pan feature (Shifted E, S, D, and X keys)
  1289. High quality antialiasing available (two dimensional)
  1290. 1:3 dithering available (great for 16 color images)
  1291. Many valuable command line options to customize the GDS environment
  1292. Reads GDS.CFG & GDSUSER.CFG, to separate your customizations
  1293. Reads lists of path/file specifications from a file (@FILENAME);
  1294.           great for slideshows
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302. ====================================
  1303.             FUTURE WATCH
  1304. ====================================
  1305.  
  1306.           GDS Professional
  1307.           ----------------
  1308.           What do you want?
  1309.        How much should it cost?
  1310.           ----------------
  1311.  
  1312. Do you want:
  1313.         More file formats?  Which?
  1314.         Unattended array generation?
  1315.         Batch language for multiple processes?
  1316.         Palette locking/translation?
  1317.         Image content palette searches?
  1318.         Extremely high quality photomontages?
  1319.         Shells to DOS and/or paint programs?
  1320.     Scanner support?
  1321.         15/16/24 bit for Targa and others?
  1322.  
  1323.  
  1324.                LET US KNOW!
  1325.  
  1326.                Phase II Electronics Inc.
  1327.                19 Sands Point Drive
  1328.                Toms River New Jersey 08755-5167
  1329.                Phone (908) 286-0080,  Fax (908) 349-3842
  1330.                Compuserve 76667,1522  Bob Holland