UnBBoolean 1.2
==============

by Danilo Balby (danbalby@yahoo.com; danbalby@gmail.com)
http://unbboolean.sourceforge.net/
https://sourceforge.net/projects/unbboolean/

Slightly modified by Andrew Davison, ad@fivedots.coe.psu.ac.th, Dec. 2020

This version is hosted at:
http://fivedots.coe.psu.ac.th/~ad/Simple3D/

UnBBoolean is a fabulous 3D modeling tool that employs Constructive Solid 
Geometry (CSG) operations on primitives (i.e. boxes, cones, cylinders 
and spheres).

To run it type:

> runbb

-------------------------------------
COMMANDS HELP
=============
    
CREATE A SOLID
On the 'Primitives' tab, select a primitive from the list, 
change its properties as you like, then click 'OK'.

MOVE A SOLID:
Dragging a solid with the mouse makes it move in the XY plane. 
Dragging while pressing the SHIFT key makes the solid rotate 
around the x- and y- axes. Dragging while pressing the ALT key 
makes it move along the z-axis.

REMOVE A SOLID:
Select a solid with the mouse, then press the delete key.

COMBINE SOLIDS:
Press the CTRL key while clicking on two solids. Then select 
an operation on the 'CSG trees' tab, and click 'OK'.

CHANGE  A SOLID:
Click on a solid and its tree will appear in the 'CSG trees' tab. 
a) Select a tree node, change its parameters, then click 'OK'. 
b) Or right click on a node, and select the 'move' item to move it. 
When it's in the right position, click 'Finish Move'.

COPY A SOLID:
Click on a solid and its tree will appear in the 'CSG trees' tab. 
Right click on any node and select the 'copy' item.

SAVE or LOAD A SOLID:
Use File>Save or File>Load on the menu bar. The 'csg' format stores 
the tree and parameters, and can be loaded again later. A solid saved 
in the 'obj' format can be read by other applications. The Save menu 
is only available when a solid has been selected. 

KEY-BASED NAVIGATION:
Click in the display window, and press the following keys to move 
the viewing window position:

	Up-arrow or W: Forward; 	Down-arrow or S: Backward
	Left-arrow or A: Left; 		Right-arrow or D: Right
	Page-up or Q: Up; 			Page-down or E: Down	

	Alt Up-arrow: Rotate up; 		Alt Down-arrow: Rotate down
	Alt Left-arrow: Rotate left; 	Alt Right-arrow: Rotate Right
	Alt Page-up: Tilt Right; 		Alt Page-down: Tilt Left
