home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 10 / intuilib / readme! < prev    next >
Encoding:
Text File  |  1994-01-27  |  3.1 KB  |  82 lines
  1. _________________________________________________________________
  2.  
  3. Title: Intuition Library
  4. By:    Jeremy Zullo
  5. Date:  11/25/86
  6. _________________________________________________________________
  7.  
  8.     This includes two source codes written in C to help the
  9. programmer pay attention to his algorithms instead of time
  10. wasting routines like opening screens and windows.  The two
  11. programs have to be compiled and left in object code. And added
  12. to the link list when the main program is being linked.  Or they
  13. can be made into your own library.  I am currently working on
  14. some routine for 3D plotting and animation.
  15.  
  16.     The first function (program) is called "screen".  As you can
  17. guess it opens up screens.  This function returns the RastPort of
  18. the screen.  The calls to it are as follows: scr=screen
  19. (x,y,x1,y1,t,d); you must have the intution include at the
  20. begining of your program so that the RastPort structure is
  21. defined.  The scr is the RastPort structure of the new screen
  22. that was just opened. X,Y are the beging X,Y coordinates of the
  23. screen.  D is the depth of the screen in bit-planes. And the T
  24. defines the options of the screen.  Below is a chart of the
  25. various options:
  26.  
  27.             1 Hires
  28.             2 Lace
  29.             4 Dual Playfield
  30.             8 Ham
  31.  
  32. If you want multiple options just add the numbers together. For
  33. instance, if you wanted Hires and Lace the T value would equal 3
  34. (1+2=3).  That is how simple it is to open the screen.  Now
  35. instead of having a gabolgy (sp?) code of say 30 lines, now it is
  36. condensed to just one single function.
  37.  
  38.  
  39. Window:
  40.  
  41.     The other command is the "window" function.  The calling is
  42. like Win=window(scr,ti,x,y,x1,y1,type); Where the SCR is the
  43. rastport of the screen that you want the window to appear on.
  44. The TI is a pointer to the text for the window. The XY are self
  45. explanatory.  The X1, and Y1 are the length and width of the
  46. window repectivly. And the type is the different options as shown
  47. on the following list:
  48.  
  49.             1 Window Drag Gadget
  50.             2   "    Close  "
  51.             4   "    Depth  "
  52.             8   "   Sizing  "
  53.            16 Backdrop
  54.            32 Activate
  55.            64 ReportMouse
  56.           128 Simple Refresh
  57.           256 Smart Refresh
  58.           512 No Care Refresh
  59.          1024 Active Window
  60.          2048 InActive Window
  61.          4096 Gimme ZeroZero
  62.          8192 Borderless
  63.  
  64. If you want multiple options just add the T values together. The
  65. Win is the RastPort of the window returned from the window
  66. function.
  67.  
  68. _________________________________________________________________
  69.  
  70.  
  71. I should be done with some of the 3D routines in a few days.  As
  72. can be seen there are an inlimited number of easy routines that
  73. can be made easier by simply sticking them into their own
  74. fuctions and making a library out of them.  Currently, I am
  75. working on rewriting the Basic routines as Fuctions which will
  76. make it easy to design your own basic compilers.  I will be
  77. releasing a PD MSB compiler in a matter of weeks.  I can be
  78. contacted by phone if there is any problems at (516-475-6741).
  79.  
  80.  
  81.                                            -Jeremy Zullo
  82.