Project

General

Profile

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

library / src / main / java / org / distorted / library / main / DistortedLibrary.java @ 60fdf71d

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.GLES30;
27
import android.opengl.GLES31;
28
import android.util.Log;
29

    
30
import org.distorted.library.R;
31
import org.distorted.library.effect.Effect;
32
import org.distorted.library.effectqueue.EffectQueue;
33
import org.distorted.library.effectqueue.EffectQueuePostprocess;
34
import org.distorted.library.effect.EffectType;
35
import org.distorted.library.effect.FragmentEffect;
36
import org.distorted.library.effect.PostprocessEffect;
37
import org.distorted.library.effect.VertexEffect;
38
import org.distorted.library.mesh.MeshBase;
39
import org.distorted.library.message.EffectMessageSender;
40
import org.distorted.library.program.DistortedProgram;
41
import org.distorted.library.program.VertexCompilationException;
42

    
43
import java.io.InputStream;
44
import java.nio.ByteBuffer;
45
import java.nio.ByteOrder;
46
import java.nio.FloatBuffer;
47
import java.nio.IntBuffer;
48

    
49
///////////////////////////////////////////////////////////////////////////////////////////////////
50
/**
51
 * A singleton class used to control various global dialog_settings.
52
 */
53
public class DistortedLibrary
54
  {
55
  private static int mGLSL;
56
  private static String mGLSL_VERSION;
57
  private static boolean mOITCompilationSuccessful;
58
  /**
59
   * When creating an instance of a DistortedTexture from another instance, clone the Bitmap that's
60
   * backing up our DistortedTexture.
61
   * <p>
62
   * This way we can have two DistortedTextures, both backed up by the same Bitmap, to which we can
63
   * apply different effects. Used in the copy constructor.
64
   */
65
  public static final int CLONE_SURFACE = 0x1;
66
  /**
67
   * When creating an instance of a DistortedEffects from another instance, clone the Matrix Effects.
68
   * <p>
69
   * This way we can have two different DistortedEffects sharing the MATRIX queue.
70
   */
71
  public static final int CLONE_MATRIX = 0x2;
72
  /**
73
   * When creating an instance of a DistortedEffects from another instance, clone the Vertex Effects.
74
   * <p>
75
   * This way we can have two different DistortedEffects sharing the VERTEX queue.
76
   */
77
  public static final int CLONE_VERTEX  = 0x4;
78
  /**
79
   * When creating an instance of a DistortedEffects from another instance, clone the Fragment Effects.
80
   * <p>
81
   * This way we can have two different DistortedEffects sharing the FRAGMENT queue.
82
   */
83
  public static final int CLONE_FRAGMENT= 0x8;
84
   /**
85
   * When creating an instance of a DistortedEffects from another instance, clone the PostProcess Effects.
86
   * <p>
87
   * This way we can have two different DistortedEffects sharing the POSTPROCESS queue.
88
   */
89
  public static final int CLONE_POSTPROCESS= 0x10;
90
  /**
91
   * When creating an instance of a DistortedNode from another instance, clone the children Nodes.
92
   * <p>
93
   * This is mainly useful for creating many similar sub-trees and rendering then at different places
94
   * on the screen with (optionally) different Effects.
95
   */
96
  public static final int CLONE_CHILDREN= 0x20;
97

    
98
  /**
99
   * Work around bugs in ARM Mali driver by, instead to a single FBO, rendering to a circular queue
100
   * of FBO_QUEUE_SIZE FBOs. (otherwise we sometimes get a 'full pipeline flush' and the end result
101
   * might be missing part of the Objects)
102
   *
103
   * This bug only exists on Mali driver r12.
104
   *
105
   * https://community.arm.com/graphics/f/discussions/10285/opengl-es-3-1-on-mali-t880-flashes
106
   */
107
  static final int FBO_QUEUE_SIZE = 4;
108

    
109
  private static boolean mInitialized=false;
110

    
111
  //////////////////////////////////////////////////////////////////////////////////////////////
112
  /// MAIN PROGRAM ///
113
  private static DistortedProgram mMainProgram;
114
  private static int mMainTextureH;
115

    
116
  /// NORMAL PROGRAM /////
117
  private static DistortedProgram mNormalProgram;
118
  private static int mNormalMVPMatrixH;
119

    
120
  /// MAIN OIT PROGRAM ///
121
  private static DistortedProgram mMainOITProgram;
122
  private static int mMainOITTextureH;
123
  private static int mMainOITSizeH;
124
  private static int mMainOITNumRecordsH;
125

    
126
  /// BLIT PROGRAM ///
127
  private static DistortedProgram mBlitProgram;
128
  private static int mBlitTextureH;
129
  private static int mBlitDepthH;
130
  private static final FloatBuffer mQuadPositions;
131

    
132
  /// FULL PROGRAM ///
133
  private static DistortedProgram mFullProgram;
134

    
135
  static
136
    {
137
    float[] positionData= { -0.5f, -0.5f,  -0.5f, 0.5f,  0.5f,-0.5f,  0.5f, 0.5f };
138
    mQuadPositions = ByteBuffer.allocateDirect(32).order(ByteOrder.nativeOrder()).asFloatBuffer();
139
    mQuadPositions.put(positionData).position(0);
140
    }
141

    
142
  /// BLIT DEPTH PROGRAM ///
143
  private static DistortedProgram mBlitDepthProgram;
144
  private static int mBlitDepthTextureH;
145
  private static int mBlitDepthDepthTextureH;
146
  private static int mBlitDepthDepthH;
147
  private static int mBlitDepthTexCorrH;
148

    
149
  /// OIT SSBO BUFFER ///
150
  private static int[] mLinkedListSSBO = new int[1];
151
  private static int[] mAtomicCounter = new int[DistortedLibrary.FBO_QUEUE_SIZE];
152
  private static int   mCurrBuffer;
153

    
154
  static
155
    {
156
    mLinkedListSSBO[0]= -1;
157
    mCurrBuffer       =  0;
158

    
159
    for(int i = 0; i< DistortedLibrary.FBO_QUEUE_SIZE; i++)  mAtomicCounter[i] = -1;
160
    }
161

    
162
  ///////////////////////////////////////////////////////////////
163
  // meaning: allocate 1.0 screenful of places for transparent
164
  // fragments in the SSBO backing up the OIT render method.
165
  private static float mBufferSize=1.0f;
166

    
167
  /// OIT CLEAR PROGRAM ///
168
  private static DistortedProgram mOITClearProgram;
169
  private static int mOITClearDepthH;
170
  private static int mOITClearTexCorrH;
171
  private static int mOITClearSizeH;
172

    
173
  /// OIT BUILD PROGRAM ///
174
  private static DistortedProgram mOITBuildProgram;
175
  private static int mOITBuildTextureH;
176
  private static int mOITBuildDepthTextureH;
177
  private static int mOITBuildDepthH;
178
  private static int mOITBuildTexCorrH;
179
  private static int mOITBuildSizeH;
180
  private static int mOITBuildNumRecordsH;
181

    
182
  /// OIT COLLAPSE PROGRAM ///
183
  private static DistortedProgram mOITCollapseProgram;
184
  private static int mOITCollapseDepthTextureH;
185
  private static int mOITCollapseDepthH;
186
  private static int mOITCollapseTexCorrH;
187
  private static int mOITCollapseSizeH;
188

    
189
  /// OIT RENDER PROGRAM ///
190
  private static DistortedProgram mOITRenderProgram;
191
  private static int mOITRenderDepthH;
192
  private static int mOITRenderTexCorrH;
193
  private static int mOITRenderSizeH;
194

    
195
  /// END PROGRAMS //////
196

    
197
///////////////////////////////////////////////////////////////////////////////////////////////////
198
// private: hide this from Javadoc
199

    
200
  private DistortedLibrary()
201
    {
202

    
203
    }
204

    
205
///////////////////////////////////////////////////////////////////////////////////////////////////
206

    
207
  private static void createPrograms(Resources resources)
208
    {
209
    // MAIN PROGRAM ////////////////////////////////////
210
    final InputStream mainVertStream = resources.openRawResource(R.raw.main_vertex_shader);
211
    final InputStream mainFragStream = resources.openRawResource(R.raw.main_fragment_shader);
212

    
213
    int numF = FragmentEffect.getNumEnabled();
214
    int numV = VertexEffect.getNumEnabled();
215

    
216
    String mainVertHeader= mGLSL_VERSION + ("#define NUM_VERTEX "   + ( numV>0 ? getMax(EffectType.VERTEX  ) : 0 ) + "\n");
217
    String mainFragHeader= mGLSL_VERSION + ("#define NUM_FRAGMENT " + ( numF>0 ? getMax(EffectType.FRAGMENT) : 0 ) + "\n");
218

    
219
    mainVertHeader += "#define MAX_COMPON " + MeshBase.getMaxComponents() + "\n";
220

    
221
    String enabledEffectV= VertexEffect.getGLSL();
222
    String enabledEffectF= FragmentEffect.getGLSL();
223

    
224
    String[] feedback = { "v_Position", "v_endPosition" };
225

    
226
    try
227
      {
228
      mMainProgram = new DistortedProgram(mainVertStream, mainFragStream, mainVertHeader, mainFragHeader,
229
                                          enabledEffectV, enabledEffectF, mGLSL, feedback);
230
      }
231
    catch(Exception e)
232
      {
233
      Log.e("EFFECTS", e.getClass().getSimpleName()+" trying to compile MAIN program: "+e.getMessage());
234
      throw new RuntimeException(e.getMessage());
235
      }
236

    
237
    int mainProgramH = mMainProgram.getProgramHandle();
238
    EffectQueue.getUniforms(mainProgramH,0);
239
    MeshBase.getUniforms(mainProgramH,0);
240
    mMainTextureH= GLES30.glGetUniformLocation( mainProgramH, "u_Texture");
241

    
242
    // BLIT PROGRAM ////////////////////////////////////
243
    final InputStream blitVertStream = resources.openRawResource(R.raw.blit_vertex_shader);
244
    final InputStream blitFragStream = resources.openRawResource(R.raw.blit_fragment_shader);
245

    
246
    try
247
      {
248
      mBlitProgram = new DistortedProgram(blitVertStream,blitFragStream, mGLSL_VERSION, mGLSL_VERSION, mGLSL);
249
      }
250
    catch(Exception e)
251
      {
252
      Log.e("EFFECTS", e.getClass().getSimpleName()+" trying to compile BLIT program: "+e.getMessage());
253
      throw new RuntimeException(e.getMessage());
254
      }
255

    
256
    int blitProgramH = mBlitProgram.getProgramHandle();
257
    mBlitTextureH  = GLES30.glGetUniformLocation( blitProgramH, "u_Texture");
258
    mBlitDepthH    = GLES30.glGetUniformLocation( blitProgramH, "u_Depth");
259

    
260
    // BLIT DEPTH PROGRAM ////////////////////////////////////
261
    final InputStream blitDepthVertStream = resources.openRawResource(R.raw.blit_depth_vertex_shader);
262
    final InputStream blitDepthFragStream = resources.openRawResource(R.raw.blit_depth_fragment_shader);
263

    
264
    try
265
      {
266
      mBlitDepthProgram = new DistortedProgram(blitDepthVertStream,blitDepthFragStream, mGLSL_VERSION, mGLSL_VERSION, mGLSL);
267
      }
268
    catch(Exception e)
269
      {
270
      Log.e("EFFECTS", e.getClass().getSimpleName()+" trying to compile BLIT DEPTH program: "+e.getMessage());
271
      throw new RuntimeException(e.getMessage());
272
      }
273

    
274
    int blitDepthProgramH   = mBlitDepthProgram.getProgramHandle();
275
    mBlitDepthTextureH      = GLES30.glGetUniformLocation( blitDepthProgramH, "u_Texture");
276
    mBlitDepthDepthTextureH = GLES30.glGetUniformLocation( blitDepthProgramH, "u_DepthTexture");
277
    mBlitDepthDepthH        = GLES30.glGetUniformLocation( blitDepthProgramH, "u_Depth");
278
    mBlitDepthTexCorrH      = GLES30.glGetUniformLocation( blitDepthProgramH, "u_TexCorr");
279

    
280
    // NORMAL PROGRAM //////////////////////////////////////
281
    final InputStream normalVertexStream   = resources.openRawResource(R.raw.normal_vertex_shader);
282
    final InputStream normalFragmentStream = resources.openRawResource(R.raw.normal_fragment_shader);
283

    
284
    try
285
      {
286
      mNormalProgram = new DistortedProgram(normalVertexStream,normalFragmentStream, mGLSL_VERSION, mGLSL_VERSION, mGLSL);
287
      }
288
    catch(Exception e)
289
      {
290
      Log.e("EFFECTS", e.getClass().getSimpleName()+" trying to compile NORMAL program: "+e.getMessage());
291
      throw new RuntimeException(e.getMessage());
292
      }
293

    
294
    int normalProgramH = mNormalProgram.getProgramHandle();
295
    mNormalMVPMatrixH  = GLES30.glGetUniformLocation( normalProgramH, "u_MVPMatrix");
296
    }
297

    
298
///////////////////////////////////////////////////////////////////////////////////////////////////
299

    
300
  private static void createFullProgram(Resources resources)
301
    {
302
    final InputStream fullVertStream = resources.openRawResource(R.raw.main_vertex_shader);
303
    final InputStream fullFragStream = resources.openRawResource(R.raw.main_fragment_shader);
304

    
305
    int numV = VertexEffect.getAllEnabled();
306

    
307
    String fullVertHeader= mGLSL_VERSION + ("#define NUM_VERTEX "   + ( numV>0 ? getMax(EffectType.VERTEX ) : 0 ) + "\n");
308
    String fullFragHeader= mGLSL_VERSION + ("#define NUM_FRAGMENT " +                                         0   + "\n");
309

    
310
    fullVertHeader += "#define MAX_COMPON " + MeshBase.getMaxComponents() + "\n";
311

    
312
    String enabledEffectV= VertexEffect.getAllGLSL();
313
    String enabledEffectF= "{}";
314

    
315
    fullVertHeader += "#define PREAPPLY\n";
316

    
317
    String[] feedback = { "v_Position", "v_endPosition", "v_Inflate" };
318

    
319
    try
320
      {
321
      mFullProgram = new DistortedProgram(fullVertStream, fullFragStream, fullVertHeader, fullFragHeader,
322
                                          enabledEffectV, enabledEffectF, mGLSL, feedback);
323
      }
324
    catch(Exception e)
325
      {
326
      Log.e("EFFECTS", e.getClass().getSimpleName()+" trying to compile FULL program: "+e.getMessage());
327
      throw new RuntimeException(e.getMessage());
328
      }
329

    
330
    int fullProgramH = mFullProgram.getProgramHandle();
331
    EffectQueue.getUniforms(fullProgramH,3);
332
    MeshBase.getUniforms(fullProgramH,3);
333
    }
334

    
335
///////////////////////////////////////////////////////////////////////////////////////////////////
336

    
337
  private static void createProgramsOIT(Resources resources)
338
    {
339
    // MAIN OIT PROGRAM ////////////////////////////////
340
    final InputStream mainVertStream = resources.openRawResource(R.raw.main_vertex_shader);
341
    final InputStream mainFragStream = resources.openRawResource(R.raw.main_fragment_shader);
342

    
343
    int numF = FragmentEffect.getNumEnabled();
344
    int numV = VertexEffect.getNumEnabled();
345

    
346
    String mainVertHeader= mGLSL_VERSION + ("#define NUM_VERTEX "   + ( numV>0 ? getMax(EffectType.VERTEX  ) : 0 ) + "\n") + ("#define OIT\n");
347
    String mainFragHeader= mGLSL_VERSION + ("#define NUM_FRAGMENT " + ( numF>0 ? getMax(EffectType.FRAGMENT) : 0 ) + "\n") + ("#define OIT\n");
348

    
349
    mainVertHeader += "#define MAX_COMPON " + MeshBase.getMaxComponents() + "\n";
350

    
351
    String enabledEffectV= VertexEffect.getGLSL();
352
    String enabledEffectF= FragmentEffect.getGLSL();
353

    
354
    try
355
      {
356
      mMainOITProgram = new DistortedProgram(mainVertStream, mainFragStream, mainVertHeader, mainFragHeader,
357
                                             enabledEffectV, enabledEffectF, mGLSL, null);
358
      }
359
    catch(Exception e)
360
      {
361
      Log.e("EFFECTS", e.getClass().getSimpleName()+" trying to compile MAIN OIT program: "+e.getMessage());
362
      throw new RuntimeException(e.getMessage());
363
      }
364

    
365
    int mainOITProgramH = mMainOITProgram.getProgramHandle();
366
    EffectQueue.getUniforms(mainOITProgramH,1);
367
    MeshBase.getUniforms(mainOITProgramH,1);
368
    mMainOITTextureH    = GLES30.glGetUniformLocation( mainOITProgramH, "u_Texture");
369
    mMainOITSizeH       = GLES30.glGetUniformLocation( mainOITProgramH, "u_Size");
370
    mMainOITNumRecordsH = GLES30.glGetUniformLocation( mainOITProgramH, "u_numRecords");
371

    
372
    // OIT CLEAR PROGRAM ////////////////////////////////////
373
    final InputStream oitClearVertStream = resources.openRawResource(R.raw.oit_vertex_shader);
374
    final InputStream oitClearFragStream = resources.openRawResource(R.raw.oit_clear_fragment_shader);
375

    
376
    try
377
      {
378
      mOITClearProgram = new DistortedProgram(oitClearVertStream,oitClearFragStream, mGLSL_VERSION, mGLSL_VERSION, mGLSL);
379
      }
380
    catch(Exception e)
381
      {
382
      Log.e("EFFECTS", e.getClass().getSimpleName()+" trying to compile OIT CLEAR program: "+e.getMessage());
383
      throw new RuntimeException(e.getMessage());
384
      }
385

    
386
    int oitClearProgramH   = mOITClearProgram.getProgramHandle();
387
    mOITClearDepthH        = GLES30.glGetUniformLocation( oitClearProgramH, "u_Depth");
388
    mOITClearTexCorrH      = GLES30.glGetUniformLocation( oitClearProgramH, "u_TexCorr");
389
    mOITClearSizeH         = GLES30.glGetUniformLocation( oitClearProgramH, "u_Size");
390

    
391
    // OIT BUILD PROGRAM ////////////////////////////////////
392
    final InputStream oitBuildVertStream = resources.openRawResource(R.raw.oit_vertex_shader);
393
    final InputStream oitBuildFragStream = resources.openRawResource(R.raw.oit_build_fragment_shader);
394

    
395
    try
396
      {
397
      mOITBuildProgram = new DistortedProgram(oitBuildVertStream,oitBuildFragStream, mGLSL_VERSION, mGLSL_VERSION, mGLSL);
398
      }
399
    catch(Exception e)
400
      {
401
      Log.e("EFFECTS", e.getClass().getSimpleName()+" trying to compile OIT BUILD program: "+e.getMessage());
402
      throw new RuntimeException(e.getMessage());
403
      }
404

    
405
    int oitBuildProgramH   = mOITBuildProgram.getProgramHandle();
406
    mOITBuildTextureH      = GLES30.glGetUniformLocation( oitBuildProgramH, "u_Texture");
407
    mOITBuildDepthTextureH = GLES30.glGetUniformLocation( oitBuildProgramH, "u_DepthTexture");
408
    mOITBuildDepthH        = GLES30.glGetUniformLocation( oitBuildProgramH, "u_Depth");
409
    mOITBuildTexCorrH      = GLES30.glGetUniformLocation( oitBuildProgramH, "u_TexCorr");
410
    mOITBuildSizeH         = GLES30.glGetUniformLocation( oitBuildProgramH, "u_Size");
411
    mOITBuildNumRecordsH   = GLES30.glGetUniformLocation( oitBuildProgramH, "u_numRecords");
412

    
413
    // OIT COLLAPSE PROGRAM ///////////////////////////
414
    final InputStream oitCollapseVertStream = resources.openRawResource(R.raw.oit_vertex_shader);
415
    final InputStream oitCollapseFragStream = resources.openRawResource(R.raw.oit_collapse_fragment_shader);
416

    
417
    try
418
      {
419
      mOITCollapseProgram = new DistortedProgram(oitCollapseVertStream,oitCollapseFragStream, mGLSL_VERSION, mGLSL_VERSION, mGLSL);
420
      }
421
    catch(Exception e)
422
      {
423
      Log.e("EFFECTS", e.getClass().getSimpleName()+" trying to compile OIT COLLAPSE program: "+e.getMessage());
424
      throw new RuntimeException(e.getMessage());
425
      }
426

    
427
    int oitCollapseProgramH   = mOITCollapseProgram.getProgramHandle();
428
    mOITCollapseDepthTextureH = GLES30.glGetUniformLocation( oitCollapseProgramH, "u_DepthTexture");
429
    mOITCollapseDepthH        = GLES30.glGetUniformLocation( oitCollapseProgramH, "u_Depth");
430
    mOITCollapseTexCorrH      = GLES30.glGetUniformLocation( oitCollapseProgramH, "u_TexCorr");
431
    mOITCollapseSizeH         = GLES30.glGetUniformLocation( oitCollapseProgramH, "u_Size");
432

    
433
    // OIT RENDER PROGRAM ///////////////////////////
434
    final InputStream oitRenderVertStream = resources.openRawResource(R.raw.oit_vertex_shader);
435
    final InputStream oitRenderFragStream = resources.openRawResource(R.raw.oit_render_fragment_shader);
436

    
437
    try
438
      {
439
      mOITRenderProgram = new DistortedProgram(oitRenderVertStream,oitRenderFragStream, mGLSL_VERSION, mGLSL_VERSION, mGLSL);
440
      }
441
    catch(Exception e)
442
      {
443
      Log.e("EFFECTS", e.getClass().getSimpleName()+" trying to compile OIT RENDER program: "+e.getMessage());
444
      throw new RuntimeException(e.getMessage());
445
      }
446

    
447
    int oitRenderProgramH   = mOITRenderProgram.getProgramHandle();
448
    mOITRenderDepthH        = GLES30.glGetUniformLocation( oitRenderProgramH, "u_Depth");
449
    mOITRenderTexCorrH      = GLES30.glGetUniformLocation( oitRenderProgramH, "u_TexCorr");
450
    mOITRenderSizeH         = GLES30.glGetUniformLocation( oitRenderProgramH, "u_Size");
451
    }
452

    
453
///////////////////////////////////////////////////////////////////////////////////////////////////
454

    
455
  private static void displayNormals(EffectQueue[] queues, MeshBase mesh)
456
    {
457
    int num = mesh.getNumVertices();
458
    int tfo = mesh.getTFO();
459

    
460
    GLES30.glBindBufferBase(GLES30.GL_TRANSFORM_FEEDBACK_BUFFER, 0, tfo );
461
    GLES30.glBeginTransformFeedback( GLES30.GL_POINTS);
462
    InternalRenderState.switchOffDrawing();
463
    GLES30.glDrawArrays( GLES30.GL_POINTS, 0, num );
464
    InternalRenderState.restoreDrawing();
465
    GLES30.glEndTransformFeedback();
466
    GLES30.glBindBufferBase(GLES30.GL_TRANSFORM_FEEDBACK_BUFFER, 0, 0);
467

    
468
    mNormalProgram.useProgram();
469
    GLES30.glUniformMatrix4fv(mNormalMVPMatrixH, 1, false, EffectQueue.getMVP(queues) , 0);
470
    mesh.bindTransformAttribs(mNormalProgram);
471
    GLES30.glLineWidth(8.0f);
472
    GLES30.glDrawArrays(GLES30.GL_LINES, 0, 2*num);
473
    }
474

    
475
///////////////////////////////////////////////////////////////////////////////////////////////////
476
// execute all VertexEffects and adjust all vertices
477

    
478
  public static void adjustVertices(MeshBase mesh)
479
    {
480
    if( mFullProgram!=null )
481
      {
482
      GLES30.glViewport(0, 0, 500, 500 ); // this is fine, we don't need viewport at all
483

    
484
      int num = mesh.getNumVertices();
485
      int tfo = mesh.getTFO();
486

    
487
      mFullProgram.useProgram();
488
      mesh.bindVertexAttribs(mFullProgram);
489
      mesh.computeQueue();
490
      mesh.sendQueue();
491
      mesh.send(3);
492

    
493
      GLES30.glBindBufferBase(GLES30.GL_TRANSFORM_FEEDBACK_BUFFER, 0, tfo );
494
      GLES30.glBeginTransformFeedback( GLES30.GL_POINTS);
495
      InternalRenderState.switchOffDrawing();
496
      GLES30.glDrawArrays( GLES30.GL_POINTS, 0, num );
497
      InternalRenderState.restoreDrawing();
498
      GLES30.glEndTransformFeedback();
499
      mesh.copyTransformToVertex();
500
      GLES30.glBindBufferBase(GLES30.GL_TRANSFORM_FEEDBACK_BUFFER, 0, 0);
501
      }
502
    }
503

    
504
///////////////////////////////////////////////////////////////////////////////////////////////////
505

    
506
  static void drawPrivOIT(DistortedEffects effects, MeshBase mesh, InternalOutputSurface surface, long currTime)
507
    {
508
    EffectQueue[] queues = effects.getQueues();
509

    
510
    EffectQueue.compute(queues, currTime);
511
    GLES30.glViewport(0, 0, surface.mWidth, surface.mHeight );
512

    
513
    DistortedLibrary.mMainOITProgram.useProgram();
514
    GLES30.glUniform1i(DistortedLibrary.mMainOITTextureH, 0);
515
    GLES30.glUniform2ui(DistortedLibrary.mMainOITSizeH, surface.mWidth, surface.mHeight);
516
    GLES30.glUniform1ui(DistortedLibrary.mMainOITNumRecordsH, (int)(DistortedLibrary.mBufferSize*surface.mWidth*surface.mHeight) );
517
    mesh.bindVertexAttribs(DistortedLibrary.mMainOITProgram);
518
    mesh.send(1);
519

    
520
    float inflate     = mesh.getInflate();
521
    float distance    = surface.mDistance;
522
    float mipmap      = surface.mMipmap;
523
    float[] projection= surface.mProjectionMatrix;
524

    
525
    EffectQueue.send(queues, distance, mipmap, projection, inflate, mesh, 1 );
526
    GLES30.glDrawArrays(GLES30.GL_TRIANGLE_STRIP, 0, mesh.getNumVertices() );
527

    
528
    if( mesh.getShowNormals() )
529
      {
530
      DistortedLibrary.mMainProgram.useProgram();
531
      mesh.send(0);
532
      EffectQueue.send(queues, distance, mipmap, projection, inflate, mesh, 0 );
533
      displayNormals(queues,mesh);
534
      }
535
    }
536

    
537
///////////////////////////////////////////////////////////////////////////////////////////////////
538

    
539
  static void drawPriv(DistortedEffects effects, MeshBase mesh, InternalOutputSurface surface, long currTime)
540
    {
541
    if( mMainProgram!=null )
542
      {
543
      EffectQueue[] queues = effects.getQueues();
544

    
545
      EffectQueue.compute(queues, currTime);
546
      GLES30.glViewport(0, 0, surface.mWidth, surface.mHeight );
547

    
548
      mMainProgram.useProgram();
549
      GLES30.glUniform1i(DistortedLibrary.mMainTextureH, 0);
550
      mesh.bindVertexAttribs(DistortedLibrary.mMainProgram);
551
      mesh.send(0);
552

    
553
      float inflate     = mesh.getInflate();
554
      float distance    = surface.mDistance;
555
      float mipmap      = surface.mMipmap;
556
      float[] projection= surface.mProjectionMatrix;
557

    
558
      EffectQueue.send(queues, distance, mipmap, projection, inflate, mesh, 0 );
559
      GLES30.glDrawArrays(GLES30.GL_TRIANGLE_STRIP, 0, mesh.getNumVertices() );
560

    
561
      if( mesh.getShowNormals() ) displayNormals(queues,mesh);
562
      }
563
    }
564

    
565
///////////////////////////////////////////////////////////////////////////////////////////////////
566

    
567
  static void blitPriv(InternalOutputSurface surface)
568
    {
569
    if( mBlitProgram!=null )
570
      {
571
      mBlitProgram.useProgram();
572

    
573
      GLES30.glViewport(0, 0, surface.mWidth, surface.mHeight );
574
      GLES30.glUniform1i(mBlitTextureH, 0);
575
      GLES30.glUniform1f( mBlitDepthH , 1.0f-surface.mNear);
576
      GLES30.glVertexAttribPointer(mBlitProgram.mAttribute[0], 2, GLES30.GL_FLOAT, false, 0, mQuadPositions);
577
      GLES30.glDrawArrays(GLES30.GL_TRIANGLE_STRIP, 0, 4);
578
      }
579
    }
580

    
581
///////////////////////////////////////////////////////////////////////////////////////////////////
582

    
583
  static void blitDepthPriv(InternalOutputSurface surface, float corrW, float corrH)
584
    {
585
    if( mBlitDepthProgram!=null )
586
      {
587
      mBlitDepthProgram.useProgram();
588

    
589
      GLES30.glViewport(0, 0, surface.mWidth, surface.mHeight );
590
      GLES30.glUniform1i(mBlitDepthTextureH, 0);
591
      GLES30.glUniform1i(mBlitDepthDepthTextureH, 1);
592
      GLES30.glUniform2f(mBlitDepthTexCorrH, corrW, corrH );
593
      GLES30.glUniform1f( mBlitDepthDepthH , 1.0f-surface.mNear);
594
      GLES30.glVertexAttribPointer(mBlitDepthProgram.mAttribute[0], 2, GLES30.GL_FLOAT, false, 0, mQuadPositions);
595
      GLES30.glDrawArrays(GLES30.GL_TRIANGLE_STRIP, 0, 4);
596
      }
597
    }
598

    
599
///////////////////////////////////////////////////////////////////////////////////////////////////
600
// yes it is safe to be mixing 3.0 and 3.1 like that, senior members of the OpenGL discussions forum assert
601

    
602
  private static int printPreviousBuffer()
603
    {
604
    int counter = 0;
605

    
606
    ByteBuffer atomicBuf = (ByteBuffer)GLES30.glMapBufferRange( GLES31.GL_ATOMIC_COUNTER_BUFFER, 0, 4,
607
                                                                GLES30.GL_MAP_READ_BIT);
608
    if( atomicBuf!=null )
609
      {
610
      IntBuffer atomicIntBuf = atomicBuf.order(ByteOrder.nativeOrder()).asIntBuffer();
611
      counter = atomicIntBuf.get(0);
612
      }
613
    else
614
      {
615
      Log.e("effects", "print: failed to map atomic buffer");
616
      }
617

    
618
    GLES30.glUnmapBuffer(GLES31.GL_ATOMIC_COUNTER_BUFFER);
619

    
620
    return counter;
621
    }
622

    
623
///////////////////////////////////////////////////////////////////////////////////////////////////
624

    
625
  private static void zeroBuffer()
626
    {
627
    ByteBuffer atomicBuf = (ByteBuffer)GLES30.glMapBufferRange( GLES31.GL_ATOMIC_COUNTER_BUFFER, 0, 4,
628
        GLES30.GL_MAP_WRITE_BIT|GLES30.GL_MAP_INVALIDATE_BUFFER_BIT);
629
    if( atomicBuf!=null )
630
      {
631
      IntBuffer atomicIntBuf = atomicBuf.order(ByteOrder.nativeOrder()).asIntBuffer();
632
      atomicIntBuf.put(0,0);
633
      }
634
    else
635
      {
636
      Log.e("effects", "zero: failed to map atomic buffer");
637
      }
638

    
639
    GLES30.glUnmapBuffer(GLES31.GL_ATOMIC_COUNTER_BUFFER);
640
    }
641

    
642
///////////////////////////////////////////////////////////////////////////////////////////////////
643
// reset atomic counter to 0
644

    
645
  static int zeroOutAtomic()
646
    {
647
    int counter = 0;
648

    
649
    if( mAtomicCounter[0]<0 )
650
      {
651
      GLES30.glGenBuffers(DistortedLibrary.FBO_QUEUE_SIZE,mAtomicCounter,0);
652

    
653
      for(int i = 0; i< DistortedLibrary.FBO_QUEUE_SIZE; i++)
654
        {
655
        GLES30.glBindBuffer(GLES31.GL_ATOMIC_COUNTER_BUFFER, mAtomicCounter[i]);
656
        GLES30.glBufferData(GLES31.GL_ATOMIC_COUNTER_BUFFER, 4, null, GLES30.GL_DYNAMIC_DRAW);
657
        zeroBuffer();
658
        }
659
      }
660

    
661
    // reading the value of the buffer on every frame would slow down rendering by
662
    // dialog_about 3%; doing it only once every 5 frames affects speed by less than 1%.
663
    if( mCurrBuffer==0 )
664
      {
665
      GLES30.glBindBufferBase(GLES31.GL_ATOMIC_COUNTER_BUFFER, 0, mAtomicCounter[mCurrBuffer]);
666
      counter = printPreviousBuffer();
667
      }
668

    
669
    if( ++mCurrBuffer>= DistortedLibrary.FBO_QUEUE_SIZE ) mCurrBuffer = 0;
670

    
671
    GLES30.glBindBufferBase(GLES31.GL_ATOMIC_COUNTER_BUFFER, 0, mAtomicCounter[mCurrBuffer]);
672
    zeroBuffer();
673

    
674
    return counter;
675
    }
676

    
677
///////////////////////////////////////////////////////////////////////////////////////////////////
678
// Pass1 of the OIT algorithm. Clear per-pixel head-pointers.
679

    
680
  static void oitClear(InternalOutputSurface surface, int counter)
681
    {
682
    if( mOITClearProgram!=null )
683
      {
684
      if( mLinkedListSSBO[0]<0 )
685
        {
686
        GLES30.glGenBuffers(1,mLinkedListSSBO,0);
687

    
688
        int size = (int)(surface.mWidth*surface.mHeight*(3*mBufferSize+1)*4);
689
        GLES30.glBindBuffer(GLES31.GL_SHADER_STORAGE_BUFFER, mLinkedListSSBO[0]);
690
        GLES30.glBufferData(GLES31.GL_SHADER_STORAGE_BUFFER, size, null, GLES30.GL_DYNAMIC_READ|GLES30.GL_DYNAMIC_DRAW);
691
        GLES30.glBindBuffer(GLES31.GL_SHADER_STORAGE_BUFFER, 0);
692

    
693
        GLES30.glBindBufferBase(GLES31.GL_SHADER_STORAGE_BUFFER, 1, mLinkedListSSBO[0]);
694
        }
695

    
696
      // See if we have overflown the SSBO in one of the previous frames.
697
      // If yes, assume we need to make the SSBO larger.
698
      float overflow = counter/(mBufferSize*surface.mWidth*surface.mHeight);
699

    
700
      if( overflow>1.0f )
701
        {
702
        //android.util.Log.e("effects", "previous frame rendered "+counter+
703
        //                   " fragments, but there was only "+(mBufferSize*surface.mWidth*surface.mHeight)+" space");
704

    
705
        mBufferSize *= (int)(overflow+1.0f);
706
        int size = (int)(surface.mWidth*surface.mHeight*(3*mBufferSize+1)*4);
707
        GLES30.glBindBuffer(GLES31.GL_SHADER_STORAGE_BUFFER, mLinkedListSSBO[0]);
708
        GLES30.glBufferData(GLES31.GL_SHADER_STORAGE_BUFFER, size, null, GLES30.GL_DYNAMIC_READ|GLES30.GL_DYNAMIC_DRAW);
709
        GLES30.glBindBuffer(GLES31.GL_SHADER_STORAGE_BUFFER, 0);
710
        }
711

    
712
      mOITClearProgram.useProgram();
713

    
714
      GLES30.glViewport(0, 0, surface.mWidth, surface.mHeight );
715
      GLES30.glUniform2f(mOITClearTexCorrH, 1.0f, 1.0f );   // corrections do not really matter here - only present because of common vertex shader.
716
      GLES30.glUniform1f( mOITClearDepthH , 1.0f);          // likewise depth
717
      GLES30.glUniform2ui(mOITClearSizeH, surface.mWidth, surface.mHeight);
718
      GLES30.glVertexAttribPointer(mOITClearProgram.mAttribute[0], 2, GLES30.GL_FLOAT, false, 0, mQuadPositions);
719
      GLES30.glDrawArrays(GLES30.GL_TRIANGLE_STRIP, 0, 4);
720
      }
721
    }
722

    
723
///////////////////////////////////////////////////////////////////////////////////////////////////
724
// Pass2 of the OIT algorithm - build per-pixel linked lists.
725

    
726
  static void oitBuild(InternalOutputSurface surface, float corrW, float corrH)
727
    {
728
    if( mOITBuildProgram!=null )
729
      {
730
      mOITBuildProgram.useProgram();
731

    
732
      GLES30.glViewport(0, 0, surface.mWidth, surface.mHeight );
733
      GLES30.glUniform1i(mOITBuildTextureH, 0);
734
      GLES30.glUniform1i(mOITBuildDepthTextureH, 1);
735
      GLES30.glUniform2f(mOITBuildTexCorrH, corrW, corrH );
736
      GLES30.glUniform2ui(mOITBuildSizeH, surface.mWidth, surface.mHeight);
737
      GLES30.glUniform1ui(mOITBuildNumRecordsH, (int)(mBufferSize*surface.mWidth*surface.mHeight) );
738
      GLES30.glUniform1f(mOITBuildDepthH , 1.0f-surface.mNear);
739
      GLES30.glVertexAttribPointer(mOITBuildProgram.mAttribute[0], 2, GLES30.GL_FLOAT, false, 0, mQuadPositions);
740
      GLES30.glDrawArrays(GLES30.GL_TRIANGLE_STRIP, 0, 4);
741
      }
742
    }
743

    
744
///////////////////////////////////////////////////////////////////////////////////////////////////
745
// Pass3 of the OIT algorithm. Cut occluded parts of the linked list.
746

    
747
  static void oitCollapse(InternalOutputSurface surface, float corrW, float corrH)
748
    {
749
    if( mOITCollapseProgram!=null )
750
      {
751
      mOITCollapseProgram.useProgram();
752

    
753
      GLES30.glViewport(0, 0, surface.mWidth, surface.mHeight );
754
      GLES30.glUniform1i(mOITCollapseDepthTextureH, 1);
755
      GLES30.glUniform2f(mOITCollapseTexCorrH, corrW, corrH );
756
      GLES30.glUniform2ui(mOITCollapseSizeH, surface.mWidth, surface.mHeight);
757
      GLES30.glUniform1f( mOITCollapseDepthH , 1.0f-surface.mNear);
758
      GLES30.glVertexAttribPointer(mOITCollapseProgram.mAttribute[0], 2, GLES30.GL_FLOAT, false, 0, mQuadPositions);
759
      GLES30.glDrawArrays(GLES30.GL_TRIANGLE_STRIP, 0, 4);
760
      }
761
    }
762

    
763
///////////////////////////////////////////////////////////////////////////////////////////////////
764
// Pass4 of the OIT algorithm. Render all the transparent pixels from the per-pixel linked lists.
765

    
766
  static void oitRender(InternalOutputSurface surface, float corrW, float corrH)
767
    {
768
    if( mOITRenderProgram!=null )
769
      {
770
      mOITRenderProgram.useProgram();
771

    
772
      GLES30.glViewport(0, 0, surface.mWidth, surface.mHeight );
773
      GLES30.glUniform2f(mOITRenderTexCorrH, corrW, corrH );
774
      GLES30.glUniform2ui(mOITRenderSizeH, surface.mWidth, surface.mHeight);
775
      GLES30.glUniform1f( mOITRenderDepthH , 1.0f-surface.mNear);
776
      GLES30.glVertexAttribPointer(mOITRenderProgram.mAttribute[0], 2, GLES30.GL_FLOAT, false, 0, mQuadPositions);
777
      GLES30.glDrawArrays(GLES30.GL_TRIANGLE_STRIP, 0, 4);
778
      }
779
    }
780

    
781
///////////////////////////////////////////////////////////////////////////////////////////////////
782

    
783
  static void setSSBOSize(float size)
784
    {
785
    mBufferSize = size;
786
    }
787

    
788
///////////////////////////////////////////////////////////////////////////////////////////////////
789
// ARM Mali driver r12 has problems when we keep swapping many FBOs (fixed in r22)
790
// PowerVR GE8100 / GE8300 compiler fails to compile OIT programs.
791

    
792
  private static void detectBuggyDrivers()
793
    {
794
    String vendor  = GLES30.glGetString(GLES30.GL_VENDOR);
795
    String version = GLES30.glGetString(GLES30.GL_VERSION);
796
    String renderer= GLES30.glGetString(GLES30.GL_RENDERER);
797

    
798
    /*
799
    android.util.Log.e("DISTORTED", "GLSL Version "+GLES30.glGetString(GLES31.GL_SHADING_LANGUAGE_VERSION));
800
    android.util.Log.e("DISTORTED", "GL Version "  +GLES30.glGetString(GLES31.GL_VERSION));
801
    android.util.Log.e("DISTORTED", "GL Vendor "   +GLES30.glGetString(GLES31.GL_VENDOR));
802
    android.util.Log.e("DISTORTED", "GL Renderer " +GLES30.glGetString(GLES31.GL_RENDERER));
803
    */
804

    
805
    if( vendor.contains("ARM") )
806
      {
807
      if( version.contains("r12") )
808
        {
809
        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.");
810
        }
811
      }
812
    else if( vendor.contains("Imagination") )
813
      {
814
      if( renderer.contains("GE8") )
815
        {
816
        Log.e("DISTORTED", "You are running this on a PowerVR GE8XXX.\nDue to a buggy compiler OIT rendering will not work");
817
        Log.e("DISTORTED", "GLSL Version "+GLES30.glGetString(GLES31.GL_SHADING_LANGUAGE_VERSION));
818
        }
819
      }
820
    }
821

    
822
///////////////////////////////////////////////////////////////////////////////////////////////////
823
/**
824
 * Return OpenGL ES version supported by the hardware we are running on.
825
 * There are only three possibilities: 300 (OpenGL ES 3.0) or 310 (at least OpenGL ES 3.1)
826
 * or 200 (OpenGL ES 2.0)
827
 */
828
  public static int getGLSL()
829
    {
830
    return mGLSL;
831
    }
832

    
833
///////////////////////////////////////////////////////////////////////////////////////////////////
834
/**
835
 * Have we successfully managed to compile the OIT programs?
836
 * Some hardware ( Imagination GE8100 / 8300, driver build 1.8@4490469 present in my HTC phone and,
837
 * sadly, Amazon Fire Stick 4K ) fails to compile the shaders. See relevant thread in Imagination's
838
 * support forum:
839
 *
840
 * https://forums.imgtec.com/t/ge8100-in-htc-desire-12-android-7-1-1-fragment-shader-fails-to-compile/2708
841
 */
842
  public static boolean OITCompilationSuccessful()
843
    {
844
    return mOITCompilationSuccessful;
845
    }
846

    
847
///////////////////////////////////////////////////////////////////////////////////////////////////
848
/**
849
 * Have we called onCreate yet, ie have we initialized the library?
850
 * @return <code>true</code> if the library is initialized and ready for action.
851
 */
852
  public static boolean isInitialized()
853
    {
854
    return mInitialized;
855
    }
856

    
857
///////////////////////////////////////////////////////////////////////////////////////////////////
858
/**
859
 * When OpenGL context gets created, call this method so that the library can initialise its internal data structures.
860
 * I.e. best called from GLSurfaceView.onCreate().
861
 * <p>
862
 * Needs to be called from a thread holding the OpenGL context.
863
 *   
864
 * @param context Context of the App using the library - used to open up Resources and read Shader code.
865
 */
866
  public static void onCreate(final Context context) throws Exception
867
    {
868
    final ActivityManager activityManager     = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
869
    final ConfigurationInfo configurationInfo = activityManager.getDeviceConfigurationInfo();
870

    
871
    int glESversion = configurationInfo.reqGlEsVersion;
872
    int major = glESversion >> 16;
873
    int minor = glESversion & 0xff;
874

    
875
    if( major< 3 )
876
      {
877
      mGLSL = 100*major + 10*minor;
878
      throw new VertexCompilationException("at least OpenGL ES 3.0 required, this device supports only "+major+"."+minor);
879
      }
880
    else
881
      {
882
      mGLSL = (major==3 && minor==0) ? 300 : 310;
883
      }
884

    
885
    android.util.Log.e("DISTORTED", "Using OpenGL ES "+major+"."+minor);
886
    mGLSL_VERSION = "#version "+mGLSL+" es\n";
887

    
888
    mInitialized = true;
889
    mOITCompilationSuccessful = false;
890

    
891
    detectBuggyDrivers();
892

    
893
    EffectMessageSender.startSending();
894

    
895
    final Resources resources = context.getResources();
896

    
897
    Exception exception=null;
898

    
899
    try
900
      {
901
      createPrograms(resources);
902
      }
903
    catch(Exception ex)
904
      {
905
      exception = ex;
906
      }
907

    
908
    try
909
      {
910
      createFullProgram(resources);
911
      }
912
    catch(Exception ex)
913
      {
914
      exception = ex;
915
      }
916

    
917
    if( mGLSL>=310)
918
      {
919
      try
920
        {
921
        createProgramsOIT(resources);
922
        mOITCompilationSuccessful = true;
923
        }
924
      catch(Exception ex)
925
        {
926
        exception = ex;
927
        }
928
      }
929

    
930
    try
931
      {
932
      EffectQueuePostprocess.createPrograms(resources, mGLSL);
933
      }
934
    catch(Exception ex)
935
      {
936
      exception = ex;
937
      }
938

    
939
    try
940
      {
941
      PostprocessEffect.createPrograms(mGLSL);
942
      }
943
    catch(Exception ex)
944
      {
945
      exception = ex;
946
      }
947

    
948
    if( exception!=null)
949
      {
950
      throw exception;
951
      }
952
    }
953

    
954
///////////////////////////////////////////////////////////////////////////////////////////////////
955
/**
956
 * Call this so that the Library can release the OpenGL related data that needs to be recreated.
957
 * Must be called from Activity.onPause().
958
 */
959
  public static void onPause()
960
    {
961
    InternalObject.onPause();
962

    
963
    mLinkedListSSBO[0]= -1;
964

    
965
    for(int i = 0; i< DistortedLibrary.FBO_QUEUE_SIZE; i++) mAtomicCounter[i] = -1;
966
    }
967

    
968
///////////////////////////////////////////////////////////////////////////////////////////////////
969
/**
970
 * Call this so that the Library can release its internal data structures.
971
 * Must be called from Activity.onDestroy(). 
972
 */
973
  public static void onDestroy()
974
    {
975
    InternalObject.onDestroy();
976
    InternalNodeData.onDestroy();
977
    InternalMaster.onDestroy();
978
    InternalOutputSurface.onDestroy();
979
    DistortedEffects.onDestroy();
980
    EffectQueue.onDestroy();
981
    Effect.onDestroy();
982
    EffectMessageSender.stopSending();
983

    
984
    mInitialized = false;
985
    }
986

    
987
///////////////////////////////////////////////////////////////////////////////////////////////////
988
/**
989
 * Returns the maximum number of effects of a given type that can be simultaneously applied to a
990
 * single (InputSurface,MeshBase) combo.
991
 *
992
 * @param type {@link EffectType}
993
 * @return The maximum number of effects of a given type.
994
 */
995
  @SuppressWarnings("unused")
996
  public static int getMax(EffectType type)
997
    {
998
    return EffectQueue.getMax(type.ordinal());
999
    }
1000

    
1001
///////////////////////////////////////////////////////////////////////////////////////////////////
1002
/**
1003
 * Sets the maximum number of effects that can be stored in a single EffectQueue at one time.
1004
 * This can fail if:
1005
 * <ul>
1006
 * <li>the value of 'max' is outside permitted range (0 &le; max &le; Byte.MAX_VALUE)
1007
 * <li>We try to increase the value of 'max' when it is too late to do so already. It needs to be called
1008
 *     before the Vertex Shader gets compiled, i.e. before the call to {@link DistortedLibrary#onCreate}. After this
1009
 *     time only decreasing the value of 'max' is permitted.
1010
 * <li>Furthermore, this needs to be called before any instances of the DistortedEffects class get created.
1011
 * </ul>
1012
 *
1013
 * @param type {@link EffectType}
1014
 * @param max new maximum number of simultaneous effects. Has to be a non-negative number not greater
1015
 *            than Byte.MAX_VALUE
1016
 * @return <code>true</code> if operation was successful, <code>false</code> otherwise.
1017
 */
1018
  @SuppressWarnings("unused")
1019
  public static boolean setMax(EffectType type, int max)
1020
    {
1021
    return EffectQueue.setMax(type.ordinal(),max);
1022
    }
1023
  }
(3-3/14)