home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / computers / pcjr / games / EGAUTILS.LZH / EGACAM.DOC < prev    next >
Text File  |  1987-05-20  |  10KB  |  213 lines
  1.                         ****************
  2.                         *    EGACAM    *
  3.                         ****************
  4.                    A Screen-Image Capture Utility
  5.  
  6.     EGACAM.COM  is a memory-resident screen image capture program. To use it,
  7.     you must first install it. The program can be invoked by pressing the
  8.     Hot-key "shutter" Alt-PrtSc. This operation will take the contents of the
  9.     currently active screen buffer and write it in a file.  The contents of the
  10.     mode and color registers will also be saved so that the image will be
  11.     displayed with the settings in effect when its picture was taken.  Screen
  12.     image information will be stored in a compressed mode.  This is true for
  13.     text and graphic modes.
  14.  
  15.     EGACAM is an upgrade of the CAMERA program that forms part of the PRESENT
  16.     Silde Presentation System. The upgrade will now capture EGA-mode graphic
  17.     images and saves them onto a disk. The format used for EGA-node PICs is one
  18.     that is compatible to the newer versions of PRESENT. They can be viewed
  19.     with the PICOPY utility.
  20.  
  21.     The camera's "film" consists of a file name pattern with an optional
  22.     drive address.  The name pattern is a valid file name only 6 characters
  23.     long.  Pictures will be stored in a file whose name begins with the 6
  24.     characters of the pattern followed by a two digit number which will be
  25.     incremented every time a picture is taken.  The extension will always
  26.     be forced to .PIC.  If less than 6 characters are specified in the
  27.     pattern, zeroes will be added to the right.  However, the count will
  28.     always be between 00 and 99.  If more than 100 pictures are taken the
  29.     number will be reset to 0.
  30.  
  31.     Command syntax:
  32.  
  33.     There are two options for the Camera command:
  34.  
  35.     Option 1:
  36.  
  37.         EGACAM [Drive:]Pattern
  38.  
  39.         Where:  Drive (optional, if not present the default will be used)
  40.                 is the drive letter where the pictures will be stored.
  41.  
  42.                 Pattern is a one to six character field (no wildcards) that
  43.                 will become the first six characters of the filenames of
  44.                 the pictures to be stored. If less than 6 are given, the
  45.                 remainder will be filled with zeroes.
  46.  
  47.         Note: Path names are not permitted.
  48.  
  49.     Option 2:
  50.  
  51.         EGACAM  (enter)
  52.  
  53.  
  54.     Option 1 is used to install the camera or to change the drive and
  55.     filename pattern. (to change its "film")
  56.  
  57.     Option 2 is used to toggle the camera on or off. If the camera was on
  58.     it will be turned off and vice-versa. (when the camera is turned off it
  59.     will remain in memory but it will not take pictures)
  60.  
  61.     TAKING PICTURES
  62.  
  63.     When the camera is installed and active, two key combinations can be
  64.     used to take pictures.  Pressing Alt-PrtSc will store the contents of
  65.     the currently active screen buffer into the specified file and pressing
  66.     Alt-Shift-PrtSc will store the contents of the color screen buffer into
  67.     the specified file and assume that a graphics picture is being taken.
  68.     This command can be given at either the command level or at an
  69.     application program level.  Although precautions have been made to allow
  70.     its use at anytime, we recommend that you take "still pictures".  That is
  71.     to say that there be no disk activity in progress when a picture is being
  72.     taken.  The camera will not signal when it has finished taking a picture,
  73.     you will simply notice that the disk in use light goes off.  On the other
  74.     hand if CAMERA encounters a problem while taking a picture, it will beep to
  75.     indicate that something went wrong, either that the disk was full, the
  76.     drive was not ready, the disk was write protected, or that there was
  77.     another error related to a disk I/O operation.  Because of this audible
  78.     signal, we urge you to be on the lookout when taking a picture while
  79.     the speaker is making sounds.
  80.  
  81.     Because of the way EGACAM is interfaced with DOS the picture taking may
  82.     not always be immediate and the program may have to wait for an
  83.     interrupt to occur before storing the display contents into a disk, so
  84.     be patient. One of these occasions occurs when taking pictures from the
  85.     DOS prompt, when you press the keys nothing will happen but if you
  86.     press the enter or enter a command, the picture will be stored.
  87.  
  88.     NOTE: When CAMERA's graphics shutter (Alt-PrtSc) is released, it will
  89.          look at the BIOS Video Display Data Area to determine the current
  90.          mode setting in order to take the correct graphics, 40x25 text,
  91.          80x25 text or monochrome picture.
  92.  
  93.          However, there are some programs that do not update the BIOS Video
  94.          Display Data Area when changing modes directly without using BIOS.
  95.          These tend to be camera shy when displaying text screens and
  96.          EGACAM may not be able to take the right picture.  One of these
  97.          programs is 1-2-3 (TM Lotus Corp.).  Pressing Alt-PrtSc will take
  98.          a picture of the text screens, pressing Alt-Shift-PrtSc will take
  99.          the picture of the graph when it is being displayed.  If you press
  100.          Alt-Shift-PrtSc when the color screen is displaying text, the
  101.          result will be a "compressed" garbage file.
  102.  
  103.     The pictures taken by EGACAM will always have file sizes that are
  104.     multiples of 512 bytes to make the best use of a diskette.  Text files
  105.     will either be 2048 or 4096 bytes in size depending on whether they are
  106.     40 or 80 columns texts respectively.  Graphics picture sizes will vary
  107.     from 512 bytes to 16K depending on the pictures complexity.  Obviously,
  108.     EGACAM's pictures will be compatible with the PRESENT system programs.
  109.  
  110.     The EGACAM program behave like a single lense reflex camera in the
  111.     sense that what you see is what you get.  Technically speaking this
  112.     means that if you are displaying a text screen on the color monitor,
  113.     EGACAM will point to the buffer currently being used so if what is on
  114.     the screen is one of the 8 buffers of a 40 column image, EGACAM will
  115.     get the right buffer.
  116.  
  117.                                 *********
  118.  
  119.     EGACAM is copyright (C) 1987 by SML Services, Inc.
  120.  
  121.     All versions of EGACAM are not public domain software, nor are they free
  122.     software.
  123.  
  124.     EGACAM is part of the PRESENT Slide Presentation System and its use is
  125.     encouraged by existing PRESENT users.  If you are not familiar with PRESENT
  126.     and wish to know more about it, write for information to:
  127.  
  128.                 SML Services, Inc.
  129.                 6095 River Chase Cir.
  130.                 Atlanta, Georgia 30328
  131.  
  132.                 (404) 953-0792
  133.  
  134.     If you have any questions concerning revisions, updates, or information
  135.     concerning any detected "bugs" or incompatibility problems, please drop us
  136.     a line or call on the telephone.  Technical support is limited to
  137.     registered PRESENT users only.
  138.  
  139.     We are interested in increasing the number of different types of screen
  140.     image files handled by EGACAM.  We encourage you to notify us of formats
  141.     that you might consider worthwhile and any and all technical information on
  142.     how the files are stored.  This means the contents of the file header, as
  143.     well as the compression scheme (if any) used to save storage requirements.
  144.  
  145.     If you are interested in being notified of EGACAM upgrades, or related
  146.     products, register as as EGACAM user by sending us your name, address and
  147.     telephone. You will mailed notices and will be able to receive an upgrade
  148.     disk for $5.00 , ($8.00 outside the U.S.)
  149.  
  150.     You are encouraged to use EGACAM and to share it with others, on the
  151.     following conditions:
  152.  
  153.          1. This note be included in all copies,
  154.  
  155.          2. The name "EGACAM" must be retained,
  156.  
  157.          3. The Copyright and authorship notices contained in the
  158.             program and documentation are not to be altered or removed.
  159.  
  160.          4. The program is not to be distributed to others in
  161.             modified form.
  162.  
  163.          5. No fee is to be charged for copying or distributing
  164.             the program. Exceptions to this rule are made for non-U.S.,
  165.             non-profit, clubs where BBS may not be a viable method of
  166.             distribution. Clubs will be allowed to charge a reasonable
  167.             charge for distributing a disk with the program.
  168.  
  169.     User groups, clubs and BBS's are encouraged to distribute the program and
  170.     documentation, subject to the above limitations.
  171.  
  172.     IN ANY CASE NO COMMERCIAL OR MONEY-MAKING VENTURES WITH REGARD TO SOFTWARE
  173.     SALES OR MODIFICATION AND THE SUBSEQUENT SALE OF THE EGACAM PROGRAM IN
  174.     WHOLE OR ANY PART IS PERMITTED.
  175.  
  176.     Fernando Pertuz
  177.     Alexis Pertuz
  178.     SML Services, Inc.
  179.  
  180.  
  181.  
  182.  
  183.          ----------------end-of-author's-documentation---------------
  184.  
  185.                         Software Library Information:
  186.  
  187.                    This disk copy provided as a service of
  188.  
  189.                         The Public (Software) Library
  190.  
  191.                   Disks in the library are updated monthly.
  192.          For a copy of the latest monthly software library newsletter
  193.           and a list of the 800+ disks in the library, call or write
  194.  
  195.                         The Public (Software) Library
  196.                                P.O.Box 35705 K
  197.                            Houston, TX 77235-5705
  198.                                (713) 721-6104
  199.  
  200.          We are not the authors of this program, nor are we associated
  201.          with the author in any way other than as a distributor of the
  202.          program in accordance with the author's terms of distribution.
  203.  
  204.          Please direct shareware payments and specific questions about
  205.          this program to the author of the program, whose name appears
  206.          elsewhere in  this documentation. If you have trouble getting
  207.          in touch with the author,  we will do whatever we can to help
  208.          you with your questions. All programs have been tested and do
  209.          run.  To report problems,  please use the form that is in the
  210.          file PROBLEM.DOC on many of our disks or in other written for-
  211.          mat with screen printouts, if possible.
  212.  
  213.