home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 053.lha / HackBench / hb.doc < prev    next >
Encoding:
Text File  |  1986-11-20  |  2.4 KB  |  60 lines
  1.     HackBench requires V1.2, and should be compiled using Aztec
  2. 3.40a with 16-bit integers:
  3.  
  4.     cc hbicon
  5.     cc hbobj
  6.     cc hbgad
  7.     ln -o hb hbicon.o hbobj.o hbgad.o -lc
  8.  
  9.     You'll undoubtedly get a few warnings--my include files are
  10. customized, e.g. Window titles are char *'s instead of UBYTE *'s,
  11. and my functions.h file has been corrected.
  12.  
  13.     The purpose of HackBench is to provide the source for a
  14. Workbench-like program; it is not intended to be an actual
  15. Workbench replacement.  Some features are not supported, such as
  16. Info, Snapshot, Format, and DiskCopy.  Use of HackBench takes
  17. more memory since Workbench is in ROM.
  18.  
  19.     HackBench manages WBObjects.  WBObjects are represented
  20. simultaneously:
  21.    1) On the disk as a .info file
  22.    2) On the screen as an icon
  23.    3) Internally as a WBObject data structure.
  24. HackBench coordinates things so that icon manipulations are
  25. transmitted to the disk.
  26.  
  27. HackBench uses the UserData field of the Intuition Window to
  28. store a pointer back to the WBObject, and sets the WBENCHWINDOW
  29. bit in the Window's Flag field as a means of identification.
  30.  
  31.     All the WBObjects existing at any time are linked together
  32. on a Master List.  Order of WBObjects in the Master List
  33. determines which icon is drawn first, and therefore which one
  34. appears in front.  Each Disk or Drawer has a Children List,
  35. imitating the structure of the filing system.  Objects currently
  36. selected (and highlighted) appear on the Select List.
  37.  
  38.     The Master List must constantly reflect what is on the
  39. screen.  When a Window is opened, each .info file found is used
  40. to build a WBObject, which is added to the Children List.  Unlike
  41. Workbench, we save the icons and display them all at once.
  42.  
  43.     When a window is closed, its Children are deleted, except
  44. for those whose icons are currently open themselves or living on
  45. the backdrop.  If the Drawer is later reopened, these orphans
  46. must be found and relinked with their Parent to avoid
  47. duplication.
  48.  
  49.     HackBench has several Intuition-like features that are
  50. managed without help from Intuition. Icons are stored in Gadget
  51. structures, but are not actual Intuition Gadgets.  HackBench
  52. handles by itself the display, highlighting and hit detection for
  53. icons.
  54.  
  55.     An open Drawer simulates an Intuition SuperBitMap Window,
  56. without using a second BitMap.  The icons live in a scrollable
  57. virtual coordinate system, but the extent of this is not fixed. 
  58. As the icons change position, the virtual coordinates
  59. automatically extend or contract as necessary.
  60.