home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / FOTO.ZIP / FOTO.DOC next >
Text File  |  1991-03-22  |  10KB  |  264 lines
  1.                                  FOTO 1.00
  2.                                  ---------
  3.  
  4.     FOTO is a utility to take a screen snapshot of an OS/2 character
  5.     mode screen.  The snapshot can be recalled via a hotkey, and it can
  6.     be stored in a disk file.  FOTO is not for PM or other graphical
  7.     applications, or for sessions running in windows--it is only for
  8.     fullscreen character mode sessions.
  9.  
  10.     This is a bit of a "quick & dirty" utility; some amenities are
  11.     missing from the current version.  Most important of these is that
  12.     the hotkeys are fixed and can't be changed by the user.  When time
  13.     permits, we will release a version with user-definable hotkeys.
  14.  
  15.  
  16.     Loading
  17.     -------
  18.     The basic syntax used to load FOTO is:
  19.  
  20.         [d:][path]FOTO [/Q] [FILE=[d:][path]name[.ext]]
  21.  
  22.     When loaded without any parameters, FOTO loads and remains resident
  23.     (in background) awaiting a hotkey wakeup call; you are returned to
  24.     the OS/2 command prompt.
  25.  
  26.     The /Q option specifies "quiet" operation; with this option, FOTO
  27.     will not make any noise unless an error is encountered and FOTO is
  28.     unable to display a message.
  29.  
  30.     The FILE option allows you to specify a filename for the snapshot
  31.     file; if no name is specified, FOTO will use the name FOTOxx.TXT,
  32.     where xx is the two-digit number that identifies the current
  33.     session.  It will be located in the root directory of the drive that
  34.     contains FOTO.EXE.
  35.  
  36.         NOTE: all FOTO keywords except ALL (i.e., FILE, SESSION,
  37.         LIST, and KILL) can be truncated to as little as one
  38.         character.  For example, any of "L", "LI", "LIS", and
  39.         "LIST" will be accepted.
  40.  
  41.     An example of a complete load command:
  42.  
  43.         d:\os2util\foto /q f=c:\snap.txt
  44.  
  45.     This example loads FOTO, specifies quiet operation, and causes FOTO
  46.     to use a file named C:\SNAP.TXT for snapshots written to disk.
  47.  
  48.     When FOTO loads, it will display a brief report indicating the
  49.     current session number (in hex), the snapshot filename, and a
  50.     reminder of the hotkey assignments.
  51.  
  52.     NOTE: while FOTO is loaded, its executable file (FOTO.EXE) is
  53.     protected by the system and cannot be deleted or moved.
  54.  
  55.  
  56.     Taking snapshots
  57.     ----------------
  58.     Once loaded, FOTO can be called up at any by pressing Alt-P (think
  59.     of Photo).  The screen must be in text mode, else FOTO will beep at
  60.     you and refuse to pop up.
  61.  
  62.     FOTO pops up a window and displays a brief menu:
  63.  
  64.         FOTO option menu
  65.         F - snapshot to file and memory
  66.         M - snapshot to memory only
  67.         U - unload FOTO
  68.         Enter option (or ESC):
  69.  
  70.     Press 'F' to take a snapshot of the current screen, save it in
  71.     memory, and copy it to the snapshot file; a brief tone sounds to let
  72.     you know that the operation was successful.  A double-pitch tone
  73.     sounds if there is a problem (disk full, bad filename, write
  74.     protected, etc.)  If the snapshot file already exists, the new
  75.     screen will be appended to it; a divider row of hyphens is placed
  76.     below each screen photo.  A brief tone
  77.  
  78.     Press 'M' to take a snapshot of the current screen and save it in
  79.     memory only; the snapshot is not appended to the snapshot file.  A
  80.     brief tone sounds to let you know that the snapshot was successful.
  81.  
  82.     Press 'U' to unload FOTO from memory.
  83.  
  84.     Press ESC to return to the active session without taking any action.
  85.  
  86.  
  87.     Quick memory snapshots
  88.     ----------------------
  89.     To take a memory snapshot at any time, press Shift-Alt-P.  This is
  90.     equivalent to pressing Alt-P and selecting M from the menu.  A brief
  91.     tone sounds to let you know that the snapshot has been taken.
  92.  
  93.  
  94.     Viewing snapshots
  95.     -----------------
  96.     To view a previous snapshot (taken with Shift-Alt-P or 'M' from the
  97.     menu), press Alt-V.  You must be in the same screen mode (text, same
  98.     number of rows and columns) as when the snapshot was taken.
  99.  
  100.     Press any key to return to the live screen.
  101.  
  102.  
  103.     Unloading FOTO
  104.     --------------
  105.     You can unload FOTO by selecting 'U' from the menu (as described
  106.     above) or from the command line.  To unload from the command line:
  107.  
  108.         [d:][path]FOTO KILL
  109.  
  110.  
  111.     Selecting a session
  112.     -------------------
  113.     FOTO is active only within a single session (sometimes called a
  114.     "screen group").  Normally, this will be the session that was active
  115.     when you loaded FOTO.  However, you can select a different session
  116.     for both loading and unloading FOTO.
  117.  
  118.     To select a session into which FOTO will be loaded, add the SESSION
  119.     option to your FOTO command:
  120.  
  121.         FOTO SESSION=n
  122.  
  123.     'n' is the 1- or 2-digit session number, in hex.  For example, to
  124.     load FOTO in session 0B:
  125.  
  126.         FOTO SESS=0B
  127.  
  128.     With this command line, FOTO is active only in session 0B, not in
  129.     the current session (unless the current is session 0B!).  If there
  130.     is no such active session, FOTO will load anyway; it will become
  131.     active if and when a session with that number is created.
  132.  
  133.     To unload a copy of FOTO from another session, simply add the
  134.     SESSION parameter to the KILL command:
  135.  
  136.         FOTO K S=0B
  137.  
  138.     You can load a copy of FOTO in each session; each copy is
  139.     independent, i.e., it has its own snapshot file (unless you specify
  140.     a common name) and its own memory snapshot buffer.
  141.  
  142.  
  143.     "Orphan" FOTOs
  144.     --------------
  145.     If you load a copy of FOTO in a session and then close the session
  146.     without unloading FOTO, you may leave "orphan" copies of FOTO in
  147.     memory.  These have no ill effects, but they do use some memory.
  148.  
  149.     You can use the PLIST program (included) to locate active copies of
  150.     FOTO if you think this has happened.  A report might look like this:
  151.  
  152.         PID   PPID   Session  Name
  153.         -----  -----  -------  ----
  154.         x0005  x0003    x20    PMEXEC
  155.         x000f  x0003    x04    CMD
  156.         x0003  x0000    x01    PMSHELL
  157.         x0002  x0000    x00    (kernel)
  158.         x0004  x0003    x00    HARDERR
  159.         x0011  x000f    x04    FSHL
  160.         x0028  x0011    x04    CMD
  161.         x0025  x0000    x05    FOTO
  162.         x0029  x0028    x04    PLIST
  163.  
  164.     A copy of FOTO is present for session 05, which is now defunct.
  165.     This can be easily removed:
  166.  
  167.         FOTO KILL S=5
  168.  
  169.     You should note that PLIST shows the number of the session that
  170.     activated FOTO, not the session number in which FOTO is actually
  171.     active.  These will be the same unless you explicitly specify a
  172.     session number when loading:
  173.  
  174.         FOTO S=0C
  175.  
  176.     In this case, PLIST would show the number of the session from which
  177.     the FOTO command was executed, not session 0C.
  178.  
  179.     When starting a progam in a separate session for which FOTO would be
  180.     useful, we like to use a batch file:
  181.  
  182.         d:\os2util\foto
  183.         ...run program
  184.         d:\os2util\foto kill
  185.  
  186.     When this is run via START (e.g., START "name" /c /fs batname.cmd),
  187.     the program runs nicely in its own session, and FOTO is loaded and
  188.     unloaded automatically.
  189.  
  190.  
  191.     Listing and unloading all copies of FOTO
  192.     ----------------------------------------
  193.     You can list the session numbers for all active copies of FOTO with
  194.     the LIST option:
  195.  
  196.         FOTO LIST
  197.  
  198.     You can also kill all active copies by adding the ALL option with
  199.     KILL:
  200.  
  201.         FOTO KILL ALL
  202.  
  203.     Remember that, unlike other FOTO keywords, "ALL" cannot be
  204.     abbreviated.
  205.  
  206.  
  207.     Version history
  208.     ---------------
  209.     1.00 03/22/91
  210.         Initial release
  211.  
  212.  
  213.     Copyright/License/Warranty
  214.     --------------------------
  215.     This document and the program file FOTO.EXE ("the software") are
  216.     copyrighted by the author.  If you are an individual, you are
  217.     licensed to:  use the software; make as many copies of the program
  218.     and documentation as you wish; give such copies to anyone; and
  219.     distribute the software and documentation via electronic means.
  220.     There is no charge for any of the above.
  221.  
  222.     However, you are specifically prohibited from charging, or
  223.     requesting donations, for any such copies, however made; and from
  224.     distributing the software and/or documentation with commercial
  225.     products without prior permission.  An exception is granted to
  226.     not-for-profit user's groups, which are authorized to charge a small
  227.     fee (not to exceed $7) for materials, handling, postage, and general
  228.     overhead.  NO FOR-PROFIT ORGANIZATION IS AUTHORIZED TO CHARGE ANY
  229.     AMOUNT FOR DISTRIBUTION OF COPIES OF THE SOFTWARE OR DOCUMENTATION,
  230.     OR TO INCLUDE COPIES OF THE SOFTWARE OR DOCUMENTATION WITH SALES OF
  231.     THEIR OWN PRODUCTS.
  232.  
  233.     THIS INCLUDES A SPECIFIC PROHIBITION AGAINST FOR-PROFIT
  234.     ORGANIZATIONS DISTRIBUTING THE SOFTWARE, EITHER ALONE OR WITH OTHER
  235.     SOFTWARE, AND CHARGING A "HANDLING" OR "MATERIALS" FEE OR ANY OTHER
  236.     SUCH FEE FOR THE DISTRIBUTION.  NO FOR-PROFIT ORGANIZATION IS
  237.     AUTHORIZED TO INCLUDE THE SOFTWARE ON ANY MEDIA FOR WHICH MONEY IS
  238.     CHARGED.  PERIOD.
  239.  
  240.     Businesses, institutions, and governmental entities are prohibited
  241.     from installing or using the software on their systems without
  242.     specific permission from The Cove Software Group.
  243.  
  244.     No copy of the software may be distributed or given away without
  245.     this document; and this notice must not be removed.
  246.  
  247.     There is no warranty of any kind, and the copyright owner is not
  248.     liable for damages of any kind.  By using this free software, you
  249.     agree to this.
  250.  
  251.     The software and documentation are:
  252.  
  253.                            Copyright (C) 1991 by
  254.                           The Cove Software Group
  255.                            Christopher J. Dunford
  256.                                P.O. Box 1072
  257.                           Columbia, Maryland 21044
  258.  
  259.                                (301) 992-9371
  260.                        CompuServe 76703,2002 [IBMNET]
  261.              Internet, Bitnet, etc.: 76703.2002@compuserve.com
  262.  
  263.               Software and documentation author: Chris Dunford
  264.