Project

General

Profile

« Previous | Next » 

Revision b73dcaa7

Added by Leszek Koltunski almost 8 years ago

Javadoc

View differences:

src/main/java/org/distorted/library/DistortedBitmap.java
23 23

  
24 24
///////////////////////////////////////////////////////////////////////////////////////////////////
25 25
/**
26
 * Wrapper around the standard Android Bitmap class to which one can apply graphical effects.
27
 * <p>
28
 * General idea is as follows:
29
 * <ul>
30
 * <li> Create an instance of DistortedBitmap
31
 * <li> Paint something onto the Bitmap that's backing it up
32
 * <li> Apply some effects
33
 * <li> Draw it!
34
 * </ul>
35
 * <p>
36
 * The effects we can apply fall into three general categories:
37
 * <ul>
38
 * <li> Matrix Effects, i.e. ones that change the Bitmap's ModelView Matrix (moves, scales, rotations)
39
 * <li> Vertex Effects, i.e. effects that are implemented in the Vertex Shader. Those typically change
40
 *      the shape of (some sub-Region of) the Bitmap in some way (deforms, distortions, sinks)
41
 * <li> Fragment Effects, i.e. effects that change (some of) the pixels of the Bitmap (transparency, macroblock)
42
 * </ul>
43
 * <p>
44
 * 
26
 * DistortedObject descendant - with a Grid of flat rectangles.
45 27
 */
46 28
public class DistortedBitmap extends DistortedObject
47 29
   {
src/main/java/org/distorted/library/DistortedCubes.java
21 21

  
22 22
///////////////////////////////////////////////////////////////////////////////////////////////////
23 23
/**
24
 * Instance of this class represents a flat set of cubes optionally textured as a whole.
24
 * DistortedObject descendant - with a Grid composed of a set of cubes, centers of which all have equal Z-coords.
25 25
 * (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 26
 */
45 27
public class DistortedCubes extends DistortedObject
46 28
   {
src/main/java/org/distorted/library/DistortedObject.java
37 37
///////////////////////////////////////////////////////////////////////////////////////////////////
38 38
/**
39 39
 * All Objects to which Distorted Graphics effects can be applied need to be extended from here.
40
 *
40
 * <p>
41
 * General idea is as follows:
42
 * <ul>
43
 * <li> Create an instance of (some class descended from) DistortedObject
44
 * <li> Paint something onto the Bitmap that's backing it up
45
 * <li> Apply some effects
46
 * <li> Draw it!
47
 * </ul>
48
 * <p>
49
 * The effects we can apply fall into three general categories:
50
 * <ul>
51
 * <li> Matrix Effects, i.e. ones that change the Bitmap's ModelView Matrix (moves, scales, rotations)
52
 * <li> Vertex Effects, i.e. effects that are implemented in the Vertex Shader. Those typically change
53
 *      the shape of (some sub-Region of) the Bitmap in some way (deforms, distortions, sinks)
54
 * <li> Fragment Effects, i.e. effects that change (some of) the pixels of the Bitmap (transparency, macroblock)
55
 * </ul>
56
 * <p>
41 57
 * Just like in DistortedNode and DistortedFramebuffer, we need to have a static list of all
42 58
 * DistortedObjects currently created by the application so that we can implement the 'mark for
43 59
 * deletion now - actually delete on next render' thing.

Also available in: Unified diff