Project

General

Profile

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

library / src / main / java / org / distorted / library / main / DistortedOutputSurface.java @ c14e495b

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