Some sample domains/libraries are given here.  If you have any questions,
please send mail to william@bourbon.cs.ucla.edu.

	The 'logic' library contains some logic gates.
	The 'flowchart' library contains some flow-chart primitives,
	The 'petri' library contains some petri net primitives.
	The 'latex' library contains one LaTeX equation example (use LaTeX
		to generate an EPS file containing an equation).  You would
		need both gs (ghostscript) and pstoepsi in your path to make
		it work.
	The 'latex2epsi' library contains another LaTeX equation example
		using a perl script.  You would need perl and pbm2epsi (from
		the pbmplus toolkit) to make it work.  This library is
		contributed by Robert Estes <estes@cipic.ucdavis.edu>.
		A separate copyright is included in it.

Please read 'tgif.man' in the tgif districution regarding how to build a
symbol file.  (Notice the invisible 'not_rigid' attributes in all the
flowchart symbols so that they can be stretched when instantiated.)

Do:

	mkdir ~/lib/tgif
	cd ~/lib/tgif
	uncompress logic.tar.Z; tar xvf logic.tar; rm logic.tar
	uncompress flowchart.tar.Z; tar xvf flowchart.tar; rm flowchart.tar
	uncompress petri.tar.Z; tar xvf petri.tar; rm petri.tar
	uncompress latex.tar.Z; tar xvf latex.tar; rm latex.tar

In .Xdefaults do:

	Tgif*MaxDomains:	4
	Tgif*DefaultDomain:	0
	Tgif*Domain0:		LOGIC
	Tgif*Domain1:		FLOWCHART
	Tgif*Domain2:		PETRI
	Tgif*Domain3:		LATEX
	Tgif*ShortCuts:		!<Key>T:ToggleNamedAttrShown(eq=) \n\
				!<Key>U:Undo() \n\
				!<Key>R:Redo()

In .cshrc do:

	setenv TGIF_LOGIC ~/lib/tgif/logic
	setenv TGIF_FLOWCHART ~/lib/tgif/flowchart
	setenv TGIF_PETRI ~/lib/tgif/petri
	setenv TGIF_LATEX ~/lib/tgif/latex

Run tgif, then do:

	<Cntrl>c	to change domain
	<Cntrl>i	to instantiate a symbol

Select an instantiated symbol by clicking on it.  Type <Cntrl>k to 'push'
in to it and view the symbol file.  Select all with <Cntrl>a.  View/move
an attribute with <Meta>m; notice the instruction in the message window.
Type <Cntrl><Meta>n to make the symbol object a grouped object.  Type
<Meta>t to detach all the attributes.  Use <Meta>u to undo and <Meta>*
to redo.

============================= additional obj files =============================

In addition to some sample domains/libraries, there are some obj files:

---------------------------------- earth.obj ----------------------------------

The earth.obj file contains a 30-frame spinning globe organized as a ``deck''.
A ``deck'' is a grouped object whose components are either all XPM or all XBM
objects.  All components must have identical sizes.  The grouped object uses
the exec= attribute for animation (select the globe and do ShowAttr from the
Special Menu to see all the attributes).  The flip_deck() command has 3
arguments: argument 1 is the number of times to run; argument 2 specifies
frames per second; argument 3 specifies either the linear or the ping_pong
style.  Everything after (and including) the '//' string is ignored ('//'
is treated like a C++ comment).

The file attribute icon_init_exec_obj= points to the globe object (which has a
name= attribute with value equals "globe").  This is what makes the globe
spin if earth.obj is used as an tgif icon.  To add, detach, or edit file
attributes, please use the suitable commands under the Special Menu.

A good way to run it would be:  'tgif -cwo =66x66 earth'.  Or, you can
set your TGIFICON X default or the TGIFICON environment variable to point
to this file (full path name) and watch the globe spins when you iconify.

---------------------------------- eos.obj ----------------------------------

The eos.obj file is similar to earth.obj.  It has two grouped objects; one
is used as the background, and the other one is the 8-frame waves.  Only
if you <Shift><Btn2> clicked on top of the waves will get the animation.

A good way to run it would be:  'tgif -cwo =308x308 eos'.  Or, you can
set your TGIFICON X default or the TGIFICON environment variable to point
to this file (full path name) and watch the waves when you iconify.

----------------------------------- usa.obj -----------------------------------

The usa.obj file contains a rough map of the United States with the states
labeled.  (The data points are obtained from a news posting of Dan Benson
<benson@ee.washington.edu> to be used with his SmallTalk program "usa.st".)