home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / code_examples / prettywindows / prettywindows.doc < prev    next >
Text File  |  1990-11-02  |  3KB  |  75 lines
  1.  
  2.  
  3.  
  4.            PrettyWindows v1.0
  5.  
  6.            by  Thom Robertson
  7.  
  8.                7/14/90
  9.  
  10. For the last couple of days I have been perusing all the neat games and
  11. stuff in the Fred Fish disk collection.  One thing became painfully clear
  12. to me.  There are many adventure games out there which are ALL text, and
  13. the Amiga implementations are very plain.  This is not necessarily a bad
  14. thing, nor am I saying that the programmers are dumb.  However, I can't
  15. help but think that even a little prettying-up would do wonders for any
  16. text adventure game (and, for that matter, many utilities, too).
  17.  
  18. PrettyWindows is a set of LATTICE C 5.04 routines designed to make a text
  19. window more presentable.  They can be easily inserted into your code, and
  20. will automatically adjust to any size or depth of window.
  21.  
  22.  
  23. The Demo
  24.  
  25. Run the file called "Demo" from your Workbench screen (or CLI on the WB
  26. screen).  This shows you what is pretty about the three different types of
  27. window PrettyWindows makes.
  28.  
  29. My Policy
  30.  
  31. PrettyWindows V1.0 in its entirety is freely redistributable, and can be
  32. used in any application, so long as:
  33.  
  34. Credit for PrettyWindows is given somewhere in the documentation AND the
  35. source code, and
  36.  
  37. You write me and share with me what you are doing with it.
  38.  
  39.  
  40. Tech Stuff
  41.  
  42. The three routines, pwindows1, pwindows2, and pwindows3 are designed to be
  43. called AFTER you have opened a window.  Each routine clears the screen to
  44. any color and put a nice border in the window.  Therefore, you can easily
  45. think of PW as a rather special ClearWindow routine.
  46.  
  47. The window should be BORDERLESS, title-less, have no border gadgets (close
  48. window, front/back, sizing) or a dragbar.  If you don't have a routine that
  49. creates such a window, my makewindow routine can, so use that.
  50.  
  51. PrettyWindows can't work with a console window (at least, I don't think it
  52. would be a good idea).  Write text to the window with the graphics 
  53. primitives Move() and Text().  Remember to SetDrMd() to JAM1.
  54.  
  55. Note that the Images in pwindows2 have data which is declared "chip".  This
  56. is a LATTICE C 5.xx convention which insures that the data will be loaded
  57. into CHIP RAM. If your compiler doesn't have this, you probably have a
  58. command line "-" argument for your compiler that will put the data into
  59. CHIP RAM.  Also note that pwindows2 won't use any other background color
  60. besides 0 (usually black).  This is because the Intuition DrawImage command
  61. will set the rectangle of the Image to 0 all the time.  It's possible to
  62. get around this (I usually use BitMaps instead of Images anyway), but I was
  63. just lazy.
  64.  
  65.  
  66. If you have any questions, please write or call me.  I would love to help
  67. put together or modify a neat game or utility.  My address as of 7-14-90
  68. is:
  69.  
  70. Thom Robertson
  71. 803-C Autumn Circle
  72. College Station, TX. 77840
  73.  
  74.  
  75.