Up    Next

string_art - string figures

Usage    |    Examples    |    Notes

Usage

Synopsis

string_art [options]

Description

Create a string figure in OFF fomat. Each pin arrangement shape is modified by any immediately following transformation options.

Options

-h
program help

-c <num>
a unit circle arrangement of num pins, centre (0,0,0) in xy plane

-l <num>
a 2 unit line arrangement of num pins, from (-1,0,0) to (1,0,0)

-p <crds>
line end points coordinates, six numbers separated by commas

-T <tran>
translation, three numbers separated by commas which are used as the x, y and z displacements

-R <rot>
rotation about an axis, four numbers separated by commas. The first three numbers are a direction vector for the axis, the last number is the angle to rotate (in degrees)

-M <norm>
reflection in a plane, three numbers separated by commas which give a vector normal to the plane of reflection.

-S <scal>
scale, one, three or four numbers separated by commas. If one number then scale by this factor in all directions. If three numbers these are the factors to scale along the x, y and z axes. If four numbers, the first three are a direction vector for the scaling, the last number is the factor to scale

-I
invert (equivalent to -S -1)

-o <file>
write output to file, if this option is not used the program writes to standard output

Examples

Nephroid
   string_art -c 180 -c 60 -o nephroid.off
Astroid
   string_art -c 120 -S 1,0,0 -c 120 -S 0,1,0 -o astroid.off

Notes

The elements can be placed anywhere in space. Attractive figures can be made by running strings between the edges of a polyhedron. The poly_kscope program can help with this. Example stella octangula
   $ string_art -l 20 -T 1,0,1.414 -R 0,0,45 -l 20 -T -1,0,-1.414 -R 0,0,-45 | poly_kscope -s O > st_oct.off

Up: Programs and Documentation
Next: lat_grid - lattices and grids with integer coordinates

Antiprism Documentation 1.2.2007 - http://www.antiprism.com/