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

library / src / main / java / org / distorted / library / DistortedCubes.java @ 5de7841c

1	d333eb6b	Leszek Koltunski	///////////////////////////////////////////////////////////////////////////////////////////////////
2			// Copyright 2016 Leszek Koltunski //
3			// //
4			// This file is part of Distorted. //
5			// //
6			// Distorted is free software: you can redistribute it and/or modify //
7			// 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			// Distorted is distributed in the hope that it will be useful, //
12			// 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			// along with Distorted. If not, see <http://www.gnu.org/licenses/>. //
18			///////////////////////////////////////////////////////////////////////////////////////////////////
19
20	6a06a912	Leszek Koltunski	package org.distorted.library;
21
22			///////////////////////////////////////////////////////////////////////////////////////////////////
23			/**
24	9361b337	Leszek Koltunski	* Instance of this class represents a flat set of cubes optionally textured as a whole.
25	6a06a912	Leszek Koltunski	* (a subset of a NxMx1 cuboid build with 1x1x1 cubes, i.e. the MxNx1 cuboid with arbitrary cubes missing)
26			* <p>
27			* General idea is as follows:
28			* <ul>
29			* <li> Create an instance of this class
30			* <li> Optionally texture it
31			* <li> Apply some effects
32			* <li> Draw it!
33			* </ul>
34			* <p>
35			* The effects we can apply fall into three general categories:
36			* <ul>
37			* <li> Matrix Effects, i.e. ones that change the Cuboid's ModelView Matrix (moves, scales, rotations)
38			* <li> Vertex Effects, i.e. effects that are implemented in the Vertex Shader. Those typically change
39			* the shape of (some sub-Region of) the Cuboid in some way (deforms, distortions, sinks)
40			* <li> Fragment Effects, i.e. effects that change (some of) the pixels of the Texture (transparency, macroblock)
41			* </ul>
42			* <p>
43			*
44			*/
45			public class DistortedCubes extends DistortedObject
46			{
47
48			///////////////////////////////////////////////////////////////////////////////////////////////////
49			// PUBLIC API
50	9361b337	Leszek Koltunski	///////////////////////////////////////////////////////////////////////////////////////////////////
51	6a06a912	Leszek Koltunski	/**
52			* Creates internal memory representation of a cuboid subset.
53	9361b337	Leszek Koltunski	*
54	6a06a912	Leszek Koltunski	* @param cols Integer helping to parse the next parameter.
55			* @param desc String describing the subset of a MxNx1 cuboid that we want to create.
56			* Its MxN characters - all 0 or 1 - decide of appropriate field is taken or not.
57	015642fb	Leszek Koltunski	* <p>
58	5de7841c	Leszek Koltunski	* <pre>
59	6a06a912	Leszek Koltunski	* For example, (cols=2, desc="111010") describes the following shape:
60	9361b337	Leszek Koltunski	*
61	6a06a912	Leszek Koltunski	* XX
62			* X
63			* X
64	9361b337	Leszek Koltunski	*
65	6a06a912	Leszek Koltunski	* whereas (cols=2,desc="110001") describes
66	9361b337	Leszek Koltunski	*
67	6a06a912	Leszek Koltunski	* XX
68	9361b337	Leszek Koltunski	*
69	6a06a912	Leszek Koltunski	* X
70	5de7841c	Leszek Koltunski	* </pre>
71	015642fb	Leszek Koltunski	* </p>
72	ffbf279e	Leszek Koltunski	* @param cubeSize size, in pixels, of the single 1x1x1 cube our cuboid is built from
73	6a06a912	Leszek Koltunski	* @param frontOnly Only create the front wall or side and back as well?
74			*/
75	ffbf279e	Leszek Koltunski	public DistortedCubes(int cols, String desc, int cubeSize, boolean frontOnly)
76	9361b337	Leszek Koltunski	{
77			int Rs = 0;
78			int Cs = 0;
79	6a06a912	Leszek Koltunski
80	9361b337	Leszek Koltunski	if( cols>0 )
81			{
82			int reallen = desc.length();
83			int len = reallen;
84	6a06a912	Leszek Koltunski
85	9361b337	Leszek Koltunski	if( (reallen/cols)*cols != reallen )
86			{
87			len = ((reallen/cols)+1)*cols;
88			for(int i=reallen; i<len; i++) desc += "0";
89			}
90	6a06a912	Leszek Koltunski
91	ada90d33	Leszek Koltunski	if( desc.contains("1") )
92	9361b337	Leszek Koltunski	{
93			Cs = cols;
94			Rs = len/cols;
95	6a06a912	Leszek Koltunski	}
96			}
97	9361b337	Leszek Koltunski
98	ffbf279e	Leszek Koltunski	mSizeX= cubeSize*Cs;
99			mSizeY= cubeSize*Rs;
100			mSizeZ= frontOnly ? 1 : cubeSize;
101	0729bc41	Leszek Koltunski	mGrid = DistortedGridFactory.getGrid(cols,desc, frontOnly);
102	ffbf279e	Leszek Koltunski	initializeData();
103	9361b337	Leszek Koltunski	}
104
105			///////////////////////////////////////////////////////////////////////////////////////////////////
106			/**
107	350cc2f5	Leszek Koltunski	* Convenience constructor.
108	9361b337	Leszek Koltunski	*/
109			public DistortedCubes(int cols, String desc, int gridSize)
110			{
111			this(cols,desc,gridSize,false);
112			}
113
114	6a06a912	Leszek Koltunski	///////////////////////////////////////////////////////////////////////////////////////////////////
115			/**
116	8298e6af	Leszek Koltunski	* Copy constructor.
117			*
118			* @param dc Object to copy
119	b911dc09	Leszek Koltunski	* @param flags see {@link DistortedObject#DistortedObject(DistortedObject,int)}
120	6a06a912	Leszek Koltunski	*/
121	9361b337	Leszek Koltunski	public DistortedCubes(DistortedCubes dc, int flags)
122			{
123			super(dc,flags);
124			}
125	6a06a912	Leszek Koltunski
126	ada90d33	Leszek Koltunski	///////////////////////////////////////////////////////////////////////////////////////////////////
127
128	0729bc41	Leszek Koltunski	protected DistortedObject deepCopy(int flags)
129			{
130			return new DistortedCubes(this,flags);
131			}
132	ada90d33	Leszek Koltunski
133	6a06a912	Leszek Koltunski	///////////////////////////////////////////////////////////////////////////////////////////////////
134	9361b337	Leszek Koltunski	}

Project

General

Profile

Distorted Android

library / src / main / java / org / distorted / library / DistortedCubes.java @ 5de7841c