home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / procssng / gds / gdsquick.doc < prev    next >
Encoding:
Text File  |  1992-08-30  |  13.1 KB  |  276 lines
  1.           GDS Quick List of functions available and what's new.
  2.                    Use PgUp, PgDn, or ,  to view.
  3. -------------------------------------------------------------------------
  4.        Ctrl-C  Copy File            Ctrl-L  List Comments, GIF89a
  5.        Ctrl-D  Delete File          Ctrl-R  Rename file
  6.        Ctrl-F  New File List/path   Ctrl-S  System Status
  7.        Ctrl-H  Hide file            Ctrl-T  Transfer file
  8.        Ctrl-P  Change display Palette.
  9. Quit      (or ESC)  Exit GDS.    Esc:   Always exits view mode.
  10. Enter     Exits single view mode; advances to next image in slide shows.
  11. Spacebar  Toggle file selection; unfit fitted image during view.
  12. Mouse     Left button select or continue, Right button exit function.
  13.  
  14. WHILE VIEWING AN IMAGE..........................
  15. -------------------------------------------------------------------------
  16. With versions above 1.10 you can move the mouse cusor to the top of the 
  17. screen while viewing an image and hold down the mouse button to access a 
  18. menu bar with pull-down windows of all the options available.  
  19. -------------------------------------------------------------------------
  20. Alt-W Writes GIF file.   Alt-P Writes PCX file.  Alt-L Writes LBM file.
  21. Alt-R Writes RIX file.   Alt-B Writes BMP file.  Alt-T Writes TGA file.
  22. Alt-I Writes TIF file.
  23. Alt-F    Re-fit image to screen.
  24. ALT-Z    Start "zoom" sequence (requires a mouse).
  25. ALT-C    Start "clip" sequence (requires a mouse).
  26. H        Horizontal flip (mirror).      V    Vertical flip (mirror).
  27. /        Rotate 90 degrees.             `    Invert Palette.
  28.  
  29. Arrow keys: move the cursor when selecting files or adjust the position 
  30.     of the lower right hand corner of the image rectangle when viewing
  31.     a file.  (use shift-arrow for larger increments.)
  32.  
  33.    E     Pan the viewing area in the direction indicated by the placement
  34.  S-+-D   of the keys.  Moves one pixel, use with shift key down to move
  35.    X     20 pixels.  (use mouse with menus instead).
  36.  
  37.      F1/F2   Red level.     F7/F8   Contrast.       Use Shift/left function
  38.      F3/F4   Green level.   F9/F10  Brightness.     key to restore.
  39.      F5/F6   Blue level.    ","/"." Color level.    F11/F12  Hue.
  40.  
  41. Available command line or .CFG options are as follows:
  42. /!<n>   Enables/disables beep after display of image (0-1).
  43. /A<n>   Default antialiasing level, 0, 1, or 2..
  44. /B<n>   Sets mode of mouse cursor.  0 = text, 1 = arrow.
  45. /C<n>   Specifies number of DAC register bits (0 to 8).
  46. /D<n>   Default dithering level.  0, 1, or 2.
  47. /E<n>   Sets image/screen fit mode (0=normal, 1=fit to screen)
  48. /F####       /F1???  Display file extension (default=0)
  49.              /F?1??  Display image resolution (default=0)
  50.              /F??1?  Display number of bits per pixel (default=0)
  51.              /F???1  Display file size (default=1)
  52. /G<mode>  Graphics mode for the display.    /G320x200x16
  53. /H or /?  Display help screen with these switches listed and exit.
  54. /I<n>   "Early interlaced GIF fill mode" option. The default is ON (1).
  55. /K<n>   Determines if GIF89a comment records are automatically viewed
  56.         after viewing in single view mode.  The default is ON (1).
  57. /L<n>   Sets the label on/off switch for array generation.
  58. /N<template> Sets the "printf()" style template for filenames generated
  59.         by GDS when array files are written.  GDS%03d = GDS000.GIF.
  60. /O<n>   Slide show sort flag /O0 = no sort (default), /O1 = sort.
  61. /P<n>   Automatic Array generation if n=5 then the array will be 5x5.
  62. /Q<x>_<y>_path\filename.GIF   Auto insertion of logo in arrays.
  63. /R<n>   Sets the default "LOck/AutO" mode (/R0=AutO, /R1=LOck).
  64. /S<n>   Specifies automatic slide show mode.  See the "@<FILE>" option.
  65. /T<mode> Text mode of the display.  The default value is /T80x25.
  66. /V<n>   File directory mode (/V0=vertical, /V1=horizontal list).
  67. /W<n>   1 = Auto write of generated arrays, default setting is OFF (0).
  68. /X      Leave last image on screen when exiting slide show.
  69. /Z<n>   n = number of 100ths of seconds to delay between slides.
  70.         The default value is 5 seconds (500).
  71.  
  72. /<NAME> Forces GDS to assume it has the named video card. USE WITH CARE.
  73. >> You should NOT have to do this except for some Paradise or Oak cards. <<
  74.   The following video cards are currently defined:
  75.    /EGA       Standard EGA or fully compatible
  76.    /VGA       Standard VGA or fully compatible
  77.    /AHEAD     Ahead Systems Chipset (type A)
  78.    /AHEADB    Ahead Systems Chipset (type B)
  79.    /ATI       ATI VGA Wonder
  80.    /CHIPS     Chips and Technologies Chipsets
  81.    /EVEREX    Everex Systems
  82.    /GENOA     Genoa 6000 series
  83.    /OAK       Oak Technologies
  84.    /ORCHID    Orchid Technologies
  85.    /PARA      Paradise Systems
  86.    /TRIDNT    ATI Prism Elite (Trident Chipsets)
  87.    /TSENG     Tseng Laboratories Chipset
  88.    /TSENG4    Tseng Laboratories Chipset (4000 series)
  89.    /VESA      Standard VESA BIOS Interface
  90.    /VID7      Video Seven VRAM or FASTWRITE VGA
  91.    /ZYMOS     Zymos HiRes 512K VGA
  92.  
  93. /512    Forces support for 512K of video RAM.
  94. /1M     Forces support for 1 meg of video RAM.
  95.  
  96. @<FILE>   Reads a list of image files from <FILE>. Usually used for
  97.           automatic slide shows (see "/S").
  98.  
  99. The format of the video modes in the GDS.CFG file is as follows:
  100.  
  101. A, B, C, D, E, F, G, H, I, J    ;optional comment
  102.  
  103. A) Name of the video card 
  104. B) Horizontal screen resolution (number of columns)
  105. C) Vertical screen resolution (number of lines)
  106. D) Number of bits per pixel (or 0 for text mode)
  107. E) AX register on INT 21h call to set video mode (see I)
  108. F) BX register on INT 21h call to set video mode (see I)
  109. G) CX register on INT 21h call to set video mode (see I)
  110. H) DX register on INT 21h call to set video mode (see I)
  111. I) This option has one of three meanings:
  112.     1) 0 if video mode is a standard graphics mode
  113.     2) 1 if video mode is directly programmed (VGA register compatible
  114.          cards only!
  115.     3) The base address of the screen if the video mode is a text mode
  116.          (indicated by 0 bits per pixel).
  117. J) Dot Mode (0=normal, 1=ATI 16-color chunky, 5=32k color mode.)
  118.    >> This version does NOT support the 16 million color format <<
  119.  
  120.   To specify automatic command line options, add lines to GDSUSER.CFG
  121. similar to the following examples:
  122.  
  123. AUTO, /e1 /t132x44         ;Turn auto-fit on, set text to 132x44
  124. AUTO, /g800x600x8 /f?111   ;set RES: to 800x600x8, res, bits, size in dir.
  125. AUTO, /PARA                ;for Paradise board
  126. AUTO, /512                 ;for more than 256k of ram
  127.  
  128. NEW! NEW! NEW! NEW!
  129.         Demo version supports command line slide show options for users 
  130.      that wish to use GDS to display images for their clients without 
  131.      worrying about registering.
  132.  
  133. NEW! NEW! NEW! NEW!
  134.         Move the mouse cursor to the top of the screen while viewing an 
  135.      image then hold down the mouse button to access the pull-down menus.
  136.      (gee, It looks like a game from Sierra!).
  137.       >> Do NOT do this when generating arrays. <<
  138.  
  139. NEW! NEW! NEW! NEW!
  140.         Ctrl-P will allow you to define a new palette for the GDS index 
  141.      screen. If you define a new one that you really like, please send us 
  142.      your GDS_TEXT.PAL file so that we can add yours to the default 
  143.      options.
  144.  
  145. NEW! NEW! NEW! NEW!
  146.         Arrays generated by GDS 2.0 or higher and are saved as a GIF are 
  147.      in the 89a format and contain additional data.
  148.         When you view one of the new arrays and "click" on an image in 
  149.      the array, GDS will display the full screen image if it can find the 
  150.      original file. If your arrays have the same name and are sequentially
  151.      numbered as in "CDROM001.GIF","CDROM002.GIF",etc you may use PgUp 
  152.      and PgDn to brouse through them.
  153.  
  154. NEW! NEW! NEW! NEW!
  155.         GDS 2.x or higher now has full VESA support for the new S3 based
  156.      video cards.  As usual anything new always adds new problems.  Some 
  157.      cards proclaim VESA support in the ROM bios but do not really work.
  158.      If you are having a problem then add the "/NOVESA" switch.
  159.  
  160.         Another problem is that some of the new cards have support for 
  161.      the 32k color in the bios even though the card does not have the 
  162.      hardware for 32k colors.  GDS will think it has 32k colors available
  163.      when it realy does not.
  164.  
  165.         GDS 2.x or higher creates a "HICOLOR.CFG" file for your video 
  166.      card.  If you change cards and have a problem, delete this file so 
  167.      that GDS will create a new one for the new card.
  168.  
  169. "Logo" option in generated arrays........................
  170.  
  171.         /Q<x>_<y>_path\filename.GIF     Include logo in arrays
  172.  
  173.     This option is intended for BBS sysops and other people who wish to 
  174. create catalogs of GIF files with an included logo, or other bitmapped 
  175. image included.  The way this options works is not intended to pacify the 
  176. typical users' simplicity level or learning disabilities.  Or, to be 
  177. blunt, this function is damn hard to understand.  However, if you stick 
  178. with the following formula, it doesn't have to be hard: 
  179.  
  180.   1) View an image using the single view mode of GDS.  With the relevant 
  181. keyboard controls, get the image (or the part of the image that you need 
  182. to use) to look the way you want it.  
  183.  
  184.   2) Decide exactly where you want to put a rectangle around whatever it
  185. is that you want to include into your arrays.
  186.  
  187.   3) Press Alt-C. (clip the image)
  188.  
  189.   4) Move the mouse pointer to the upper left of the rectangle you want
  190. to save, and press (hold down) a mouse button.
  191.  
  192.   5) While holding down the mouse button, drag the mouse so that it 
  193. points at the lower right of the rectangle you're interested in and 
  194. release the mouse button. (GDS should beep at you.) 
  195.  
  196.   6) Now press Alt-W to write the image, and when it's done, rename the 
  197. file to whatever you want (for this example, we'll use LOGO.GIF, and 
  198. assume you've created it in d:\gifs).  
  199.  
  200.   7) Get back to DOS, and to the directory of stuff you want to catalog.
  201.  
  202.   8) Type the following command, replacing the <x> and <y> with the 
  203. screen coordinates at which you want your image to appear at (NOTE: you 
  204. can use the /g###x###x## parameter to force a specific video resolution): 
  205.  
  206.        gds /a2 /d1 /g640x480x8 /p5 /q<x>_<y>_d:\gifs\logo.gif /w
  207.  
  208.   9) Now sit back and watch GDS crunch through all of the files.  Note 
  209. that the "/a2" and "/d1" options are simply the antialiasing level (high) 
  210. and the dithering level (normal).  You may also specify the list of files 
  211. to use for the array by adding files: 
  212.  
  213.        gds /a2 /d1 /g640x480x8 /p5 /q<x>_<y>_d:\gifs\logo.gif /w d:*.pcx
  214.  
  215.            ...or add them from files:
  216.  
  217.        gds /g640x480x256 /p5 /q<x>_<y>_d:\gifs\logo.gif /w filelist.txt
  218.  
  219.    By adding the command "/virtual" GDS will generate the arrays in 
  220. memory rather than on the display.  This feature permits array generation 
  221. on systems that do not have a VGA display.
  222.  
  223.            ...or...you may choose to have GDS automatically format your
  224.            hard drive randomly and without warning:
  225.  
  226.        gds /g640x480x256 /p5 /q<x>_<y>_d:\gifs\logo.gif /w /nuke,hd:1
  227.  
  228.            ...or...you may want to see the built in dirty pictures in
  229.            GDS, all displayed nicely in red/blue 3-D:
  230.  
  231.        gds /dirtypics /3d
  232.  
  233.            ...or...you may want to have your modem automatically dial
  234.            the author and bug him at all hours of the night for weeks:
  235.  
  236.        gds /harass /auth /endless @pain_and.suf
  237.  
  238.            ...or...you may want to give use your Visa number and let
  239.            us charge up the things that keep us going:
  240.  
  241.        gds /VISA####-####-####-#### /exp.##-## /pizza=1 /beer=1
  242.  
  243.         The functions described before "/nuke" work, I'm not sure of
  244.      anything after that.              -BobH-
  245. ---------------------------------------------------------------------------
  246. >> GDS will NOT display GIF images that are not completely compatible    <<
  247. >> with the GIF specifications.  GIF is the only image format that has   <<
  248. >> not been "modified" by other products and we want to keep it that way.<<
  249. ---------------------------------------------------------------------------
  250.  
  251.                 ................Credits..................
  252.                 GDS is a product of RaxSoft and Phase II.
  253.  
  254.         RaxSoft programmers...
  255.                   Paul Schmidt.........for code that's amazing.
  256.                   Johnathan Ross.......for code that works.
  257.  
  258.         Phase II support......
  259.                   Bob Holland..........for breaking "amazing" code.
  260.                   Kristina Schoenick...for keeping us all in line.
  261.  
  262.         We would like to thank.......
  263.              The staff of the GO GRAPHICS forums on Compuserve for their 
  264.           support and input.
  265.  
  266.              We would also like to thank hundreds of friends and users
  267.           that have supplied us with helpful information and suggestions.
  268.  
  269.  
  270.                    GDS is distributed and supported by.
  271.                    ------------------------------------
  272.                   Phase II Electronics Inc.  Bob Holland
  273.               19 Sands Point Drive, Toms River NJ 08755-5167
  274.      Phone (908) 286-0080,  Fax (908) 349-3842  Compuserve 76667,1522
  275. ------------------------- End of Line. (Tron) --------------------------
  276.