JOGL Rubik's Cube Files

Jogl Rubik Cube README
----------------------

What do you need to use it ?
----------------------------

*) For Windows
-- A computer with a 3D enable graphic card (an integrated via unichrome s3g k8m800 is enough, no need to buy
an ATI or a NVIDIA)
--The windows version of the java 6 jre 
--DirectX (at least 9, the latest is better) in order to have the OpenGL specifications

*) For Linux
-- A computer with a 3D enable graphic card (an integrated via unichrome s3g k8m800 is enough, no need to buy
an ATI or a NVIDIA)
-- The Java 6 jre that you may find in your package manager
-- The latest OpenGL driver (the one given by your package manager should be enough)

*) For Mac
-- Build the jar : I did not release the Mac version of the jar, as I could not test the result. But you can build it.
In order to do that you will need to fetch the code from the Mercurial repository, install the java JDK 6, and follow
the instruction of the Wiki (the page "Building executable jar for a particular Operating System")
-- A computer with a 3D enable graphic card (an integrated via unichrome s3g k8m800 is enough, no need to buy
an ATI or a NVIDIA)
-- The Java 6 jre, that you should have had by installing the java 6 jdk, in the previous step
-- The latest OpenGL driver (the one given by your package manager should be enough) ? (I don't know what you can
install on a Mac).

What can you do with it ?
-------------------------

For now, just rotate the whole RubikCube with a right button dragging : 
Hold right click on it, move onto the screen, then release.

How to launch
-------------

*) Windows

Double-click on the jar in order to launch it. However, you may encounter problems due to an archiver
 (WinZip, WinRar, ...) installation : in that case
    1) right click on the jar
    2) select run as : Java SE Platform binary
    
*) Linux

The jar cannot be launched with simple click (even with right click) because of the execution denied permission.
So you must enable it :
    1) Open a terminal and change directory to the one you've got the jogl rubik cube jar
    2) Enter : chmod +x JoglRubikCube but do not validate right now
    3) Press the keyboard tab button in order to complete the file name and validate
    4) Now you can do right click and Launch with your Java runtime (OpenJDK Java Runtime,  Sun Java Runtime,
     ...)
     
History
---------

0.3.4 ) This time, you can nearly do all you want with the RubikCube :)
        -> you can rotate the whole rubik cube with right click dragging (hold right click on RubikCube and move)
        -> you can rotate a plate with left click dragging, whatever is the whole RubikCube orientation
        (you can even try on a "far far" plate : that is a plate that is so far that you just can see it)
        -> an animation is started as soon you stop the left click dragging, in order to put the plate in a "stable" state,
        and let you move others plate without problem : notice that if you move a plate less than by 45 degrees, it is
        animated so that it come back to its old position, otherwise, it is animated so that it will come to its new position.
        
        The drawbacks of this version, that I'll try to correct
        -> the speed of plate rotation is not proportional to the mouse move speed
        -> the animation for completing the rotation is not fast enough
        -> once begun, the left dragging must be perfect (in the given direction) in order to keep on the plate rotation : the tolerance is still small
        (as small as the tolerance in order to start the dragging)
0.3.2 ) Now you can see some plates being rotated, as a general demo : and you still can rotate the cube
		by a right button dragging on screen (You don't have to wait for the demo to finish ^^). 
		And also, this time the project has been tested on computers with windows xp and/or with older
		graphic card (such as the via unichrome s3g graphic card from the k8m800 motherboard).
		FPS is fixed to 30, so that it should be the same speed on most computers : quite old as newer.
		(Indeed, I hope that it will be so).
0.3.0 ) The whole RubikCube is drawn, but you just can rotate it with a right button dragging on it.
		(Hold right click on it, move onto the screen, then release)
0.2.0 ) Just a little cube, with one different color per face, is spinning in a black background