From: yking@cs.ubc.ca (Yossarian Yggy King)
Subject: Site Swap Scribe Software Announcement
Summary: Postscript viewer for site swaps
Keywords: postscript, site swap, notation
Organization: Computer Science, University of B.C., Vancouver, B.C., Canada
Date: Thu, 13 Aug 92 22:41:15 GMT

Announcing YASSV ... yet another site swap viewer, only this time it's
hardcopy!
	It's meant to help people learn site swap patterns by
displaying them in a more human format. The program complements
animation type site swap viewers like xjuggle. Most of it was written
during a 24 hour hack session (something I haven't done in ages) when
I should have been catching up on sleep so I could work on my thesis
with renewed vim and vigour the next day (yeah, right).

For those who just want to jump right in and use it, skip down
to RETRIEVAL below.

PONTIFICATION
-------------
The Site Swap Scribe generates an attractive PostScript representation
of site swap juggling notation.
	The output consists of a staff representing the flow of time
as the pattern progresses, (vaguely) reminiscent of a musical staff. The
staff is split in two, representing the left and right hand.  Each
line of the staff represents a throw, with alternating lines being
throws from alternating hands. A throw at time t of length L is
represented by a circle in row t, placed under the appropriate hand,
and a line from the circle to the appropriate hand at time t+L.
	sss is in part meant as a sort of prototype for a more general
juggling notation viewer/editor. ASCII notations are necessary for the
net, but there should be a more user-friendly notation for juggling
choreography, a la musical notation or dance notation (such as
Labanotation). In general, one wants to represent objects and hands
(where a hand could be a foot, etc) being in different places at
different times. One could imagine deciding on a granularity for time,
drawing a row for each moment in time, and splitting each row up into
columns, where each column represents a different possible position
(inside left, on head, etc). This would allow arbitrary numbers of
objects/patterns/people/etc. (An alternative to "time granularity"
might be to use symbols along the lines of 1/2, 1/4, 1/8 notes etc.)
It should be feasible to spew out a compact ASCII representation which
could then be easily swapped over the net. Anyway, this is speculation
for the future, as I have no time to work on it now.

RETRIEVAL (flexibility and directions courtesy of Terry)
---------
there are a few options to getting it:

* if you have ftp, tar and uncompress you can simply get 
  pub/juggling/programs/sss.tar.Z from moocow.cogsci.indiana.edu

* if you don't have ftp but you do have tar and uncompress and uudecode,
  you can send mail to juggling-request@moocow.cogsci.indiana.edu with
  the line

  send programs/sss.tar.Z.uu

  in the BODY of the mail (not the subject).

* if you have ftp but not tar or uncompress or uudecode etc, then you
  can ftp to moocow and get the files one by one from the directory
  pub/juggling/programs/sss

* if you don't have ftp or tar or uudecode or uncompress, you can
  request the files individually by sending the following messages 
  to juggling-request@moocow,

  send programs/sss/README
  send programs/sss/diddle.sss
  send programs/sss/install
  send programs/sss/sss.c
  send programs/sss/sss.ps

INSTALLATION
------------
Basically you just need to run the "install" script that comes
bundled with the package. The README file has more details on this.
You will need a C compiler (probably cc) and a Postscript printer
or previewer (if you want to see any of the results). I have
tried the program out on sun4 and MIPS architectures ... others
should work, but no guarantees.

USE
---
The README file tells everything you should need to know. There's
lots of command line options, most of which have (hopefully)
reasonable defaults.

Have fun! ... and let me know if you like it (or think it's a piece
of crap, or whatever :-)
-- 
Yggy King	| "Outside of a dog, a book is a person's best friend;	
UBC Comp Sci	|     inside of a dog, it's too dark to read."
B.C., Canada	|		    --Groucho Marx