home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac_os2 / wpsav20b.zip / WPSAV20.DSK / unc.dsk / WPSAVER! / WPSAVER.DOC < prev    next >
Text File  |  1996-05-13  |  21KB  |  580 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                    WPSaver
  22.                                 version 2.00
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                         copyright (c) IcaruSoft, 1996
  50.                              License Agreement
  51.                              -----------------
  52.  
  53. IcaruSoft grants a license to the individual and/or corporate licensee to 
  54. use the program product (the set of computer programs and machine 
  55. readable and printed materials supplied with this package) for a term 
  56. beginning on the day you accept this Agreement and continuing until 
  57. termination.  This agreement is automatically terminated if you violate 
  58. any of the terms and conditions of this Agreement.  You may terminate 
  59. this agreement at any time by destroying all copies, modifications, 
  60. updates, and original materials supplied with the Program Product. 
  61. IcaruSoft grants the right to use the shareware version of the enclosed 
  62. software program on as many terminals connected to as many computers as 
  63. you wish.   This software is distributed in both shareware and commercial 
  64. versions.  You are encouraged to share the shareware version of the 
  65. software, in its entirety,  with as many people as possible;  however,  
  66. this software may not be distributed for profit unless the following 
  67. terms are agreed to:
  68.  
  69.    1)  The packaging of the media upon which the software is distributed 
  70.        must clearly state that the package contains shareware which must
  71.        be purchased separately.
  72.    2)  The distributor of said media charge no more than necessary to     
  73.        cover normal cost of business plus a reasonable profit.
  74.  
  75. Under no circumstances are you, or anyone else not explicitly directed in 
  76. writing by an authorized IcaruSoft executive, permitted to give, sale, or 
  77. otherwise distribute in any manner this software product to any third 
  78. party.
  79.  
  80.                                 Copyright
  81.                                                                           
  82.   The software is owned by IcaruSoft and is protected by United States 
  83. copyright laws and international treaty provisions.  Therefore, you must 
  84. treat the software like any other copyrighted material (e.g., a  book or 
  85. musical recording) except that you may either (a) make a copy of the 
  86. software solely for backup or archival purposes, or (b) transfer the
  87. software to a single hard disk provided you keep the original solely for 
  88. backup or archival purposes.  You may not copy the written materials 
  89. accompanying the software.  The copyright notice must be maintained and 
  90. displayed as provided in the program.  
  91.  
  92.  
  93.                               Restrictions
  94.                                                                           
  95.   You may not use, copy, modify, merge, rent, lease, or transfer the 
  96. program product or any portion or modification thereof in whole or in 
  97. part, except as expressly provided in this agreement.  You may not 
  98. reverse engineer, decompile, or disassemble the software.  You may not 
  99. use this Software, in any manner, in violation of applicable Federal, 
  100. State or Local Laws.  
  101.                                                                           
  102.                                     ii
  103.                             Limited Warranty
  104. IcaruSoft warrants the distribution diskette(s) upon which the program(s) 
  105. are provided are free from defects, in materials and workmanship, under 
  106. normal use, for a period of thirty (30) days from the original date of 
  107. purchase, to the original purchaser, provided that the program was 
  108. purchased on said diskette(s) and from IcaruSoft or an IcaruSoft 
  109. distributor.  IcaruSoft will issue NO refunds once the diskette envelope 
  110. is opened.  Returns, if authorized by IcaruSoft, will be subject to a 15% 
  111. restocking fee.  For breach of any written or implied warranty on this 
  112. product, the consumer is limited to the replacement of the defective 
  113. diskette(s).
  114.    NOTE:  SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF 
  115.    INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR 
  116.    EXCLUSION MAY NOT APPLY TO YOU.  
  117.               
  118.    ICARUSOFT MAKES NO OTHER WARRANTY OF ANY KIND, EITHER EXPRESSED OR 
  119.    IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF 
  120.    MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND NO WARRANTY 
  121.    THAT THE PROGRAM PRODUCT IS FREE OF ERRORS.  
  122. IcuraSoft, its agents or employees shall not be liable or responsible for 
  123. the manner in which the Software is used by the end user, or be liable 
  124. for the cost of any repair or correction required for defective IcaruSoft 
  125. program product material except as stated in this paragraph.
  126.               
  127. NO LIABILITY FOR CONSEQUENTIAL DAMAGES.  In no event shall IcaruSoft or 
  128. its suppliers be liable for any damages whatsoever (including, without 
  129. limitation, damages for loss of business profits, business interruption, 
  130. loss of business information, or other pecuniary loss) arising out of the 
  131. use of or inability to use this product, even if IcaruSoft has been 
  132. advised of the possibility of such damages.  
  133.               
  134.                               General Terms
  135. This is the only agreement between user and IcaruSoft regarding this 
  136. program product and it may be modified only by a written agreement 
  137. between those parties.  This agreement cannot be modified by purchase 
  138. orders, advertising, or other representation by any person.  If any 
  139. provision of this agreement shall be held invalid, illegal, or 
  140. unenforceable, then the validity, legality, and enforceability of the 
  141. remaining provisions shall not be affected or impaired thereby.  This 
  142. agreement shall be governed by the laws of the State of North Carolina. 
  143. By opening or keeping the diskette package, or keeping the shareware 
  144. version of the program you acknowledge that you have read this agreement, 
  145. understand it, and agree to be bound by its terms and conditions.
  146.               
  147.                     U.S. Government Restricted Rights
  148. The software and documentation are provided with restricted rights.  
  149. Use,duplication, or disclosure by the Government is subject to 
  150. restrictions as set forth in subparagraph (c)(l)(ii) of The Rights in 
  151. Technical Data and Computer Software clause at 52.227-7013. 
  152. Contractor/manufacturer is IcaruSoft, 2920 Pleasant Garden Rd., 
  153. Greensboro, North Carolina, 27406
  154.  
  155.                                     iii
  156.                                  Forward
  157.                                  --------
  158.  
  159. ABOUT WPSAVER
  160.  
  161. WPSaver is a PM only screen saver featuring:
  162.          - Small memory and disk requirements
  163.          - Full 32-bit power
  164.          - Full support for MMPM/2
  165.          - Digital clock interface
  166.          - Password protection
  167.          - Unsurpassed extensibility
  168.  
  169. WPSaver is a 32-bit Presentation Manager screen saver.  It has been 
  170. designed to be as light on system resources as possible, while at the 
  171. same time  having unlimited extensibility.  Memory, disk, and run time 
  172. requirements have all been kept to a bare minimum without sacrificing
  173. quality.  Only the main executable and one dynamically linked library 
  174. resides in memory when
  175. WPSaver is inactive.  When the keyboard monitor times out after the user 
  176. specified time of inactivity, only the library required for the currently 
  177. running module is loaded, and the module is freed when WPSaver switches 
  178. to another module or user activity is detected.
  179.  
  180. Each Screen effect or "module" is implemented as a separate dll. The user 
  181. need only keep the dll for the modules that are actually being used on 
  182. their hard drives.  If the user likes variety, WPSaver supports a 
  183. theoretically unlimited number of saver modules; however, if the user is 
  184. short on disk space, WPSaver can be fully functional with only 70K.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194. ABOUT ICARUSOFT
  195.  
  196. IcaruSoft, formed in 1996, is a small independent software developer 
  197. dedicated to producing and promoting quality software that takes 
  198. advantage of the advanced features of IBM's OS/2 operating system.
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.                                     iv
  209.  
  210.                              Table of Contents
  211.                              -----------------
  212.  
  213. I    - Title Page. . . . . . . . . . . . . . . . . . . . . . .i
  214.  
  215. II   - License Agreement . . . . . . . . . . . . . . . . . . .ii
  216.  
  217. III  - Forward . . . . . . . . . . . . . . . . . . . . . . . .iv
  218.         1) About WPSaver
  219.         2) About IcaruSoft
  220.  
  221. IV   - Table of Contents . . . . . . . . . . . . . . . . . . .v
  222.  
  223. V    - Installing WPSaver. . . . . . . . . . . . . . . . . . .1
  224.         1) Upgrading from previous version of WPSaver
  225.         2) Installing the program
  226.         3) Adding and removing modules
  227.  
  228. VI   - Launching WPSaver . . . . . . . . . . . . . . . . . . .2
  229.         1) From the command line
  230.         2) From the workplace shell
  231.             a} Normal
  232.             b) Using drag and drop
  233.  
  234. VII  - Configuring WPSaver. . . . . . . . . . . . . . . . . . .3
  235.         1) From the command line
  236.         2) From the workplace shell
  237.       
  238. VIII - Ordering WPSaver . . . . . . . . . . . . . . . . . . . .4
  239.         1) Direct from IcaruSoft
  240.         2) Through the Internet
  241.         3) From the SOS/2 BBS
  242.  
  243. IX   - History. . . . . . . . . . . . . . . . . . . . . . . . .5
  244.  
  245. X    - Contacting IcaruSoft . . . . . . . . . . . . . . . . . .6
  246.        1)Technical Support
  247.        2)Customer Service
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                     v
  262.                             Installing WPSaver
  263.                             ------------------
  264.  
  265. 1)UPGRADING FROM A PREVIOUS VERSION OF WPSAVER
  266. It is critical that components of previous versions of WPsaver not be 
  267. used with version 2.00 or higher.  The program has been completely 
  268. rewritten to take advantage of OS/2 features, and in the process most 
  269. internal data structures were changed.  PREVIOUS COMPONENTS ARE NOT 
  270. COMPATIBLE.
  271.  
  272. 2) INSTALLING THE PROGRAM
  273. To install WPSaver, open an icon view of the distribution diskette and
  274. drag the "WPSaver by IcaruSoft" icon to your desktop.  Double-click the 
  275. new icon to bring up the WPSaver folder.  Double-click the "Install" icon
  276. to place a reference to WPSaver in you Startup folder.
  277.  
  278. 3) ADDING ADDITIONAL MODULES
  279. There are two steps to adding additional modules to WPSaver.  The modules 
  280. dll file must first be placed in either the same directory as the WPSaver 
  281. executable file, "WPSaver.exe," or in a directory that is included in the 
  282. config.sys "LIBPATH" statement.  The file "saver.nam" must then be edited 
  283. to include the new module.  Open the file by double-clicking its icon.  
  284. On a new line and in lower case, type the name of the new module, 
  285. followed by the underscore character "_".  DO NOT END YOUR LINE WITH THE 
  286. ENTER KEY, as this will cause you big headaches.
  287.  
  288. For example, you receive a module called `mymod.dll'.  Your saver.nam 
  289. file looks like the following:
  290.  
  291. banner_
  292. boxer_
  293. american_
  294.  
  295. If you press the Control and End keys simultaneously while in the E 
  296. editor, it will place the cursor after the last character in the file.  
  297. The cursor should immediately follow the last underscore character on the 
  298. same line.  If it is not, use the backspace key until it is.
  299.  
  300. To add `mymod.dll', you would hit the Enter key once and type "mymod_".  
  301. DO NOT HIT THE ENTER KEY AT THIS TIME.  Saver the file and exit.  The 
  302. next time you start WPSaver, this module will be available.
  303.  
  304. Restart WPSaver and click the clock with the 2nd mouse button.  Choose 
  305. the "Module" tab and highlight the new module by clicking it with the 1st 
  306. mouse button.  Now click on the "Customize" button to make any 
  307. adjustments that the author may have provided and to register your new 
  308. module in the WPSaver initialization file.  (If you fail to perform this 
  309. last step, an irritating dialog box will appear whenever the module 
  310. starts.  This irritation will cease when the step is eventually done, 
  311. however.)
  312.  
  313.  
  314.                                      1
  315.                              Launching WPSaver
  316.                              -----------------
  317.  
  318. 1) FROM THE COMMAND LINE
  319. There are several options available from the command line.  They can be 
  320. used in any order and, unless stated otherwise, must be preceded by the 
  321. forward slash character "/".  The command syntax is:
  322.  
  323. WPSaver [module] [/C] [/P] [/Fn] [/Tn]
  324.  
  325. where:
  326.     [module] is the name of the dll for a specific module.  This          
  327.              parameter does not require the forward slash.  Do not        
  328.              include the brackets.
  329.  
  330.     /C  Cycle -- causes WPSaver to periodically change the module.  The   
  331.         rate is determined by the timeout value.
  332.  
  333.     /P  Password Protect --causes WPSaver to envoke the case sensitive    
  334.         password protection (the password is "Password" by default).
  335.  
  336.     /Fn Frequency -- (n is a number between 1 and 9)  This option sets    
  337.         how many times per second WPSaver is asked to update the screen   
  338.         display.  A higher value produces a smoother, faster animation.   
  339.         A lower value requires less cpu power.
  340.  
  341.     /Tn Timeout -- (n is a number between 1 and 9)  This option sets how  
  342.         many minutes WPSaver will wait before timing out.  
  343.  
  344. 2) FROM THE WORKPLACE SHELL
  345.  
  346.     a)Normal use
  347.        Using the settings dialog (reached by 2nd mouse button click on    
  348.        the program's icon), you can set command line options in the       
  349.        parameters entry field.  You can then start the program by double  
  350.        clicking its icon, or with any other standard OS/2 method.
  351.  
  352.     b)Drag and drop
  353.        Open the folder containing the WPSaver modules. Drag any modle and 
  354.        drop it on the WPSaver icon, The program will start up using that  
  355.        module.  If the program is already running, drag a module onto the 
  356.        WPSaver clock and the module will start.
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.                                      2
  368.  
  369.                             Configuring WPSaver
  370.                             -------------------
  371. 1)FROM THE COMMAND LINE
  372.     see section on launching WPSaver from the command line.
  373.  
  374. 2)FROM THE WORKPLACE SHELL
  375. Click on the clock with the right mouse button.  The resulting         
  376. notebook has five pages:
  377.       (1)About, gives general information and a copyright notice.  The    
  378.          IcaruSoft emblem is used to hide the notebook.
  379.  
  380.       (2)Timing, allows the timeout (the length of time of inactivity     
  381.          before a module starts) and frequency (how often WPSaver is      
  382.          asked to update the screen) to be set.  If it is important that  
  383.          WPSaver not timeout until explicitly commanded, then check the   
  384.          "disabled" box.  The program will only start when double         
  385.          clicking on the icon or a drag and drop operation.
  386.  
  387.       (3)Password.  Check the password option if you wish to use WPSaver  
  388.          password protection.  Two entry fields will appear.  The word    
  389.          must be typed in BOTH fields for the password to be changed.     
  390.          Please not theat the password is case sensitive, meaning 'A' is  
  391.          NOT the same as 'a' and "Password" is not the same as            
  392.          "password".(NOTE: The password can not be changed in shareware   
  393.          version, it will always be "Password".)  The characters appear   
  394.          as asterisks for security.  The password change will not take    
  395.          affect until the settings notebook is dismissed with the         
  396.          IcaruSoft logo button on the ABOUT page.
  397.  
  398.  
  399. *****WARNING*******WARNING******WARNING*******WARNING********WARNING******
  400. To keep WPSaver as safe and simple as possible, the IcaruSoft designers 
  401. made the decision not to directly interface with the keyboard hardware 
  402. using low level routines.  Unfortunately, this has rendered the password 
  403. protection very weak.  Therefore, IcaruSoft does not recommend WPSaver as 
  404. a device to secure valuable documents.  This software will not hold 
  405. against a knowledgeable assualt.  IcaruSoft refuses responsibility for 
  406. any loss arising from the inability of this software to maintain a secure 
  407. PC.
  408. *****WARNING********WARNING******WARNING*******WARNING********WARNING*****
  409.  
  410.          (4)Module,allows you to choose which module will run.  If you    
  411.             check the "Cycle Savers" option, then the module chosen will  
  412.             simply be the first one in the cycle; otherwise, it will be   
  413.             the only one.  If the author of the module has provided       
  414.             customization options, they can be set by choosing the module 
  415.             and then clicking the "Customize" button.
  416.  
  417.          (5)Date/Time, lets you set your system clocks date and time.
  418.             (NOTE: This feature is disabled in shareware version.)
  419.  
  420.                                      3
  421.                               Ordering WPSaver
  422.                               ----------------
  423.  
  424. If you have the shaveware version of WPSaver 2.00, you may order the
  425. complete program directly from IcaruSoft.  Whenever you call up the 
  426. settings notebook a file named 'Order.frm' is placed in the same directory
  427. as the WPSaver executables.  Fill out this form and mail it with the 
  428. appropriate payment to 
  429.  
  430.                                IcaruSoft
  431.                                2920 Pleasant Garden Rd.
  432.                                Greensboro, NC 27406
  433.  
  434. IcaruSoft also plans to market WPSaver through CompuServe, 
  435. Peter Norloff's OS/2 BBS, BMT Micro and other online distribution centers.
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.                                     4
  474.                                   History
  475.                                   -------
  476.  
  477.  
  478. WPSaver 1.0
  479. -----------
  480. release 11/95
  481. -base program
  482.  
  483.  
  484. WPSaver 1.01
  485. ------------
  486. -Small fix in sample module BOXER, whereby some values weren't being 
  487.  initialized causing the figure to be drawn off screen.
  488.  
  489. WPSaver 1.20
  490. ------------
  491. -Small fix in the main setup dialog.  The background color of some objects
  492.  didn't match the dialog's background by a very small amount, but was 
  493.  enough to make it ugly on low resolution displays.
  494. -Major bug fixes and performance enhancements.
  495.  
  496. WPSaver 2.00
  497. ------------
  498. -Added clock interface which remains visible.
  499. -Added option to vary how much CPU usage program takes by limiting how 
  500.  often the programs updates the screen.
  501. -Changed the way the modules are called so that writing modules are 
  502.  greatly simplified.
  503. -Modified the way modules are changed so that there is no longer a 
  504.  'security hole' between switches.
  505. -Increased the length of the module listing so that more can be displayed.
  506. -The program will now prompt you to save setting on exit if they have been
  507.  changed but not saved.
  508. -Removed the option to disable sounds globally.  This will now be handled
  509.  at the individual module level.
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                                      5
  527.                             Contacting IcaruSoft
  528.                             --------------------
  529.  
  530. 1) TECHNICAL SUPPORT
  531. To get help or request enhancements of any aspect of WPSaver you may send
  532. mail to the author in any of the following ways:
  533.  
  534. through the internet: Ernestc@cris.com
  535.  
  536. BBS                 : SOS/2 BBS (910) 379-7625 
  537.                      login:WPSaver HELP, Password:HELP, 
  538.                      leave note for Sysop describing your problem and
  539.                      include information on how to contact you
  540.  
  541. post                : IcaruSoft
  542.                       Attn: Ernest Christley
  543.                       2920 Pleasant Garden Rd.
  544.                       Greensboro, NC 27406
  545.  
  546. 2) CUSTOMER SUPPORT
  547. If you have a problem with any IcaruSoft product and would like help from
  548. an IcaruSoft representative you man send mail to IcaruSoft Customer Support
  549. in any of the following ways:
  550.  
  551. through the internet: 
  552.  
  553. through CompuServe  : 104640.1407@compuserve.com
  554.  
  555. BBS                 : SOS/2 BBS (910) 379-7625 (leave note for Sysop)
  556.                       login:Saver Support, Password:SUPPORT, 
  557.                       leave note for Sysop describing your problem and
  558.                       include information on how to contact you
  559.  
  560. post                : IcaruSoft
  561.                       Attn: Todd Newman
  562.                       2920 Pleasant Garden Rd.
  563.                       Greensboro, NC 27406
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.                                      6
  580.