TwistyPuzzleLib

        case TC_BARREL           : mTouchControl = new TouchControlBarrel(this);

                                   break;

  CHES_2 ( new MetadataCHES_2() ),

  public static final int CATEGORY_SHAPE_BAR    = 7;

///////////////////////////////////////////////////////////////////////////////////////////////////

// Copyright 2024 Leszek Koltunski                                                               //

//                                                                                               //

// This file is part of Magic Cube.                                                              //

//                                                                                               //

// Magic Cube is proprietary software licensed under an EULA which you should have received      //

// along with the code. If not, check https://distorted.org/magic/License-Magic-Cube.html        //

///////////////////////////////////////////////////////////////////////////////////////////////////

package org.distorted.objectlib.metadata;

import org.distorted.objectlib.R;

import org.distorted.objectlib.objects.TwistyCheese;

///////////////////////////////////////////////////////////////////////////////////////////////////

public class MetadataCHES_2 extends Metadata

  {

  public static int INDEX = 92;

  public MetadataCHES_2()         { super( TwistyCheese.class, new int[] {2,2,2,2}, 0, null, INDEX ); }

  public int numScrambles()       { return 15; }

  public int icon()               { return R.drawable.dske_3; }

  public boolean getActive()      { return false; }

  public int price()              { return 50; }

  public int extrasJson()         { return 0; }

  public int objectJson()         { return 0; }

  public int mesh()               { return 0; }

  public String getAuthor()       { return "Anthony Greenhill"; }

  public int getYearOfInvention() { return 2002; }

  public float getDifficulty()    { return 1.1f; }

  public String getObjectName()   { return "Rubik Cheese"; }

  public int getCategory()        { return CATEGORY_SHAPE_BAR | CATEGORY_AXIS_OTHE; }

  }

///////////////////////////////////////////////////////////////////////////////////////////////////

// Copyright 2021 Leszek Koltunski                                                               //

//                                                                                               //

// This file is part of Magic Cube.                                                              //

//                                                                                               //

// Magic Cube is proprietary software licensed under an EULA which you should have received      //

// along with the code. If not, check https://distorted.org/magic/License-Magic-Cube.html        //

///////////////////////////////////////////////////////////////////////////////////////////////////

package org.distorted.objectlib.objects;

import static org.distorted.objectlib.touchcontrol.TouchControl.TC_BARREL;

import static org.distorted.objectlib.touchcontrol.TouchControl.TYPE_NOT_SPLIT;

import org.distorted.library.type.Static3D;

import org.distorted.library.type.Static4D;

import org.distorted.objectlib.helpers.FactoryCubit;

import org.distorted.objectlib.helpers.ObjectFaceShape;

import org.distorted.objectlib.helpers.ObjectShape;

import org.distorted.objectlib.helpers.ObjectVertexEffects;

import org.distorted.objectlib.main.InitAssets;

import org.distorted.objectlib.metadata.ListObjects;

import org.distorted.objectlib.metadata.Metadata;

import org.distorted.objectlib.shape.ShapeBarrel;

import org.distorted.objectlib.touchcontrol.TouchControlBarrel;

///////////////////////////////////////////////////////////////////////////////////////////////////

public class TwistyCheese extends ShapeBarrel

{

  static final Static3D[] ROT_AXIS = new Static3D[]

         {

           new Static3D(    0, 1,     0),

           new Static3D(    1, 0,     0),

           new Static3D( 0.5f, 0, SQ3/2),

           new Static3D(-0.5f, 0, SQ3/2),

         };

  private int[][] mEdges;

  private int[][] mBasicAngle;

  private int[] mQuatIndex;

  private float[][] mCuts;

  private float[][] mCenters;

///////////////////////////////////////////////////////////////////////////////////////////////////

  public TwistyCheese(int iconMode, Static4D quat, Static3D move, float scale, Metadata meta, InitAssets asset)

    {

    super(iconMode, meta.getNumLayers()[0], quat, move, scale, meta, asset);

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// here we cannot automatically detect the outer monochromatic walls -> use the old way.

  @Override

  public int getSolvedFunctionIndex()

    {

    return 0;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  @Override

  public float[][] returnRotationFactor()

    {

    float C1 = 1.0f;

    float C2 = 1.7f;

    float[] f1 = new float[] { C1,C1 };

    float[] f2 = new float[] { C2,C2 };

    return new float[][] { f1,f2,f2,f2 };

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// make the equator a bit thicker

/*

  @Override

  public void adjustStickerCoords()

    {

    final float X1 = -0.38861537f;

    final float Y1 = -0.4252297f;

    final float X2 =  0.5f;

    final float Y2 = -0.2860808f;

    final float X3 =  0.18867691f;

    final float Y3 =  1.05f*0.39392126f;

    final float X4 = -0.30006152f;

    final float Y4 =  1.05f*0.3173893f;

    final float Y = 0.02f;

    mStickerCoords = new float[][][][]

          {

            { { {X1+Y*(X4-X1), Y1+Y*(Y4-Y1)}, {X2+Y*(X3-X2), Y2+Y*(Y3-Y2)}, {X3, Y3}, {X4, Y4} } },

            { { {-0.17166577f, 0.92f*-0.28301144f}, {0.24996112f, 0.92f*-0.21698855f}, {-0.07829534f, 0.5f} } }

          };

    }

*/

///////////////////////////////////////////////////////////////////////////////////////////////////

/*

  @Override

  public int[][] getSolvedQuats()

    {

    // special SolvedQuats for the case where there are no corner of edge cubits.

    // first row {0} - means there are no corners or edges.

    // each next defines all cubits of a singe face

    // (numCubits, firstCubit, cubit1,..,cubitN-1, quat0,..., quatM)

    return new int[][] {

                         {0},

                         {4, 0, 1,16,17, 13},

                         {4, 2, 3,18,19, 12},

                         {4, 4, 5,20,21, 15},

                         {4, 6, 7,22,23, 14},

                         {4, 8, 9,24,25, 13},

                         {4,10,11,26,27, 12},

                         {4,12,13,28,29, 15},

                         {4,14,15,30,31, 14},

                       };

    }

*/

///////////////////////////////////////////////////////////////////////////////////////////////////

// TODO

  public int[][] getScrambleEdges()

    {

    if( mEdges==null )

      {

      mEdges = new int[][]

        {

          { 0,1, 1,1, 2,1, 3,1, 4,1, 5,1, 6,1, 7,1, 8,1, 9,1,

           10,1,11,1,12,1,13,1,14,1,15,1,16,1,17,1,18,1,19,1,

           20,1,21,1,22,1,23,1,24,1,25,1,26,1,27,1

          },

          {28,2,29,2,30,2,31,2,32,2,33,2,34,2,35,2 },

          { 0,1, 1,1, 2,1, 3,1, 4,1, 5,1, 6,1, 7,1, 8,1, 9,1,

           10,1,11,1,12,1,13,1,14,1,15,1,16,1,17,1,18,1,19,1,

           20,1,21,1,22,1,23,1,24,1,25,1,26,1,27,1,

           28,0,29,0,30,0,31,0,32,0,33,0,34,0,35,0

          }

        };

      }

    return mEdges;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public float[][] getCuts(int[] numLayers)

    {

    if( mCuts==null )

      {

      float[] c = { 0.0f };

      mCuts = new float[][] { c,c,c,c };

      }

    return mCuts;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public boolean[][] getLayerRotatable(int[] numLayers)

    {

    boolean[] l = {true,true};

    return new boolean[][] { l,l,l,l };

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public int getTouchControlType()

    {

    return TC_BARREL;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// not used

  public int getTouchControlSplit()

    {

    return TYPE_NOT_SPLIT;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// Each 'face' is a vertical strip of 1/8 of longitude (PI/4).

// The first one spans longitude from -PI/8 to +PI/8, where Greenwich is long=0.

// Next successively to the east.

  public int[][][] getEnabled()

    {

    return new int[][][] { {{0,1}},{{0,4}},{{0,3}},{{0,2}},{{0,1}},{{0,4}},{{0,3}},{{0,2}} };

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public float[] getDist3D(int[] numLayers)

    {

    final float D = 0.5f*(float)Math.sqrt((2*SQ2+5)/17);

    return new float[] { D,D,D,D,D,D,D,D,D,D,D,D,D,D,D,D };

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public Static3D[] getFaceAxis()

    {

    return TouchControlBarrel.FACE_AXIS;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public float[][] getCubitPositions(int[] numLayers)

    {

    if( mCenters==null )

      {

      final float X1 = 3*SQ2/8;

      final float Y1 = 0.5f;

      final float Z1 = 0.750f+3*SQ2/8;

      final float X2 = X1/3;

      final float Y2 = 1.5f;

      final float Z2 = Z1/3;

      mCenters = new float[][]

         {

             { X1, Y1, Z1 },

             { X1,-Y1, Z1 },

             { Z1, Y1, X1 },

             { Z1,-Y1, X1 },

             { Z1, Y1,-X1 },

             { Z1,-Y1,-X1 },

             { X1, Y1,-Z1 },

             { X1,-Y1,-Z1 },

             {-X1, Y1,-Z1 },

             {-X1,-Y1,-Z1 },

             {-Z1, Y1,-X1 },

             {-Z1,-Y1,-X1 },

             {-Z1, Y1, X1 },

             {-Z1,-Y1, X1 },

             {-X1, Y1, Z1 },

             {-X1,-Y1, Z1 },

             { X2, Y2, Z2 },

             { X2,-Y2, Z2 },

             { Z2, Y2, X2 },

             { Z2,-Y2, X2 },

             { Z2, Y2,-X2 },

             { Z2,-Y2,-X2 },

             { X2, Y2,-Z2 },

             { X2,-Y2,-Z2 },

             {-X2, Y2,-Z2 },

             {-X2,-Y2,-Z2 },

             {-Z2, Y2,-X2 },

             {-Z2,-Y2,-X2 },

             {-Z2, Y2, X2 },

             {-Z2,-Y2, X2 },

             {-X2, Y2, Z2 },

             {-X2,-Y2, Z2 },

         };

      }

    return mCenters;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public Static4D getCubitQuats(int cubit, int[] numLayers)

    {

    if( mQuatIndex==null ) mQuatIndex = new int[] { 0,13,7,9,6,12,5,8,4,15,3,11,2,14,1,10,

                                                    0,13,7,9,6,12,5,8,4,15,3,11,2,14,1,10 };

    return mObjectQuats[mQuatIndex[cubit]];

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  private float[][] getVertices(int variant)

    {

    final float D = 0.1f;

    if( variant==0 )

      {

      return new float[][]

          {

              { -3*SQ2/8             ,        -0.5f  ,  1.250f-3*SQ2/8 },

              {  5*SQ2/8             ,        -0.5f  , -0.750f+5*SQ2/8 },

              { -3*SQ2/8             ,         0.5f-D,  0.250f-3*SQ2/8 +D },

              {    SQ2/8 +D*(4*SQ2/8),         0.5f-D, -0.750f+  SQ2/8 +D*(4*SQ2/8) },

              { -3*SQ2/8             ,        -0.5f  , -0.750f-3*SQ2/8 },

              { -3*SQ2/8             , 0.01f*(0.5f-D), -0.750f-3*SQ2/8 },

          };

      }

    else

      {

      return new float[][]

          {

              { -SQ2/8             , -0.5f -D,  -SQ2/8+0.75f +D },

              {3*SQ2/8 +D*(4*SQ2/8), -0.5f -D, 3*SQ2/8-0.25f +D*(4*SQ2/8) },

              { -SQ2/8             , -0.5f -D,  -SQ2/8-0.25f },

              { -SQ2/8             , +0.5f   ,  -SQ2/8-0.25f }

          };

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public ObjectShape getObjectShape(int variant)

    {

    if( variant==0 )

      {

      int[][] indices =

          {

              {0,1,3,2},

              {4,0,2,5},

              {1,4,5,3},

              {2,3,5},

              {4,1,0}

          };

      return new ObjectShape(getVertices(variant), indices);

      }

    else

      {

      int[][] indices =

          {

              {0,1,3},

              {2,0,3},

              {1,2,3},

              {2,1,0}

          };

      return new ObjectShape(getVertices(variant), indices);

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public ObjectFaceShape getObjectFaceShape(int variant)

    {

    if( variant==0 )

      {

      float height = isInIconMode() ? 0.001f : 0.015f;

      float[][] bands = { {height,35,0.25f,0.5f,10,0,0},{0.001f,35,0.25f,0.5f,4,0,0} };

      int[] indices   = { 0,1,1,1,1 };

      return new ObjectFaceShape(bands,indices,null);

      }

    else

      {

      float height = isInIconMode() ? 0.001f : 0.020f;

      float[][] bands = { {height,35,0.20f,0.6f,9,0,0}, {0.001f,35,0.20f,0.6f,4,0,0} };

      int[] indices   = { 0,1,1,1 };

      return new ObjectFaceShape(bands,indices,null);

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public ObjectVertexEffects getVertexEffects(int variant)

    {

    if( variant==0 )

      {

      float[][] corners   = { {0.04f,0.10f} };

      int[] cornerIndices = { -1,-1,-1,-1,-1,-1 };

      float[][] centers   = { { -3*SQ2/16, -0.5f,-0.375f-3*SQ2/16 } };

      int[] centerIndices = { 0,0,0,0,-1,-1 };

      return FactoryCubit.generateVertexEffect(getVertices(variant),corners,cornerIndices,centers,centerIndices);

      }

    else

      {

      float[][] corners   = { {0.02f,0.10f} };

      int[] cornerIndices = { -1,-1,-1,-1 };

      float[][] centers   = {  { -SQ2/8, -0.5f, -SQ2/8-0.25f } };

      int[] centerIndices = { 0,0,-1,0 };

      return FactoryCubit.generateVertexEffect(getVertices(variant),corners,cornerIndices,centers,centerIndices);

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public int getNumCubitVariants(int[] numLayers)

    {

    return 2;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public int getCubitVariant(int cubit, int[] numLayers)

    {

    return cubit<16 ? 0:1;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public float getStickerRadius()

    {

    return 0.10f;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public float getStickerStroke()

    {

    return isInIconMode() ? 0.13f : 0.10f;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public float[][][] getStickerAngles()

    {

    float A = (float)(Math.PI/12);

    return new float[][][] { {{ 0,0,-A,0 }} , {{A,0,0}}  };

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// PUBLIC API

  public Static3D[] getRotationAxis()

    {

    return ROT_AXIS;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public int[][] getBasicAngles()

    {

    if( mBasicAngle==null )

      {

      int[] AV = {8,8,8,8};

      int[] AH = {2,2};

      mBasicAngle = new int[][] { AV,AH,AH,AH,AH };

      }

    return mBasicAngle;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public String getShortName()

    {

    return ListObjects.BALL_4.name();

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public String[][] getTutorials()

    {

    return new String[][]{

                          {"gb","n41Rng0g65c","How to solve Masterball","javahamburg"},

                          {"es","zmdgV15BQi0","Tutorial para la Masterball","Robert Cubes"},

                          {"de","EjGf-VytMcA","Masterball Tutorial Deutsch","javahamburg"},

                         };

    }

}

///////////////////////////////////////////////////////////////////////////////////////////////////

// Copyright 2024 Leszek Koltunski                                                               //

//                                                                                               //

// This file is part of Magic Cube.                                                              //

//                                                                                               //

// Magic Cube is proprietary software licensed under an EULA which you should have received      //

// along with the code. If not, check https://distorted.org/magic/License-Magic-Cube.html        //

///////////////////////////////////////////////////////////////////////////////////////////////////

package org.distorted.objectlib.shape;

import org.distorted.library.type.Static3D;

import org.distorted.library.type.Static4D;

import org.distorted.objectlib.main.InitAssets;

import org.distorted.objectlib.main.TwistyObject;

import org.distorted.objectlib.metadata.Metadata;

import static org.distorted.objectlib.shape.ShapeColors.*;

///////////////////////////////////////////////////////////////////////////////////////////////////

public abstract class ShapeBarrel extends TwistyObject

{

  public static final Static4D DEFAULT_ROT = new Static4D(-0.09848663f, 0.6306283f, 0.67572856f, 0.36878252f);

  public static final int[] FACE_COLORS = new int[]

         {

                 COLOR_VIOLET, COLOR_GREY,

                 COLOR_BLUE, COLOR_RED,

                 COLOR_ORANGE, COLOR_LGREEN,

                 COLOR_WHITE, COLOR_YELLOW

         };

  public static final int NUM_FACES = 8;

  public static final int FOV = 40;

  public static final float RATIO = 0.75f;

///////////////////////////////////////////////////////////////////////////////////////////////////

  public ShapeBarrel(int iconMode, float realSize, Static4D quat, Static3D move, float scale, Metadata meta, InitAssets asset)

    {

    super(iconMode, realSize, quat, move, scale, meta, asset);

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public final int getNumPuzzleFaces()

    {

    return NUM_FACES;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public int[] getColorTable()

    {

    return FACE_COLORS;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public int getFOV()

    {

    return FOV;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public float getScreenRatio()

    {

    return RATIO;

    }

}

  public static final int TC_BARREL            =   2;

///////////////////////////////////////////////////////////////////////////////////////////////////

// Copyright 2024 Leszek Koltunski                                                               //

//                                                                                               //

// This file is part of Magic Cube.                                                              //

//                                                                                               //

// Magic Cube is proprietary software licensed under an EULA which you should have received      //

// along with the code. If not, check https://distorted.org/magic/License-Magic-Cube.html        //

///////////////////////////////////////////////////////////////////////////////////////////////////

package org.distorted.objectlib.touchcontrol;

import static org.distorted.objectlib.main.TwistyObject.SQ2;

import org.distorted.library.helpers.QuatHelper;

import org.distorted.library.type.Static3D;

import org.distorted.library.type.Static4D;

import org.distorted.objectlib.main.TwistyObject;

///////////////////////////////////////////////////////////////////////////////////////////////////

// Barrel-shaped objects: map the 2D swipes of user's fingers to 3D rotations

public class TouchControlBarrel extends TouchControl

{

  private static final float MIN_LEN = 0.35f;

  private static final float[] mTmp = new float[4];

  private final Static3D[] mRotAxis;

  private final float[] mPoint, mCamera, mTouch;

  private final int[] mEnabledRotAxis;

  private final int[][][] mEnabled;

  private final float[] mMove2D;

  private final float[][] mCastedRotAxis;

  private float[][] mTouchBorders;

  private float mLongitude, mLatitude;

  private float mX, mY, mZ;

  private static final float X = (float)Math.sqrt( (2-SQ2)/(6+SQ2) );

  private static final float Y = (float)Math.sqrt( (2+SQ2)/(6+SQ2) );

  public static final Static3D[] FACE_AXIS = new Static3D[]

        {

          new Static3D( X, Y, Y),

          new Static3D( X,-Y, Y),

          new Static3D( Y, Y, X),

          new Static3D( Y,-Y, X),

          new Static3D( Y, Y,-X),

          new Static3D( Y,-Y,-X),

          new Static3D( X, Y,-Y),

          new Static3D( X,-Y,-Y),

          new Static3D(-X, Y,-Y),

          new Static3D(-X,-Y,-Y),

          new Static3D(-Y, Y,-X),

          new Static3D(-Y,-Y,-X),

          new Static3D(-Y, Y, X),

          new Static3D(-Y,-Y, X),

          new Static3D(-X, Y, Y),

          new Static3D(-X,-Y, Y),

        };

///////////////////////////////////////////////////////////////////////////////////////////////////

  public TouchControlBarrel(TwistyObject object)

    {

    super(object);

    int[] numLayers       = object.getNumLayers();

    float[][] cuts        = object.getCuts(numLayers);

    boolean[][] rotatable = object.getLayerRotatable(numLayers);

    float size            = object.getSize();

    mRotAxis = object.getRotationAxis();

    mEnabled = object.getEnabled();

    mMove2D  = new float[2];

    mPoint = new float[3];

    mCamera= new float[3];

    mTouch = new float[3];

    int numRotAxis = mRotAxis.length;

    mEnabledRotAxis = new int[numRotAxis+1];

    mCastedRotAxis = new float[numRotAxis][2];

    mGhostAxisEnabled = -1;

    computeBorders(cuts,rotatable,size);

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  private float[] computeBorder(float[] cuts, boolean[] rotatable, float size)

    {

    if( cuts==null ) return null;

    int len = cuts.length;

    float[] border = new float[len];

    for(int i=0; i<len; i++)

      {

      if( !rotatable[i] )

        {

        border[i] = i>0 ? border[i-1] : -Float.MAX_VALUE;

        }

      else

        {

        if( rotatable[i+1] ) border[i] = cuts[i]/size;

        else

          {

          int found = -1;

          for(int j=i+2; j<=len; j++)

            {

            if( rotatable[j] )

              {

              found=j;

              break;

              }

            }

          border[i] = found>0 ? (cuts[i]+cuts[found-1])/(2*size) : Float.MAX_VALUE;

          }

        }

      }

    return border;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// size, not numLayers (see Master Skewb where size!=numLayers) - also cuboids.

  void computeBorders(float[][] cuts, boolean[][] rotatable, float size)

    {

    int numCuts = cuts.length;

    mTouchBorders = new float[numCuts][];

    for(int axis=0; axis<numCuts; axis++)

      {

      mTouchBorders[axis] = computeBorder(cuts[axis],rotatable[axis],size);

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  private int computeRowFromOffset(int axisIndex, float offset)

    {

    float[] borders = mTouchBorders[axisIndex];

    if( borders==null ) return 0;

    int len = borders.length;

    for(int i=0; i<len; i++)

      {

      if( offset<borders[i] ) return i;

      }

    return len;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// Longitude spans from 0 (at Guinea Bay) increasing to the east all the way to 2PI

// Latitude - from -PI/2 (South Pole) to +PI/2 (North Pole)

  private void computeLongitudeAndLatitude(float A, float B, float C)

    {

    float sqrt = (float)Math.sqrt(B*B - 4*A*C);

    float alpha= (-B+sqrt)/(2*A); // this is the closer point

    float cx = mCamera[0];

    float cy = mCamera[1];

    float cz = mCamera[2];

    float vx = mCamera[0]-mPoint[0];

    float vy = mCamera[1]-mPoint[1];

    float vz = mCamera[2]-mPoint[2];

    mX = cx + alpha*vx;

    mY = cy + alpha*vy;

    mZ = cz + alpha*vz;

    mLongitude = mZ==0 ? 0 : (float)Math.atan(mX/mZ);

    mLatitude  = (float)Math.asin(2*mY);

    if( mZ<0 ) mLongitude += Math.PI;

    else if( mX<0 ) mLongitude += 2*Math.PI;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// this is Masterball-specific. See TwistyMasterball.getEnabled()

  private int returnTouchedFace()

    {

    float t = (float)(mLongitude + Math.PI/8);

    if( t>2*Math.PI ) t-=(2*Math.PI);

    int ret = (int)(t/(Math.PI/4));

    return ret<8 ? ret : 7;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// this is Masterball-specific. No parts in any faces.

  private int returnTouchedPart()

    {

    return 0;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  private float computeOffset(int rotIndex)

    {

    Static3D axis = mRotAxis[rotIndex];

    return mX*axis.get0() + mY*axis.get1() + mZ*axis.get2();

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  private void computeEnabledAxis()

    {

    if( mGhostAxisEnabled<0 )

      {

      int face = returnTouchedFace();

      int part = returnTouchedPart();

      int num = mEnabled[face][0].length;

      mEnabledRotAxis[0] = num;

      System.arraycopy(mEnabled[face][part], 0, mEnabledRotAxis, 1, num);

      }

    else

      {

      mEnabledRotAxis[0] = 1;  // if in 'ghost' mode, only one axis is enabled.

      mEnabledRotAxis[1] = mGhostAxisEnabled;

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public int getTouchedCubitFace()

    {

    return 0;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public float[] getTouchedPuzzleCenter()

    {

    return null;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public int getTouchedCubit()

    {

    return 0;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public boolean objectTouched(Static4D rotatedTouchPoint, Static4D rotatedCamera)

    {

    mPoint[0]  = rotatedTouchPoint.get0()/mObjectRatio;

    mPoint[1]  = rotatedTouchPoint.get1()/mObjectRatio;

    mPoint[2]  = rotatedTouchPoint.get2()/mObjectRatio;

    mCamera[0] = rotatedCamera.get0()/mObjectRatio;

    mCamera[1] = rotatedCamera.get1()/mObjectRatio;

    mCamera[2] = rotatedCamera.get2()/mObjectRatio;

    float vx = mCamera[0]-mPoint[0];

    float vy = mCamera[1]-mPoint[1];

    float vz = mCamera[2]-mPoint[2];

    float R = 0.5f;

    float A = vx*vx + vy*vy + vz*vz;

    float B = 2*(vx*mCamera[0] + vy*mCamera[1] + vz*mCamera[2]);

    float C = (mCamera[0]*mCamera[0] + mCamera[1]*mCamera[1] + mCamera[2]*mCamera[2]) - R*R;

    if( B*B >= 4*A*C )

      {

      computeLongitudeAndLatitude(A,B,C);

      return true;

      }

    return false;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public void newRotation(int[] output, Static4D rotatedTouchPoint, Static4D quat)

    {

    computeEnabledAxis();

    mTouch[0]  = rotatedTouchPoint.get0()/mObjectRatio;

    mTouch[1]  = rotatedTouchPoint.get1()/mObjectRatio;

    mTouch[2]  = rotatedTouchPoint.get2()/mObjectRatio;

    float x = mTouch[0]-mPoint[0];

    float y = mTouch[1]-mPoint[1];

    float z = mTouch[2]-mPoint[2];

    QuatHelper.rotateVectorByQuat(mTmp,x,y,z,0,quat);

    mMove2D[0] = mTmp[0];

    mMove2D[1] = mTmp[1];

    for(int i=1; i<=mEnabledRotAxis[0]; i++)

      {

      int enabled = mEnabledRotAxis[i];

      Static3D axis = mRotAxis[enabled];

      float[] vector = mCastedRotAxis[enabled];

      float bx = axis.get0();

      float by = axis.get1();

      float bz = axis.get2();

      QuatHelper.rotateVectorByQuat(mTmp,bx,by,bz,0,quat);

      float len = (float)Math.sqrt(mTmp[0]*mTmp[0] + mTmp[1]*mTmp[1]);

      if( len<MIN_LEN )

        {

        vector[0] = 1000f;  // switch off the axis because when casted

        vector[1] = 1000f;  // onto the screen it is too short

        }

      else

        {

        vector[0] = mTmp[0]/len;

        vector[1] = mTmp[1]/len;

        }

      }

    int rotIndex = computeRotationIndex( mCastedRotAxis, mMove2D, mEnabledRotAxis);

    float offset = computeOffset(rotIndex);

    int row      = computeRowFromOffset(rotIndex,offset);

    output[0] = rotIndex;

    output[1] = row;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

// simply cast the appropriate rotational axis of the object to the screen surface.

  public void getCastedRotAxis(float[] output, Static4D quat, int axisIndex)

    {

    Static3D a = mRotAxis[axisIndex];

    Static4D result = QuatHelper.rotateVectorByQuat(a.get0(),a.get1(),a.get2(),0,quat);

    float cx = result.get0();

    float cy = result.get1();

    float len= (float)Math.sqrt(cx*cx+cy*cy);

    if( len!=0 )

      {

      output[0] = cx/len;

      output[1] = cy/len;

      }

    else

      {

      output[0] = 1;

      output[1] = 0;

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

  public boolean axisAndFaceAgree(int axisIndex)

    {

    return false;

    }

}