display a terminal
Using the spacebar puts the data point printed to the standard output (you
should see this in your terminal) in the 3D space of the frame in the form of a
black dot. Move the frame around with your left hand to see that this is so. 31
points can be set (1 of 32 is used to keep track of the cursor's position).
Using the backspace key removes the last point set and moves the cursor to that
The : key (shift + ;) redirects keyboard input from controlling the frame and
cursor to taking commands from you in english (mostly). A small set of commads
are understood. To see what a command looks like you can press the escape key
and the quit command is entered for you. A command that you type is not really
given untill you press the enter/return key. Move the cursor and frame around
then type :reset as a command. The 3D space is reset. Like this readme file I
think a good program has help available to you when you need it. Type :help for
quick reminder of the commands for moving around.
Welcome to the roses project.
open an window
display a frame
control a cursor
write a point
The folder that contains the bin, src, and doc folders is call the build
directory. This one is named roses-0.0.0.0. You will find a makefile here, also.
From this build directory you have access to all the files and commands you will
need to edit, configure and build roses.
The bin directory is empty at first. It is where roses will go when you build
it. The doc directory contains this readme.txt file. The src directory contains
a makefile and a single C source code file main.c.
Open a terminal window, cd to the build directory and type 'make'. When it has
finished type 'bin/roses' to start roses.
To move the cursor around use the hjklJK keys. J and K are capitalized, use the
left shift key.
To change the primitive rotation terms alpha, beta, and zeta, use the gfdsFD keys. F and D
are capitalized, use the right shift key.
To understand the use of the hjklJK keys (and likewise the gfdsFD keys) for controlling the
cursor you can type vimtutor at the command prompt.
To move the cursor, press the hjklKJ and gfdsFD keys as indicated in this ASCII
| +y [k]
| -beta [f]
-z [J] \--> + beta [d]
. |__ _ -alpha [g]
.| | / \
-x [h] <- - - - - + - - - - | - - - - [l]> +x [l] RED
| . \ V
| . +alpha [s]
| . _
| ./ \
| |.| -zeta [F]
-y [j] | V /.
+zeta [D] [K] +z