Project

General

Profile

Download (9.76 KB) Statistics
| Branch: | Revision:

library / src / main / java / org / distorted / library / effect / EffectName.java @ e979d285

1 da9b3f07 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
2
// Copyright 2016 Leszek Koltunski                                                               //
3
//                                                                                               //
4 46b572b5 Leszek Koltunski
// This file is part of Distorted.                                                               //
5 da9b3f07 Leszek Koltunski
//                                                                                               //
6 46b572b5 Leszek Koltunski
// Distorted is free software: you can redistribute it and/or modify                             //
7 da9b3f07 Leszek Koltunski
// it under the terms of the GNU General Public License as published by                          //
8
// the Free Software Foundation, either version 2 of the License, or                             //
9
// (at your option) any later version.                                                           //
10
//                                                                                               //
11 46b572b5 Leszek Koltunski
// Distorted is distributed in the hope that it will be useful,                                  //
12 da9b3f07 Leszek Koltunski
// but WITHOUT ANY WARRANTY; without even the implied warranty of                                //
13
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                                 //
14
// GNU General Public License for more details.                                                  //
15
//                                                                                               //
16
// You should have received a copy of the GNU General Public License                             //
17 46b572b5 Leszek Koltunski
// along with Distorted.  If not, see <http://www.gnu.org/licenses/>.                            //
18 da9b3f07 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
19
20
package org.distorted.library.effect;
21
22
///////////////////////////////////////////////////////////////////////////////////////////////////
23
/**
24
 * Names of Effects one can add to the DistortedEffects queues.
25
 * <p>
26
 * Effect's 'Type' is one of the constants defined in {@link EffectType}.
27 9d0d8530 leszek
 * </p>
28
 * <p>
29
 * Effect's 'Uniforms' are a vector of 7 (matrix effects) 12 (vertex) or 8 (fragment) floats, which
30
 * together form full information how to compute a given effect.
31
 * Typically, some of those values will be Interpolated in CPU (by one of the 'EffectQueueX.compute()'
32
 * methods) and the effect of such Interpolation sent to the Shaders.
33
 * </p>
34
 * <p>
35
 * Effect's 'Unity' is such a particular vector of its 'interpolated values' which makes the
36
 * effect NULL. For example, if the effect is 'MOVE' by a 3-dimensional vector, then a 'NULL
37
 * MOVE' is a MOVE by vector (0,0,0), thus (0,0,0) is the unity of the MOVE effect.
38
 * This is used by the EffectQueue classes to decide if the final form of the Effect is NULL - and
39
 * thus if it can safely be removed from Effect Queues without affecting the visual in any way.
40
 * </p>
41 da9b3f07 Leszek Koltunski
 */
42
43
public enum EffectName
44
  {
45 143095f7 Leszek Koltunski
  // EFFECT NAME /////// EFFECT TYPE ////////// EFFECT UNITY //////////// DIM REGION CENTER // CLASS
46 b24e4719 Leszek Koltunski
  ROTATE           ( EffectType.MATRIX  ,   new float[] {0.0f}           , 4, 0,     3    , MatrixEffectRotate.class       ),
47
  QUATERNION       ( EffectType.MATRIX  ,   new float[] {0.0f,0.0f,0.0f} , 4, 0,     3    , MatrixEffectQuaternion.class   ),
48
  MOVE             ( EffectType.MATRIX  ,   new float[] {0.0f,0.0f,0.0f} , 3, 0,     0    , MatrixEffectMove.class         ),
49
  SCALE            ( EffectType.MATRIX  ,   new float[] {1.0f,1.0f,1.0f} , 3, 0,     0    , MatrixEffectScale.class        ),
50
  SHEAR            ( EffectType.MATRIX  ,   new float[] {0.0f,0.0f,0.0f} , 3, 0,     3    , MatrixEffectShear.class        ),
51
52 5e96393c Leszek Koltunski
  DISTORT          ( EffectType.VERTEX  ,   new float[] {0.0f,0.0f,0.0f} , 3, 4,     3    , VertexEffectDistort.class      ),
53
  DEFORM           ( EffectType.VERTEX  ,   new float[] {0.0f,0.0f,0.0f} , 3, 4,     3    , VertexEffectDeform.class       ),
54
  SINK             ( EffectType.VERTEX  ,   new float[] {1.0f}           , 1, 4,     3    , VertexEffectSink.class         ),
55 aee0b581 Leszek Koltunski
  PINCH            ( EffectType.VERTEX  ,   new float[] {1.0f}           , 3, 4,     3    , VertexEffectPinch.class        ),
56 5e96393c Leszek Koltunski
  SWIRL            ( EffectType.VERTEX  ,   new float[] {0.0f}           , 1, 4,     3    , VertexEffectSwirl.class        ),
57
  WAVE             ( EffectType.VERTEX  ,   new float[] {0.0f}           , 5, 4,     3    , VertexEffectWave.class         ),
58 e979d285 Leszek Koltunski
  VERTEX_MOVE      ( EffectType.VERTEX  ,   new float[] {0.0f,0.0f,0.0f} , 3, 0,     0    , VertexEffectMove.class         ),
59
  VERTEX_QUATERNION( EffectType.VERTEX  ,   new float[] {0.0f,0.0f,0.0f} , 4, 0,     3    , VertexEffectQuaternion.class   ),
60 b24e4719 Leszek Koltunski
61 5e96393c Leszek Koltunski
  ALPHA            ( EffectType.FRAGMENT,   new float[] {1.0f}           , 1, 3,     3    , FragmentEffectAlpha.class      ),
62
  SMOOTH_ALPHA     ( EffectType.FRAGMENT,   new float[] {1.0f}           , 1, 3,     3    , FragmentEffectAlpha.class      ),
63
  CHROMA           ( EffectType.FRAGMENT,   new float[] {0.0f}           , 4, 3,     3    , FragmentEffectChroma.class     ),
64
  SMOOTH_CHROMA    ( EffectType.FRAGMENT,   new float[] {0.0f}           , 4, 3,     3    , FragmentEffectChroma.class     ),
65
  BRIGHTNESS       ( EffectType.FRAGMENT,   new float[] {1.0f}           , 1, 3,     3    , FragmentEffectBrightness.class ),
66
  SMOOTH_BRIGHTNESS( EffectType.FRAGMENT,   new float[] {1.0f}           , 1, 3,     3    , FragmentEffectBrightness.class ),
67
  SATURATION       ( EffectType.FRAGMENT,   new float[] {1.0f}           , 1, 3,     3    , FragmentEffectSaturation.class ),
68
  SMOOTH_SATURATION( EffectType.FRAGMENT,   new float[] {1.0f}           , 1, 3,     3    , FragmentEffectSaturation.class ),
69
  CONTRAST         ( EffectType.FRAGMENT,   new float[] {1.0f}           , 1, 3,     3    , FragmentEffectContrast.class   ),
70
  SMOOTH_CONTRAST  ( EffectType.FRAGMENT,   new float[] {1.0f}           , 1, 3,     3    , FragmentEffectContrast.class   ),
71 b24e4719 Leszek Koltunski
72
  BLUR             ( EffectType.POSTPROCESS,new float[] {0.0f}           , 1, 0,     0    , PostprocessEffectBlur.class    ),
73
  GLOW             ( EffectType.POSTPROCESS,new float[] {0.0f}           , 5, 0,     0    , PostprocessEffectGlow.class    );
74 da9b3f07 Leszek Koltunski
75
///////////////////////////////////////////////////////////////////////////////////////////////////
76
77 c3651001 Leszek Koltunski
  public static final int LENGTH = values().length;
78 9d0d8530 leszek
79 da9b3f07 Leszek Koltunski
  private final EffectType type;
80 9d0d8530 leszek
  private final float[] unity;
81
  private final int dimension;
82 b24e4719 Leszek Koltunski
  private final int regionDim;
83
  private final int centerDim;
84 2f1f7570 Leszek Koltunski
  private final Class<? extends Effect> effectClass;
85 9d0d8530 leszek
86
  private static final int[] dimensions;
87 b24e4719 Leszek Koltunski
  private static final int[] regionDimension;
88
  private static final int[] centerDimension;
89 c3651001 Leszek Koltunski
  private static final EffectName[] names;  // copy the values() to a local variable so that we
90
                                            // don't have to keep recreating the array every time
91
  static
92 da9b3f07 Leszek Koltunski
    {
93 c3651001 Leszek Koltunski
    int i=0;
94 9d0d8530 leszek
95
    dimensions      = new int[LENGTH];
96 b24e4719 Leszek Koltunski
    regionDimension = new int[LENGTH];
97
    centerDimension = new int[LENGTH];
98 9d0d8530 leszek
    names           = new EffectName[LENGTH];
99 c3651001 Leszek Koltunski
100
    for(EffectName name: EffectName.values())
101
      {
102 9d0d8530 leszek
      dimensions[i]      = name.dimension;
103 b24e4719 Leszek Koltunski
      regionDimension[i] = name.regionDim;
104
      centerDimension[i] = name.centerDim;
105 9d0d8530 leszek
      names[i]           = name;
106
107
      i++;
108 c3651001 Leszek Koltunski
      }
109 da9b3f07 Leszek Koltunski
    }
110
111
///////////////////////////////////////////////////////////////////////////////////////////////////
112
113 9d0d8530 leszek
  float[] getUnity()
114
    {
115
    return unity;
116
    }
117
118
///////////////////////////////////////////////////////////////////////////////////////////////////
119
120 b24e4719 Leszek Koltunski
  EffectName(EffectType type, float[] unity, int dimension, int regionDim,
121
             int centerDim, Class<? extends Effect> effectClass )
122 da9b3f07 Leszek Koltunski
    {
123 2f1f7570 Leszek Koltunski
    this.type        = type;
124
    this.unity       = unity;
125
    this.dimension   = dimension;
126 b24e4719 Leszek Koltunski
    this.regionDim   = regionDim;
127
    this.centerDim   = centerDim;
128 2f1f7570 Leszek Koltunski
    this.effectClass = effectClass;
129 da9b3f07 Leszek Koltunski
    }
130
131
///////////////////////////////////////////////////////////////////////////////////////////////////
132
// PUBLIC API
133
///////////////////////////////////////////////////////////////////////////////////////////////////
134
/**
135 143095f7 Leszek Koltunski
 * Returns the Type of an individual Effect. For example, EffectName.ROTATE.getType() will
136 da9b3f07 Leszek Koltunski
 * return EffectType.MATRIX.
137
 * @return type of the effect.
138
 */
139
  public EffectType getType()
140
    {
141
    return type;
142
    }
143 c3651001 Leszek Koltunski
144 2f1f7570 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
145 143095f7 Leszek Koltunski
/**
146
 * Returns the Class of an individual Effect. For example, EffectName.ROTATE.getEffectClass()
147
 * returns MatrixEffectRotate.class.
148
 * @return effect class.
149
 */
150 2f1f7570 Leszek Koltunski
  public Class<? extends Effect> getEffectClass()
151
    {
152
    return effectClass;
153
    }
154
155 c3651001 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
156
/**
157
 * Returns the i-th EffectName.
158
 * <p>
159
 * If you want to loop over all possible Effects, you need this.
160
 */
161
  public static EffectName getName(int ordinal)
162
    {
163
    return names[ordinal];
164
    }
165 9d0d8530 leszek
166
///////////////////////////////////////////////////////////////////////////////////////////////////
167
/**
168
 * Returns the dimension of an Effect (in other words, the number of interpolated values).
169
 * @return dimension of the Effect.
170
 */
171 b24e4719 Leszek Koltunski
  public int getEffectDimension() { return dimensions[ordinal()]; }
172 9d0d8530 leszek
173
///////////////////////////////////////////////////////////////////////////////////////////////////
174
/**
175 b24e4719 Leszek Koltunski
 * What is the dimension of the Region supported by this effect?
176
 * @return Dimension of the Region supported (0-region not supported at all).
177 9d0d8530 leszek
 */
178 b24e4719 Leszek Koltunski
  public int getRegionDimension() { return regionDimension[ordinal()]; }
179 9d0d8530 leszek
180
///////////////////////////////////////////////////////////////////////////////////////////////////
181
/**
182 b24e4719 Leszek Koltunski
 * What is the dimension of the Center supported by this effect?
183
 * @return Dimension of the Center supported (0-center not supported at all).
184 9d0d8530 leszek
 */
185 b24e4719 Leszek Koltunski
  public int getCenterDimension() { return centerDimension[ordinal()]; }
186 da9b3f07 Leszek Koltunski
  }