home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0010 - 0019 / ibm0010-0019 / ibm0010.tar / ibm0010 / CSHOW82A.ZIP / CSHOW8A.DOC < prev    next >
Encoding:
Text File  |  1990-08-14  |  38.8 KB  |  945 lines

  1.                                =================
  2.                                C o m p u S h o w
  3.                                =================
  4.  
  5.  
  6.  
  7.  
  8.                             Standard Version 8.20a
  9.  
  10.                                     for the
  11.                  IBM PC, XT, AT, PCjr, PS/2 (and compatibles)
  12.                                      with
  13.  
  14.                      Hercules Monochrome Graphics Adapter
  15.                                       or
  16.                          Color Graphics Adapter (CGA)
  17.                                       or
  18.                         Enhanced Graphics Adapter (EGA)
  19.                                       or
  20.                        Multi-Color Graphics Array (MCGA)
  21.                                       or
  22.                           Video Graphics Array (VGA)
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  Execute CompuShow  by typing  CSHOW (and  a <Carriage  Return>) at  your  DOS
  32.  prompt. The program requires at least 212k of available memory (depending  on
  33.  the "start-up options" specified.) If  the program displays an  "Insufficient
  34.  memory" message, you need to make more memory available. (Remove some memory-
  35.  resident programs, for example.)
  36.  
  37. Start-Up Options
  38. ================
  39.  
  40.  "Command-line switches" let you control  graphics video features and the  way
  41.  that the program allocates memory for various purposes.
  42.  
  43. Video Hardware Identification
  44. -----------------------------
  45.  
  46.  CompuShow should recognize the type of video adapter present in your computer
  47.  (Hercules, CGA,  EGA, MCGA,  or VGA).  In case  the detect  routine fails  to
  48.  identify the  correct  adapter,  a  command-line  switch  will  override  the
  49.  automatic routine:
  50.  
  51.      >CShow +H          (or +h)       force Hercules mode
  52.      >CShow +C          (or +c)       force CGA mode
  53.      >CShow +E          (or +e)       force EGA mode
  54.      >CShow +B          (or +b)       force EGA (monochrome monitor) mode
  55.      >CShow +M          (or +m)       force MCGA mode
  56.      >CShow +V          (or +v)       force VGA mode
  57.  
  58.  
  59.                                                                         Page 1
  60. "Super-Ega"
  61. -----------
  62.  
  63.  A "/" switch is  used to  indicate the  presence of  a 480  line  "Super-EGA"
  64.  adapter. The program knows about several:
  65.  
  66.      >CShow /A          ( or /a )     Ahead Systems
  67.      >CShow /G          ( or /g )     Genoa
  68.      >CShow /P          ( or /p )     Paradise AutoSwitch EGA-480
  69.      >CShow /T          ( or /t )     Tseng
  70.      >CShow /V          ( or /v )     "VGA" (eg. the Zenith "VGA")
  71.  
  72.  These commands specify graphics modes 38,  115, 80, 37, and 18  respectively,
  73.  which puts  each card  in 480  line EGA  mode. Other  480 line  cards may  be
  74.  identified by supplying the (decimal) graphics mode number, for example:
  75.  
  76.      >CShow /71                       to use mode 71 for 640x480 EGA
  77.  
  78. Hardware-Specific Video Drivers:
  79. --------------------------------
  80.  
  81.  CompuShow uses "video drivers" to support  extended graphics modes on a  wide
  82.  variety of video hardware.   With the standard  (version 8.20a) program,  the
  83.  video drivers  are  included as  separate  disk files,  named  "videoP1.drv",
  84.  "videoI4.drv", etc. The "+S" command-line switch tells the program to load  a
  85.  specific video driver, for example:
  86.  
  87.                 >CShow +sP1
  88.  
  89.  loads the "P1" video driver ("videoP1.drv").
  90.  
  91.  To set up a video driver to be used whenever the program is started:
  92.  
  93.                 >copy videoP1.drv video.drv
  94.  
  95.  With no "+S" switch specified, the program will load file "VIDEO.DRV".
  96.  
  97.  With the enhanced (version  8.20b) program, the  video (and printer)  drivers
  98.  are "built in to" and selected with the System Configuration program  CSHOWI.
  99.  When  you  select  a  video  driver  with  the  CSHOWI  program,  it  creates
  100.  "VIDEO.DRV", which is loaded automatically at program start-up.
  101.  
  102.  +-------------------------------------------------------------------------+
  103.  | FOR A COMPLETE, UP-TO-DATE LISTING OF THE VIDEO DRIVERS, SEE README.DOC |
  104.  +-------------------------------------------------------------------------+
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                                                         Page 2
  119. Optional Features
  120. -----------------
  121.  
  122.  A "#" switch is used to specify optional features:
  123.  
  124.      >CShow #E          ( or #e )     DISABLES horizontal EGA panning
  125.  
  126.  Some EGA adapters have trouble with  horizontal panning. If your EGA  display
  127.  is "scrambled", use the #E switch.
  128.  
  129.      >CShow #J          ( or #j )     ENABLES PCjr/Tandy-1000 video modes
  130.  
  131.  The program  will reserve  32k of  memory required  for these  special  video
  132.  modes. (Without this switch, the memory  is available for the program to  use
  133.  for other purposes.)
  134.  
  135.      >CShow #MS         ( or #ms )    allocate MEMORY for a SMALL buffer
  136.      >CShow #MM         ( or #mm )    allocate MEMORY for a MEDIUM buffer
  137.      >CShow #ML         ( or #ml )    allocate MEMORY for a LARGE buffer
  138.  
  139.  This option lets you control the  amount of memory that the program  reserves
  140.  for reading the graphics file. The small  buffer is 2k, the medium buffer  is
  141.  32k, and the large buffer  is 62k. A small (2k)  buffer is the default.  (The
  142.  size of the read  buffer DOES NOT  determine the maximum  size file that  the
  143.  program can display: a 45k file requires 23  reads with a 2k buffer, 2  reads
  144.  with a 32k buffer, and 1 read with a 62k buffer.)
  145.  
  146.      >CShow #D300
  147.  
  148.  This option  lets you  control the  amount of  memory reserved  for the  file
  149.  directory. The "default" is 120 files. You  may specify any number from 0  to
  150.  9999.
  151.  
  152.      >CShow #Q
  153.  
  154.  Turns off the sounds that the program makes (Quiet).
  155.  
  156. Missing files
  157. -------------
  158.  
  159.  There are a number of associated files that make up the CompuShow  "package",
  160.  including documentation, device  drivers, etc. CompuShow  checks to see  that
  161.  its files are present on the same disk and sub-directory as the program,  and
  162.  displays a "missing files" message for 15 seconds at program start-up if  one
  163.  or more files are missing.
  164.  
  165.  The program "remembers" if it's been run with all files present, so that  you
  166.  may erase  documentation or  driver files  that  you no  longer need.  We  do
  167.  recommend, however, that you make a copy of the original disk or archive file
  168.  before you erase any files from your disk.
  169.  
  170.  Please remember that you MUST INCLUDE ALL FILES when you pass CompuShow on to
  171.  a friend, or post it on a BBS.
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                                                         Page 3
  178. Dual Monitor Operation
  179. ======================
  180.  
  181.  On a system with both a monochrome  and color graphics (CGA, EGA, VGA,  etc.)
  182.  adapter installed, start the program on the monochrome monitor to operate  in
  183.  dual monitor  mode.  The  directory  screen will  appear  on  the  monochrome
  184.  monitor, and graphics images on the color graphics monitor.
  185.  
  186.  When you finish displaying  a graphic, press <Carriage  Return> to leave  the
  187.  graphic image on screen, or <ESCape> to clear the graphics screen.
  188.  
  189. [F1] for Help
  190. =============
  191.  
  192.  Press the [F1] function key  to pop up a  quick-reference Help Screen with  a
  193.  brief description of the options available.
  194.  
  195. [Shift-F1] for Information
  196. ==========================
  197.  
  198.  Hold a  shift key  and  press the  [F1]  function key  to  pop up  a  Program
  199.  Information box, which identifies the options you've specified and the amount
  200.  of memory used by the program  for various purposes. Several of the  start-up
  201.  options control the way the program  allocates memory. This is important  for
  202.  several reasons.
  203.  
  204.   - The amount of Display  Memory determines the  extents for panning  images,
  205.     and can affect  the operation  of transparency and  "restore to  previous"
  206.     functions.
  207.  
  208.     The (default)  small read  buffer provides  the most  memory for  a  large
  209.     virtual screen. If you specify a larger read buffer (eg. with the "#MM" or
  210.     "#ML" command line switch), you take memory away from the virtual screen.
  211.  
  212.   - If you have a lot of files in the directory, and the program needs  memory
  213.     to pop up a box, it will have to "abandon" the sorted file list. When  you
  214.     return to the directory screen, the  program will retrieve, sort, and  re-
  215.     display the directory, and  you will be  placed at the  first file on  the
  216.     first screen.
  217.  
  218.     The "#D" option  lets you reserve  memory for  a directory of  up to  9999
  219.     files, so that the  program won't have  to "abandon" it  to pop up  boxes.
  220.     Keep in  mind that  reserving memory  for a  large directory  leaves  less
  221.     memory for the virtual screen.
  222.  
  223. Changing the directory display
  224. ==============================
  225.  
  226.  The program  automatically selects  a  format to  display  as many  files  as
  227.  possible on each screen.  If you have  more than one  screen of files,  press
  228.  PgDn/PgUp (with  the cursor  in the  input area)  to view  the  next/previous
  229.  directory screen.
  230.  
  231.  - At the input area, you may change to  a different disk drive by typing  the
  232.    drive designation and  pressing the [F2]  key. For example,  type "A:"  and
  233.    press [F2] to switch to drive A:.
  234.  
  235.  
  236.                                                                         Page 4
  237.    You may also change  to a different  sub-directory. Type the  sub-directory
  238.    name in the input area and press [F2]. The sub-directory specification  can
  239.    be  any  form  acceptable  in  a  DOS  "ChDir"  command,  such  as  "\"  or
  240.    "..\..\OTHER". You can also combine a drive and sub-directory change,  such
  241.    as "B:\PICS".
  242.  
  243.      Press [Alt-A] or [Alt-B] to change to drive A: or B:.
  244.  
  245.      Press [Shift-F2] to change to your "original" (drive and)  sub-directory;
  246.      where you were when you started CompuShow.
  247.  
  248.      Press [Ctrl-F2] to change to the (drive and) sub-directory containing the
  249.      CompuShow program.
  250.  
  251.      Press [Alt-F2] to change to the "start-up" (drive and) sub-directory that
  252.      you installed with CShowI (with the enhanced program.)
  253.  
  254.  - Press [F3] to  "toggle" between the  compressed directory display  (4 or  6
  255.    columns) and a wide  directory display (two  columns, including file  name,
  256.    size, date, and time.)
  257.  
  258.  - Enter a directory mask and press [F4]. Type "*.GIF" and press [F4] to limit
  259.    the directory display to all files with a ".GIF" file name extension. Press
  260.    [F4] with a blank mask to reset the directory mask to "*.*".
  261.  
  262.  - Press [F5] to pop up a directory sort box:
  263.  
  264.     - Press "C" for a Complete directory display with the volume label, hidden
  265.       files and sub-directories, including  "." (this sub-directory) and  ".."
  266.       (the directory "above"). Press "O" to display Only files.
  267.  
  268.     - Press "U", "N", "E", "S", or "D" for Unsorted (DOS sequence) or to  sort
  269.       the directory on Name, Extension, Size, or Date.
  270.  
  271.     - Press "F"  or  "B"  for Forward  (ascending)  or  Backward  (descending)
  272.       sequence.
  273.  
  274.     - Press carriage return when you're done.
  275.  
  276. Selecting a file to display
  277. ===========================
  278.  
  279. Method 1: Enter the name of the file
  280. ------------------------------------
  281.  
  282.  Type the name of any file and press <Carriage Return> to select it. Note that
  283.  you may use this method  to specify a file that's  not in the displayed  file
  284.  list.  (You  may  need  to  include   the  drive  and  subdirectory,  as   in
  285.  "c:\pics\special\hidden\other.gif"). When  you press  <Carriage Return>,  the
  286.  file will be retrieved, or a "beep" will sound if it was not found.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                                                         Page 5
  296. Method 2: Selecting from the directory list
  297. -------------------------------------------
  298.  
  299.  Press the "up arrow" cursor key to move into the directory display, then:
  300.  
  301.   - "Down arrow" ("Up arrow") moves you to the next (previous) file.
  302.  
  303.       - At the  last  (first)  file  on  the screen,  you  move  to  the  next
  304.         (previous) screen, if there is one.
  305.  
  306.   - PgDn (PgUp) moves you to the bottom (top) of the column.
  307.  
  308.       - At the bottom  (top) of the  column, you move  to the next  (previous)
  309.         screen.
  310.  
  311.   - Ctrl-PgDn (Ctrl-PgUp) moves you to the next (previous) screen.
  312.  
  313.   - Ctrl-End (Ctrl-Home) moves you immediately to the last (first) screen.
  314.  
  315.   - A letter key (A..Z) moves you to the next file starting with that  letter.
  316.     (Type "A" repeatedly to move to each file starting with "A".)
  317.  
  318.  When you find a  graphic that you want  to display, press <Carriage  Return>.
  319.  Press ESCape to return the cursor to the input area.
  320.  
  321. Directory "Goodies"
  322. ===================
  323.  
  324.  There are four "file functions" available while you're "in the directory":
  325.  
  326.   ChDir At a sub-directory (identified by  <DIR>), press <Carriage Return>  to
  327.         change to that sub-directory.  Sub-directories are displayed when  you
  328.         select "C"omplete in the [F5] directory sort box. Remember that "." is
  329.         "this directory" (so  nothing happens  when you attempt  to change  to
  330.         "."), and ".." is "the directory above".
  331.  
  332.   DEL   Press Alt-D to delete the current file. (You must confirm a delete  by
  333.         responding "Y".)
  334.  
  335.   REN   Press Alt-R to REName the current file. Enter a new name for the file,
  336.         or press ESCape (or just leave  it blank and press <carriage  return>)
  337.         to change your mind about renaming it.
  338.  
  339.   COPY  Press Alt-C to  copy the  current file. Enter  the "destination"  file
  340.         name, or press  ESCape (or  just leave  it blank  and press  <carriage
  341.         return>) to change your mind about copying it.
  342.  
  343.  NOTE: While parallel to the  DOS commands "REN"  and "COPY", these  functions
  344.  are different in one important respect. You can't use any "short-cuts",  such
  345.  as "?" or "*" wildcards for Alt-R and Alt-C, or "destination only" for Alt-C:
  346.  
  347.  Valid DOS command              CShow function
  348.  ----------------------         -------------------------
  349.  REN  NUMBER1.GIF  N1.*         Alt-R (name>) N1.GIF        (N1.* won't work)
  350.  COPY NUMBER1.GIF  N1.*         Alt-C (name>) N1.GIF        (N1.* won't work)
  351.  COPY NUMBER2.GIF  B:           Alt-C (name>) B:NUMBER2.GIF (B: won't work)
  352.  
  353.  
  354.                                                                         Page 6
  355. The Graphics Information Box
  356. ============================
  357.  
  358.  The top line of each Graphics Information Box identifies the type of  graphic
  359.  file, and any other information available, such as "version", width,  height,
  360.  and number of colors in the graphic.
  361.  
  362.  Monochrome graphics  (CompuServe RLE  and MacPaint)  have a  simple  Graphics
  363.  Information Box, with a single display option. To display the graphic,  press
  364.  "1" or the spacebar.
  365.  
  366.  Color graphics (CompuServe GIF, PC  Paint, PC Paintbrush, Dr. Halo,  ColoRix,
  367.  etc.) have up to 40 display modes listed; for example "EGA 5=320x200x16":
  368.  
  369.    - You may have Hercules,  CGA, PCjr/Tandy, EGA,  MCGA, VGA, "extended  VGA"
  370.      and video driver  modes available, based  on the type  of video  adapter,
  371.      start-up options, and the video driver you've loaded.
  372.  
  373.    - The "5" will appear in a bright text color if it's "recommended" or in  a
  374.      dim color if the graphic is larger than the screen, or has more colors.
  375.  
  376.    - The "=" indicates that this is a  "true" graphic mode. A ":" indicates  a
  377.      simulated mode.
  378.  
  379.    - "320x200x16" means that  the screen is  320 "pixels" (dots)  wide by  200
  380.      pixels high in 16 colors.
  381.  
  382.  To display a  color graphic, press  the key  ("5" in the  above example),  or
  383.  press the spacebar to have the program choose the "best available mode".
  384.  
  385.  Special Modes:
  386.  -------------
  387.  
  388.  On an EGA or  VGA, with a graphic  that's 320x200 or smaller,  a "Z" mode  is
  389.  available:
  390.  
  391.    - If the graphic has  16 colors or less,  this will display it  double-wide
  392.      and double-high using the 640x350x16 or 640x480x16 mode, which will  have
  393.      much truer colors than the 320x200x16 display.
  394.  
  395.    - If it  has more  that 16  colors, it  will be  displayed using  a  "color
  396.      dithering" routine, which simulates over 2000 colors.
  397.  
  398.  On an MCGA or  VGA, five "extended" modes  are available. These modes  should
  399.  work on any PS/2 or other VGA, although they are not "IBM standard" modes.
  400.  
  401.    "[" sets the adapter to 360x480x256 mode.
  402.  
  403.          "]" simulates 720x480x256 by skipping every other pixel horizontally.
  404.  
  405.    "," sets the adapter to 320x400x256 mode.
  406.  
  407.          "." simulates 640x400x256 by skipping every other pixel horizontally.
  408.  
  409.          "/" simulates 640x480x256 by skipping every other pixel horizontally,
  410.              and skipping one row out of every six.
  411.  
  412.  
  413.                                                                         Page 7
  414.  The simulated modes above and the  simulated modes in the video drivers  will
  415.  provide a  good looking  display  on most  graphics,  except for  areas  that
  416.  contain text. Text characters on graphics  screens may be illegible in  these
  417.  simulated modes, since some columns and rows are skipped.
  418.  
  419. RLE Graphics
  420. ============
  421.  
  422.  The RLE format  supports "Medium"  (128x96) and  "High" (256x192)  resolution
  423.  monochrome graphics. While the RLE image is displayed:
  424.  
  425.        - Press  "N"  (or  Alt-N)  to   Negate  the  image.  Some  RLE   images
  426.          (radar/weather maps, for example) should be "negated", which reverses
  427.          black and white, before printing. Without negating, you would print a
  428.          black page with white lines.
  429.  
  430.        - With the enhanced program,  you may print the  image by pressing  "P"
  431.          (or ^P).
  432.  
  433. MacPaint Images
  434. ===============
  435.  
  436.  The information box indicates the number of rows in the MacPaint image.  Each
  437.  image is 576 wide,  and a maximum  of 720 long.  MacPaint images are  usually
  438.  longer than the physical screen. During display:
  439.  
  440.        - The up and down arrow keys "auto-pan", so that the image moves slowly
  441.          up or down the screen until the top or bottom is reached, or until  a
  442.          key is pressed to stop the "auto-pan."
  443.  
  444.        - Home and End jump immediately to the top and bottom.
  445.  
  446.        - Press "N" (or Alt-N) to negate the image.
  447.  
  448.        - On an EGA  or VGA,  press "C" during  the display  to "colorize"  the
  449.          image. The 576x720 image is compressed to 288x360, and displayed with
  450.          shades of reds and browns in place of the black and white image.  The
  451.          [F1]..[F10] function keys allow  you to select  any of ten  different
  452.          pre-defined color palettes.
  453.  
  454.          Press any key to remove the colorized image.
  455.  
  456.        - With the  enhanced  program  you  may print  the  MacPaint  image  by
  457.          pressing "P" (or ^P).
  458.  
  459. CompuServe GIF Graphics
  460. =======================
  461.  
  462.  The information box for a GIF (pronounced "JIF") graphics file indicates  the
  463.  GIF signature and version. CompuShow  supports GIF versions "87a" and  "89a".
  464.  If the GIF  file is an  unknown (future)  version, you will  hear a  "buzzer"
  465.  sound, and  the GIF  version will  blink. The  width, height,  and number  of
  466.  colors in the image are also shown.
  467.  
  468.  
  469.  
  470.  
  471.  
  472.                                                                         Page 8
  473.  During display, if there's an error in the GIF file, the program will make  a
  474.  "buzzer" sound  as the  error is  encountered.  When you  return to  the  GIF
  475.  information box, the  error description  and location  are shown  on the  top
  476.  line:
  477.  
  478.       Version: GIF87a, 320x200x256    Error: End Of File at 36050 [00]
  479.  
  480.  The possible errors are: Bad  Block ID, Bad MinCode,  End of File, Bad  Code,
  481.  Invalid Image, Interlace Overrun,  and Sequential Overrun.  In all cases,  an
  482.  error indicates that the GIF file is damaged (perhaps in downloading), or was
  483.  incorrectly encoded in the first place.
  484.  
  485.  With the release of GIF version 89a (July '90) several exciting new  features
  486.  are supported:
  487.  
  488.   - Text may  be included  for display  with the  graphic. On  an EGA  or  VGA
  489.     system, CompuShow uses a text font "built-in" to the adapter. On any other
  490.     adapter, the program uses the character fonts in the file FONTS.DRV.
  491.  
  492.   - A "user input" request  causes CompuShow to  wait for you  to press a  key
  493.     before continuing, to allow you time  to read text, etc. To indicate  that
  494.     it's waiting for your  keypress, the program sounds  a "click". Press  any
  495.     key to proceed (ESCape will interrupt further processing.)
  496.  
  497.   - Delays between images may be used for  animation or to allow time for  you
  498.     to read text. Delays are also  usually associated with any user input,  so
  499.     that the program can continue after you've pressed a key or the delay time
  500.     has expired.
  501.  
  502.   - Transparency may  be  used  to  create  non-rectangular  images  (or  text
  503.     characters) to appear "on top of" the underlying image.
  504.  
  505.   - Images may  appear which  are "disposed  of" by  restoring to  either  the
  506.     background color or the previous (underlying) image.
  507.  
  508.   - Comments may be  included by  the person  creating the  GIF. After  you've
  509.     viewed a GIF with comments, you're asked whether you want to read them.
  510.  
  511.  As a  rule of  thumb, transparency  and restore  to previous  functions in  a
  512.  640x480x256 GIF will  require a 640k  system, with no  RAM resident  programs
  513.  loaded (TSRs, RAM disks, etc.), so that at least 530k of memory is  available
  514.  to CompuShow. If there isn't  enough memory available, the transparent  color
  515.  will be displayed, and restore  to previous will be  handled as a restore  to
  516.  background.
  517.  
  518.   +-------------------------------------------------------------------------+
  519.   | See  README.DOC for information about "CompuMake Tools"  for converting |
  520.   | your  existing  graphics  images  to GIF,  including  support  for  all |
  521.   | features of the GIF89a format.                                          |
  522.   +-------------------------------------------------------------------------+
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                                                                         Page 9
  532. PC Paintbrush
  533. =============
  534.  
  535.  The information box for a PC Paintbrush PCX file indicates the version,  size
  536.  and number  of colors.  CompuShow  supports PC  Paintbrush version  2.5,  2.8
  537.  (including external  256 color  palette  ".PAL" file),  and 3.0  graphics  in
  538.  2 to 256 colors.
  539.  
  540. PC Paint
  541. ========
  542.  
  543.  The information box for a  PC Paint PIC file  indicates the size, colors  and
  544.  "mode". CompuShow displays mode "G" and "L" graphics with 16 or 256 colors.
  545.  
  546.  Note that PC Paint graphics are displayed  starting at the bottom, so if  the
  547.  graphic is larger than  the screen, it may  appear that nothing is  happening
  548.  until you reach the point where the row is on screen.
  549.  
  550. Dr. Halo
  551. ========
  552.  
  553.  The information box for a Dr. Halo  PIC file indicates the version, size  and
  554.  number of colors. CompuShow supports Dr. Halo versions 2 and 3, and a  number
  555.  of  formats  including  320x200x4,  320x200x16,  640x350x16,  720x348x2   and
  556.  720x348x16.
  557.  
  558. RIX ColoRix and Ega Paint
  559. =========================
  560.  
  561.  The information box for a ColoRix "SCx" file indicates the size and number of
  562.  colors. CompuShow  supports uncompressed  ColoRix files  in a  wide range  of
  563.  sizes and 256 colors.
  564.  
  565.  Ega Paint images are 640x350x16 colors.
  566.  
  567. Targa
  568. =====
  569.  
  570.  Targa 16, 24, or  32 bit, uncompressed or  run-length-encoded, mapped or  RGB
  571.  images may be displayed. (Targa type 1, 2, 9, and 10.)
  572.  
  573. Color Graphic Display
  574. =====================
  575.  
  576.  To display  any  color graphic  (GIF,  PC  Paintbrush, PC  Paint,  Dr.  Halo,
  577.  Rix, Targa, etc.):
  578.  
  579.  - Type any character listed in the Information Box to display the graphic  in
  580.    that mode, or
  581.  
  582.  - Press the  spacebar  to  have  the program  select  the  "best  mode"  (the
  583.    character it will use is  displayed at the cursor),  based on the size  and
  584.    number of colors  in the  graphic. To tell  the program  to consider  video
  585.    driver modes  when  selecting the  best  display mode,  see  "Video  driver
  586.    modes", below.
  587.  
  588.  
  589.  
  590.                                                                        Page 10
  591.      As the image is being displayed, press ESCape or Ctrl-C to interrupt (and
  592.      abort) display of the rest of  the image. (The partial image will  remain
  593.      on the screen. Type <Carriage Return> to return to the information box.)
  594.  
  595.      While the image is displayed:
  596.  
  597.        - Images larger than the PHYSICAL SCREEN can be "panned", using the up,
  598.          down, left and right cursor arrow keys. Press a key (once) to pan  in
  599.          that direction. Panning will stop at the end of the image, or may  be
  600.          interrupted by pressing any key. In addition:
  601.  
  602.              Home/End jump to the upper-left/lower-right corner, 
  603.              Ctrl-Lft/Ctrl-Rgt jump "one screen width" Left/Right, 
  604.              Ctrl-Home/Ctrl-End jump "one screen height" Up/Down.
  605.  
  606.           - The EGA/VGA display pans both vertically and horizontally, and can
  607.             accommodate 16 color images up to 320x1638, 640x819, or 1024x512.
  608.  
  609.           - Other display modes (including  hardware-specific modes) pan  both
  610.             vertically and horizontally, with the maximum size dependent  upon
  611.             the amount of  memory available. (The  [Shift-F1] information  box
  612.             indicates the size of the "virtual screen".)
  613.  
  614.        - The "brightness"  of  any  monochrome  (mode  A..P)  display  may  be
  615.          adjusted, as described below.
  616.  
  617.        - Alt-N negates any monochrome display.
  618.  
  619.        - On an  EGA/MCGA/VGA monitor,  you may  adjust the  appearance of  the
  620.          COLOR image, as described below.
  621.  
  622.        - With the enhanced  program, you may  print an image  by pressing  "P"
  623.          (or ^P).
  624.  
  625. Video driver modes
  626. ------------------
  627.  
  628.  CompuShow doesn't normally consider video driver modes (S..Y) when  selecting
  629.  the best mode to display a graphic with the space bar. However, it will, once
  630.  you tell it which video driver modes work on your adapter.
  631.  
  632.  For example, assume  that modes S,  U, V, and  W work on  your VGA,  (perhaps
  633.  modes T, X, and Y require  additional memory that you don't have  installed.)
  634.  Create a text (ASCII) file named VIDEO.DAT with the characters "SUVW" to tell
  635.  the program that  those four  modes work.  You can  use a  word processor  to
  636.  create the file (make sure you save it non-document, un-formatted, or ASCII),
  637.  or just type in the following at your DOS prompt:
  638.  
  639.         COPY CON VIDEO.DAT
  640.         SUVW
  641.  
  642.  and then press [F6] or Ctrl-Z to write the file.
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.                                                                        Page 11
  650. Adjusting a MONOCHROME image
  651. ----------------------------
  652.  
  653.  An image displayed in EGA/VGA monochrome  mode P may be adjusted by  pressing
  654.  PgUp to make the image brighter, or  PgDn to make it darker. This  brightness
  655.  adjustment is instantaneous.
  656.  
  657.  An image displayed in a Hercules, CGA, or MCGA monochrome mode (A..O) may  be
  658.  adjusted by pressing  PgUp to make  the image  brighter, or PgDn  to make  it
  659.  darker. You may also adjust the image to a particular brightness by  pressing
  660.  the letter key (A..O). This "adjustment" is accomplished by re-displaying the
  661.  image. The previous image is left on the screen, so you can see the effect of
  662.  the adjustment as the new image  replaces the former display. (Displaying  an
  663.  image in monochrome mode H and then  pressing PgUp results in the same  image
  664.  as monochrome mode G.)
  665.  
  666. Adjusting a COLOR image
  667. -----------------------
  668.  
  669.  EGA:
  670.  ----
  671.  
  672.  CompuShow uses a "color dithering" technique for displaying images:
  673.  
  674.     - with more than 16 colors,
  675.     - which are 320 wide (or narrower),
  676.     - when displayed in mode Z ("Zoomed" to 640 wide).
  677.  
  678.  With this technique,  the program  "simulates" over  2000 colors  using a  16
  679.  color EGA palette.  Dithered images  MAY NOT  be adjusted.  However, you  CAN
  680.  adjust the colors of a non-dithered image displayed in EGA modes 7, 9, or  Z.
  681.  The sixteen colors displayed are  numbered 0 to 9 and  A to F. Color zero  is
  682.  always the background.  To select a  color to adjust,  type the color  number
  683.  (0..9 or A..F). That color  will flash, so that you  can see where it is  and
  684.  decide whether it  should be adjusted.  There are two  methods for  adjusting
  685.  colors:
  686.  
  687.  - A selected  color may  be adjusted  by increasing  or decreasing  the  Red,
  688.    Green, or Blue component:
  689.  
  690.                 RED:            decrease [F1]   [F2] increase 
  691.                 GREEN:          decrease [F3]   [F4] increase
  692.                 BLUE:           decrease [F5]   [F6] increase
  693.  
  694.    Each color has a Red, Green, and Blue component with a "weight" of 0..3, so
  695.    pressing [F2] four times will step through all four levels of Red.
  696.      [ 4 (Red) x 4 (Green) x 4 (Blue) = the palette of sixty-four colors. ]
  697.  
  698.  - You may "step through" all sixty-four colors in color number sequence:
  699.  
  700.                 COLOR NUMBER:   decrease [F7]   [F8] increase
  701.  
  702.  The adjusted palette may be saved to disk by pressing Alt-F10 (hold down  the
  703.  Alt key and type the  [F10] function key.) When you  display the GIF file  in
  704.  mode 7, 9,  or Z, the  program automatically uses  this saved palette  (press
  705.  [F9] to see the  original color palette;  [F10] to switch  back to the  saved
  706.  color palette.)
  707.  
  708.                                                                        Page 12
  709.  MCGA/VGA:
  710.  ---------
  711.  
  712.  On an MCGA or VGA adapter, you can adjust the colors of an image displayed in
  713.  any 16 color mode  (5, 6, 7, 9,  or Z) or 256  color mode (8), including  any
  714.  "Super-VGA" modes (S..Y).
  715.  
  716.  - PgUp/PgDn increases/decreases the "brightness" of the image.
  717.  
  718.  - The color may be adjusted:
  719.  
  720.                 RED:            decrease [F1]   [F2] increase 
  721.                 GREEN:          decrease [F3]   [F4] increase
  722.                 BLUE:           decrease [F5]   [F6] increase
  723.  
  724.  As with an EGA, the  adjusted palette is saved  to disk by pressing  Alt-F10,
  725.  and [F9] and [F10] allow you  to review the differences between the  original
  726.  and the adjusted palette.
  727.  
  728.  MCGA/VGA Grayscale:
  729.  -------------------
  730.  
  731.  On an MCGA or VGA adapter, any image displayed in a 16 or 256 color mode  may
  732.  be instantly converted to a "Grayscale", by pressing Alt-G, and returned to a
  733.  color display by pressing Alt-C. While the grayscale image is displayed, PgUp
  734.  and PgDn adjust the brightness of the image.
  735.  
  736. Quitting CompuShow
  737. ==================
  738.  
  739.  At the input area, press ESCape to exit the program and return to DOS.
  740.  
  741. The Enhanced Program
  742. ====================
  743.  
  744.  The enhanced program (CompuShow version  8.20b) includes all features of  the
  745.  standard program, plus:
  746.  
  747.   - Printing of all graphics images on most dot matrix and laser printers.
  748.  
  749.      NOTE that color printing is supported in version 8. See README.DOC for  a
  750.      complete, up-to-date list of supported color printers.
  751.  
  752.   - A "slide show" program with script generator, for automated display of all
  753.     graphics in a "stand-alone" or "operator attended" mode.
  754.  
  755.   - A System Configuration program, which  lets you change screen colors,  and
  756.     specify "start-up" options, making the command-line switches  unnecessary.
  757.     You can also automatically log to  a disk drive and/or sub-directory,  and
  758.     set the type of directory display you want, including:
  759.  
  760.      the [F3] "wide" directory display,
  761.      the [F4] directory mask (eg. "*.GIF"),
  762.      the [F5] directory sort options.
  763.  
  764.  The user's guide describing these features is CSHOW8B.DOC, included with  the
  765.  enhanced program.
  766.  
  767.                                                                        Page 13
  768.                                S H A R E W A R E
  769.                                =================
  770.  
  771.    CompuShow is copyrighted software. However, you are encouraged to copy  and
  772.  share it with others according to the following requirements:
  773.  
  774.       CompuShow may be freely copied and  shared with others, so long  as
  775.       no charge is made for the software, and it is unmodified and copied
  776.       in its  entirety,  including  all  program  documentation  and  all
  777.       support files.
  778.  
  779.       CompuShow may be distributed via modem, provided that all files are
  780.       transmitted (archived) together.
  781.  
  782.    Notice that ShareWare  is copyrighted  software. It's  not "Public  Domain"
  783.  software, nor is  it "free"  software. If you  continue to  use this  program
  784.  beyond a reasonable "trial period", not to  exceed 21 days, you must pay  for
  785.  it by registering.
  786.  
  787.  WHY SHAREWARE?
  788.  --------------
  789.  
  790.    A few  years ago,  we advertised  a (much  simpler) program  in a  national
  791.  computer magazine. Our advertising cost was so high that, even with a  retail
  792.  price of  $45, we  never reached  "break-even"! The  ShareWare concept  turns
  793.  CompuShow into  its own  ad! Our  costs are  reduced, and  we can  price  the
  794.  program accordingly.
  795.  
  796.    ShareWare let's you "try it before you buy it"! You can determine whether a
  797.  program works properly and how easy it is to use, before you pay for it.
  798.  
  799.  WHY REGISTER?
  800.  -------------
  801.  
  802.    Since CompuShow is a ShareWare product,  we don't receive a penny when  you
  803.  download it  from a  commercial information  service, such  as CompuServe  or
  804.  GEnie, from a BBS, or receive it on a disk of ShareWare programs.
  805.  
  806.    Since version 1.7 was released in July 1987, we've continued to improve and
  807.  enhance the program, and have released new versions on a regular basis.  Most
  808.  of the enhancements were suggested by  our registered users, and most of  our
  809.  registered users  have upgraded  as  new versions  are announced.  They  like
  810.  CompuShow and  the  improvements  that  their  registration  fees  have  made
  811.  possible!
  812.  
  813.  If you use CompuShow, you must register:
  814.  
  815.    - Your registration fee makes it possible for us to continue to improve the
  816.      program and  to  provide  similar high  quality  software  at  reasonable
  817.      prices.
  818.  
  819.    - For your registration fee you receive the LATEST VERSION of the  ENHANCED
  820.      PROGRAM.
  821.  
  822.    - As a registered user,  you'll be notified as  new versions are  released,
  823.      and may upgrade for a nominal charge.
  824.  
  825.  
  826.                                                                        Page 14
  827.    - Registered users may purchase other CaSSS software at reduced prices.
  828.  
  829.    - IF YOU USE THE PROGRAM FOR COMMERCIAL PURPOSES, YOU MUST REGISTER.
  830.  
  831.  Registering for the Enhanced Program
  832.  ------------------------------------
  833.  
  834.  For your convenience, we've included an order form (OFORM.DOC) with space for
  835.  all the required information. (Complete it by hand or with a word processor.)
  836.  
  837.                            Prices as of January, 1990
  838.                            --------------------------
  839.  
  840.  Basic registration, 5.25" disk............................. $25
  841.  To receive a 3.5" disk, please add......................... $ 1
  842.  For overseas delivery, please add.......................... $ 2
  843.  Arizona residents, please include 7% sales tax............. 
  844.  
  845.    - Credit Card: Indicate  Visa or  MasterCard, card  number, and  expiration
  846.      date.
  847.  
  848.    - Check or Money Order:  must be in  U.S. funds, drawn on  a U.S. bank.  (A
  849.      Canadian Postal Money Order in US Dollars is acceptable.)
  850.  
  851.    - Sorry, no CODs or Purchase Orders.
  852.  
  853.    - The $2 for overseas shipping IS  NOT REQUIRED for Alaska, Hawaii,  Canada
  854.      or Mexico.
  855.  
  856.    Electronic Mail:  CompuServe Mail: [76555,167]
  857.                      (MCI Mail can be routed to CompuServe) 
  858.                      Internet (BITNET, ARPANET, CICNet, etc.): 
  859.                          76555.167@compuserve.com
  860.                      GE Mail: R.BERRY7
  861.  
  862.    U.S. Mail:        Canyon State Systems and Software
  863.                      Post Office Box 86
  864.                      Sedona, AZ. 86336
  865.  
  866.    Phone:            (602) 282-5070
  867.  
  868.  Orders are shipped first class mail, and registration puts you on our mailing
  869.  list for notification when future versions are available. If you're  ordering
  870.  through a  corporation,  college,  or university  purchasing  department,  an
  871.  individual's name would be advisable, so that upgrade notices don't get  lost
  872.  in "receiving department".
  873.  
  874.  Uploading to a Bulletin Board: 
  875.  -----------------------------
  876.  
  877.  As mentioned, we encourage you to copy and share CompuShow with others. We do
  878.  ask, however, that you  be considerate when  you upload to a  BBS (or give  a
  879.  copy to a  friend, computer  club, or  user group.)  A number  of users  have
  880.  called asking for help because the CompuShow that they downloaded from a  BBS
  881.  was missing documentation, and/or support files. Be kind to the other guy! If
  882.  you're going  to upload  to a  BBS, be  sure you  include ALL  FILES in  your
  883.  upload. Not only  is this a  requirement for distribution  as ShareWare,  but
  884.  
  885.                                                                        Page 15
  886.  it's also the only way to be fair to the people who download it!
  887.  
  888.  Keep in mind that any  upload that doesn't include  all files will result  in
  889.  the display of the "missing files" message.
  890.  
  891.  BBS SysOps and ShareWare Distributors:
  892.  -------------------------------------
  893.  
  894.  We appreciate the distribution of CompuShow on electronic bulletin boards and
  895.  ShareWare disks. If  you have a  version of CompuShow  which may be  outdated
  896.  (the program date is displayed on the second line of the screen), or you just
  897.  want to be sure you  have the latest version, contact  me. I'll send you  the
  898.  most current  version (at  no  charge), and  put you  on  a mailing  list  to
  899.  automatically receive free upgrades when available.
  900.  
  901.  If you see the  "missing files" message at  program start-up, you don't  have
  902.  the full package and  don't have permission to  distribute it. If the  person
  903.  who provided the disk or archive  can't supply the missing files, contact  me
  904.  for the latest complete version.
  905.  
  906.  Viruses and Trojan Horses:
  907.  -------------------------
  908.  
  909.  Due to the growing  concern over computer viruses,  Trojan horses, and  other
  910.  malicious programs,  BBS  SysOps  and  ShareWare  distributors  have  started
  911.  establishing "direct from author" libraries, or providing ONLY that  software
  912.  which they receive  directly from the  author. We feel  this is an  excellent
  913.  policy, and expect to see it become more common as time passes.
  914.  
  915.  For your information,  we post CompuShow  to CompuServe and  GEnie, and  mail
  916.  copies directly to  a number  of BBS  SysOps and  ShareWare distributors.  We
  917.  NEVER post directly to BBS's.
  918.  
  919.  (Just to  put  in  one  last "plug"),  your  concern  about  possible  "virus
  920.  infection" is another  reason to register  the ShareWare that  you intend  to
  921.  continue using.
  922.  
  923.  
  924.   Thank you for your support:   Bob Berry
  925.                                 Canyon State Systems and Software
  926.                                 Post Office Box 86
  927.                                 Sedona, Az. 86336
  928.                                 (602) 282-5070
  929.                                 CompuServe: [76555,167]
  930.                                 Internet:   76555.167@compuserve.com
  931.                                 GEnie:      R.BERRY7
  932.  
  933.  
  934.  
  935.  
  936.  
  937.            Graphics Interchange Format(c) copyright CompuServe Inc.
  938.              GIF(sm) is a Service Mark property of CompuServe Inc.
  939.  
  940.     Copyright (c) 1990, Canyon State Systems and Software (tm), Sedona, Az.
  941.  
  942.  
  943.  
  944.                                                                        Page 16
  945.