/src/main/java/org/distorted/library/effect/EffectName.java - Annotate - Distorted Android

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

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	9f34a0f6	Leszek Koltunski	VERTEX_ROTATE ( EffectType.VERTEX , new float[] {0.0f} , 4, 0, 3 , VertexEffectRotate.class ),
61	a918bba1	Leszek Koltunski	VERTEX_SCALE ( EffectType.VERTEX , new float[] {1.0f,1.0f,1.0f} , 3, 0, 0 , VertexEffectScale.class ),
62	b24e4719	Leszek Koltunski
63	5e96393c	Leszek Koltunski	ALPHA ( EffectType.FRAGMENT, new float[] {1.0f} , 1, 3, 3 , FragmentEffectAlpha.class ),
64			SMOOTH_ALPHA ( EffectType.FRAGMENT, new float[] {1.0f} , 1, 3, 3 , FragmentEffectAlpha.class ),
65			CHROMA ( EffectType.FRAGMENT, new float[] {0.0f} , 4, 3, 3 , FragmentEffectChroma.class ),
66			SMOOTH_CHROMA ( EffectType.FRAGMENT, new float[] {0.0f} , 4, 3, 3 , FragmentEffectChroma.class ),
67			BRIGHTNESS ( EffectType.FRAGMENT, new float[] {1.0f} , 1, 3, 3 , FragmentEffectBrightness.class ),
68			SMOOTH_BRIGHTNESS( EffectType.FRAGMENT, new float[] {1.0f} , 1, 3, 3 , FragmentEffectBrightness.class ),
69			SATURATION ( EffectType.FRAGMENT, new float[] {1.0f} , 1, 3, 3 , FragmentEffectSaturation.class ),
70			SMOOTH_SATURATION( EffectType.FRAGMENT, new float[] {1.0f} , 1, 3, 3 , FragmentEffectSaturation.class ),
71			CONTRAST ( EffectType.FRAGMENT, new float[] {1.0f} , 1, 3, 3 , FragmentEffectContrast.class ),
72			SMOOTH_CONTRAST ( EffectType.FRAGMENT, new float[] {1.0f} , 1, 3, 3 , FragmentEffectContrast.class ),
73	b24e4719	Leszek Koltunski
74			BLUR ( EffectType.POSTPROCESS,new float[] {0.0f} , 1, 0, 0 , PostprocessEffectBlur.class ),
75			GLOW ( EffectType.POSTPROCESS,new float[] {0.0f} , 5, 0, 0 , PostprocessEffectGlow.class );
76	da9b3f07	Leszek Koltunski
77			///////////////////////////////////////////////////////////////////////////////////////////////////
78
79	c3651001	Leszek Koltunski	public static final int LENGTH = values().length;
80	9d0d8530	leszek
81	da9b3f07	Leszek Koltunski	private final EffectType type;
82	9d0d8530	leszek	private final float[] unity;
83			private final int dimension;
84	b24e4719	Leszek Koltunski	private final int regionDim;
85			private final int centerDim;
86	2f1f7570	Leszek Koltunski	private final Class<? extends Effect> effectClass;
87	9d0d8530	leszek
88			private static final int[] dimensions;
89	b24e4719	Leszek Koltunski	private static final int[] regionDimension;
90			private static final int[] centerDimension;
91	c3651001	Leszek Koltunski	private static final EffectName[] names; // copy the values() to a local variable so that we
92			// don't have to keep recreating the array every time
93			static
94	da9b3f07	Leszek Koltunski	{
95	c3651001	Leszek Koltunski	int i=0;
96	9d0d8530	leszek
97			dimensions = new int[LENGTH];
98	b24e4719	Leszek Koltunski	regionDimension = new int[LENGTH];
99			centerDimension = new int[LENGTH];
100	9d0d8530	leszek	names = new EffectName[LENGTH];
101	c3651001	Leszek Koltunski
102			for(EffectName name: EffectName.values())
103			{
104	9d0d8530	leszek	dimensions[i] = name.dimension;
105	b24e4719	Leszek Koltunski	regionDimension[i] = name.regionDim;
106			centerDimension[i] = name.centerDim;
107	9d0d8530	leszek	names[i] = name;
108
109			i++;
110	c3651001	Leszek Koltunski	}
111	da9b3f07	Leszek Koltunski	}
112
113			///////////////////////////////////////////////////////////////////////////////////////////////////
114
115	9d0d8530	leszek	float[] getUnity()
116			{
117			return unity;
118			}
119
120			///////////////////////////////////////////////////////////////////////////////////////////////////
121
122	b24e4719	Leszek Koltunski	EffectName(EffectType type, float[] unity, int dimension, int regionDim,
123			int centerDim, Class<? extends Effect> effectClass )
124	da9b3f07	Leszek Koltunski	{
125	2f1f7570	Leszek Koltunski	this.type = type;
126			this.unity = unity;
127			this.dimension = dimension;
128	b24e4719	Leszek Koltunski	this.regionDim = regionDim;
129			this.centerDim = centerDim;
130	2f1f7570	Leszek Koltunski	this.effectClass = effectClass;
131	da9b3f07	Leszek Koltunski	}
132
133			///////////////////////////////////////////////////////////////////////////////////////////////////
134			// PUBLIC API
135			///////////////////////////////////////////////////////////////////////////////////////////////////
136			/**
137	143095f7	Leszek Koltunski	* Returns the Type of an individual Effect. For example, EffectName.ROTATE.getType() will
138	da9b3f07	Leszek Koltunski	* return EffectType.MATRIX.
139			* @return type of the effect.
140			*/
141			public EffectType getType()
142			{
143			return type;
144			}
145	c3651001	Leszek Koltunski
146	2f1f7570	Leszek Koltunski	///////////////////////////////////////////////////////////////////////////////////////////////////
147	143095f7	Leszek Koltunski	/**
148			* Returns the Class of an individual Effect. For example, EffectName.ROTATE.getEffectClass()
149			* returns MatrixEffectRotate.class.
150			* @return effect class.
151			*/
152	2f1f7570	Leszek Koltunski	public Class<? extends Effect> getEffectClass()
153			{
154			return effectClass;
155			}
156
157	c3651001	Leszek Koltunski	///////////////////////////////////////////////////////////////////////////////////////////////////
158			/**
159			* Returns the i-th EffectName.
160			* <p>
161			* If you want to loop over all possible Effects, you need this.
162			*/
163			public static EffectName getName(int ordinal)
164			{
165			return names[ordinal];
166			}
167	9d0d8530	leszek
168			///////////////////////////////////////////////////////////////////////////////////////////////////
169			/**
170			* Returns the dimension of an Effect (in other words, the number of interpolated values).
171			* @return dimension of the Effect.
172			*/
173	b24e4719	Leszek Koltunski	public int getEffectDimension() { return dimensions[ordinal()]; }
174	9d0d8530	leszek
175			///////////////////////////////////////////////////////////////////////////////////////////////////
176			/**
177	b24e4719	Leszek Koltunski	* What is the dimension of the Region supported by this effect?
178			* @return Dimension of the Region supported (0-region not supported at all).
179	9d0d8530	leszek	*/
180	b24e4719	Leszek Koltunski	public int getRegionDimension() { return regionDimension[ordinal()]; }
181	9d0d8530	leszek
182			///////////////////////////////////////////////////////////////////////////////////////////////////
183			/**
184	b24e4719	Leszek Koltunski	* What is the dimension of the Center supported by this effect?
185			* @return Dimension of the Center supported (0-center not supported at all).
186	9d0d8530	leszek	*/
187	b24e4719	Leszek Koltunski	public int getCenterDimension() { return centerDimension[ordinal()]; }
188	da9b3f07	Leszek Koltunski	}

Project

General

Profile

Distorted Android

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