Project

General

Profile

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

library / src / main / java / org / distorted / library / main / DistortedOutputSurface.java @ 51a3cbab

1 c5369f1b leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
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 c5369f1b leszek
22 e6519ac8 Leszek Koltunski
import android.opengl.GLES31;
23 af4cc5db Leszek Koltunski
import android.opengl.Matrix;
24 86e99907 leszek
25 3521c6fe leszek
import org.distorted.library.effect.EffectQuality;
26
27 12f45260 Leszek Koltunski
import java.nio.ByteBuffer;
28
import java.nio.ByteOrder;
29 66ace7f5 Leszek Koltunski
import java.nio.IntBuffer;
30 a09ada4c Leszek Koltunski
import java.util.ArrayList;
31 af4cc5db Leszek Koltunski
32
///////////////////////////////////////////////////////////////////////////////////////////////////
33 70b6a155 Leszek Koltunski
/**
34
 * This is not really part of the public API.
35
 *
36
 * @y.exclude
37
 */
38
public abstract class DistortedOutputSurface extends DistortedSurface implements DistortedMaster.Slave
39 af4cc5db Leszek Koltunski
{
40 86e99907 leszek
//////////// DEBUG FLAGS /////////////////////////////////////////////
41
/**
42
 * When rendering a Screen, show FPS in the upper-left corner?
43
 */
44
public static final int DEBUG_FPS = 1;
45
//////////// END DEBUG FLAGS /////////////////////////////////////////
46
47 89de975c leszek
/**
48
 * Do not create DEPTH or STENCIL attachment
49
 */
50 23eecbd9 Leszek Koltunski
  public static final int NO_DEPTH_NO_STENCIL = 0;
51 89de975c leszek
/**
52
 * Create DEPTH, but not STENCIL
53
 */
54 23eecbd9 Leszek Koltunski
  public static final int DEPTH_NO_STENCIL    = 1;
55 89de975c leszek
/**
56
 * Create both DEPTH and STENCIL
57
 */
58 23eecbd9 Leszek Koltunski
  public static final int BOTH_DEPTH_STENCIL  = 2;
59 89de975c leszek
60 efe3d8fe leszek
  private static final int ATTACH = 0;
61
  private static final int DETACH = 1;
62
  private static final int DETALL = 2;
63
  private static final int SORT   = 3;
64
65 a09ada4c Leszek Koltunski
  private ArrayList<DistortedNode> mChildren;
66
  private int mNumChildren;   // ==mChildren.length(), but we only create mChildren if the first one gets added
67
68 efe3d8fe leszek
  private class Job
69
    {
70
    int type;
71
    DistortedNode node;
72
73 ffbe7ecf Leszek Koltunski
    Job(int t, DistortedNode n)
74 efe3d8fe leszek
      {
75
      type = t;
76
      node = n;
77
      }
78
    }
79
80
  private ArrayList<Job> mJobs = new ArrayList<>();
81
82 70b6a155 Leszek Koltunski
  DistortedOutputSurface[] mBuffer;
83 60c1c622 leszek
84 95c441a2 leszek
  private long mTime;
85 c2c08950 leszek
  private float mFOV;
86
  float mDistance, mNear;
87 af4cc5db Leszek Koltunski
  float[] mProjectionMatrix;
88
89 89de975c leszek
  int mDepthStencilCreated;
90
  int mDepthStencil;
91
  int[] mDepthStencilH = new int[1];
92
  int[] mFBOH          = new int[1];
93 a436ccc5 leszek
94 a9f41fa3 leszek
  private float mClearR, mClearG, mClearB, mClearA;
95
  private float mClearDepth;
96 23eecbd9 Leszek Koltunski
  private int mClearStencil;
97 ad16ed3b Leszek Koltunski
  private int mClear;
98 78db8663 Leszek Koltunski
  float mMipmap;
99
100 86e99907 leszek
  private int mDebugLevel;
101
102 12f45260 Leszek Koltunski
  ////////////////////////////////////////////////////////////////////////////////
103
  // section dealing with Shader Storage Buffer Object (for counting transparency)
104
  private static final int BUFFERING = 3;
105
  private static int mBufferSize     =10;
106
  private static DistortedObjectCounter mSurfaceCounter = new DistortedObjectCounter();
107
  private static int[] mSSBO = new int[1];
108 66ace7f5 Leszek Koltunski
  private static IntBuffer mIntBuffer;
109 12f45260 Leszek Koltunski
110
  static
111
    {
112 66ace7f5 Leszek Koltunski
    mSSBO[0]= -1;
113 12f45260 Leszek Koltunski
    }
114
115
  private int mSurfaceID;
116
  private int mLastIndex;
117 8a57da61 Leszek Koltunski
  private int mLastValue =-1;
118 12f45260 Leszek Koltunski
  // end section
119
  ////////////////////////////////////////////////////////////////////////////////
120
121 86e99907 leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
122
123
  abstract void prepareDebug(long time);
124
  abstract void renderDebug(long time);
125 12f45260 Leszek Koltunski
  abstract void createSurface();
126
  abstract void deleteSurface();
127
  abstract void recreateSurface();
128 86e99907 leszek
129 af4cc5db Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
130
131 9ed80185 Leszek Koltunski
  DistortedOutputSurface(int width, int height, int createColor, int numcolors, int depthStencil, int fbo, int type)
132 af4cc5db Leszek Koltunski
    {
133 9ed80185 Leszek Koltunski
    super(width,height,createColor,numcolors,type);
134 af4cc5db Leszek Koltunski
135
    mProjectionMatrix = new float[16];
136
137
    mFOV = 60.0f;
138 54fe333a leszek
    mNear=  0.5f;
139 af4cc5db Leszek Koltunski
140 23eecbd9 Leszek Koltunski
    mDepthStencilCreated= (depthStencil== NO_DEPTH_NO_STENCIL ? DONT_CREATE:NOT_CREATED_YET);
141 89de975c leszek
    mDepthStencil = depthStencil;
142
143
    mFBOH[0]         = fbo;
144
    mDepthStencilH[0]= 0;
145 a436ccc5 leszek
146 95c441a2 leszek
    mTime = 0;
147 86e99907 leszek
    mDebugLevel = 0;
148 95c441a2 leszek
149 a9f41fa3 leszek
    mClearR = 0.0f;
150
    mClearG = 0.0f;
151
    mClearB = 0.0f;
152
    mClearA = 0.0f;
153
154
    mClearDepth = 1.0f;
155 23eecbd9 Leszek Koltunski
    mClearStencil = 0;
156 e6519ac8 Leszek Koltunski
    mClear = GLES31.GL_DEPTH_BUFFER_BIT | GLES31.GL_COLOR_BUFFER_BIT;
157 a9f41fa3 leszek
158 70b6a155 Leszek Koltunski
    mBuffer = new DistortedOutputSurface[1+EffectQuality.LENGTH];
159 638b5b5c leszek
160 8426bd6a Leszek Koltunski
    mMipmap = 1.0f;
161 78db8663 Leszek Koltunski
162 af4cc5db Leszek Koltunski
    createProjection();
163
    }
164
165 12f45260 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
166
// Must be called from a thread holding OpenGL Context
167
168
  void create()
169
    {
170
    if( mSSBO[0]<0 )
171
      {
172
      GLES31.glGenBuffers(1,mSSBO,0);
173
174
      // here bind the new SSBO and map it
175
      GLES31.glBindBuffer(GLES31.GL_SHADER_STORAGE_BUFFER, mSSBO[0]);
176
      GLES31.glBufferData(GLES31.GL_SHADER_STORAGE_BUFFER, BUFFERING*mBufferSize*4 , null, GLES31.GL_DYNAMIC_READ);
177 66ace7f5 Leszek Koltunski
      ByteBuffer buf = (ByteBuffer) GLES31.glMapBufferRange(GLES31.GL_SHADER_STORAGE_BUFFER, 0, BUFFERING*mBufferSize*4, GLES31.GL_MAP_READ_BIT );
178
      mIntBuffer = buf.order(ByteOrder.nativeOrder()).asIntBuffer();
179 2ab60f72 Leszek Koltunski
      GLES31.glBindBufferBase(GLES31.GL_SHADER_STORAGE_BUFFER,0, mSSBO[0]);
180 12f45260 Leszek Koltunski
      }
181
182
    mSurfaceID = mSurfaceCounter.returnNext();
183
184
    if( mSurfaceID>=mBufferSize )
185
      {
186 51a3cbab Leszek Koltunski
      // increase size of the Buffer, copy over old values, remap.
187
      int[] tmp = new int[BUFFERING*mBufferSize];
188
      for(int i=0;i<BUFFERING*mBufferSize;i++) tmp[i] = mIntBuffer.get(i);
189
190
      mBufferSize*= 2;
191
192
      GLES31.glBindBufferBase(GLES31.GL_SHADER_STORAGE_BUFFER, 0, 0);
193
      GLES31.glUnmapBuffer(GLES31.GL_SHADER_STORAGE_BUFFER);
194
      GLES31.glBindBuffer(GLES31.GL_SHADER_STORAGE_BUFFER,0);
195
196
      GLES31.glBindBuffer(GLES31.GL_SHADER_STORAGE_BUFFER, mSSBO[0]);
197
      GLES31.glBufferData(GLES31.GL_SHADER_STORAGE_BUFFER, BUFFERING*mBufferSize*4 , null, GLES31.GL_DYNAMIC_READ);
198
      ByteBuffer buf = (ByteBuffer) GLES31.glMapBufferRange(GLES31.GL_SHADER_STORAGE_BUFFER, 0, BUFFERING*mBufferSize*4, GLES31.GL_MAP_READ_BIT );
199
      mIntBuffer = buf.order(ByteOrder.nativeOrder()).asIntBuffer();
200
      GLES31.glBindBufferBase(GLES31.GL_SHADER_STORAGE_BUFFER,0, mSSBO[0]);
201
202
      for(int i=0;i<tmp.length;i++) mIntBuffer.put(i,tmp[i]);
203 12f45260 Leszek Koltunski
      }
204
205
    createSurface();
206
    }
207
208
///////////////////////////////////////////////////////////////////////////////////////////////////
209
// Must be called from a thread holding OpenGL Context
210
211
  void delete()
212
    {
213
    mSurfaceCounter.release(mSurfaceID);
214
    deleteSurface();
215
    }
216
217
///////////////////////////////////////////////////////////////////////////////////////////////////
218
219
  void recreate()
220
    {
221
    mSSBO[0] = -1;
222
    mSurfaceCounter.releaseAll();
223
    recreateSurface();
224
    }
225
226 27cd6b98 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
227
228 8a57da61 Leszek Koltunski
  int getNewCounter()
229 27cd6b98 Leszek Koltunski
    {
230 8a57da61 Leszek Koltunski
    int value = mIntBuffer.get(BUFFERING*mSurfaceID+mLastIndex);
231 12f45260 Leszek Koltunski
232 8a57da61 Leszek Koltunski
    if( value!=mLastValue )
233
      {
234
      mLastValue = value;
235
      android.util.Log.d("surface", "surface id: "+mSurfaceID+" value now: "+mLastValue);
236
      }
237 12f45260 Leszek Koltunski
238
    mLastIndex++;
239
    if( mLastIndex>=BUFFERING ) mLastIndex-=BUFFERING;
240
241 8a57da61 Leszek Koltunski
    mIntBuffer.put(BUFFERING*mSurfaceID+mLastIndex,0);
242
    return BUFFERING*mSurfaceID + mLastIndex;
243 12f45260 Leszek Koltunski
    }
244
245 c5369f1b leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
246
247 be60d4ff leszek
  private void createProjection()
248 af4cc5db Leszek Koltunski
    {
249
    if( mWidth>0 && mHeight>1 )
250
      {
251
      if( mFOV>0.0f )  // perspective projection
252
        {
253 54fe333a leszek
        float a = 2.0f*(float)Math.tan(mFOV*Math.PI/360);
254 8426bd6a Leszek Koltunski
        float q = mWidth*mNear;
255
        float c = mHeight*mNear;
256 54fe333a leszek
257 c2c08950 leszek
        float left   = -q/2;
258
        float right  = +q/2;
259
        float bottom = -c/2;
260
        float top    = +c/2;
261
        float near   =  c/a;
262 54fe333a leszek
263 8426bd6a Leszek Koltunski
        mDistance    = mHeight/a;
264 af4cc5db Leszek Koltunski
        float far    = 2*mDistance-near;
265
266
        Matrix.frustumM(mProjectionMatrix, 0, left, right, bottom, top, near, far);
267
        }
268
      else             // parallel projection
269
        {
270 8426bd6a Leszek Koltunski
        float left   = -mWidth/2.0f;
271
        float right  = +mWidth/2.0f;
272
        float bottom = -mHeight/2.0f;
273
        float top    = +mHeight/2.0f;
274
        float near   = mWidth+mHeight-mHeight*(1.0f-mNear);
275
        mDistance    = mWidth+mHeight;
276
        float far    = mWidth+mHeight+mHeight*(1.0f-mNear);
277 af4cc5db Leszek Koltunski
278
        Matrix.orthoM(mProjectionMatrix, 0, left, right, bottom, top, near, far);
279
        }
280
      }
281
    }
282
283 1d6d261e Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
284
285 6b962e80 Leszek Koltunski
  private void createBuffers()
286 1d6d261e Leszek Koltunski
    {
287
    float mipmap=1.0f;
288
289
    for(int j=0; j<EffectQuality.LENGTH; j++)
290
      {
291 0f011027 Leszek Koltunski
      mBuffer[j] = new DistortedFramebuffer(2,BOTH_DEPTH_STENCIL,TYPE_SYST, (int)(mWidth*mipmap), (int)(mHeight*mipmap) );
292
      mBuffer[j].mMipmap = mipmap;
293 73208cab leszek
      mBuffer[j].mNear   = mNear;  // copy mNear as well (for blitting- see PostprocessEffect.apply() )
294 7ad20cce Leszek Koltunski
      mBuffer[j].glClearColor(1.0f,1.0f,1.0f,0.0f);
295 1d6d261e Leszek Koltunski
      mipmap *= EffectQuality.MULTIPLIER;
296
      }
297
298 70b6a155 Leszek Koltunski
    mBuffer[EffectQuality.LENGTH] = this;
299
300 1d6d261e Leszek Koltunski
    DistortedObject.toDo(); // create the FBOs immediately. This is safe as we must be holding the OpenGL context now.
301
302 e6519ac8 Leszek Koltunski
    GLES31.glStencilMask(0xff);
303
    GLES31.glDepthMask(true);
304
    GLES31.glColorMask(true,true,true,true);
305
    GLES31.glClearColor(0.0f,0.0f,0.0f,0.0f);
306
    GLES31.glClearDepthf(1.0f);
307
    GLES31.glClearStencil(0);
308 1d6d261e Leszek Koltunski
309
    for(int j=0; j<EffectQuality.LENGTH; j++)
310
      {
311 0f011027 Leszek Koltunski
      mBuffer[j].setAsOutput();
312 e6519ac8 Leszek Koltunski
      GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_COLOR_ATTACHMENT0, GLES31.GL_TEXTURE_2D, mBuffer[j].mColorH[1], 0);
313
      GLES31.glClear(GLES31.GL_COLOR_BUFFER_BIT|GLES31.GL_DEPTH_BUFFER_BIT|GLES31.GL_STENCIL_BUFFER_BIT);
314
      GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_COLOR_ATTACHMENT0, GLES31.GL_TEXTURE_2D, mBuffer[j].mColorH[0], 0);
315
      GLES31.glClear(GLES31.GL_COLOR_BUFFER_BIT);
316 1d6d261e Leszek Koltunski
      }
317
    }
318
319 6b962e80 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
320
321 70b6a155 Leszek Koltunski
  private int blitWithDepth(long currTime, DistortedOutputSurface buffer)
322 6b962e80 Leszek Koltunski
    {
323 e6519ac8 Leszek Koltunski
    GLES31.glViewport(0, 0, mWidth, mHeight);
324 6b962e80 Leszek Koltunski
    setAsOutput(currTime);
325 e6519ac8 Leszek Koltunski
    GLES31.glActiveTexture(GLES31.GL_TEXTURE0);
326
    GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, buffer.mColorH[0]);
327
    GLES31.glActiveTexture(GLES31.GL_TEXTURE1);
328
    GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, buffer.mDepthStencilH[0]);
329 6b962e80 Leszek Koltunski
330 e6519ac8 Leszek Koltunski
    GLES31.glDisable(GLES31.GL_STENCIL_TEST);
331
    GLES31.glStencilMask(0x00);
332 6b962e80 Leszek Koltunski
333
    DistortedEffects.blitDepthPriv(this);
334 e6519ac8 Leszek Koltunski
    GLES31.glActiveTexture(GLES31.GL_TEXTURE0);
335
    GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, 0);
336
    GLES31.glActiveTexture(GLES31.GL_TEXTURE1);
337
    GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, 0);
338 6b962e80 Leszek Koltunski
339
    // clear buffers
340 e6519ac8 Leszek Koltunski
    GLES31.glStencilMask(0xff);
341
    GLES31.glDepthMask(true);
342
    GLES31.glColorMask(true,true,true,true);
343
    GLES31.glClearColor(0.0f,0.0f,0.0f,0.0f);
344
    GLES31.glClearDepthf(1.0f);
345
    GLES31.glClearStencil(0);
346 6b962e80 Leszek Koltunski
347
    buffer.setAsOutput();
348 e6519ac8 Leszek Koltunski
    GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_COLOR_ATTACHMENT0, GLES31.GL_TEXTURE_2D, buffer.mColorH[1], 0);
349
    GLES31.glClear(GLES31.GL_COLOR_BUFFER_BIT|GLES31.GL_DEPTH_BUFFER_BIT|GLES31.GL_STENCIL_BUFFER_BIT);
350
    GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_COLOR_ATTACHMENT0, GLES31.GL_TEXTURE_2D, buffer.mColorH[0], 0);
351
    GLES31.glClear(GLES31.GL_COLOR_BUFFER_BIT);
352 6b962e80 Leszek Koltunski
353
    return 1;
354
    }
355
356 af4cc5db Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
357 e02264ff leszek
// Render all children, one by one. If there are no postprocessing effects, just render to THIS.
358
// Otherwise, render to a buffer and on each change of Postprocessing Bucket, apply the postprocessing
359
// to a whole buffer and merge it.
360 39086ebb leszek
361 8e28b6ff leszek
  int renderChildren(long time, int numChildren, ArrayList<DistortedNode> children)
362 b2939df4 Leszek Koltunski
    {
363 7266d8ef Leszek Koltunski
    int quality=0, internalQuality = 0, numRenders = 0, bucketChange = 0;
364 3f44e745 Leszek Koltunski
    DistortedNode child1, child2;
365 70b6a155 Leszek Koltunski
    EffectQueuePostprocess lastQueue=null, currQueue;
366 915b7b2b leszek
    long lastBucket=0, currBucket;
367 0afc143a leszek
368 8e28b6ff leszek
    for(int i=0; i<numChildren; i++)
369 39086ebb leszek
      {
370 3f44e745 Leszek Koltunski
      child1 = children.get(i);
371 70b6a155 Leszek Koltunski
      currQueue = child1.getPostprocessQueue();
372
      currBucket= currQueue.getID();
373 b9798977 leszek
374 915b7b2b leszek
      if( currBucket==0 ) numRenders += child1.draw(time,this);
375 60c1c622 leszek
      else
376
        {
377 0f011027 Leszek Koltunski
        if( mBuffer[0]==null ) createBuffers();
378 c9a24bfb Leszek Koltunski
379 915b7b2b leszek
        if( lastBucket!=currBucket )
380 c9a24bfb Leszek Koltunski
          {
381 915b7b2b leszek
          if( lastBucket!=0 )
382 c9a24bfb Leszek Koltunski
            {
383
            for(int j=bucketChange; j<i; j++)
384
              {
385 3f44e745 Leszek Koltunski
              child2 = children.get(j);
386 70b6a155 Leszek Koltunski
              numRenders += child2.markStencilAndDepth(time,mBuffer[internalQuality],lastQueue);
387 c9a24bfb Leszek Koltunski
              }
388
389 70b6a155 Leszek Koltunski
            numRenders += lastQueue.postprocess(this);
390 bed13bea leszek
            numRenders += blitWithDepth(time, mBuffer[quality]);
391 c9a24bfb Leszek Koltunski
            }
392 660cd468 leszek
393 70b6a155 Leszek Koltunski
          internalQuality = currQueue.getInternalQuality();
394
          quality         = currQueue.getQuality();
395
          bucketChange    = i;
396 c9a24bfb Leszek Koltunski
          }
397
398 70b6a155 Leszek Koltunski
        child1.draw(time,mBuffer[quality]);
399
        //numRenders += currQueue.draw(child1,time,mBuffer);
400 c9a24bfb Leszek Koltunski
401 8e28b6ff leszek
        if( i==numChildren-1 )
402 cf7394cc leszek
          {
403 8e28b6ff leszek
          for(int j=bucketChange; j<numChildren; j++)
404 c9a24bfb Leszek Koltunski
            {
405 3f44e745 Leszek Koltunski
            child2 = children.get(j);
406 70b6a155 Leszek Koltunski
            numRenders += child2.markStencilAndDepth(time,mBuffer[internalQuality],currQueue);
407 c9a24bfb Leszek Koltunski
            }
408
409 70b6a155 Leszek Koltunski
          numRenders += currQueue.postprocess(this);
410 7266d8ef Leszek Koltunski
          numRenders += blitWithDepth(time, mBuffer[quality]);
411 cf7394cc leszek
          }
412 60c1c622 leszek
        }
413 b9798977 leszek
414 70b6a155 Leszek Koltunski
      lastQueue = currQueue;
415
      lastBucket= currBucket;
416 95c441a2 leszek
      }
417 270c27bc Leszek Koltunski
418 39086ebb leszek
    return numRenders;
419
    }
420
421 be60d4ff leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
422
423 26a4e5f6 leszek
  ArrayList<DistortedNode> getChildren()
424 be60d4ff leszek
    {
425 26a4e5f6 leszek
    return mChildren;
426 be60d4ff leszek
    }
427
428 b2939df4 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
429
// PUBLIC API
430 39086ebb leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
431 86e99907 leszek
/**
432
 * Make the library show various debugging information.
433
 * <p>
434
 * Currently only DEBUG_FPS - show FPS in the upper-left corner of every Screen - is defined.
435
 *
436
 * @param bitmask 0, or a bitmask of DEBUG_** flags to enable (currently only DEBUG_FPS defined)
437
 */
438
  public void setDebug(int bitmask)
439
    {
440 26a4e5f6 leszek
    if( this instanceof DistortedScreen )
441
      mDebugLevel = bitmask;
442 86e99907 leszek
    }
443
444
///////////////////////////////////////////////////////////////////////////////////////////////////
445
446 c5369f1b leszek
/**
447 d9706fd2 Leszek Koltunski
 * Draws all the attached children to this OutputSurface.
448 af4cc5db Leszek Koltunski
 * <p>
449
 * Must be called from a thread holding OpenGL Context.
450
 *
451 d9706fd2 Leszek Koltunski
 * @param time Current time, in milliseconds. This will be passed to all the Effects stored in the children Nodes.
452 7691a39f leszek
 * @return Number of objects rendered.
453 c5369f1b leszek
 */
454 b2939df4 Leszek Koltunski
  public int render(long time)
455 af4cc5db Leszek Koltunski
    {
456 26a4e5f6 leszek
    if( mDebugLevel!=0 ) prepareDebug(time);
457 86e99907 leszek
458 c204c69d leszek
    // change tree topology (attach and detach children)
459 889cce10 Leszek Koltunski
/*
460 42571056 Leszek Koltunski
    boolean changed1 =
461 889cce10 Leszek Koltunski
*/
462 efe3d8fe leszek
    DistortedMaster.toDo();
463 eadf0859 leszek
/*
464 42571056 Leszek Koltunski
    if( changed1 )
465 c204c69d leszek
      {
466
      for(int i=0; i<mNumChildren; i++)
467
        {
468 af27df87 leszek
        mChildren.get(i).debug(0);
469 c204c69d leszek
        }
470 af27df87 leszek
471 7691a39f leszek
      DistortedNode.debugMap();
472 c204c69d leszek
      }
473 eadf0859 leszek
*/
474 09ab7524 Leszek Koltunski
    // create and delete all underlying OpenGL resources
475
    // Watch out: FIRST change topology, only then deal
476
    // with OpenGL resources. That's because changing Tree
477
    // can result in additional Framebuffers that would need
478
    // to be created immediately, before the calls to drawRecursive()
479 42571056 Leszek Koltunski
/*
480
    boolean changed2 =
481
*/
482 f8377ef8 leszek
    toDo();
483 eadf0859 leszek
/*
484 42571056 Leszek Koltunski
    if( changed2 )
485 af27df87 leszek
      {
486 226144d0 leszek
      DistortedObject.debugLists();
487 42571056 Leszek Koltunski
      }
488 eadf0859 leszek
*/
489 c834348d leszek
    // mark OpenGL state as unknown
490
    DistortedRenderState.reset();
491 2ed1c692 leszek
492 b2939df4 Leszek Koltunski
    int numRenders=0;
493 7691a39f leszek
494 d9706fd2 Leszek Koltunski
    for(int i=0; i<mNumChildren; i++)
495 af4cc5db Leszek Koltunski
      {
496 b2939df4 Leszek Koltunski
      numRenders += mChildren.get(i).renderRecursive(time);
497 af4cc5db Leszek Koltunski
      }
498 7691a39f leszek
499 070695a5 Leszek Koltunski
    setAsOutput(time);
500 b2939df4 Leszek Koltunski
    numRenders += renderChildren(time,mNumChildren,mChildren);
501
502 26a4e5f6 leszek
    if( mDebugLevel != 0 ) renderDebug(time);
503 b28c6c21 leszek
504 7691a39f leszek
    return numRenders;
505 af4cc5db Leszek Koltunski
    }
506
507
///////////////////////////////////////////////////////////////////////////////////////////////////
508 c5369f1b leszek
/**
509
 * Bind this Surface as a Framebuffer we can render to.
510 02ab6f9d leszek
 *
511
 * @param time Present time, in milliseconds. The point: looking at this param the library can figure
512
 *             out if this is the first time during present frame that this FBO is being set as output.
513
 *             If so, the library, in addition to binding the Surface for output, also clears the
514
 *             Surface's color and depth attachments.
515 c5369f1b leszek
 */
516 95c441a2 leszek
  public void setAsOutput(long time)
517 a436ccc5 leszek
    {
518 e6519ac8 Leszek Koltunski
    GLES31.glBindFramebuffer(GLES31.GL_FRAMEBUFFER, mFBOH[0]);
519 95c441a2 leszek
520
    if( mTime!=time )
521
      {
522
      mTime = time;
523 23eecbd9 Leszek Koltunski
      DistortedRenderState.colorDepthStencilOn();
524 e6519ac8 Leszek Koltunski
      GLES31.glClearColor(mClearR, mClearG, mClearB, mClearA);
525
      GLES31.glClearDepthf(mClearDepth);
526
      GLES31.glClearStencil(mClearStencil);
527
      GLES31.glClear(mClear);
528 144d252c Leszek Koltunski
      DistortedRenderState.colorDepthStencilRestore();
529 95c441a2 leszek
      }
530 a436ccc5 leszek
    }
531 af4cc5db Leszek Koltunski
532 1dfc9074 leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
533
/**
534
 * Bind this Surface as a Framebuffer we can render to.
535
 * <p>
536
 * This version does not attempt to clear anything.
537
 */
538
539
  public void setAsOutput()
540
    {
541 e6519ac8 Leszek Koltunski
    GLES31.glBindFramebuffer(GLES31.GL_FRAMEBUFFER, mFBOH[0]);
542 1dfc9074 leszek
    }
543
544
///////////////////////////////////////////////////////////////////////////////////////////////////
545
/**
546
 * Return the Near plane of the Projection included in the Surface.
547
 *
548
 * @return the Near plane.
549
 */
550
  public float getNear()
551
    {
552
    return mNear;
553
    }
554
555 638b5b5c leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
556
/**
557
 * Set mipmap level.
558
 * <p>
559
 * Trick for speeding up your renders - one can create a pyramid of OutputSurface objects, each next
560
 * one some constant FACTOR smaller than the previous (0.5 is the common value), then set the Mipmap
561
 * Level of the i-th object to be FACTOR^i (we start counting from 0). When rendering any scene into
562
 * such prepared OutputSurface, the library will make sure to scale any Effects used so that the end
563
 * scene will end up looking identical no matter which object we render to. Identical, that is, except
564
 * for the loss of quality and gain in speed associated with rendering to a smaller Surface.
565 8426bd6a Leszek Koltunski
 * <p>
566
 * Example: if you create two FBOs, one 1000x1000 and another 500x500 in size, and set the second one
567
 * mipmap to 0.5 (the first one's is 1.0 by default), define Effects to be a single move by (100,100),
568
 * and render a skinned Mesh into both FBO, the end result will look proportionally the same, because
569
 * in the second case the move vector (100,100) will be auto-scaled to (50,50).
570 638b5b5c leszek
 *
571
 * @param mipmap The mipmap level. Acceptable range: 0&lt;mipmap&lt;infinity, although mipmap&gt;1
572
 *               does not make any sense (that would result in loss of speed and no gain in quality)
573
 */
574
  public void setMipmap(float mipmap)
575
    {
576
    mMipmap = mipmap;
577
    }
578
579 a9f41fa3 leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
580
/**
581 e6519ac8 Leszek Koltunski
 * Set the (R,G,B,A) values of GLES31.glClearColor() to set up color with which to clear
582 ad16ed3b Leszek Koltunski
 * this Surface at the beginning of each frame.
583 a9f41fa3 leszek
 *
584
 * @param r the Red component. Default: 0.0f
585
 * @param g the Green component. Default: 0.0f
586
 * @param b the Blue component. Default: 0.0f
587
 * @param a the Alpha component. Default: 0.0f
588
 */
589
  public void glClearColor(float r, float g, float b, float a)
590
    {
591
    mClearR = r;
592
    mClearG = g;
593
    mClearB = b;
594
    mClearA = a;
595
    }
596
597
///////////////////////////////////////////////////////////////////////////////////////////////////
598
/**
599 23eecbd9 Leszek Koltunski
 * Uses glClearDepthf() to set up a value with which to clear
600
 * the Depth buffer of our Surface at the beginning of each frame.
601 a9f41fa3 leszek
 *
602
 * @param d the Depth. Default: 1.0f
603
 */
604
  public void glClearDepthf(float d)
605
    {
606
    mClearDepth = d;
607
    }
608
609 23eecbd9 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
610
/**
611
 * Uses glClearStencil() to set up a value with which to clear the
612
 * Stencil buffer of our Surface at the beginning of each frame.
613
 *
614
 * @param s the Stencil. Default: 0
615
 */
616
  public void glClearStencil(int s)
617
    {
618
    mClearStencil = s;
619
    }
620
621 ad16ed3b Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
622
/**
623
 * Which buffers to Clear at the beginning of each frame?
624
 * <p>
625
 * Valid values: 0, or bitwise OR of one or more values from the set GL_COLOR_BUFFER_BIT,
626
 *               GL_DEPTH_BUFFER_BIT, GL_STENCIL_BUFFER_BIT.
627
 * Default: GL_DEPTH_BUFFER_BIT | GL_COLOR_BUFFER_BIT.
628
 *
629
 * @param mask bitwise OR of BUFFER_BITs to clear.
630
 */
631
  public void glClear(int mask)
632
    {
633
    mClear = mask;
634
    }
635
636 af4cc5db Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
637
/**
638
 * Create new Projection matrix.
639
 *
640
 * @param fov Vertical 'field of view' of the Projection frustrum (in degrees).
641 54fe333a leszek
 *            Valid values: 0<=fov<180. FOV==0 means 'parallel projection'.
642
 * @param near Distance between the screen plane and the near plane.
643
 *             Valid vaules: 0<near<1. When near==0, the Near Plane is exactly at the tip of the
644
 *             pyramid. When near==1 (illegal!) the near plane is equivalent to the screen plane.
645 af4cc5db Leszek Koltunski
 */
646 54fe333a leszek
  public void setProjection(float fov, float near)
647 af4cc5db Leszek Koltunski
    {
648 8069e806 Leszek Koltunski
    if( fov < 180.0f && fov >=0.0f )
649
      {
650
      mFOV = fov;
651
      }
652
653
    if( near<   1.0f && near> 0.0f )
654
      {
655
      mNear= near;
656
      }
657
    else if( near<=0.0f )
658
      {
659
      mNear = 0.01f;
660
      }
661
    else if( near>=1.0f )
662
      {
663
      mNear=0.99f;
664
      }
665 af4cc5db Leszek Koltunski
666 1dfc9074 leszek
    if( mBuffer[0]!=null )
667
      {
668
      for(int j=0; j<EffectQuality.LENGTH; j++) mBuffer[j].mNear = mNear;
669
      }
670
671 af4cc5db Leszek Koltunski
    createProjection();
672
    }
673
674
///////////////////////////////////////////////////////////////////////////////////////////////////
675 c5369f1b leszek
/**
676 af4cc5db Leszek Koltunski
 * Resize the underlying Framebuffer.
677 c7da4e65 leszek
 * <p>
678
 * This method can be safely called mid-render as it doesn't interfere with rendering.
679 af4cc5db Leszek Koltunski
 *
680
 * @param width The new width.
681
 * @param height The new height.
682 c5369f1b leszek
 */
683 af4cc5db Leszek Koltunski
  public void resize(int width, int height)
684
    {
685
    if( mWidth!=width || mHeight!=height )
686
      {
687
      mWidth = width;
688
      mHeight= height;
689 f8377ef8 leszek
690
      createProjection();
691
692 c7da4e65 leszek
      if( mColorCreated==CREATED )
693 f8377ef8 leszek
        {
694 f28fffc2 Leszek Koltunski
        markForCreation();
695 f8377ef8 leszek
        recreate();
696
        }
697 af4cc5db Leszek Koltunski
      }
698
    }
699 a09ada4c Leszek Koltunski
700 a436ccc5 leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
701
/**
702 89de975c leszek
 * Return true if the Surface contains a DEPTH attachment.
703 a436ccc5 leszek
 *
704 89de975c leszek
 * @return <bold>true</bold> if the Surface contains a DEPTH attachment.
705 a436ccc5 leszek
 */
706 89de975c leszek
  public boolean hasDepth()
707 a436ccc5 leszek
    {
708 89de975c leszek
    return mDepthStencilCreated==CREATED;
709 a436ccc5 leszek
    }
710
711
///////////////////////////////////////////////////////////////////////////////////////////////////
712
/**
713 89de975c leszek
 * Return true if the Surface contains a STENCIL attachment.
714 a436ccc5 leszek
 *
715 89de975c leszek
 * @return <bold>true</bold> if the Surface contains a STENCIL attachment.
716 a436ccc5 leszek
 */
717 89de975c leszek
  public boolean hasStencil()
718 a436ccc5 leszek
    {
719 89de975c leszek
    return (mDepthStencilCreated==CREATED && mDepthStencil==BOTH_DEPTH_STENCIL);
720 a436ccc5 leszek
    }
721
722 a09ada4c Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
723
/**
724
 * Adds a new child to the last position in the list of our Surface's children.
725 c204c69d leszek
 * <p>
726
 * We cannot do this mid-render - actual attachment will be done just before the next render, by the
727 efe3d8fe leszek
 * DistortedMaster (by calling doWork())
728 a09ada4c Leszek Koltunski
 *
729
 * @param node The new Node to add.
730
 */
731 c204c69d leszek
  public void attach(DistortedNode node)
732 a09ada4c Leszek Koltunski
    {
733 ffbe7ecf Leszek Koltunski
    mJobs.add(new Job(ATTACH,node));
734 efe3d8fe leszek
    DistortedMaster.newSlave(this);
735 a09ada4c Leszek Koltunski
    }
736
737
///////////////////////////////////////////////////////////////////////////////////////////////////
738
/**
739
 * Adds a new child to the last position in the list of our Surface's children.
740 c204c69d leszek
 * <p>
741
 * We cannot do this mid-render - actual attachment will be done just before the next render, by the
742 efe3d8fe leszek
 * DistortedMaster (by calling doWork())
743 a09ada4c Leszek Koltunski
 *
744
 * @param surface InputSurface to initialize our child Node with.
745
 * @param effects DistortedEffects to initialize our child Node with.
746
 * @param mesh MeshObject to initialize our child Node with.
747
 * @return the newly constructed child Node, or null if we couldn't allocate resources.
748
 */
749 c204c69d leszek
  public DistortedNode attach(DistortedInputSurface surface, DistortedEffects effects, MeshObject mesh)
750 a09ada4c Leszek Koltunski
    {
751
    DistortedNode node = new DistortedNode(surface,effects,mesh);
752 ffbe7ecf Leszek Koltunski
    mJobs.add(new Job(ATTACH,node));
753 efe3d8fe leszek
    DistortedMaster.newSlave(this);
754 c204c69d leszek
    return node;
755
    }
756
757 af27df87 leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
758
/**
759
 * Removes the first occurrence of a specified child from the list of children of our Surface.
760
 * <p>
761
 * A bit questionable method as there can be many different Nodes attached as children, some
762
 * of them having the same Effects but - for instance - different Mesh. Use with care.
763
 * <p>
764
 * We cannot do this mid-render - actual detachment will be done just before the next render, by the
765 efe3d8fe leszek
 * DistortedMaster (by calling doWork())
766 af27df87 leszek
 *
767
 * @param effects DistortedEffects to remove.
768
 */
769
  public void detach(DistortedEffects effects)
770
    {
771
    long id = effects.getID();
772
    DistortedNode node;
773 8baa1fe6 Leszek Koltunski
    boolean detached = false;
774 af27df87 leszek
775
    for(int i=0; i<mNumChildren; i++)
776
      {
777
      node = mChildren.get(i);
778
779
      if( node.getEffects().getID()==id )
780
        {
781 8baa1fe6 Leszek Koltunski
        detached = true;
782 ffbe7ecf Leszek Koltunski
        mJobs.add(new Job(DETACH,node));
783 efe3d8fe leszek
        DistortedMaster.newSlave(this);
784 af27df87 leszek
        break;
785
        }
786
      }
787 8baa1fe6 Leszek Koltunski
788
    if( !detached )
789
      {
790
      // if we failed to detach any, it still might be the case that
791 efe3d8fe leszek
      // there's an ATTACH job that we need to cancel.
792
      int num = mJobs.size();
793
      Job job;
794
795
      for(int i=0; i<num; i++)
796
        {
797
        job = mJobs.get(i);
798
799
        if( job.type==ATTACH && job.node.getEffects()==effects )
800
          {
801
          mJobs.remove(i);
802
          break;
803
          }
804
        }
805 8baa1fe6 Leszek Koltunski
      }
806 af27df87 leszek
    }
807
808 a09ada4c Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
809
/**
810
 * Removes the first occurrence of a specified child from the list of children of our Surface.
811 c204c69d leszek
 * <p>
812
 * We cannot do this mid-render - actual attachment will be done just before the next render, by the
813 efe3d8fe leszek
 * DistortedMaster (by calling doWork())
814 c204c69d leszek
 *
815
 * @param node The Node to remove.
816
 */
817
  public void detach(DistortedNode node)
818
    {
819 ffbe7ecf Leszek Koltunski
    mJobs.add(new Job(DETACH,node));
820 efe3d8fe leszek
    DistortedMaster.newSlave(this);
821 a09ada4c Leszek Koltunski
    }
822
823
///////////////////////////////////////////////////////////////////////////////////////////////////
824
/**
825
 * Removes all children Nodes.
826 c204c69d leszek
 * <p>
827
 * We cannot do this mid-render - actual attachment will be done just before the next render, by the
828 efe3d8fe leszek
 * DistortedMaster (by calling doWork())
829 c204c69d leszek
 */
830
  public void detachAll()
831
    {
832 ffbe7ecf Leszek Koltunski
    mJobs.add(new Job(DETALL,null));
833 efe3d8fe leszek
    DistortedMaster.newSlave(this);
834 c204c69d leszek
    }
835
836
///////////////////////////////////////////////////////////////////////////////////////////////////
837
/**
838
 * This is not really part of the public API. Has to be public only because it is a part of the
839 efe3d8fe leszek
 * DistortedSlave interface, which should really be a class that we extend here instead but
840 c204c69d leszek
 * Java has no multiple inheritance.
841 43fbf0dd leszek
 *
842
 * @y.exclude
843 a09ada4c Leszek Koltunski
 */
844 efe3d8fe leszek
  public void doWork()
845 a09ada4c Leszek Koltunski
    {
846 efe3d8fe leszek
    int num = mJobs.size();
847
    Job job;
848
849
    for(int i=0; i<num; i++)
850
      {
851
      job = mJobs.remove(0);
852
853
      switch(job.type)
854
        {
855 be60d4ff leszek
        case ATTACH: if( mChildren==null ) mChildren = new ArrayList<>(2);
856
                     job.node.setSurfaceParent(this);
857
                     DistortedMaster.addSorted(mChildren,job.node);
858 efe3d8fe leszek
                     mNumChildren++;
859
                     break;
860 be60d4ff leszek
        case DETACH: if( mNumChildren>0 && mChildren.remove(job.node) )
861 efe3d8fe leszek
                       {
862 be60d4ff leszek
                       job.node.setSurfaceParent(null);
863 efe3d8fe leszek
                       mNumChildren--;
864
                       }
865
                     break;
866 be60d4ff leszek
        case DETALL: if( mNumChildren>0 )
867 efe3d8fe leszek
                       {
868 be60d4ff leszek
                       DistortedNode tmp;
869
870
                       for(int j=mNumChildren-1; j>=0; j--)
871
                         {
872
                         tmp = mChildren.remove(j);
873
                         tmp.setSurfaceParent(null);
874
                         }
875
876 efe3d8fe leszek
                       mNumChildren = 0;
877
                       }
878
                     break;
879 ffbe7ecf Leszek Koltunski
        case SORT  : mChildren.remove(job.node);
880 be60d4ff leszek
                     DistortedMaster.addSorted(mChildren,job.node);
881 efe3d8fe leszek
                     break;
882
        }
883
      }
884 a09ada4c Leszek Koltunski
    }
885 af4cc5db Leszek Koltunski
}