Project

General

Profile

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

library / src / main / java / org / distorted / library / main / Distorted.java @ 7a5e538a

1
///////////////////////////////////////////////////////////////////////////////////////////////////
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
package org.distorted.library.main;
21

    
22
import android.app.ActivityManager;
23
import android.content.Context;
24
import android.content.pm.ConfigurationInfo;
25
import android.content.res.Resources;
26
import android.opengl.GLES31;
27

    
28
import org.distorted.library.effect.Effect;
29
import org.distorted.library.effect.FragmentEffect;
30
import org.distorted.library.effect.PostprocessEffect;
31
import org.distorted.library.effect.VertexEffect;
32
import org.distorted.library.message.EffectMessageSender;
33

    
34
///////////////////////////////////////////////////////////////////////////////////////////////////
35
/**
36
 * A singleton class used to control various global settings.
37
 */
38
public class Distorted 
39
  {
40
  public static final int GLSL = 310;
41
  public static final String GLSL_VERSION= "#version 310 es\n";
42
  /**
43
   * When creating an instance of a DistortedTexture from another instance, clone the Bitmap that's
44
   * backing up our DistortedTexture.
45
   * <p>
46
   * This way we can have two DistortedTextures, both backed up by the same Bitmap, to which we can
47
   * apply different effects. Used in the copy constructor.
48
   */
49
  public static final int CLONE_SURFACE = 0x1;
50
  /**
51
   * When creating an instance of a DistortedEffects from another instance, clone the Matrix Effects.
52
   * <p>
53
   * This way we can have two different DistortedEffects sharing the MATRIX queue.
54
   */
55
  public static final int CLONE_MATRIX = 0x2;
56
  /**
57
   * When creating an instance of a DistortedEffects from another instance, clone the Vertex Effects.
58
   * <p>
59
   * This way we can have two different DistortedEffects sharing the VERTEX queue.
60
   */
61
  public static final int CLONE_VERTEX  = 0x4;
62
  /**
63
   * When creating an instance of a DistortedEffects from another instance, clone the Fragment Effects.
64
   * <p>
65
   * This way we can have two different DistortedEffects sharing the FRAGMENT queue.
66
   */
67
  public static final int CLONE_FRAGMENT= 0x8;
68
   /**
69
   * When creating an instance of a DistortedEffects from another instance, clone the PostProcess Effects.
70
   * <p>
71
   * This way we can have two different DistortedEffects sharing the POSTPROCESS queue.
72
   */
73
  public static final int CLONE_POSTPROCESS= 0x10;
74
  /**
75
   * When creating an instance of a DistortedNode from another instance, clone the children Nodes.
76
   * <p>
77
   * This is mainly useful for creating many similar sub-trees and rendering then at different places
78
   * on the screen with (optionally) different Effects.
79
   */
80
  public static final int CLONE_CHILDREN= 0x20;
81

    
82
  /**
83
   * Work around bugs in ARM Mali driver by, instead to a single FBO, rendering to a circular queue
84
   * of FBO_QUEUE_SIZE FBOs. (otherwise we sometimes get a 'full pipeline flush' and the end result
85
   * might be missing part of the Objects)
86
   *
87
   * This bug only exists on Mali driver r12.
88
   *
89
   * https://community.arm.com/graphics/f/discussions/10285/opengl-es-3-1-on-mali-t880-flashes
90
   */
91
  public static final int FBO_QUEUE_SIZE = 4;
92
  /**
93
   * Number of Main program variants (ATM 3: MAIN, MAIN OIT, PREPROCESS)
94
   */
95
  public static final int MAIN_VARIANTS = 3;
96

    
97
  private static boolean mInitialized=false;
98

    
99
///////////////////////////////////////////////////////////////////////////////////////////////////
100
// private: hide this from Javadoc
101

    
102
  private Distorted()
103
    {
104

    
105
    }
106

    
107
///////////////////////////////////////////////////////////////////////////////////////////////////
108
// ARM Mali driver r12 has problems when we keep swapping many FBOs (fixed in r22)
109
// PowerVR GE8100 compiler fails to compile OIT programs.
110

    
111
  static void detectBuggyDrivers()
112
    {
113
    String vendor  = GLES31.glGetString(GLES31.GL_VENDOR);
114
    String version = GLES31.glGetString(GLES31.GL_VERSION);
115
    String renderer= GLES31.glGetString(GLES31.GL_RENDERER);
116

    
117
    /*
118
    android.util.Log.e("DISTORTED", "GLSL Version "+GLES31.glGetString(GLES31.GL_SHADING_LANGUAGE_VERSION));
119
    android.util.Log.e("DISTORTED", "GL Version "  +GLES31.glGetString(GLES31.GL_VERSION));
120
    android.util.Log.e("DISTORTED", "GL Vendor "   +GLES31.glGetString(GLES31.GL_VENDOR));
121
    android.util.Log.e("DISTORTED", "GL Renderer " +GLES31.glGetString(GLES31.GL_RENDERER));
122
    */
123

    
124
    if( vendor.contains("ARM") )
125
      {
126
      if( version.contains("r12") )
127
        {
128
        android.util.Log.e("DISTORTED", "You are running this on a ARM Mali driver r12.\nThis is a buggy driver, please update to r22. Problems with flashing expected.");
129
        }
130
      }
131
    else if( vendor.contains("Imagination") )
132
      {
133
      if( renderer.contains("GE8") )
134
        {
135
        android.util.Log.e("DISTORTED", "You are running this on a PowerVR GE8XXX.\nDue to a buggy compiler OIT rendering will not work");
136
        }
137
      }
138
    }
139

    
140
///////////////////////////////////////////////////////////////////////////////////////////////////
141
/**
142
 * Have we called onCreate yet, ie have we initialized the library?
143
 * @return <code>true</code> if the library is initialized and ready for action.
144
 */
145
  public static boolean isInitialized()
146
    {
147
    return mInitialized;
148
    }
149

    
150
///////////////////////////////////////////////////////////////////////////////////////////////////
151
/**
152
 * When OpenGL context gets created, you need to call this method so that the library can initialise its internal data structures.
153
 * I.e. best called from GLSurfaceView.onCreate().
154
 * <p>
155
 * Needs to be called from a thread holding the OpenGL context.
156
 *   
157
 * @param context Context of the App using the library - used to open up Resources and read Shader code.
158
 */
159
  public static void onCreate(final Context context) throws Exception
160
    {
161
    final ActivityManager activityManager     = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
162
    final ConfigurationInfo configurationInfo = activityManager.getDeviceConfigurationInfo();
163
    android.util.Log.e("DISTORTED", "Using OpenGL ES "+configurationInfo.getGlEsVersion());
164

    
165
    mInitialized = true;
166

    
167
    detectBuggyDrivers();
168

    
169
    EffectMessageSender.startSending();
170

    
171
    final Resources resources = context.getResources();
172

    
173
    Exception exception=null;
174

    
175
    try
176
      {
177
      DistortedEffects.createPrograms(resources);
178
      }
179
    catch(Exception ex)
180
      {
181
      exception = ex;
182
      }
183

    
184
    try
185
      {
186
      DistortedEffects.createProgramsOIT(resources);
187
      }
188
    catch(Exception ex)
189
      {
190
      exception = ex;
191
      }
192

    
193
    try
194
      {
195
      EffectQueuePostprocess.createPrograms(resources);
196
      }
197
    catch(Exception ex)
198
      {
199
      exception = ex;
200
      }
201

    
202
    try
203
      {
204
      PostprocessEffect.createPrograms();
205
      }
206
    catch(Exception ex)
207
      {
208
      exception = ex;
209
      }
210

    
211
    if( exception!=null)
212
      {
213
      throw exception;
214
      }
215
    }
216

    
217
///////////////////////////////////////////////////////////////////////////////////////////////////
218
/**
219
 * Call this so that the Library can release the OpenGL related data that needs to be recreated.
220
 * Must be called from Activity.onPause().
221
 */
222
  public static void onPause()
223
    {
224
    DistortedObject.onPause();
225
    DistortedEffects.onPause();
226
    }
227

    
228
///////////////////////////////////////////////////////////////////////////////////////////////////
229
/**
230
 * Call this so that the Library can release its internal data structures.
231
 * Must be called from Activity.onDestroy(). 
232
 */
233
  public static void onDestroy()
234
    {
235
    DistortedObject.onDestroy();
236
    DistortedNode.onDestroy();
237
    DistortedEffects.onDestroy();
238
    DistortedMaster.onDestroy();
239
    DistortedOutputSurface.onDestroy();
240
    EffectQueue.onDestroy();
241
    Effect.onDestroy();
242
    VertexEffect.onDestroy();
243
    FragmentEffect.onDestroy();
244
    EffectMessageSender.stopSending();
245

    
246
    mInitialized = false;
247
    }
248
  }
(1-1/17)