home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / SCRBL12C.ZIP / SCRNBLNK.TXT < prev   
Text File  |  1990-06-12  |  10KB  |  201 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                  Screen Blanker V1.2
  8.  
  9.                            A Screen Saver Program for OS/2
  10.  
  11.                                                     Alan Ballard
  12.                                                     June 12, 1990
  13.  
  14.             Notice:        Screen Blanker is (c) copyright 1990 Alan
  15.                            Ballard. It may be used without charge and
  16.                            may be freely distributed as long as it is
  17.                            not modified in any way.  It may not be sold,
  18.                            traded, or otherwise disposed of for profit
  19.                            without permission from the author.
  20.  
  21.             Disclaimer:    This program is offered on an "as-is" basis            __________A
  22. A                         __________A
  23.  
  24. A                            without any guarantee as to correct
  25.                            functioning or fitness for any specific
  26.                            purpose. The author believes this program to
  27.                            work as described, but you use the program
  28.                            entirely at your own risk.  The author will
  29.                            not be responsible for any hardware or
  30.                            software damage, loss of data, or incidental
  31.                            or consequential damage that may result from
  32.                            use of the program, whether or not such use
  33.                            is in accordance with the instructions.
  34.  
  35.             Purpose:       A screen saver is a program which blanks the
  36.                            screen after a specified period of
  37.                            inactivity, in order to prevent patterns from
  38.                            being "burned-in" to the screen.
  39.  
  40.             Hardware and software required:
  41.                            Screen Blanker Version 1.2 requires OS/2
  42.                            Version 1.1 or 1.2.  It should work with
  43.                            either Standard Edition or Extended Edition
  44.                            and with any computer and monitor that are
  45.                            supported by OS/2. The current version (1.2c)
  46.                            has only been tested with OS/2 1.2 SE
  47.                            syslevel XR04020 (the "November Update"
  48.                            version of 1.2 SE).
  49.  
  50.             Installation:
  51.                            Copy the file SCRNBLNK.EXE to a directory
  52.                            that is part of your normal OS/2 search path.
  53.                            \OS2 or \OS2\PBIN are good candidates.
  54.  
  55.                            Copy the file SCRNBLNK.DLL to any directory
  56.                            that is specified in your OS/2 LIBPATH.
  57.                            \OS2\DLL is normally used for DLL's, but any
  58.                            other directory in the LIBPATH is OK.
  59.  
  60.                            Then, modify your STARTUP.CMD file to
  61.                            activate Screen Blanker each time you reboot
  62.                            your system.  The command to do this is:
  63.                                 SCRNBLNK /INSTALL
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                                                   Page 2
  74.                            You may also wish to add an entry for Screen
  75.                            Blanker to the OS/2 1.1 Start Programs menu
  76.                            or a (version 1.2) Desktop Manager program
  77.                            group so you can easily start it at other
  78.                            times.
  79.  
  80.             Usage:         Screen Blanker is normally activated from
  81.                            your STARTUP.CMD file whenever the system is
  82.                            booted, as described under Installation
  83.                            above.
  84.  
  85.                            Once Screen Blanker has been activated, it
  86.                            will monitor keyboard and mouse activity in
  87.                            all OS/2 sessions.  If the specified period
  88.                            elapses without either being used, the screen
  89.                            will be blanked. Optionally, a display of the
  90.                            current date and time will be shown in random
  91.                            positions on the screen.
  92.  
  93.                            The screen can be restored to its previous
  94.                            state by pressing any key or moving the
  95.                            mouse.
  96.  
  97.                            Screen Blanker may also be started at other
  98.                            times in any of the usual OS/2 ways -- by
  99.                            selecting it from the File System, by an
  100.                            entry in a Start Programs menu, or by
  101.                            entering the command SCRNBLNK from a command-
  102.                            line window.
  103.  
  104.                            When Screen Blanker is started it normally
  105.                            displays a dialog box that allows you to set
  106.                            some options.  The command line parameter
  107.                            /INSTALL used at startup suppresses this
  108.                            dialog box and uses default or previously set
  109.                            values.
  110.  
  111.                            If Screen Blanker is already active when it
  112.                            is started, the new copy communicates with
  113.                            the previous copy to change the options in
  114.                            effect. The Remove button in the dialog box
  115.                            can be used to terminate a previously-
  116.                            activated screen blanker.
  117.  
  118.                            Screen Blanker will not blank the screen
  119.                            while the Dos Compatibility mode session is
  120.                            in control of the screen.  A separate Dos
  121.                            screen blanker may be used in the Dos
  122.                            compatibility session.
  123.  
  124.             Options        The Screen Blanker dialog box allows
  125.                            selecting the time interval at which blanking
  126.                            should occur. The default is five minutes.
  127.  
  128.                            The "PM Sessions" and "Non-PM Sessions"
  129.                            checkboxes allow you to control when Screen
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                                                                   Page 3
  140.                            Blanker is active.  By default it is active
  141.                            in all OS/2 sessions.  If you remove the
  142.                            check from "PM Sessions", blanking will not
  143.                            be active in the PM session.  This allows you
  144.                            to install one of the fancier Presentation
  145.                            Manager screen blankers that are available,
  146.                            while still using Screen Blanker for non-PM
  147.                            sessions.
  148.  
  149.                            The "Show clock" check box can be used to
  150.                            control whether the time and date are
  151.                            displayed during "blanked" periods.  If "Show
  152.                            clock" is selected, then the "Colors"
  153.                            pushbutton can be used to adjust the colors
  154.                            used in the time/date display.  When this
  155.                            pushbutton is selected a second dialog box
  156.                            pops up containing scroll bars that are used
  157.                            to select the colors.
  158.  
  159.                            If the "Save settings" check box is selected,
  160.                            then your preferences for the other options
  161.                            will be saved in the system OS2.INI file, and
  162.                            will be applied automatically whenever the
  163.                            Screen Blanker is subsequently started.
  164.  
  165.             Caveats: (1)   Screen Blanker uses the OS/2 VioPopUp service
  166.                            to blank the screen.  OS/2 limits use of this
  167.                            function to one program (session) at a time.
  168.                            This means that if a running program has
  169.                            taken over the screen by  "popping up",
  170.                            Screen Blanker will be unable to blank the
  171.                            screen.  It also means that a running program
  172.                            that wants to use the "popup" while the
  173.                            screen is blanked will be unable to do so.
  174.                            Most programs that use this function appear
  175.                            to wait for the screen to be available, so in
  176.                            practice this doesn't seem to be a serious
  177.                            problem.
  178.  
  179.                       (2)  OS/2 version 1.2 contains a bug in VioPopUp
  180.                            which results in a "Protection Violation"
  181.                            (Message SYS1943) if the program is removed
  182.                            (by selecting the Remove option). (This
  183.                            occurs only if it has blanked the screen one
  184.                            or more times before being removed). This
  185.                            errors arises a few seconds after the program
  186.                            has terminated and appears to be beyond my
  187.                            control. It is apparently harmless.
  188.  
  189.             Author:        Alan Ballard,
  190.                            3452 West 11th Avenue,
  191.                            Vancouver, Canada, V6R 2J9
  192.  
  193.                            Compuserve: 70446,44
  194.                            Internet:   ballard@staff.ucs.ubc.ca
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.