home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 24 / af024a.adf / FW_docs < prev    next >
Encoding:
Text File  |  1991-05-15  |  6.2 KB  |  157 lines
  1. (Deep breath...)
  2.                 - WARRANTY -
  3.  
  4.  
  5. THIS PRODUCT IS DISTRIBUTED "AS IS" WITHOUT REPRESENTATION OR WARRANTY
  6. OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING WITHOUT
  7. LIMITATION, ANY REPRESENTATIONS OR ENDORSEMENTS REGARDING THE USE OF,
  8. THE RESULTS OF, OR PERFORMANCE OF THE PRODUCT, ITS APPROPRIATENESS,
  9. ACCURACY, RELIABILTY, OR CURRENTNESS. THE ENTIRE RISK AS TO THE USE OF
  10. THE PRODUCT IS ASSUMED BY THE USER.
  11.  
  12. IN NO EVENT WILL I BE  LIABLE FOR ANY DAMAGES, DIRECT, INDIRECT,
  13. INCIDENTAL OR CONSEQUENTIAL, RESULTING FROM ANY DEFECT IN THE PRODUCT.
  14.  
  15. THIS DISCLAIMER SHALL SUPERSEDE ANY VERBAL OR WRITTEN STATEMENT TO THE
  16. CONTRARY.
  17.  
  18. (...phew!)
  19. ==============================================================================
  20.  
  21.           FastWINDOWS v0.2, ©1990 by Rob Plant.
  22.  
  23.      An intuition-based window designer for Amiga programmers.
  24.  
  25. ==============================================================================
  26.  
  27. Introduction
  28.     If you, like me, program the Amiga using Intuition and find that
  29.     you spend hours and hours and hours and hours (yes, allright, we
  30.     get the idea...) trying to get the size, shape, flags etc. set
  31.     correctly for your window, then FastWINDOWS is for YOU!!!!
  32.  
  33.     FastWINDOWS allows you to design your window in a WYSIWYS way:-
  34.     You can alter position and sizes; set the IDCMP and TYPE flags;
  35.     Enter titles, define labels for a Checkmark image or to the first
  36.     gadget etc.. And all with a click of the mouse.
  37.  
  38.     Right, if you want all this, then read on!!!....
  39.  
  40. Installation
  41.     You can keep FastWINDOWS anywhere you want to. It only takes up
  42.     about 14K (7K crunched) so it won't take up too much space on a
  43.     utility disk etc. To run FastWINDOWS, simply type 'FastWINDOWS'
  44.     (assuming that it is in the current directory). Anything after this
  45.     will be ignored. I'm afraid that I don't know about running a
  46.     program from the Workbench so FastWINDOWS must be run from the CLI
  47.     only.
  48.     (I'd like to complain here about the horrendous price of Amiga
  49.     software and reference material!)
  50.  
  51. Useage
  52.     FastWINDOWS is designed to be very easy to use. In fact, most of
  53.     the features should be self explanatory. However, here is a brief
  54.     description of the main screen...
  55.  
  56.     'Name' string gadget: the text for the Window title.
  57.     'Scrn'    "     "   : the optional label for the LONGWORD which
  58.                  contains the ptr to a screen.
  59.     'Gdgt'    " "       : an optional label which is the first gadget
  60.                   in the string that are displayed when the
  61.                   window is opened
  62.     'Chck'    "     "   : the optional label which is the image for
  63.                   a userdefined checkmark
  64.     'G00Bitmap'     "   : another optional label to a bitmap. I don't
  65.                   actually know how to use this!! I want the
  66.                   intuition reference manual (sigh!).
  67.     Detail & Background : the default colours in the window.
  68.     ScrnType        : the actual screen type (eg. 15 = custom).
  69.  
  70.     The IDCMP gadgets   : These allow you to select which IDCMP events
  71.     (bottom left block)   your window should report. Simply click on
  72.                   them to Select them (and again to deselect).
  73.                   The actual hex value of your selections is
  74.                   shown after "IDCMP flag:" (under the 'Name'
  75.                   box).
  76.     The TYPE gadgets    : These let you select the appearance of your
  77.     (bottom right block)  window (eg. BORDERLESS, WINDOWSIZING)
  78.                   They work in the same way as the IDCMP gadgets.
  79.                   The value of your selection is shown after
  80.                   "TYPE flag:".
  81.     POS, SZE, MAX, MIN  : These allow you to define the Position, Size
  82.                   Maximum-size and Minimum-size of your window.
  83.                   Simply drag the window to the desired
  84.                   position or alter the size of it as you wish.
  85.                   Then press any key to return to the main
  86.                   screen.
  87.     The 6 gadgets to the: If you wish to type in a position/size etc.
  88.     to the right of POS : then just click on the gadgets and type in
  89.     etc.              your value. The boxes are in the order of
  90.                   x,y. That is  POS X-coord Y-coord. Oh, I'm
  91.                   too tired to try and explain. Just have a
  92.                   go!!!
  93.  
  94.     And now a description of the menu.... (wow!)
  95.  
  96.     See Window        : Allows you to see your window in all it's glory!
  97.                   Click inside the window and press any key to
  98.                   return to the main screen.
  99.     About....        : All about the proggy.
  100.     Screen            : Select the screen type you wish to see/define
  101.                   your window in.
  102.     Generate        : Actually write the source code to disk.
  103.                   At the moment, only Assembler source can be
  104.                   generated, 'cos I can't be bothered to do the
  105.                   BASIC and I don't know about 'C'!!! Send
  106.                   a donation and info (about 'C') if you want
  107.                   either of these!!!!!
  108.     Quit            : Exit FastWINDOWS. What a suprise!
  109.  
  110.     Right, that's all you need to know, really. Just have a go and play
  111.     around with the program. You should get used to it very quickly.
  112.  
  113. PLEASE, PLEASE, PLEASE !!!
  114.  
  115. If you use FastWINDOWS and think that it is useful, or you simply like it,
  116. or would like to support an impoverished programmer, or are just very nice,
  117. then please send me something (no, not a bomb or fingers!)
  118.  
  119. - Some money would be very nice, say about £5!
  120. - If you can't manage 'bish bosh bundles of dosh' then please write
  121.   something useful and place it in the Public Domain.
  122.  
  123. Future improvements are along the lines of palette, gadgets, menus etc.
  124. I would also appreciate it if you would send me criticisms and
  125. improvements...
  126.  
  127.           Hope this proggy is useful!
  128.  
  129.                     Rob Plant,
  130.                     2 Charlham Way,
  131.                     Down Ampney,
  132.                     Cirencester,
  133.                     Glos. GL7 5RB.
  134.                               January 1991
  135.  
  136. PS. Sorry if you think it's a naff manual. It's 12:30 am and I'm knackered!
  137.  
  138. PPS. Night, night!
  139.  
  140. ADDITIONAL INFO
  141. This program is written in a 100% assembler on a half-meg A500, using the
  142. free demonstration copy of Devpac 1, with Abacus' Amiga machine Language
  143. book as reference. Dedication or what???!!!
  144.  
  145. The correct length of FastWINDOWS is 14,856 Bytes. Compressed using Power
  146. Packer it is 7,396 bytes.
  147.  
  148. FastWINDOWS v0.2 is "Giftware". This means that if you find it useful,
  149. I would appreciate it if you would send me a little something to to
  150. support my further efforts! (See above.)
  151. Please do not distubute this program at a great profit. It is meant to
  152. encourage people like me who think that 60 pounds is a lot of beans
  153. for something like Power Windows.
  154.  
  155.  
  156.  
  157.