Project

General

Profile

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

library / src / main / java / org / distorted / library / main / Distorted.java @ 6672d895

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 fe82a979 Leszek Koltunski
package org.distorted.library.main;
21 6a06a912 Leszek Koltunski
22 30beb34f Leszek Koltunski
import android.app.ActivityManager;
23 7845dc66 Leszek Koltunski
import android.content.Context;
24 30beb34f Leszek Koltunski
import android.content.pm.ConfigurationInfo;
25 d6e94c84 Leszek Koltunski
import android.content.res.Resources;
26 310e14fb leszek
27 26a4e5f6 leszek
import org.distorted.library.effect.Effect;
28 7cd24173 leszek
import org.distorted.library.effect.FragmentEffect;
29 aa2f0486 Leszek Koltunski
import org.distorted.library.effect.PostprocessEffect;
30 7cd24173 leszek
import org.distorted.library.effect.VertexEffect;
31 432442f9 Leszek Koltunski
import org.distorted.library.program.*;
32 6a06a912 Leszek Koltunski
33
///////////////////////////////////////////////////////////////////////////////////////////////////
34
/**
35
 * A singleton class used to control various global settings.
36
 */
37
public class Distorted 
38 39cbf9dc Leszek Koltunski
  {
39 f8f6d457 leszek
  static int GLSL;
40
  static String GLSL_VERSION;
41 6a06a912 Leszek Koltunski
  /**
42 cacc63de Leszek Koltunski
   * When creating an instance of a DistortedTexture from another instance, clone the Bitmap that's
43
   * backing up our DistortedTexture.
44 6a06a912 Leszek Koltunski
   * <p>
45 cacc63de Leszek Koltunski
   * This way we can have two DistortedTextures, both backed up by the same Bitmap, to which we can
46 6a06a912 Leszek Koltunski
   * apply different effects. Used in the copy constructor.
47
   */
48 29a06526 Leszek Koltunski
  public static final int CLONE_SURFACE = 0x1;
49 6a06a912 Leszek Koltunski
  /**
50 cacc63de Leszek Koltunski
   * When creating an instance of a DistortedEffects from another instance, clone the Matrix Effects.
51 6a06a912 Leszek Koltunski
   * <p>
52 cacc63de Leszek Koltunski
   * This way we can have two different DistortedEffects sharing the MATRIX queue.
53 6a06a912 Leszek Koltunski
   */
54 015642fb Leszek Koltunski
  public static final int CLONE_MATRIX = 0x2;
55 6a06a912 Leszek Koltunski
  /**
56 cacc63de Leszek Koltunski
   * When creating an instance of a DistortedEffects from another instance, clone the Vertex Effects.
57 6a06a912 Leszek Koltunski
   * <p>
58 cacc63de Leszek Koltunski
   * This way we can have two different DistortedEffects sharing the VERTEX queue.
59 6a06a912 Leszek Koltunski
   */
60
  public static final int CLONE_VERTEX  = 0x4;
61
  /**
62 cacc63de Leszek Koltunski
   * When creating an instance of a DistortedEffects from another instance, clone the Fragment Effects.
63 6a06a912 Leszek Koltunski
   * <p>
64 cacc63de Leszek Koltunski
   * This way we can have two different DistortedEffects sharing the FRAGMENT queue.
65 6a06a912 Leszek Koltunski
   */
66
  public static final int CLONE_FRAGMENT= 0x8;
67 d6e94c84 Leszek Koltunski
   /**
68
   * When creating an instance of a DistortedEffects from another instance, clone the PostProcess Effects.
69
   * <p>
70
   * This way we can have two different DistortedEffects sharing the POSTPROCESS queue.
71
   */
72
  public static final int CLONE_POSTPROCESS= 0x10;
73 6a06a912 Leszek Koltunski
  /**
74 a09ada4c Leszek Koltunski
   * When creating an instance of a DistortedNode from another instance, clone the children Nodes.
75 6a06a912 Leszek Koltunski
   * <p>
76 cacc63de Leszek Koltunski
   * This is mainly useful for creating many similar sub-trees and rendering then at different places
77
   * on the screen with (optionally) different Effects.
78 6a06a912 Leszek Koltunski
   */
79 d6e94c84 Leszek Koltunski
  public static final int CLONE_CHILDREN= 0x20;
80 b3618cb5 Leszek Koltunski
81 586b5fa1 Leszek Koltunski
  /**
82
   * Work around bugs in ARM Mali driver by, instead to a single FBO, rendering to a circular queue
83
   * of FBO_QUEUE_SIZE FBOs. (otherwise we sometimes get a 'full pipeline flush' and the end result
84
   * might be missing part of the Objects)
85 6672d895 Leszek Koltunski
   *
86
   * This bug only exists on Mali driver r12. TODO: on other platforms, make this equal to 1.
87
   *
88
   * https://community.arm.com/graphics/f/discussions/10285/opengl-es-3-1-on-mali-t880-flashes
89 586b5fa1 Leszek Koltunski
   */
90 6672d895 Leszek Koltunski
  public static final int FBO_QUEUE_SIZE = 3;
91 586b5fa1 Leszek Koltunski
92 55c14a19 Leszek Koltunski
  private static boolean mInitialized=false;
93 6a06a912 Leszek Koltunski
94
///////////////////////////////////////////////////////////////////////////////////////////////////
95 c638c1b0 Leszek Koltunski
// private: hide this from Javadoc
96 6a06a912 Leszek Koltunski
97
  private Distorted()
98
    {
99 8eccf334 Leszek Koltunski
100 6a06a912 Leszek Koltunski
    }
101
102 421c2728 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
103 310e14fb leszek
/**
104
 * Have we called onCreate yet, ie have we initialized the library?
105 1dfc9074 leszek
 * @return <code>true</code> if the library is initialized and ready for action.
106 310e14fb leszek
 */
107
  public static boolean isInitialized()
108 421c2728 Leszek Koltunski
    {
109 55c14a19 Leszek Koltunski
    return mInitialized;
110 421c2728 Leszek Koltunski
    }
111
112 6a06a912 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
113
/**
114
 * When OpenGL context gets created, you need to call this method so that the library can initialise its internal data structures.
115 432442f9 Leszek Koltunski
 * I.e. best called from GLSurfaceView.onCreate().
116 6a06a912 Leszek Koltunski
 * <p>
117 432442f9 Leszek Koltunski
 * Needs to be called from a thread holding the OpenGL context.
118 6a06a912 Leszek Koltunski
 *   
119 015642fb Leszek Koltunski
 * @param context Context of the App using the library - used to open up Resources and read Shader code.
120 86e99907 leszek
 * @throws FragmentCompilationException Fragment Shader failed to compile
121
 * @throws VertexCompilationException   Vertex Shader failed to compile
122
 * @throws VertexUniformsException      Too many uniforms in the Vertex Shader
123
 * @throws FragmentUniformsException    Too many uniforms in the Fragment Shader
124
 * @throws LinkingException             Shader failed to link
125 6a06a912 Leszek Koltunski
 */
126 432442f9 Leszek Koltunski
  public static void onCreate(final Context context)
127
  throws FragmentCompilationException,VertexCompilationException,VertexUniformsException,FragmentUniformsException,LinkingException
128 d6e94c84 Leszek Koltunski
    {
129 30beb34f Leszek Koltunski
    final ActivityManager activityManager     = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
130
    final ConfigurationInfo configurationInfo = activityManager.getDeviceConfigurationInfo();
131
    android.util.Log.e("DISTORTED", "Using OpenGL ES "+configurationInfo.getGlEsVersion());
132 6672d895 Leszek Koltunski
    /*
133
    android.util.Log.e("DISTORTED", "GLSL Version "+GLES31.glGetString(GLES31.GL_SHADING_LANGUAGE_VERSION));
134
    android.util.Log.e("DISTORTED", "GL Version "  +GLES31.glGetString(GLES31.GL_VERSION));
135
    android.util.Log.e("DISTORTED", "GL Vendor "   +GLES31.glGetString(GLES31.GL_VENDOR));
136
    android.util.Log.e("DISTORTED", "GL Renderer " +GLES31.glGetString(GLES31.GL_RENDERER));
137
    */
138 47511918 Leszek Koltunski
    GLSL = ( (configurationInfo.reqGlEsVersion>>16)>=3 ? 310 : 100 );
139
    GLSL_VERSION= (GLSL==100 ? "#version 100\n" : "#version 310 es\n");
140 94f6d472 Leszek Koltunski
141 0e924ba5 Leszek Koltunski
    EffectMessageSender.startSending();
142
143 d6e94c84 Leszek Koltunski
    final Resources resources = context.getResources();
144 c90b9e01 Leszek Koltunski
    DistortedEffects.createProgram(resources);
145 aa2f0486 Leszek Koltunski
    PostprocessEffect.createPrograms();
146 c90b9e01 Leszek Koltunski
147
    mInitialized = true;
148 6a06a912 Leszek Koltunski
    }
149
150 05ecc6fe Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
151
/**
152 78e89fb5 Leszek Koltunski
 * Call this so that the Library can release the OpenGL related data that needs to be recreated.
153 05ecc6fe Leszek Koltunski
 * Must be called from Activity.onPause().
154
 */
155
  public static void onPause()
156
    {
157 226144d0 leszek
    DistortedObject.onPause();
158 0c303a2c Leszek Koltunski
    DistortedNode.onPause();
159 78e89fb5 Leszek Koltunski
    DistortedEffects.onPause();
160 05ecc6fe Leszek Koltunski
    }
161
162 6a06a912 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
163
/**
164
 * Call this so that the Library can release its internal data structures.
165
 * Must be called from Activity.onDestroy(). 
166
 */
167
  public static void onDestroy()
168
    {
169 226144d0 leszek
    DistortedObject.onDestroy();
170 a09ada4c Leszek Koltunski
    DistortedNode.onDestroy();
171 421c2728 Leszek Koltunski
    DistortedEffects.onDestroy();
172 efe3d8fe leszek
    DistortedMaster.onDestroy();
173 ce154014 Leszek Koltunski
    DistortedOutputSurface.onDestroy();
174 42571056 Leszek Koltunski
    EffectQueue.onDestroy();
175 26a4e5f6 leszek
    Effect.onDestroy();
176 7cd24173 leszek
    VertexEffect.onDestroy();
177
    FragmentEffect.onDestroy();
178 6a06a912 Leszek Koltunski
    EffectMessageSender.stopSending();
179 f8686932 Leszek Koltunski
180 55c14a19 Leszek Koltunski
    mInitialized = false;
181 6a06a912 Leszek Koltunski
    }
182 a2d56cfd Leszek Koltunski
183
///////////////////////////////////////////////////////////////////////////////////////////////////
184
/**
185
 * Return 2 or 3 depending if we have OpenGL Es 2.0 or 3.x context created.
186
 */
187
  public static int getGlVersion()
188
    {
189
    return GLSL == 300 ? 3:2;
190
    }
191 f8f6d457 leszek
  }