Name Last modified Size Description
![[PARENTDIR]](/icons/back.gif)
Parent Directory -
![[ ]](/icons/compressed.gif)
QT_movies.tar.Z 1993-02-18 01:00 2.9M
![[TXT]](/icons/text.gif)
README 1993-07-01 02:00 7.3K
VfW_movies.tar.Z 1993-02-18 01:00 5.6M
adder.tar.Z 1995-12-07 01:00 76K
coop.tar.Z 1995-12-07 01:00 46K
demos.tar.Z 1993-07-01 02:00 9.2M
examples.tar.Z 1993-07-02 02:00 33M
pj.tar.Z 1993-07-02 02:00 1.6M
% Copyright (c) [1989, 1990, 1991, and 1992] Xerox Corporation. All Rights Reserved.
% Use, reproduction, and preparation of derivative works of this
% software is permitted, but only for non-commercial research or
% educational purposes. Any copy of this software or of any derivative
% work must include both the above copyright notice of Xerox Corporation
% and this paragraph. This software is made available AS IS, and XEROX
% CORPORATION DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
% WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
% FITNESS FOR A PARTICULAR PURPOSE, AND NOTWITHSTANDING ANY OTHER
% PROVISION CONTAINED HEREIN, ANY LIABILITY FOR DAMAGES RESULTING FROM
% THE SOFTWARE OR ITS USE IS EXPRESSLY DISCLAIMED, WHETHER ARISING IN
% CONTRACT, TORT (INCLUDING NEGLIGENCE) OR STRICT LIABILITY, EVEN IF
% XEROX CORPORATION IS ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
The ftp directory contains three compressed tar files for Pictorial
Janus: pj.tar.Z, demos.tar.Z, and examples.tar.Z. (See man pages for
use of compress and tar.) pj.tar.Z is needed to run the system.
demos.tar.Z contains simple examples with precomputed movies, and
examples.tar.Z contains more complex examples.
Volker Haarslev has contributed QT_movies.tar.Z (Pictorial Janus
movies converted to Macintosh Quicktime) and VfW_movies.tar.Z
(Pictorial Janus movies converted to Microsoft Video for Windows).
His e-mail address is <[email protected]>.
If you have problems with the installation or use of the Pictorial Janus
system, feel free to send mail to Ken Kahn <[email protected]> or
Markus Fromherz <[email protected]>. We will try to help, but we
don't guarantee anything.
Pictorial Janus is a unified visual programming/program animation
system. Programs are presented to the system as PostScript files
depicting the programs (see the doc subdirectory and the papers
referenced below for more details on the syntax and system). The
system then generates a sequence of raster files which can be viewed
by the movietool described below.
The following three papers were written about Pictorial Janus.
1. Ken Kahn and Vijay Saraswat, "Complete Visualizations of Concurrent
Programs and their Executions"; Xerox PARC SSL-90-38 and 1990 IEEE Visual
Language Workshop.
2. K. Kahn: Concurrent Constraint Programs to Parse and Animate Pictures of
Concurrent Constraint Programs; Xerox PARC SSS-91-16 (P91-00143) and FGCS92.
3. K. Kahn: Towards Visual Concurrent Constraint Programming; Xerox
PARC SSL-91-92 (P92-00011).
These papers may be obtained by sending a request to [email protected].
For system requirements and installation instructions, see below.
For how to use PictorialJanus, see ./doc/README.
System requirements
-------------------
This is an implementation of Pictorial Janus. In order to run Pictorial
Janus animations, you need
movietool 1.2 or 1.3
How to obtain movietool:
From titan.rice.edu you get the files movietool-1.3_kit[1-5],
movietool.uu.[1-6] (an audio file), and possibly movieras.uu.[1-34]
(a sample movie in monochrome). These files are also available by
anonymous FTP from oersted.ltf.dth.dk (129.142.66.16) in the ~/pub
directory as movietool-1.3.shar.Z, movietool.au.Z and
movietool.rasters.tar.Z, respectively. Please use titan.rice.edu from
the American side of the Atlantic. If you don't have FTP access to
Internet, please send mail to the Rice archive server (mail the word
"help" to "[email protected]".
Suntools or NeWS to run movietool.
In order to create programs and animations, you also need
Strand88 (Buckingham version 20). Commericially available from Strand
Software Technology. To install extensions see the make_strand/README.
In the U.S., contact Stuart Bar-On at (619) 737-9731,
<[email protected]>.
In the UK (or nearby), call +582-842424, or fax +582-840282.
Ghostscript 2.3 or 2.5 (available as GNUS software) or Sun's NeWS 2.0 or
3.0. (Locally extended Ghostscript version included but needs the fonts
and libraries in the 2.3 release version.)
A graphical editor. Idraw under X11 as part of the Interviews package
is supported. It is also necessary for using some parsing debugging tools.
(*.idraw files are Postscript files and can therefore be printed or viewed.)
The system has been tested on SparcStations running system 4.1.1 and 4.1.3.
Files and directories in this release
-------------------------------------
bin scripts and executables for parsing and animating programs
demos simple sample Pictorial Janus programs and animations
doc documentation of syntax and parameters, and hints
emacs emacs utilities for converting *.istd to *.std files
examples advanced sample Pictorial Janus programs (no animations)
make_strand scripts and required files to make a strand image
pnmtorast convert pnm files to Sun raster files
ps Postscript code used in the system
src system source files (*.istd files, i.e. "implicit variable Strand")
strand compiled system files (*.std and *.sam files)
styles sample styles for animation parameters (for *.defaults)
To just see some of the movies produced by the system you need to
install the bin and demos directories. To see, for example, the
Append demo type
setenv PJHOME <Pictorial Janus top level directory>
setenv PJPATH $PJHOME/demos
$PJHOME/bin/rollem append
Other demos that can be run:
appendRace cell cellVocabulary compare merge mergeExample naiveReverse
npartition partition q reverseRace sort.
You need to either be running SunTools or NeWS for the movietool to work.
There are more examples in $PJHOME/examples and its subdirectories,
but most have to be animated first (see doc/README for the use of
animate).
Installation instructions
-------------------------
Create
You should set the environment variables
PJHOME -- The path to the directory which contains the bin, pj,
strand, network_strand, src, etc. directories.
PJPATH -- The path to the default place for pictures and movies.
Elements of the PJPATH should be directory names (without the final /)
separated by spaces. It is recommended that a drawing named foo be put
on an element of $PJPATH as <directory>/foo.idraw. (Or
<directory>/foo.idraw_landscape if it is in landscape mode.)
Other editors are easy to support (using .idraw with another editor
might turn things 90 or 180 degrees).
PJMOVIEDIRECTORY --- The directory were the animation frames are
stored. (May for example be a local harddisk.)
Default is "" (i.e. same place as drawing and generated code file).
PJSOUND -- Currently only the value "S950" (Akai S950 sound sampler)
is supported. Default is "" (i.e. no sound).
PJPS -- possible values:
"gs2.3_ext" -- Ghostscript 2.3 beta with local modifications for
writing sun raster (currently is buggy for black&white)
"gs2.3" -- Ghostscript 2.3 beta -- requires pbmplus to convert
to sunraster (which is slower) and the color map
isn't stable. pbmplus is available over the net.
"NeWS" -- Sun's Postscript interpreter in NeWS 2.0
"NeWS3.0" -- Sun's Postscript interpreter in NeWS 3.0
PJMAXPROCESSES -- by default at most 4 rasterization processes can
run concurrently.
GSDIR -- location of Ghostscript
GS-LIB -- location of Ghostscript libraries
The file top/defaults has reasonable defaults settings. Replace the
settings where necessary.