home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / STRNG102.ZIP / STRINGER.DOC < prev    next >
Text File  |  1993-04-13  |  15KB  |  329 lines
  1.                        ████████████████████ 
  2.                        ██                ██
  3.                        ██    STRINGER    ██                   
  4.                        ██                ██
  5.                        ██  Version 1.02  ██
  6.                        ██                ██
  7.                        ████████████████████
  8.  
  9. ┌───────────────────────────────────────────────────────────────┐ 
  10. │ GENERAL                                                       │
  11. └───────────────────────────────────────────────────────────────┘ 
  12.  
  13.     This demonstration program is designed to help train new 
  14. users on the OS/2 Presentation Manager (PM).   The program draws 
  15. "string art" in a PM window, and has many options to control 
  16. color, speed, and other items.  It is well suited for training, 
  17. because it uses many of the PM interface features (pulldown 
  18. menus, dialog boxes, scroll bars, movable and resizable windows, 
  19. context sensitive help, background operation, etc.), but has an 
  20. element of entertainment that keeps the student interested. 
  21.  
  22.     In addition to its training aspects, STRINGER can also be 
  23. useful for demonstrating the capabilities of a particular 
  24. computer, or of OS/2 in general.  Or, you may enjoy simply 
  25. running it to take advantage of idle CPU time, or when you want 
  26. to relax and watch new and unusual art forms evolve before your 
  27. eyes.  Beware - STRINGER is hypnotic and addicting! 
  28.  
  29.     STRINGER works by drawing one "quadruplet" at a time (four 
  30. lines arranged symmetrically around the center point) until it 
  31. reaches the maximum number of quadruplets specified (see below 
  32. under "Quadruplets").  That constitutes one "set."  STRINGER then 
  33. switches to another random color and draws the next set of 
  34. quadruplets.  It continues until it reaches the maximum number of 
  35. sets specified (see below under "Sets"), then clears the window 
  36. and starts over.  
  37.  
  38.     STRINGER keeps running even when you're working with other 
  39. programs, or when it's minimized to an icon.  Sometimes, however, 
  40. it may stop if OS/2 lowers its priority too far.  To restore 
  41. STRINGER's priority (and restart it), simply drag the mouse 
  42. pointer over STRINGER's window, or press Alt-Esc until STRINGER 
  43. becomes the active window. 
  44.  
  45. ┌───────────────────────────────────────────────────────────────┐ 
  46. │ WHAT'S IN THIS PACKAGE                                        │
  47. └───────────────────────────────────────────────────────────────┘ 
  48.  
  49. This package consists of the following files:
  50.  
  51.     STRINGER.EXE   The STRINGER program itself
  52.     STRINGER.DOC   Program documentation
  53.     REGISTER.DOC   Form to register your copy of the program
  54.     VENDOR.DOC     Information on other software available
  55.  
  56. ┌───────────────────────────────────────────────────────────────┐ 
  57. │ SYSTEM REQUIREMENTS                                           │
  58. └───────────────────────────────────────────────────────────────┘ 
  59.  
  60.     This program requires the OS/2 operating system, version 1.1 
  61. or later. 
  62.  
  63. ┌───────────────────────────────────────────────────────────────┐ 
  64. │ WHAT'S IN THIS PACKAGE                                        │
  65. └───────────────────────────────────────────────────────────────┘ 
  66.  
  67. This package consists of the following files:
  68.  
  69.     STRINGER.EXE   The STRINGER program itself
  70.     STRINGER.DOC   Program documentation
  71.     REGISTER.DOC   Form to register your copy of the program
  72.     VENDOR.DOC     Information on other software available
  73.  
  74. ┌───────────────────────────────────────────────────────────────┐ 
  75. │ REVISION HISTORY                                              │
  76. └───────────────────────────────────────────────────────────────┘ 
  77.  
  78. 1.00   Original version
  79. 1.01   Fine tuned menus
  80. 1.02   Minor improvements to code
  81.  
  82. ┌───────────────────────────────────────────────────────────────┐ 
  83. │ MENU SELECTIONS                                               │
  84. └───────────────────────────────────────────────────────────────┘ 
  85.  
  86.    For general help about the program, press F1 or click on 
  87. F1=Help.  For help on a specific menu item, press F10, highlight 
  88. the item, then press F1. 
  89.  
  90. Start.  This selection starts drawing in the window.  Pressing 
  91. the right mouse button has the same effect if the mouse pointer 
  92. is in STRINGER's window. 
  93.  
  94. Stop.  Pauses the drawing, but does not erase it.  Pressing the 
  95. right mouse button has the same effect if the mouse pointer is in 
  96. STRINGER's window. 
  97.  
  98. Step.  Draws one set of quadruplets, then stops. 
  99.  
  100. Clear.  Erases the window.  If STRINGER was drawing, it continues 
  101. drawing.  If it was stopped, it is still stopped. 
  102.  
  103. Color.  Sets the background color with which the window is 
  104. cleared.  Sixteen available choices.  Choosing this option erases 
  105. the current drawing. 
  106.  
  107. Delay.  Sets the amount of time STRINGER waits between drawing 
  108. sets.  The larger the delay, the slower the drawing speed. 
  109.  
  110. Quadruplets.  Sets the number of quadruplets per set (i.e., lines 
  111. drawn in the same color). 
  112.  
  113. Sets.  Determines the number of sets drawn before the window is 
  114. cleared. 
  115.  
  116. Save.  Saves the current background, delay, quadruplets, and sets 
  117. values, for use next time you run STRINGER. 
  118.  
  119. About.  Shows general information about STRINGER. 
  120.  
  121. Exit.  Terminates the program. 
  122.  
  123. ┌───────────────────────────────────────────────────────────────┐ 
  124. │ OPTIONS                                                       │ 
  125. └───────────────────────────────────────────────────────────────┘ 
  126.  
  127.     STRINGER lets you set various items according to your 
  128. personal preference:  background color, drawing speed, string 
  129. density, and number of sets drawn before erasure.  Choose the 
  130. item you want to change from the Options menu, and a dialog box 
  131. opens.  Use the scroll bar to change the settings to values you 
  132. want.  If desired, you can move the dialog box so it doesn't 
  133. cover the STRINGER window.  This lets you experiment with 
  134. different settings to see their effect. 
  135.  
  136.     If you choose "Save" on the Options menu, STRINGER stores the 
  137. current settings and retrieves them the next time you run the 
  138. program.  If you change option settings but don't save them, 
  139. STRINGER reminds you when you exit the program, and gives you 
  140. once last chance to save them. 
  141.  
  142. ┌───────────────────────────────────────────────────────────────┐ 
  143. │ MESSAGES                                                      │
  144. └───────────────────────────────────────────────────────────────┘ 
  145.  
  146. Couldn't retrieve all of STRINGER's option data.  OS/2 reported a 
  147. problem with the configuration file, for reasons unknown.  Some 
  148. or all of the option configuration data may be missing, so you 
  149. may have to reset it. 
  150.  
  151. Couldn't save option data.    OS/2 reported a problem with the 
  152. configuration file, for reasons unknown.  Some or all of the 
  153. option configuration data may be missing, so you may have to 
  154. reset it. 
  155.  
  156. Couldn't start timer.  Other programs are probably using all 
  157. available system timers.  Try terminating some of your other 
  158. programs. 
  159.  
  160. You changed the option settings....  Choose Yes to save the 
  161. option settings for next time, else choose No. 
  162.  
  163.  
  164. ┌───────────────────────────────────────────────────────────────┐ 
  165. │ CREDITS                                                       │
  166. └───────────────────────────────────────────────────────────────┘
  167.  
  168.     STRINGER was written in C by Richard W. Adams.  It was 
  169. developed with PC-Write, version 3.02, & the Microsoft C 
  170. Optimizing Compiler, version 5.1. 
  171.  
  172.     The author is a member of the Association of Shareware 
  173. Professionals (ASP).  You may reach him at the address given in 
  174. REGISTER.DOC.  Should that address no longer be valid, try 
  175. contacting him through the ASP.   
  176.  
  177. ┌───────────────────────────────────────────────────────────────┐ 
  178. │ REGISTRATION                                                  │
  179. └───────────────────────────────────────────────────────────────┘
  180.  
  181.     STRINGER is copyright 1990 by Richard W. Adams, all rights 
  182. reserved.  The program is "shareware."  If you use STRINGER for 
  183. more than 30 days, you must register.  To do so, complete the 
  184. registration form in REGISTER.DOC & send it a check for the 
  185. indicated amount to the author at the address on the form. 
  186.  
  187. When you register, you receive:
  188.  
  189.     o The right to use your copy of STRINGER on a single 
  190.       computer. 
  191.  
  192.     o Free technical support by mail for three months.
  193.  
  194.     o Eligibility for free copies of future versions if you're 
  195.       the first to suggest improvements or report bugs that are 
  196.       fixed/incorporated in future versions. 
  197.  
  198.    Not only is registration a legal & ethical requirement, but 
  199. registration fees give shareware authors the incentive to develop 
  200. new software & improve old ones. 
  201.  
  202.     Tax exempt Christian religious organizations & churches are 
  203. eligible for free registration of STRINGER for official business.  
  204. Send a written request to the author, & you'll receive 
  205. registration forms.  The registration takes effect when you 
  206. complete return the forms.  This is a charitable donation. 
  207.  
  208.     Companies, government agencies & other organizations may 
  209. obtain site licenses for STRINGER, at greatly reduced unit costs.  
  210. Contact the author for details & a price list. 
  211.  
  212. ┌───────────────────────────────────────────────────────────────┐ 
  213. │ SHAREWARE                                                     │ 
  214. └───────────────────────────────────────────────────────────────┘ 
  215.  
  216.     Shareware distribution gives users a chance to try software 
  217. before buying it. If you try a Shareware program and continue 
  218. using it, you are expected to register.  Individual programs 
  219. differ on details--some request registration, others require it, 
  220. and some specify a maximum trial period.  With registration, you 
  221. get anything from the simple right to continue using the software 
  222. to an updated program with printed manual. 
  223.  
  224.     Copyright laws apply to both Shareware and commercial 
  225. software, and the copyright holder retains all rights, with a few 
  226. specific exceptions as stated below.  Shareware authors are 
  227. accomplished programmers, just like commercial authors, and the 
  228. programs are of comparable quality. (In both cases, there are 
  229. good programs and bad ones!)  The main difference is in the 
  230. method of distribution.  The author specifically grants the right 
  231. to copy and distribute the software, either to all and sundry or 
  232. to a specific group.  For example, some authors require written 
  233. permission before a commercial disk vendor may copy their 
  234. Shareware. 
  235.  
  236.     Shareware is a distribution method, not a type of software. 
  237. You should find software that suits your needs and pocketbook, 
  238. whether it's commercial or Shareware. The Shareware system makes 
  239. fitting your needs easier, because you can try before you buy. 
  240. And because the overhead is low, prices are low also. Shareware 
  241. has the ultimate money-back guarantee--if you don't use the 
  242. product, you don't pay for it. 
  243.  
  244. DISCLAIMER - AGREEMENT 
  245.  
  246.     Users of STRINGER must accept this disclaimer of warranty: 
  247. "STRINGER is supplied as is.  The author disclaims all 
  248. warranties, expressed or implied, including, without limitation, 
  249. the warranties of merchantability and of fitness for any purpose. 
  250. The author assumes no liability for damages, direct or 
  251. consequential, which may result from the use of STRINGER." 
  252.  
  253.     STRINGER is a Shareware program and is provided at no charge 
  254. for your evaluation.  Feel free to share it with your friends, 
  255. but please don't give it away altered or as part of another 
  256. system.  The essence of "user-supported" software is to provide 
  257. personal computer users with quality software without high 
  258. prices, and yet to provide incentive for programmers to continue 
  259. to develop new products.  If you find STRINGER useful and 
  260. continue to use it after a reasonable trial period, you must make 
  261. a registration payment of $10.00 to the author.  The $10.00 
  262. registration fee will license one copy for use on any one 
  263. computer at any one time.  You must treat this software just like 
  264. a book.  An example is that any number of people may use this 
  265. software and may freely move it from one computer location to 
  266. another, so long as there is no possibility of it being used at 
  267. one location while it's being used at another.  Just as two 
  268. different people can't read a book at the same time. 
  269.  
  270.     Commercial users of STRINGER must register and pay for their 
  271. copies of STRINGER within 30 days of first use or their license 
  272. is withdrawn.  Site-License arrangements may be made by 
  273. contacting the author. 
  274.  
  275.     Anyone distributing STRINGER for any kind of remuneration 
  276. must first contact the author for authorization. This 
  277. authorization will be automatically granted to distributors 
  278. recognized by the (ASP) as adhering to its guidelines for 
  279. shareware distributors, and such distributors may begin offering 
  280. STRINGER immediately. (However, you must still advise the author 
  281. so the distributor can be kept up-to-date with the latest version 
  282. of STRINGER.) 
  283.  
  284.     You are encouraged to pass a copy of STRINGER to your friends 
  285. for evaluation.  Please encourage them to register their copy if 
  286. they find that they can use it. 
  287.  
  288. ┌───────────────────────────────────────────────────────────────┐ 
  289. │ COPYING                                                       │ 
  290. └───────────────────────────────────────────────────────────────┘ 
  291.  
  292. You may copy & distribute STRINGER freely, as long as you: 
  293.  
  294.     o Don't distribute it for commercial purposes without written 
  295.       permission from the author. 
  296.  
  297.     o Don't rent or lease it.
  298.  
  299.     o Include all constituent files.
  300.  
  301.     o Don't change the software or documentation.
  302.  
  303.     o Charge no fee other than a nominal one to cover distribution 
  304.       costs.
  305.  
  306. ┌───────────────────────────────────────────────────────────────┐ 
  307. │ OMBUDSMAN                                                     │ 
  308. └───────────────────────────────────────────────────────────────┘ 
  309.  
  310.     The author is a member of the Association of Shareware 
  311. Professionals (ASP).  ASP wants to make sure that the shareware 
  312. principle works for you. If you can't resolve a shareware related 
  313. problem with an ASP member by contacting the member directly, ASP 
  314. may be able to help.  The ASP Ombudsman can help you resolve a 
  315. dispute or problem with an ASP member, but does not provide 
  316. technical support for members' products.  Please write to the ASP 
  317. Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a 
  318. CompuServe mail message to the ASP Ombudsman (70007,3536). 
  319.  
  320.                        _______
  321.                   ____|__     |                (R)
  322.                --|       |    |-------------------
  323.                  |   ____|__  |  Association of
  324.                  |  |       |_|  Shareware
  325.                  |__|   o   |    Professionals
  326.                -----|   |   |---------------------
  327.                     |___|___|    MEMBER
  328.  
  329.