Project

General

Profile

Wiki » History » Version 14

Distorted Admin, 04/16/2020 12:49 PM

1 2 Distorted Admin
h1. Overview
2 1 Distorted Admin
3 6 Distorted Admin
Magic Cube is an application which lets one play with Cubes and Pyraminxes of any size. It contains graphhics effects provided by the "Distorted":https://distorted.org/redmine/projects/distorted-android/wiki/wiki library.
4 5 Distorted Admin
Users can submit their best times to a central High Scores list and download results made by others.
5
A 3x3x3 Cube solver and a Pretty Patterns tutorial is in the plans.
6
7 2 Distorted Admin
Magic Cube is open source and released under the terms of the "GNU General Public License v2":http://www.gnu.org/licenses/old-licenses/gpl-2.0.html (GPL).
8 1 Distorted Admin
9 2 Distorted Admin
h1. Source code
10 1 Distorted Admin
11 2 Distorted Admin
<pre>
12 1 Distorted Admin
git clone http://distorted.org/git/distorted-library.git
13
git clone http://distorted.org/git/distorted-cube.git 
14 2 Distorted Admin
</pre>
15 3 Distorted Admin
16
h1. Tutorials
17 13 Distorted Admin
18 3 Distorted Admin
h2. How to add a new Rubik Object
19
20 8 Distorted Admin
* Write a new class which extends "RubikObject":https://distorted.org/redmine/projects/magic-cube/repository/magiccube/revisions/master/entry/src/main/java/org/distorted/object/RubikObject.java
21
* Write a new class which extends "RubikObjectMovement":https://distorted.org/redmine/projects/magic-cube/repository/magiccube/revisions/master/entry/src/main/java/org/distorted/object/RubikObjectMovement.java
22 9 Distorted Admin
* add your new classes to the "RubikObjectList":https://distorted.org/redmine/projects/magic-cube/repository/magiccube/revisions/master/entry/src/main/java/org/distorted/object/RubikObjectList.java enum  
23 3 Distorted Admin
24 11 Distorted Admin
Currently implemented Objects: a "Cube":https://distorted.org/redmine/projects/magic-cube/repository/magiccube/revisions/master/entry/src/main/java/org/distorted/object/RubikCube.java and a "Pyraminx":https://distorted.org/redmine/projects/magic-cube/repository/magiccube/revisions/master/entry/src/main/java/org/distorted/object/RubikPyraminx.java.
25 3 Distorted Admin
26
h2. How to add a new Transition Effect
27
28 14 Distorted Admin
If you would like to add, say, a new WIN effect (i.e. animation which happens when the Object gets solved) all you need to do is add a new class which extends "org.distorted.effect.WinEffect":https://distorted.org/redmine/projects/magic-cube/repository/magiccube/revisions/master/entry/src/main/java/org/distorted/effect/win/WinEffect.java and add the new class to the "org.distorted.effect.WinEffect.Type":https://distorted.org/redmine/projects/magic-cube/repository/magiccube/revisions/master/entry/src/main/java/org/distorted/effects/win/WinEffect.java enum. 
29
The new effect will automatically become available in the Effects dialog.