home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Tools / workspace / DockClock.README < prev    next >
Encoding:
Text File  |  1992-06-20  |  3.0 KB  |  92 lines
  1. DockClock v1.8
  2.  
  3. ABOUT THE PROGRAM:
  4.  
  5. This program was created because I am one of the owners of a 8-105 slab.  It
  6. irked me that to get a clock in the dock I had to run Preferences, but since
  7. I don't use Preferences very often I compressed it.  Also, Preferences in my
  8. mind is a memory hog (I only have 8 megs of real memory).
  9.  
  10. So to make a long story short, I created my own dock clock.  This is a
  11. simple clock with the same clock faces as Preferences, and you can add your
  12. own analog backgrounds.
  13.  
  14. The clock face that has the calendar and such doesn't look exactly like
  15. Preferences because NeXT used bitmaps to do the fonts and I didn't want to
  16. put the code in to do that.
  17.  
  18. For those of you who have color machines but not 3.0, the background comes
  19. from 3.0 so it is going to look better then the rest of your icons while it
  20. is running.
  21.  
  22. USAGE:
  23.  
  24. Simply put the App in a convenient place and start it up.  It doesn't look
  25. so great if you start it from the command line.  Clicking on the clock face
  26. in the preference window will change the clock face. Hiding the app causes
  27. the main clock face (in the icon) to change to the set preferences.  Some of 
  28. the flags you can toggle will have no affect on the clock.  If that is true
  29. then don't worry because somethings like military time don't look good on an 
  30. analog clock.
  31.  
  32. ADDING YOUR OWN ANALOG BACKGROUNDS:
  33.  
  34. To add your own background, copy a tiff file into the app wrapper of the
  35. application.  Name the tiff with a number (e.g. 8.tiff).  There should be no
  36. gaps in the numbers.
  37.  
  38. The image should be 64x64 with an Alpha channel to look right.  Look at how
  39. did some of mine.
  40.  
  41. REQUIRED FILES IN APP WRAPPER:
  42.  
  43. The following files are required to be in the app wrapper:
  44.     analognumber.tiff
  45.     analog.tiff
  46.     black.tiff
  47.     DockClock
  48.     Clock.nib
  49.     granite.tiff
  50.     Info.nib
  51.     Preferences.nib
  52.     standard.tiff
  53.  
  54. COMMENTS AND CRITISMS TO:
  55.  
  56. Brian Glaeske
  57. glaeske@plains.NoDak.edu    ..!uunet!plains!glaeske
  58.  
  59. THANKS TO:
  60.  
  61. Before I talk about the programming stuff, I would like to thank Scott Hess
  62. and peter@tahiti.umhc.umn.edu for some comments on the program.  Scott Hess 
  63. also wrote a program called Clocks that I scavenged code to do the analog
  64. hands.
  65.  
  66. PROGRAMMING STUFF:
  67.  
  68. I only re-wrote this thing about 10 times before I got an acceptable
  69. application for distribution.  This still isn't the best example program for
  70. beginners (or experts) to look at.
  71.  
  72. The following is my critique of the program.
  73.  
  74. Good Points:
  75.     Used mulitple .nib's.  Start up time is real quick because of this.
  76.     Used an object to distribute messages to the clock instances.
  77.     Made it an app wrapper.
  78.     Freeing windows when the app is hidden.  Hopefully no mem leaks.
  79.  
  80. Bad Points:
  81.     Set the font to many times.
  82.     -drawSelf:: could be MUCH cleaner.  It gets the job done.
  83.     Not a good example of using an object oriented style.
  84.  
  85. COPYRIGHT STUFF:
  86.  
  87. I am copyrighting this program under the GNU Public licence.  So any changes
  88. that you make send back to me and do not distribute.  Any changes that are
  89. sent back to me and I like, I'll put into the program and put your name in
  90. the Info panel with mine.
  91.  
  92.