XYZPLT

Homepage by Ralph Trenkler
Description and installation instructions in english.
NAME
DESCRIPTION
OPTIONS
INPUT FILE FORMAT
AUTHOR

NAME

xyzplt - 3D lines and points plot with OpenGL

xyzplt

[-c height] [-h] [-m angle fps] [-fps fps] [-a alpha] [-f] [file]

DESCRIPTION

The xyzplt(1) program plots lines and points with different colors in 3D using OpenGL. The plots can be animated. The input file structure is quite simple.

OPTIONS

The following options can be given.
-c
height

Set the vertical camera position. The default value is 0.7.

-h

Print help text and exit.

-m angle fps

Rotate the cube in steps of angle in degrees with fps frames per second.

-fps fps

Set time steps for animation to fps frames per second.

-a alpha

Set global alpha value for blending. This value must be between 0.0 and 1.0.

-f

Read from unformatted fortran binary file.

INPUT FILE FORMAT

The input data is read from standard input or the given file. The head of the file can contain comment lines, which start with an ’#’ character.

First, you can include the axes labels. The labels are optional and the default is "x", "y" and "z".

xlabel "label"

ylabel "label"

zlabel "label"

box x y z

This decribes the length of the sides of the three dimensional box in which the plotting is done. The default values are 1.0 1.0 1.0. The next expression is:

scale xmin xmax ymin ymax zmin zmax

This are the coordinate ranges for the cube in which the lines and points are drawn. The default is 0.0 1.0 0.0 1.0 0.0 1.0.

animate nt

This optional statement tells xyzplt(1) to read in nt data blocks, one for each time step. If this statement is not given, no animation is done.

data m

This directive gives the number of line and points statements.

line red green blue n vertex-x vertex-y vertex-z ...

This statement plots a line in the RGB colors red green blue with n vertices.

points red green blue n vertex-x vertex-y vertex-z ...

This statement plots n points in the RGB colors red green blue.

line_a red green blue alpha n vertex-x vertex-y vertex-z ...

This statement plots a line in the RGB colors red green blue with alpha blending alpha and n vertices. Alpha must be a number between 0.0 and 1.0.

points_a red green blue alpha n vertex-x vertex-y vertex-z ...

This statement plots points in the RGB colors red green blue with alpha blending alpha and n points. Alpha must be a number between 0.0 and 1.0.

AUTHOR

This program was written by Ralph Trenkler <ralph-trenkler@t-online.de>.