home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac / twils210.zip / TWILIGHT.DOC < prev    next >
Text File  |  1996-05-25  |  10KB  |  288 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                       T W I L I G H T   S E N T I N E L
  12.  
  13.                                     v 2.1
  14.  
  15.                       Copyright 1994 Vincent Penquerc'h
  16.                              All Rights Reserved
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                             DISCLAIMER OF WARRANTY
  25.  
  26.  
  27. THE AUTHOR WILL REFER TO VINCENT PENQUERC'H.
  28.  
  29. THE PROGRAM WILL REFER TO TWILIGHT SENTINEL, INCLUDING THE PROGRAM ITSELF,
  30. ITS DOCUMENTATION, AND ANY FILE IN THE ORIGINAL TWILIGHT SENTINEL PACKAGE.
  31.  
  32. THE AUTHOR HEREBY DISCLAIMS ALL WARRANTIES RELATING TO THIS PROGRAM,
  33. WHENEVER EXPRESSED OR IMPLIED, INCLUDING WITHOUT ANY LIMITATION ANY
  34. IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  35.  
  36. THE AUTHOR WILL NOT BE LIABLE FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL,
  37. INDIRECT OR SIMILAR DAMAGES DUE TO LOSS OF DATA, DAMAGE OF HARDWARE OR
  38. ANY OTHER REASON, EVEN IF THE AUTHOR WAS ADVISED OF THE POSSIBILITY OF
  39. SUCH LOSS OR DAMAGE.
  40.  
  41. THIS PROGRAM AND DOCUMENTATION ARE RELEASED "AS IS" AS SHAREWARE. IT IS
  42. COPYRIGHTED BY THE AUTHOR, AND ALL RIGHTS AND OWNERSHIP ARE KEPT WITH THE
  43. AUTHOR. YOU MAY USE IT, COPY IT, AND GIVE IT TO ANYBODY AS LONG AS NO
  44. MODIFICATIONS ARE MADE.
  45.  
  46. PROGRAM AND DOCUMENTATION COPYRIGHT 1994 VINCENT 'INDY' PENQUERC'H, ALL
  47. RIGHTS RESERVED.
  48.  
  49. ALL QUOTED PRODUCT AND COMPANY NAMES ARE TRADEMARKS OF THEIR RESPECTIVE
  50. OWNERS.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                          TABLE OF CONTENTS
  57.  
  58.  
  59.  
  60.  
  61.       1. What is Twilight Sentinel ?
  62.       2. System requirements
  63.       3. Using Twilight Sentinel
  64.       4. Command line options
  65.       5. Contacting the author
  66.       6. Revision history
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.    1. What is Twilight Sentinel ?
  76.       ---------------------------
  77.  
  78.  
  79.       Twilight Sentinel is a screen saver. When you have been idle for a 
  80.       certain time ( that is no keyboard key was hit during this time ), 
  81.       Twilight Sentinel blackens your screen. At the first key hit, the 
  82.       screen will be restored and Twilight Sentinel will go on checking for 
  83.       another idle period. Saving your screen is very important when you stay 
  84.       idle for a long time, as the screen is likely to get damaged when a 
  85.       motionless image stays on it.
  86.       Twilight Sentinel can be called by programs using its API. Any program
  87.       may request Twilight Sentinel to blank or restore the screen.
  88.       Twilight Sentinel has a password option that will require a password
  89.       to be typed to restore the screen. All keystrokes will be discarded
  90.       until the right password is typed.
  91.  
  92.  
  93.  
  94.  
  95.    2. System requirements
  96.       -------------------
  97.  
  98.  
  99.  
  100.       To use Twilight Sentinel, you will need a 8088 based PC, DOS 2.0 or
  101.       higher, and at least 600 bytes of memory. You will also need a VGA
  102.       or VGA compatible board.
  103.  
  104.  
  105.  
  106.  
  107.    3. Using Twilight Sentinel
  108.       -----------------------
  109.  
  110.  
  111.       Type TWILIGHT at the DOS prompt. It will start and install itself in 
  112.       memory. Twilight Sentinel will activate each time you are idle for
  113.       the wanted time.
  114.  
  115.  
  116.    4. Command line options
  117.       --------------------
  118.  
  119.  
  120.       Twilight Sentinel is not case sensitive. Command line options can be
  121.       entered in both upper and lower case, even mixing them.
  122.       To get an help screen, just type the following:
  123.  
  124.         TWILIGHT -H
  125.         or
  126.         TWILIGHT -?
  127.  
  128.       To unload Twilight Sentinel from memory, use the 'U' switch:
  129.  
  130.         TWILIGHT -U
  131.  
  132.       To select the idle delay to activate the screen saver, use the 'D'
  133.       switch, followed by the delay you want to set, in seconds. For example,
  134.       the command:
  135.  
  136.         TWILIGHT -D180
  137.  
  138.       will set a delay of 180 seconds (3 minutes).
  139.       If you want to activate Twilight Sentinel without having to wait the
  140.       required amount of time, you may press the activation hotkey. The default
  141.       is Alt-T, but you can specify a new hotkey at Twilight Sentinel's command
  142.       line, using the 'K' switch, as follows:
  143.  
  144.         TWILIGHT -K CONTROL RIGHTSHIFT F1
  145.  
  146.       This is the template for using this switch. You first give the mask
  147.       for the hotkey you want, after the letter 'K'. This mask can be any
  148.       combination of the following key names: control, alt, leftshift,
  149.       rightshift. You may specify any of them in any order, even none of
  150.       them. But beware not being in conflict with another program that
  151.       would use the same key combination. If you choose a null mask, that is
  152.       if you don't give any of these four symbols, Twilight Sentinel will
  153.       trigger any time you press this key, so it is likely to trigger even
  154.       when you don't want it, if you are to use this key for another purpose.
  155.       Giving one or more mask keys is wise. Once the mask is specified, give
  156.       the key you want to trigger Twilight Sentinel. You may give any of the
  157.       keyboard keys but the special keys, as the shifts, the scroll lock and
  158.       num lock keys, the system request key, the break key, the caps lock
  159.       key, the control key or the alt key. If the key you choose does not
  160.       have an associated character to be displayed, such as the page up key,
  161.       or the escape key, use the following table that gives you the word to
  162.       use to designate this key:
  163.  
  164.  
  165.         Function keys:              F1, F2, F3, F4, F5, F6, F7, F8,
  166.                                     F9, F10, F11, F12
  167.         Arrow keys:                 up, down, left, right
  168.         Keypad special keys:        Keypad/, Keypad*, Keypad-, Keypad+,
  169.                                     Keypad5
  170.         Other Keys:                 backspace, del, end, enter, esc, home,
  171.                                     ins, pgdn, pgup, prtsc, spacebar, tab
  172.  
  173.  
  174.       Know that some key combinations won't trigger Twilight Sentinel's
  175.       keyboard handler, as no scan code is sent from the keyboard, especially
  176.       when all status keys are pressed at the same time. Command line case is
  177.       not significant. You may enter these symbols in upper or lower case,
  178.       Twilight Sentinel will accept both.
  179.       To enable password, use the P switch, as follows:
  180.  
  181.         TWILIGHT -P
  182.  
  183.       You will be prompted for a password. You may then type your password,
  184.       and press enter to accept or escape to abort. If you choose to enable
  185.       the password, typing it will be the only way to get back to your screen
  186.       once it is blanked. This is great for locking the machine while going
  187.       away if the machine is working meanwhile.
  188.       The password length is limited to 10 keystrokes.
  189.       In the evaluation version, the password can't be chosen, and is always
  190.       set to the default string 'register' (without the quotes). You may
  191.       by registering obtain a key that will enable Twilight Sentinel to
  192.       prompt for a password. See included file ORDER.FRM for details.
  193.  
  194.       To disable software blanking and restoring, you may use the 'N' switch:
  195.  
  196.         TWILIGHT -N
  197.  
  198.       This will prevent other programs from blanking and restoring the screen
  199.       by requesting Twilight Sentinel.
  200.  
  201.       To tell Twilight Sentinel to check for mouse activity, use the 'M'
  202.       switch, followed by one of those parameters:
  203.         0: Dont't check mouse
  204.         1: Check mouse not using mouse driver (default)
  205.         2: Check mouse using mouse driver
  206.  
  207.       This allows you to use Twilight Sentinel even with bare configurations
  208.       with no mouse driver installed and is much faster than checking the
  209.       mouse driver.
  210.       For example, if you want to use your mouse theu its driver, use:
  211.  
  212.         TWILIGHT -M2
  213.  
  214.       When you have registered, a personal registration number is sent to
  215.       you and can be used to register your copy of Twilight Sentinel, so
  216.       you can choose the screen restoring password. To register your copy
  217.       of Twilight Sentinel, use the 'R' switch, as follows:
  218.  
  219.         TWILIGHT -R <name>,<number>
  220.  
  221.       Twilight Sentinel will then record your registration and no more set
  222.       the default password.
  223.  
  224.  
  225.  
  226.  
  227.  
  228.    5. Contacting the author
  229.       ---------------------
  230.  
  231.  
  232.       If you have any bug reports, comments, flames or if you want to
  233.       register, feel free to write me at the following email address:
  234.  
  235.       penquerc@enssat.fr
  236.  
  237.       or via snail mail:
  238.  
  239.       Vincent Penquerc'h
  240.       3, rue d'Ecosse
  241.       35200 Rennes
  242.       France
  243.  
  244.  
  245.  
  246.  
  247.       The registration fee for this program is $10 (60 francs for France).
  248.       Please note that Cut & Paste is shareware and is not free software
  249.       nor public domain software. If you use this program after a two week
  250.       free evaluation period, please register, so I can continue enhancing
  251.       Cut & Paste and release other neat programs to meet your needs.
  252.       Acceptable payments are in French francs or US $ (in this case, add
  253.       $15 to the fee, due to very high exchange rate from my bank).
  254.       Please see included file ORDER.FRM for more information.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.    6. Revision history
  262.       ----------------
  263.  
  264.  
  265.  
  266.    v2.1   May 23rd 1996
  267.             - Now works with all mice by using mouse driver.
  268.  
  269.  
  270.    v2.0   January 28th 1996
  271.             - Added mouse checking in activity polling.
  272.             - Now works with mono displays.
  273.             - Added software screen blanking and restoring commands.
  274.             - Added password feature.
  275.  
  276.  
  277.    v1.11  September 6th 1995
  278.             - Fixed a little bug.
  279.  
  280.  
  281.    v1.1   April 21st 1995 (not released)
  282.             - Added selectable activation hotkey.
  283.  
  284.  
  285.    v1.0   March 19th 1995 (not released)
  286.             - First version of Twilight Sentinel.
  287.  
  288.