home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 2 / MECOMP-CD-II.iso / amiga / tools / systempatch / birdie15 / birdie.doc next >
Encoding:
Text File  |  1997-10-28  |  5.3 KB  |  162 lines
  1.  
  2. Birdie 1.5 © 1997 Trond Werner Hansen (Tronan).
  3.  
  4. Email: tronhan@stud.ntnu.no
  5.  
  6. Birdie is a *hack* which gives you patterns in the windowborders
  7. of windows on the workbench screen.
  8.  
  9. NOTE: this hack is designed for gfxcard owners, and although
  10. version 1.3 works with AGA/ECS, keep in mind that I won't spend
  11. time tuning if for such setups..
  12.  
  13. Remember to disable patches like QuickDraw.
  14.  
  15. Usage
  16. -----
  17.  
  18. "Birdie ?" gives:
  19.  
  20. "ACTIVEPATTERN/S,PATTERNS/M,NODRAW/S,NOBITMAPS/S,NOICONBORDER/S,
  21. NOLIGHTING/S,ACTIVECOLOR/K,IMPOSELEVEL/N,LRA/N,LGA/N,LBA/N,DRA/N,DGA/N,DBA/N,
  22. PRECISION/N,FLOODMASKMWB/S,PUBSCREENS/S,EXCLUDE/K"
  23.  
  24. PATTERNS
  25. --------
  26. From 1 to 20 names of patterns. If none are given or birdie
  27. is unable to load none for some reason, birdie simply returns, doing 
  28. nothing. When running, each window will get a random pattern from this
  29. list. The patterns are loaded using datatypes.
  30.  
  31. example: "Birdie pattern1.iff pattern2.iff"
  32.  
  33. ACTIVEPATTERN
  34. -------------
  35. This switch tells birdie that the first pattern
  36. in the list (see above), should be used as active window pattern.
  37. When windows are inactive they will get a random one from the
  38. REST of the list. This switch makes no sense unless you give birdie
  39. at least 2 patterns.
  40.  
  41. example "Birdie pattern1.iff pattern2.iff pattern3.iff ACTIVEPATTERN"
  42.  
  43. In this example, "pattern1.iff" will be used for the active window,
  44. while when inactive each window will get either "pattern2.iff" or
  45. "pattern3.iff" (selected random, when window is opened).
  46.  
  47. NODRAW
  48. ------
  49. This switch disables the Draw() patch in gfx.lib. Meant for
  50. debugging purpose.
  51.  
  52. NOBITMAPS
  53. ---------
  54. No bitmaps rendered to the window border will be patched.
  55. This usually means that system gadgets will be left alone.
  56.  
  57. NOICONBORDER
  58. ------------
  59. This switch is for users of the original Workbench. Icons
  60. will be rendered without border and have pen 0 transparent.
  61. The iconbitmaps and masks are cached after first draw, which
  62. means it will refresh faster, but it also eats memory.
  63.  
  64. Use this option instead of the NewIcons one. Also, disable
  65. QuickDraw in MCP.
  66.  
  67. NOTE: For this switch to work, you must NOT use the NODRAW
  68. or NOBITMAPS.
  69.  
  70. PRECISION
  71. ---------
  72. This is a number from 32 to -1 meant for AGA users to specify
  73. the remap precision, so that they can save some pen allocations.
  74. Default is -1, which gives best precision (EXACT).
  75.  
  76. example: "birdie pattern1.iff PRECISION=32" (very low precision)
  77.  
  78. FLOODMASKMWB
  79. ------------
  80. This switch makes the NOICONBORDER patch more complete.
  81. If enabled, icons with 16 colors or less (which usually is mwb
  82. style or old standard amiga style) will have their masks generated
  83. by flooding pen0 around the border. Instead of making pen 0
  84. transparent everywhere, only those pen 0 pixels which are reachable
  85. from the border becomes transparent.
  86.  
  87. I advice everyone which are using Workbench (and not some 
  88. replacement like Scalos or DOpus) to try out NOICONBORDER and 
  89. FLOODMASKMWB (specify both). Use this feature *instead* of 
  90. all other noborder hacks like the one in newicons (disable it in
  91. newicons prefs).
  92.  
  93. NOTE: The flood mask routine uses a handmade Flood() routine in
  94. 100% ASM so you don't suffer from slow loading.
  95.  
  96. PUBSCREENS
  97. ----------
  98. Switch that cause birdie to affect all public screens, unless EXCLUDE 
  99. is defined.
  100.  
  101. EXCLUDE
  102. -------
  103. Defines a string that will be matched against public screen names.
  104. Successful match indicates that screen will be left alone. The 
  105. string can be a standard pattern-match like string with wildcards etc.
  106.  
  107. example: EXCLUDE=Workbench (workbench not affected)
  108. example: EXCLUDE=(Workbench|MyPubScreen) (workbench nor mypubscreen affected)
  109.  
  110. *********************************************************************
  111. * the following options only make sense for users of
  112. * hi/truecolor screens. (ie. Gfxcards)
  113. *********************************************************************
  114.  
  115. NOLIGHTING
  116. ----------
  117. This switch causes users of hi/truecolor displays to not have
  118. the real shine/shadow effect, but get the old white/black lines.
  119. Will save you some memory.
  120.  
  121. ACTIVECOLOR
  122. -----------
  123. Instead of using ATCIVEPATTERN switch to get a seperate pattern
  124. for the active window, you can instead make the window get
  125. the same pattern as used when inactive, but imposed with a
  126. a special color. The color is given as a hexnumber in RGB format,
  127. 8bits per gun. See example.
  128.  
  129. example: "birdie Patterns1.iff ACTIVECOLOR=ff0000"
  130.  
  131. This imposes color Red (ff0000) to the active window.
  132.  
  133. NOTE: this uses even more memory, twice as much in fact.
  134.  
  135. IMPOSELEVEL
  136. -----------
  137. If you use the ACTIVECOLOR option, you can use IMPOSELEVEL
  138. to set how much in % the color should be imposed. Default
  139. is 50%.
  140.  
  141. example: "birdie pattern1.iff ACTIVECOLOR=ffff00 IMPOSELEVEL=20"
  142. this will impose the active pattern by yellow, 20%.
  143.  
  144. LRA,LGA,LBA,DRA,DGA,DBA
  145. -----------------------
  146. Each of these options is given with a number which is the 
  147. RGB balance value used for generating the shine/shadow effect
  148. in high/truecolor.
  149.  
  150. DEFAULT is, shine: 60,60,60 shadow: -60,-60,-60
  151.  
  152. example: "Birdie pattern1.iff LRA 100 LGA 80 LBA 60 DRA -60
  153. DGA -80 DBA -100"
  154.  
  155. This will give the shine version of the pattern a balance of
  156. 100,80 and 60, which means 100 will be added to the RED gun
  157. of each pixel, 80 to the GREEN and 60 to the BLUE.
  158. For the shadow version I use negative numbers so that the
  159. RGB values get lower (darker pixel). Each gun i 8bit (0-255).
  160.  
  161. If you don't get it, try and you'll soon figure it out.
  162.