                 rTutor.S16 - The Resource Tutorial Application
                                  version 3.3
             (This time around, we explore icons and custom cursors)


This "Read.Me" file is a SHORT summary of what's new this time around and
how to build the application from its source code.  More detailed information
will be available seperately (once I write it) in the form of "Rez 105" - the
fifth installment in my on going detailed docs for the resource tutorial.  As
I write this, only Rez 101 and Rez 102 have been done so far.  I still need
to do Rez 103 and Rez 104 before I do Rez 105, so don't hold your breath - it
takes a lot of time to do some of this stuff...

The APW C source file "rTutor.C" and the Rez source file "rTutor.Rez" together
create an application that starts up all needed tools from a list in
the application's resource fork, installs a menu bar in that application, and
opens a window (with icons in it) from the resource fork.  The menu bar and
all of the menus in that menu bar are also stored in the resource fork of the
application.  The icon in the window is also kept in resources so you can
change the "look" of the window and menus using only resource editing tools
such as DeRez/Rez (from APDA) or GeneSys (from SSSi).  The standard pointer
cursor has been changed to a pig face just to show how custom cursors are
created in resources and how to use them from within your applications.

Compiling the Rez source code requires the Rez compiler which can be purchased
from either "Developer Tools Express" or from "APDA" (Apple Programmers and
Developers Association).  Rez, along with a number of other resource tools and
APW utilities can be ordered by calling APDA (it's the same phone number for
"Developer Tools Express" - the only difference is that you do NOT have to be
an APDA member to order from Developer Tools Express) at:  1-800-282-2732.
These tools are part of the product named "APW Tools & Interfaces v.1.1",
the price is fifty dollars.  The part number for this package is "A0240LL/A".

Three other tools from that package are also used to build this resource
tutorial application.  These tools are "duplicate" (which copies files without
losing their resource forks like the regular COPY command currently does) and
LinkIIGS.  If you use the original APW linker or ORCA's original linker, please
be sure to add (at the END of all other lines) the two lines:

COMPACT rTutor.S16 -o rt.comp
EXPRESS rt.comp -o rTutor.S16

These steps are NOT needed if you're using The Byte Works, Inc's new "ZapLink"
since it automatically does the equivalent of COMPACT and EXPRESS, just like
LinkIIGS does.

To create the application, issue the following command from the APW/ORCA
shell's command line:

rTutor.Make

Everything else is taken care of by this EXEC script.  If you want to see how
the rTutor application is built, simply TYPE or print the rTutor.Make file.





enjoy!
Tim S.

I can be reached on the following networks for questions, info, request, etc.
Please be sure to check the general forums there first since you're more likely
to get a fast answer in the public forums than via email.

GEnie:  Tim.Swihart (post in A2Pro first)
America Online: A2Pro Tim    (post in ADV first)
AppleLink  Tim.Swihart  (post on GEnie or America Online first)


p.s.->  Cursors are a PAIN!  And their masks are even worse!  The pig face has
a square mask (because I was tired of futzing with it).  If you're looking for
a way to explore cursors, then I suggest you tackle the problem of making the
mask for that cursor work better.  By the time you're done, you'll be VERY
familiar with cursors...  <grin>
