There are two types of commands in partiview
:
Control Commands and Data Commands.
Probably the most important difference between the two is that Control
Commands return feedback to the user, whereas Data Commands
are interpreted "as is". Control Commands are entered in the command window.
But once in Control Command mode,
you can still let commands become Data Commands (using the
add
Control Command, and in Data Command mode one can
let a command be a Control Command by preceding it with the
eval
command. Before we explain the two types of Commands in
more detail, a few other concepts are needed:
While the data are being read, particles can be grouped in different object groups, each of which can be manipulated and displayed on its own. The Group Row, if present, allows easy access to the different groups.
(see partibrains.c::specks_parse_args)
Most (all?) commands can be
prefixed with a generic group designation, gN
, to which this command
applies. See the object
Data Command how to place different data in
different groups.
Data Commands can also be given, if prefixed with the add
command.
read a specks file
NOTYET, does the same as the read command.
see the on
command.
see the off
command.
This should be a no-op, since it would normally allow you to give a Control Command in Data Command mode.
This will enter a Data Command while in Control Command mode.
This will allow you to execute an arbitrary unix command, the subprocess of which its stdout will be taken as a stream of Control Commands.
Ensures the screen is updated.
Generates a histogram of values of the datafield named by dataval.
-l logarithmic, -c clipped, -t threshed.
Reports 3D extent of the data
(note that fspeed
has been deprecated)
Selects a 3D clipbox
on
off
viewing control options for kira (starlab)
formatted data that have been read in with
the kira
Data Command.
Generic prefix to any control command to act on the selected group gN (N=1,2,3,....).
BEGIN !CAVEMENU (virdir emulation)
Add stereo separation. Numbers can be 0.02 to 0.1 or -0.02 to -0.1 to swap eyes.
set snapshot parameters
take a snapshot of the current viewport (uses convert(1))
Set or get clipping distances
NOTYET
Get or set field of view (in degrees)
Get or set field of view (in degrees)
Get or set the focal length. Use the 's' key to toggle stereo display. The focal length also determines the fly/tran speed.
Get or set the current position (XYZ) and/or viewing (RxRyRz) angle.
Get or set the current rotation center (XYZ) for orbit/rotate
Read a (.wf
) file describing a path through space.
Read a Wavefront (.wf
) file describing a path through space.
Play the currently loaded path, at speed times normal speed (with "f" suffice it would play every speed-th frame).
Get, or set the current frame the frameno-th.
Get or set region of interest
Get or set region of interest
Get or set size of marker / interest-marker size
END !CAVEMENU (virdir emulation)
This either reports at which step you are, or changes the view to the selected step-number. If preceded with a plus or minus sign, the step is relative to the current frame.
scaling particles
Get or set the value to display every N-th particle
Load (ascii) filename with RGB values
Toggle box display between
off
, ON
, or ONLY
. (notice case sensitivity)
Toggle or set box label display mode.
Toggle or set box axes display mode.
(Note: pointsize is deprecated)
Toggle the display status of points (the point
status in the top row), or
explicitely set point display on
or off
.
Toggle the display status of labels (the poly
status in the top row), or
explicitely set polygon display on
or off
.
Toggle the display status of textures (the tex
status in the top row), or
explicitely set textures on
or off
.
Toggle the display status of labels (the lbl
status in the top row), or
explicitely set labels on
or off
.
Toggle ...
Number of sides a polygon should have
Get or set the alpha value.
see also ptsize
makes more sense than fast
.
BEGIN CAVEMENU pos P1 P2 wall P1 hid [P1] show [P1] h [P1] demandfps [P1] font help ? END CAVEMENU
(see also partibrains.c::specks_read)
Lines starting with #
will be skipped. The following Data Commands
can be placed in a data file.
Control Commands can be given, if prefixed with the eval
command.
read a speck
formatted file. Recursive, commands can nest. (strtok ok??)
read a speck
formatted file.
read a IEEEIO formatted file, with optional timestep number (0 based). Support for this type of data must be explicitly compiled into the program.
read a kira
formatted file. See the kiractl
Control
Command to modify the looks of the objects.
Defines/Selects a particular group number (N=1,2,3....) to an ALIAS. In
command mode you can use gN=ALIAS
. Any data following this command
will now belong to this group.
Select an existing group. Following data will now belong to this group.
Choose which data fields to
extract from binary sdb files (any of: mMcrogtxyzSn
) for subsequent
sbd
commands.
Read an SDB (binary) formatted file, with optional timestep number (0 based).
Draw a box, using any of the following formats:
xmin ymin zmin xmax ymax zmax
xmin,xmax ymin,ymax zmin,zmax
xcen,ycen,zcen xrad,yrad,zrad
[-t time] [-n boxno] [-l level] xcen,ycen,zcen xrad,yrad,zrad
level
determines color.
Object-to-world transformation. Either
tx ty tz rx ry rz or 16 numbers for 4x4 matrix.
(something> must contain *
h p r)
execute a Control Command.
Synonymous for eval
Synonymous for eval
A colon separate list of directories in which datafiles
will be searched for. If preceded with the +
symbol,
this list will be appended to the current filepath.
This will control the positions in space of polygons, as you rotate the world.
indexno is an integer, 0 being the first one.
Name this variable.
Label subsequent data with this time (a floating point number).
These lines, with XYZ positions in the first 3 columns, will make up the bulk of the dataset. The 4th and subsequent columns contain the values of the datavariables as named with the datavar commands. Note that data variables are 0-based.