home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_2.iso / files / 679b.lha / FlyingToasters_v1.2 / ft.doc.pp / ft.doc
Text File  |  1992-09-27  |  6KB  |  177 lines
  1.  
  2.  
  3.                                 Again it's
  4.  
  5.  
  6.                              Flying Toasters! 
  7.  
  8.                                 Version 1.2
  9.  
  10.                                     by
  11.  
  12.                           Gernot Reisinger (w)92
  13.  
  14.  
  15.  
  16. Copyright Notice:
  17.  
  18. FT is Public Domain. This release includes binary and source files.
  19. Do anything with it you want but:
  20.  
  21.     1. keep all files of the package together,
  22.     2. describe the changes you made in the program,
  23.     3. I am the author of the original program, so please state this
  24.        in your release,
  25.     4. no commercial selling (copy fees up to 2$ (5$ including the
  26.        medium) are allowed),
  27.     5. the permission to include and to distribute FT within the Fred 
  28.        Fish PD disks is explicitly stated here,
  29.     6. FT is limited to non-atomic, non-military and non-chemical
  30.        industries related usage (write your own screen blankers -
  31.        coneheads!)
  32.     7. send me a postcard of your hometown if you frequently use
  33.        FT!
  34.  
  35. Purpose:
  36. --------
  37.  
  38. Another screen/mouse blanker commodity (software that makes you happy ;=)
  39.  
  40.  
  41. Story:
  42. ------
  43.  
  44. I saw them fly on the macintosh and on a stupid pc. From that on I
  45. couldn't sleep. Flying objects arround everywhere.
  46.  
  47. Well it was a 3 days hack to bring them on the amiga and for the 
  48. flight studies required for the art design I crashed 17 toasters ;-).
  49.  
  50. The blanker eats up a lot of calculation time. So if you do any 
  51. background calculations adjust the number of objects or decrease
  52. the object speed (new 1.1 change priority).
  53.  
  54. Tooltypes:
  55. ----------
  56.  
  57. CX_POPKEY    (default shift f1)    Pops up the FT preferences window.
  58. CX_BLANKKEY    (default shift f2)    Immediatly blanks the screen.
  59. CX_PRIORITY    (default 0)            Commodity priority
  60. CX_POPUP    (default no)        Open preferences window at startup
  61. SPEED        (default medium)    toaster speed 
  62.                                 Choose between boring, medium and turbo.
  63. TIMEOUT        (default 180)        Seconds until screen blank.
  64. OBJECTS        (default 20)        Maximum number of toaster on the screen
  65.                                 (max. 40). 0 disables toasters - simple
  66.                                 screen blanker.
  67. PRIORITY    (default 0)            The process priority of the animation process.
  68. SLEEP        (default top right)    The sleep corner. Place the mouse in this screen
  69.                                 corner and the screen immediatly blanks.
  70. NEVERSLEEP    (default bottom left)    disable screen blanking while mouse is in this
  71.                                 screen corner
  72. MOUSETIMEOUT (default 3)        seconds until mouse pointer blanks, if -1 specified
  73.                                 mouse blanking is disabled.
  74.  
  75. The Preferences Window:
  76. -----------------------
  77.  
  78. Lets you adjust the speed and number of objects and timeout. Additional 
  79. you can watch the different flight modes of the toasters (use the 
  80. mx-gadget or menu). The about menu item displays some program notices
  81. (sorry for the bad scroller). The rest should be self explaining,
  82.  
  83.  
  84. Implementation:
  85. ---------------
  86.  
  87. (All files edited with tabsize = 4!!)
  88.  
  89. I developed the whole package with SAS-C ver. 5.10 (thanks to HS for 
  90. providing me the machine and compiler). The package includes no makefile as 
  91. I used my private version of bmake which is not compatible to the official 
  92. version. Compile all files with -v and link cback.o! The include file std.h 
  93. contents some private goodies and is also not included in the package.
  94.  
  95. All typedefs and defines needed stated below:
  96.  
  97. typedef    unsigned char    UCHAR;
  98. typedef    char            BYTE;
  99. typedef    unsigned int    UINT;
  100. typedef    unsigned long    ULONG;
  101. typedef    long            LONG;
  102. typedef    char            BOOLEAN;
  103. typedef short            SHORT;
  104. typedef unsigned short    USHORT;
  105. typedef    int                INT;
  106. #undef    TRUE
  107. #undef    FALSE
  108. #define    TRUE            ((BOOLEAN) 1)
  109. #define    FALSE            ((BOOLEAN) 0)
  110. #undef    GLOBAL
  111. #undef    LOCAL
  112. #define    GLOBAL            extern
  113. #define    LOCAL            static
  114. #define    FOREVER        for(;;)
  115. #undef    NULL
  116. #define    NULL        0L
  117. #define    IS_KICK2_0    (SysBase->LibNode.lib_Version >= 37)
  118.  
  119. Further you should define following symbols:
  120.     HEADER_PRECOMPILED        if you want to use procompiled header files
  121.     DEBUG                    to enable debugging mode
  122.  
  123.  
  124. I developed FT on a Amiga 3000 25 MHz with 5 MB and 150 MB Harddisk. 
  125. I didn't test FT on other machines. But there is no reason why it 
  126. shouldn't work (performance may lack on a 68000 machine).
  127.  
  128. FT was modeled on several other programs programs:
  129.  
  130.     FracBlank            by Olaf Barthel & MXM
  131.     MouseBlanker        by Stefan Sticht
  132.  
  133. Other implementation Tools:
  134.     IFF2Src                J. Thyberghein
  135.     makec                Robert Kesterson
  136.  
  137. All programs appeared withtin the Fred Fish PD series.
  138.  
  139.  
  140.  
  141. At least - send regards, bug fixes, your own little hacks to
  142.  
  143.                              Gernot Reisinger
  144.                              4943 Geinberg 121
  145.                              Austria (Europe)
  146.  
  147. EMail:    gr@cast.uni-linz.ac.at (may expire in october '92)
  148.         (Department of Systems Science, University Linz, Austria)
  149.  
  150.         I try to reply all incoming mail, but PLEASE be patient!
  151.  
  152.  
  153.  
  154. --------------------------------------------------------------------------
  155. Motto of release 1.2:
  156.  
  157.                        The easy way is always mined.
  158.  
  159. --------------------------------------------------------------------------
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166. --------------------------------------------------------------------------
  167. HISTORY
  168. --------------------------------------------------------------------------
  169. 24/03/92    1.0        very first public release
  170. 30/03/92    1.1        added sleep corner and priority selection, decreased
  171.                     stack of animation process. Added a mouse blanker
  172. 12/09/92    1.2        Bugfixes; forgot to include pics in the previous 
  173.                     releases - pics are nw included in version 1.2;
  174.                     implemented mousblanking disable; changed the mouse
  175.                     blanking methods of the ft window which caused some
  176.                     problems (SetSprite replaced OFF_SPRITE)
  177.