File	Date	Author	Commit
src	2011-12-28	Laurent BERNABE	[a9bdf6] In the previous commit, i've forgotten to remov...
.hgignore	2014-08-04	laurentdu64	[5ddf2b] Removed unusefull libs folder, and jar_builders...
HISTORY.txt	2014-08-04	laurentdu64	[5ddf2b] Removed unusefull libs folder, and jar_builders...
LICENSES.txt	2011-12-13	Laurent BERNABE	[c8ae85] I came back to an old revision (number 11) so t...
README.txt	2011-12-20	Laurent BERNABE	[addd5e] This time, whatever the cube orientation, all p...

Read Me

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.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