ftp.nice.ch/pub/next/tools/workspace/DockClock.README

This is the README for DockClock.1.8.NISH.bs.tar.gz [Download] [Browse] [Up]

DockClock v1.8

ABOUT THE PROGRAM:

This program was created because I am one of the owners of a 8-105 slab.  It
irked me that to get a clock in the dock I had to run Preferences, but since
I don't use Preferences very often I compressed it.  Also, Preferences in my
mind is a memory hog (I only have 8 megs of real memory).

So to make a long story short, I created my own dock clock.  This is a
simple clock with the same clock faces as Preferences, and you can add your
own analog backgrounds.

The clock face that has the calendar and such doesn't look exactly like
Preferences because NeXT used bitmaps to do the fonts and I didn't want to
put the code in to do that.

For those of you who have color machines but not 3.0, the background comes
from 3.0 so it is going to look better then the rest of your icons while it
is running.

USAGE:

Simply put the App in a convenient place and start it up.  It doesn't look
so great if you start it from the command line.  Clicking on the clock face
in the preference window will change the clock face. Hiding the app causes
the main clock face (in the icon) to change to the set preferences.  Some of 
the flags you can toggle will have no affect on the clock.  If that is true
then don't worry because somethings like military time don't look good on an 
analog clock.

ADDING YOUR OWN ANALOG BACKGROUNDS:

To add your own background, copy a tiff file into the app wrapper of the
application.  Name the tiff with a number (e.g. 8.tiff).  There should be no
gaps in the numbers.

The image should be 64x64 with an Alpha channel to look right.  Look at how
did some of mine.

REQUIRED FILES IN APP WRAPPER:

The following files are required to be in the app wrapper:
	analognumber.tiff
	analog.tiff
	black.tiff
	DockClock
	Clock.nib
	granite.tiff
	Info.nib
	Preferences.nib
	standard.tiff

COMMENTS AND CRITISMS TO:

Brian Glaeske
glaeske@plains.NoDak.edu	..!uunet!plains!glaeske

THANKS TO:

Before I talk about the programming stuff, I would like to thank Scott Hess
and peter@tahiti.umhc.umn.edu for some comments on the program.  Scott Hess 
also wrote a program called Clocks that I scavenged code to do the analog
hands.

PROGRAMMING STUFF:

I only re-wrote this thing about 10 times before I got an acceptable
application for distribution.  This still isn't the best example program for
beginners (or experts) to look at.

The following is my critique of the program.

Good Points:
	Used mulitple .nib's.  Start up time is real quick because of this.
	Used an object to distribute messages to the clock instances.
	Made it an app wrapper.
	Freeing windows when the app is hidden.  Hopefully no mem leaks.

Bad Points:
	Set the font to many times.
	-drawSelf:: could be MUCH cleaner.  It gets the job done.
	Not a good example of using an object oriented style.

COPYRIGHT STUFF:

I am copyrighting this program under the GNU Public licence.  So any changes
that you make send back to me and do not distribute.  Any changes that are
sent back to me and I like, I'll put into the program and put your name in
the Info panel with mine.

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.