Distorted Android

///////////////////////////////////////////////////////////////////////////////////////////////////

// Copyright 2016 Leszek Koltunski                                                               //

//                                                                                               //

// This file is part of Distorted.                                                               //

//                                                                                               //

// Distorted is free software: you can redistribute it and/or modify                             //

// it under the terms of the GNU General Public License as published by                          //

// the Free Software Foundation, either version 2 of the License, or                             //

// (at your option) any later version.                                                           //

//                                                                                               //

// Distorted is distributed in the hope that it will be useful,                                  //

// but WITHOUT ANY WARRANTY; without even the implied warranty of                                //

// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                                 //

// GNU General Public License for more details.                                                  //

//                                                                                               //

// You should have received a copy of the GNU General Public License                             //

// along with Distorted.  If not, see <http://www.gnu.org/licenses/>.                            //

///////////////////////////////////////////////////////////////////////////////////////////////////

///////////////////////////////////////////////////////////////////////////////////////////////////

 * This is not really part of the public API.

 *

 * @y.exclude

 */

public abstract class DistortedOutputSurface extends DistortedSurface implements DistortedMaster.Slave

 * Do not create DEPTH or STENCIL attachment

 */

 * Create DEPTH, but not STENCIL

 */

 * Create both DEPTH and STENCIL

 */

  private static final int DETACH = 1;

  private static final int DETALL = 2;

  private static final int SORT   = 3;

  private int mNumChildren;   // ==mChildren.length(), but we only create mChildren if the first one gets added

    {

    int type;

    DistortedNode node;

      type = t;

      node = n;

      }

    }

  private ArrayList<Job> mJobs = new ArrayList<>();

  float mDistance, mNear;

  int mDepthStencil;

  int[] mDepthStencilH = new int[1];

  int[] mFBOH          = new int[1];

  private float mClearDepth;

  int mRealHeight;  // larger than the viewport we have to it.

                    // mWidth,mHeight are the sizes of the Viewport, those -

                    // sizes of the backing up texture.

    mRealHeight= height;

    mFOV = 60.0f;

    mFBOH[0]         = fbo;

    mDepthStencilH[0]= 0;

    mClearG = 0.0f;

    mClearB = 0.0f;

    mClearA = 0.0f;

    mClearDepth = 1.0f;

    }

    if( mWidth>0 && mHeight>1 )

      {

      if( mFOV>0.0f )  // perspective projection

        {

        float c = mHeight*mNear;

        float right  = +q/2;

        float bottom = -c/2;

        float top    = +c/2;

        float near   =  c/a;

        Matrix.frustumM(mProjectionMatrix, 0, left, right, bottom, top, near, far);

        }

      else             // parallel projection

        {

        float right  = +mWidth/2.0f;

        float bottom = -mHeight/2.0f;

        float top    = +mHeight/2.0f;

        float near   = mWidth+mHeight-mHeight*(1.0f-mNear);

        mDistance    = mWidth+mHeight;

        float far    = mWidth+mHeight+mHeight*(1.0f-mNear);

        Matrix.orthoM(mProjectionMatrix, 0, left, right, bottom, top, near, far);

        }

      }

    }

    for(int j=0; j<EffectQuality.LENGTH; j++)

      {

      }

    DistortedObject.toDo(); // create the FBOs immediately. This is safe as we must be holding the OpenGL context now.

    GLES31.glDepthMask(true);

    GLES31.glColorMask(true,true,true,true);

    GLES31.glClearStencil(0);

    for(int j=0; j<EffectQuality.LENGTH; j++)

      {

      GLES31.glClear(GLES31.GL_COLOR_BUFFER_BIT|GLES31.GL_DEPTH_BUFFER_BIT|GLES31.GL_STENCIL_BUFFER_BIT);

      GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_COLOR_ATTACHMENT0, GLES31.GL_TEXTURE_2D, mBuffer[j].mColorH[0], 0);

      GLES31.glClear(GLES31.GL_COLOR_BUFFER_BIT);

    }

        {

        mBuffer[i] = null;

        }

      mBuffer = null;

    }

// adjust the texture coords - see the get{Width|Height}Correction functions.

      for(int i=0; i<EffectQuality.LENGTH; i++)

        {

        surface = mBuffer[i];

        surface.mWidth  = (int)(from.mWidth *surface.mMipmap);

        surface.mHeight = (int)(from.mHeight*surface.mMipmap);

        surface.mNear   = from.mNear;  // Near plane is independent of the mipmap level

        int maxw = surface.mWidth  > surface.mRealWidth  ? surface.mWidth  : surface.mRealWidth;

        int maxh = surface.mHeight > surface.mRealHeight ? surface.mHeight : surface.mRealHeight;

          {

          surface.mRealWidth = maxw;

          surface.mRealHeight = maxh;

          surface.create();

        }

    }

    GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, buffer.mColorH[0]);

    GLES31.glActiveTexture(GLES31.GL_TEXTURE1);

    GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, buffer.mDepthStencilH[0]);

    GLES31.glStencilMask(0x00);

    GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, 0);

    GLES31.glActiveTexture(GLES31.GL_TEXTURE1);

    GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, 0);

    // clear buffers

    GLES31.glDepthMask(true);

    GLES31.glColorMask(true,true,true,true);

    GLES31.glClearColor(0.0f,0.0f,0.0f,0.0f);

    GLES31.glClearDepthf(1.0f);

    GLES31.glClearStencil(0);

    buffer.setAsOutput();

    GLES31.glClear(GLES31.GL_COLOR_BUFFER_BIT|GLES31.GL_DEPTH_BUFFER_BIT|GLES31.GL_STENCIL_BUFFER_BIT);

    GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_COLOR_ATTACHMENT0, GLES31.GL_TEXTURE_2D, buffer.mColorH[0], 0);

    GLES31.glClear(GLES31.GL_COLOR_BUFFER_BIT);

    return 1;

    }

  void clear()

    {

    DistortedRenderState.colorDepthStencilOn();

    GLES31.glClearColor(mClearR, mClearG, mClearB, mClearA);

    GLES31.glClearDepthf(mClearDepth);

    GLES31.glClearStencil(mClearStencil);

    GLES31.glClear(mClear);

    DistortedRenderState.colorDepthStencilRestore();

    }

// Otherwise, render to a buffer and on each change of Postprocessing Bucket, apply the postprocessing

      currBucket= currQueue.getID();

        {

        GLES31.glBindFramebuffer(GLES31.GL_FRAMEBUFFER, mFBOH[0]);

        numRenders += child1.draw(time,this);

        }

        {

            {

            clonePostprocessingViewport(this);

            }

          else

            for(int j=bucketChange; j<i; j++)

              {

            mBuffer[quality].setAsOutputAndClear(time);

          quality         = currQueue.getQuality();

          bucketChange    = i;

      lastBucket= currBucket;

    }

/**

 * Not part of the Public API.

 *

 * @y.exclude

 */

  public float getWidthCorrection()

    {

    return (float)mWidth/mRealWidth;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

 * Not part of the Public API.

 *

 * @y.exclude

 */

  public float getHeightCorrection()

    {

    return (float)mHeight/mRealHeight;

    }

/**

 * Bind this Surface as a Framebuffer we can render to; always clear it's color bit.

 *

 * Useful for drawing to the postprocessing buffer, which must sometimes be cleared multiple times

 * per frame.

 */

  private void setAsOutputAndClear(long time)

    {

    GLES31.glBindFramebuffer(GLES31.GL_FRAMEBUFFER, mFBOH[0]);

    mTime = time;    // have to do this otherwise on the next setAsOutput() we would clear

    DistortedRenderState.colorDepthStencilOn();

    GLES31.glClearColor(mClearR, mClearG, mClearB, mClearA);

    GLES31.glClear(GLES31.GL_COLOR_BUFFER_BIT);

    DistortedRenderState.colorDepthStencilRestore();

    }

// PUBLIC API

 * Must be called from a thread holding OpenGL Context.

 *

      for(int i=0; i<mNumChildren; i++)

        {

    // Watch out: FIRST change topology, only then deal

    // with OpenGL resources. That's because changing Tree

    // can result in additional Framebuffers that would need

    // to be created immediately, before the calls to drawRecursive()

    boolean changed2 =

*/

    DistortedRenderState.reset();

///////////////////////////////////////////////////////////////////////////////////////////////////

 * Bind this Surface as a Framebuffer we can render to.

 * @param time Present time, in milliseconds. The point: looking at this param the library can figure

 *             out if this is the first time during present frame that this FBO is being set as output.

 *             If so, the library, in addition to binding the Surface for output, also clears the

 *             Surface's color and depth attachments.

    if( mTime!=time )

      {

      mTime = time;

/**

 * Bind this Surface as a Framebuffer we can render to.

 * <p>

 * This version does not attempt to clear anything.

 */

  public void setAsOutput()

    {

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

 * Return the Near plane of the Projection included in the Surface.

 *

 * @return the Near plane.

 */

  public float getNear()

    {

    return mNear;

    }

/**

 * Set mipmap level.

 * <p>

 * Trick for speeding up your renders - one can create a pyramid of OutputSurface objects, each next

 * one some constant FACTOR smaller than the previous (0.5 is the common value), then set the Mipmap

 * Level of the i-th object to be FACTOR^i (we start counting from 0). When rendering any scene into

 * such prepared OutputSurface, the library will make sure to scale any Effects used so that the end

 * scene will end up looking identical no matter which object we render to. Identical, that is, except

 * for the loss of quality and gain in speed associated with rendering to a smaller Surface.

 * Example: if you create two FBOs, one 1000x1000 and another 500x500 in size, and set the second one

 * mipmap to 0.5 (the first one's is 1.0 by default), define Effects to be a single move by (100,100),

 * and render a skinned Mesh into both FBO, the end result will look proportionally the same, because

 * in the second case the move vector (100,100) will be auto-scaled to (50,50).

 * @param mipmap The mipmap level. Acceptable range: 0<mipmap<infinity, although mipmap>1

 *               does not make any sense (that would result in loss of speed and no gain in quality)

 */

  public void setMipmap(float mipmap)

    {

    mMipmap = mipmap;

    }

/**

 * @param r the Red component. Default: 0.0f

 * @param g the Green component. Default: 0.0f

 * @param b the Blue component. Default: 0.0f

 * @param a the Alpha component. Default: 0.0f

 */

  public void glClearColor(float r, float g, float b, float a)

    {

    mClearR = r;

    mClearG = g;

    mClearB = b;

    mClearA = a;

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

 * the Depth buffer of our Surface at the beginning of each frame.

 * @param d the Depth. Default: 1.0f

 */

  public void glClearDepthf(float d)

    {

    mClearDepth = d;

    }

/**

 * Uses glClearStencil() to set up a value with which to clear the

 * Stencil buffer of our Surface at the beginning of each frame.

 *

 * @param s the Stencil. Default: 0

 */

  public void glClearStencil(int s)

    {

    mClearStencil = s;

    }

/**

 * Which buffers to Clear at the beginning of each frame?

 * <p>

 * Valid values: 0, or bitwise OR of one or more values from the set GL_COLOR_BUFFER_BIT,

 *               GL_DEPTH_BUFFER_BIT, GL_STENCIL_BUFFER_BIT.

 * Default: GL_DEPTH_BUFFER_BIT | GL_COLOR_BUFFER_BIT.

 *

 * @param mask bitwise OR of BUFFER_BITs to clear.

 */

  public void glClear(int mask)

    {

    mClear = mask;

    }

/**

 * Create new Projection matrix.

 *

 * @param fov Vertical 'field of view' of the Projection frustrum (in degrees).

 * @param near Distance between the screen plane and the near plane.

 *             the pyramid. When near==1 (illegal!) the near plane is equivalent to the screen plane.

      {

      mFOV = fov;

      }

    if( near<   1.0f && near> 0.0f )

      {

      mNear= near;

      }

    else if( near<=0.0f )

      {

      mNear = 0.01f;

      }

    else if( near>=1.0f )

      {

      mNear=0.99f;

      }

      for(int j=0; j<EffectQuality.LENGTH; j++) mBuffer[j].mNear = mNear;

      }

    }

///////////////////////////////////////////////////////////////////////////////////////////////////

 * This method can be safely called mid-render as it doesn't interfere with rendering.

 * @param width The new width.

 * @param height The new height.

    {

    if( mWidth!=width || mHeight!=height )

      {

      mHeight= mRealHeight= height;

      createProjection();

        }

    }

/**

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

/**

 * Adds a new child to the last position in the list of our Surface's children.

 * We cannot do this mid-render - actual attachment will be done just before the next render, by the

 * @param node The new Node to add.

 */

///////////////////////////////////////////////////////////////////////////////////////////////////

/**

 * Adds a new child to the last position in the list of our Surface's children.

 * We cannot do this mid-render - actual attachment will be done just before the next render, by the

 * @param surface InputSurface to initialize our child Node with.

 * @param effects DistortedEffects to initialize our child Node with.

 * @param mesh MeshObject to initialize our child Node with.

 * @return the newly constructed child Node, or null if we couldn't allocate resources.

 */