AGAT(1) AGAT(1)
Release 1.2
NAME
agat - Another Graphic Animation Tool
SYNTAX
agat [options]
DESCRIPTION
Agat is a new system for algorithm animation. Agat differs from other
such systems by its client-server architecture and the use of
specialized programming language to decribe the animation itself,
independently of the animated program.
When you click or you press a key in a window, you can activate
commands (see COMMANDS section).
OPTIONS
There are basically three ways to use an animation :
- to run the user program with an animation
- to replay a previously recorded animation
- to run the user program with no animation but recording the
emitted values.
Here are the possible corresponding options:
agat [-f agat_file] [-w] [-d dump_file] [-I dir] cmd arg1...argn
cmd is executed (with arg1...argn as arguments), and animation
described by agat_file is performed. The emitted values are
recorded in dump_file. Several -I can be given (specifying a
search path). Warning messages are not printed if -w flag is
present.
agat -f agat_file [-w] -r dump_file [-I dir] [-s speed] [-m]
An animation described by agat_file is performed from the data
found in dump_file. The animation is played at speed speed. This
should be a positive integer, specifying a percentage of "real-
time". So, 50 means "run at half speed" and 200 "run at double
speed". If the -m argument is present, the animation is replayed
as fast as possible. Warning messages are not printed if the -wfP
flag is present.
agat -d dump_file cmd arg1...argn
cmd is run with arguments arg1...argn. The emitted values are
recorded in dump_file. No animation is performed.
Agat accepts several specific options (see RESOURCES section below).
COMMANDS
The key commands:
- 1 - Formatted: November 16, 2025
AGAT(1) AGAT(1)
Release 1.2
b,B To have a big window.
k,K Kill a zoom window.
n,N To have a normal window.
p,P Create a PostScript file in the current directory. The name
of the created file is the name of the window in which you
press key.
q,Q Quits Agat.
r,R Force to refresh a window. (Specialy for zoom windows)
s,S Stop the animation. Press any key to restart.
t,T To have a tiny window.
The mouse commands:
Button1 Display the coordinate of the clicked point. Stopped when
button released.
Button2 Move the view. Only for 3D operators.
Button3 It's the zoom function. When you click on this button, you
can select the area where you want to zoom. Release the
button to activate the zoom. You can zoom in a zoom window.
But there is no automatic refresh in a zoom window. To have
a refresh, use the r function.
RESOURCES
Agat has the following application specific resources:
background (Class Background)
Sets the background color of a window.
colorxx (Class Colorxx)
Sets the color number xx for drawing.
font (Class Font)
Sets the font to draw the labels and axes.
foreground (Class Foreground)
Sets the color of the text on the axes.
organized (Class Organized)
Opens the windows with a "beautiful" organization.
origx (Class Origx)
Specifies the place of the first window for the X coordinate.
- 2 - Formatted: November 16, 2025
AGAT(1) AGAT(1)
Release 1.2
Just use when organized is enable.
origy (Class Origy)
Specifies the place of the first window for the Y coordinate.
Just use when organized is enable.
pdx (Class Pdx)
Specifies the space between two windows for the X coordinate.
Just use when organized is enable.
pdy (Class Pdy)
Specifies the space between two windows for the Y coordinate.
Just use when organized is enable.
xm (Class Xm)
Specifies the margin in the window for the X coordinate.
xsz (Class Xsz)
Specifies the size of the window for the X coordinate.
ym (Class Ym)
Specifies the margin in the window for the X coordinate.
ysz (Class Ysz)
Specifies the size of the window for the Y coordinate.
bigx (Class Bigx)
Specifies the size of a big window for the X coordinate.
bigy (Class Bigy)
Specifies the size of a big window for the Y coordinate.
tinyx (Class Tinyx)
Specifies the size of a tiny window for the X coordinate.
tinyy (Class Tinyy)
Specifies the size of a tiny window for the Y coordinate.
You can specifie resources for:
- all the application
agat*<resource>: <val>
- a class of graphic operator
agat.<op_name>*<resource>: <val>
- a specified window
agat.<op_name>.<window_name>.<resource>: <val>
- 3 - Formatted: November 16, 2025
AGAT(1) AGAT(1)
Release 1.2
For example (the default ressources):
agat.organized: True
agat.origx: 15
agat.origy: 15
agat.pdx: 10
agat.pdy: 10
agat*background: White
agat*foreground: Black
agat*xsz: 300
agat*ysz: 300
agat*bigx: 600
agat*bigy: 600
agat*tinyx: 100
agat*tinyy: 100
agat*xm: 5
agat*ym: 5
agat*markcolor: Red
agat*font: -adobe-helvetica-medium-r-normal-*-18-180-75-75-p-98-iso8859-1
agat*color0: Blue
agat*color1: Magenta
agat*color2: Red
agat*color3: Sienna
agat*color4: DimGray
agat*color5: Springgreen
agat*color6: Goldenrod
agat*color7: Darkorange
agat*color8: OrangeRed
agat*color9: Maroon
agat*color10: Saddlebrown
agat*color11: Slategrey
agat*color12: Seagreen
agat*color13: Navyblue
agat*color14: Pink
BUGS
No known bugs. But if you find some, report it to:
Stephane Lavirotte (slavirot@sophia.inria.fr)
or
Olivier Arsac (oarsac@sophia.inria.fr)
SEE ALSO
X(1), xrdb(1)
COPYRIGHT
Copyright 1994, INRIA Sophia Antipolis, France.
AUTHORS
Stephane Dalmas (dalmas@sophia.inria.fr)
Olivier Arsac (oarsac@sophia.inria.fr)
- 4 - Formatted: November 16, 2025
AGAT(1) AGAT(1)
Release 1.2
Marc Geatano (gaetano@sophia.inria.fr)
- 5 - Formatted: November 16, 2025
