home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d599 / stslib.lha / STSLib / STSLib.readme < prev    next >
Text File  |  1992-02-01  |  6KB  |  124 lines
  1.  
  2.  
  3.                                  STSLib
  4.                                  ======
  5.                                  
  6.                             SciTech  Software
  7.                               23, Stag Leys
  8.                                  Ashtead
  9.                                  Surrey
  10.                                 KT21 2TD
  11.  
  12.                          Tel.: +44 (0372) 275775
  13.  
  14.  
  15. STSLib is a commercial product. However, the linkable library is being 
  16. distributed through public domain collections such as the Fish Disk 
  17. series. Our intention is thus to bring programmers STSLib at a minimum 
  18. cost, by removing overheads such as advertising.
  19.  
  20. To use STSLib in your own software (whether for your own use, public 
  21. domain, shareware or commercial distribution) you must pay the licence 
  22. fee of £20.00 sterling to SciTech Software. In addition to the right to 
  23. use STSLib in your own software, this licence fee will get you a disk 
  24. containing the latest version of STSLib, source code for STSLib and a 
  25. printed and bound manual (>50 A5 pages) explaining the functions which 
  26. STSLib supplies and how to use them.
  27.  
  28.  
  29. Distribution Information
  30. ========================
  31. You are encouraged to pass the Blink compatible library on to your 
  32. friends, include it in public domain libraries, etc., subject to the 
  33. following conditions:
  34.  
  35. o     You must charge no more than a nominal distribution/copying fee 
  36.       (a maximum of £4.00 in the U.K.).
  37.  
  38. o     This file (STSLib.readme) must be included in the distribution.
  39.  
  40. o     If you are releasing your own public domain or shareware software 
  41.       which uses STSLib, you must have paid the registration (licence) 
  42.       fee to SciTech Software. You should also acknowledge SciTech 
  43.       Software in the program and/or its accompanying documentation.
  44.  
  45. o     You must NOT distribute the documentation on the use of STSLib
  46.       (which is only available if you have paid the licence fee) in any 
  47.       form whatsoever.
  48.  
  49. o     You must NOT distribute the STSLib source code (which is only
  50.       available if you have paid the licence fee).
  51.       
  52. o     The Blink library may not be distributed with a commercial product 
  53.       unless you have gained prior permission from SciTech Software,
  54.       although executables resulting from linking with STSLib may be
  55.       distributed subject to the following condition.
  56.  
  57. o     Executables resulting from linking with STSLib may only be 
  58.       distributed if you have paid the registration (licence) fee to 
  59.       SciTech Software. You should also acknowledge SciTech Software in 
  60.       the program and/or its accompanying documentation.
  61.  
  62. If you are not distributing your own public domain or shareware software 
  63. with the Blink library, you are requested to distribute a program such 
  64. as PrLabel from SciTech Software which uses STSLib.
  65.  
  66.  
  67. Introduction - What is STSLib?
  68. ==============================
  69. Utility software such as PowerWindows (PowerWindows is a trademark of 
  70. InovaTronics, Inc.) allows the easy creation of screens, windows, gadgets 
  71. and menus for the Amiga's Intuition (Amiga, AmigaDOS and Intuition are 
  72. trademarks of Commodore-Amiga, Inc.) interface. However, these utilities 
  73. create static structures which greatly increase the amount of source code 
  74. which needs to be handled and creates large executables. In addition, at 
  75. present none of these utilities support the 3D-look of AmigaDOS V2.0.
  76.  
  77. AmigaDOS V2.0 now supplies a library of routines known as `gadtools'. 
  78. These routines allocate memory and create 3D-look gadgets using function 
  79. calls rather than the programmer having to define static structures. 
  80. However, programs written to use these functions are not compatible with 
  81. Amigas running AmigaDOS V1.3 and programmers wishing to write code which 
  82. will run on the widest range of machines must either ignore gadtools 
  83. or write code conditional on the operating system version. In addition, 
  84. the calls to gadtools routines are somewhat complex.
  85.  
  86. STSLib is similar to gadtools. It allocates space for gadgets and menus
  87. supplying 3D-look AmigaDOS V2.0 style gadgets to programmers in a form 
  88. which is compatible with both AmigaDOS V1.3 and V2.0.
  89.  
  90. STSLib is able to select pens intelligently for the top-left and 
  91. bottom-right of gadgets such that the 3D-look will appear lit from the 
  92. top left under the vast majority of screen colour combinations. 
  93. AmigaDOS V2.04 gadtools performs badly in this respect, always selecting 
  94. pen 2 for the top-left and pen 1 for the bottom-right.
  95.  
  96. Routines are available to build the check box, radio button and cycle 
  97. gadgets found in gadtools as well as boolean, string, and slider gadgets.
  98. Routines are also supplied to allocate and build Menu and MenuItem
  99. structures. As with the gadtools routines, these take account of the font 
  100. size being used for menus and correctly scale the menus to cope with 
  101. large or small fonts. Another routine allows pairs of menu items or 
  102. sub-items to be made mutually exclusive. Miscellaneous routines include 
  103. those for creating windows, treating windows as requesters, creating 
  104. IntuiText structures, drawing raised or depressed frames and freeing 
  105. memory allocated by the other routines. Additionally, a replacement for 
  106. AutoRequest() is supplied which produces a more attractive requester 
  107. under V1.3.
  108.  
  109. The C calls used to create menus and gadgets are easier to use than those 
  110. supplied with gadtools. This ease of use means that some of the 
  111. flexibility of gadtools is missing in the supplied calls. However, since 
  112. the gadgets and menus created are standard Intuition structures (unlike 
  113. gadtools), they may be further modified by the programmer if required. 
  114. Additionally, source code for the routines is available and the 
  115. programmer may modify this to satisfy particular requirements.
  116.  
  117. STSLib V1.0 does not support the composite gadget types provided by 
  118. gadtools. These include sliders with associated arrow gadgets and sliders 
  119. which display a value.
  120.  
  121. The software is fully compatible with AmigaDOS V2.0, the enhanced chip set
  122. and the Amiga A3000 as well as earlier machines and AmigaDOS V1.3
  123.  
  124.