Project

General

Profile

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

library / src / main / java / org / distorted / library / main / DistortedFramebuffer.java @ 8ebbc730

1 f6fb3c6d Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
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 f6fb3c6d Leszek Koltunski
22 e6519ac8 Leszek Koltunski
import android.opengl.GLES31;
23 f6fb3c6d Leszek Koltunski
24
///////////////////////////////////////////////////////////////////////////////////////////////////
25 dedacd82 Leszek Koltunski
/**
26
 * Class which represents a OpenGL Framebuffer object.
27 71c3fecc Leszek Koltunski
 * <p>
28 c5369f1b leszek
 * User is able to create offscreen FBOs and both a) render to them b) use their COLOR0 attachment as
29 2ed1c692 leszek
 * an input texture. Attaching Depths and/or Stencils is also possible.
30 dedacd82 Leszek Koltunski
 */
31 af4cc5db Leszek Koltunski
public class DistortedFramebuffer extends DistortedOutputSurface implements DistortedInputSurface
32 f6fb3c6d Leszek Koltunski
  {
33 bd3da5b2 Leszek Koltunski
34 f6fb3c6d Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
35 6537ba91 Leszek Koltunski
// Must be called from a thread holding OpenGL Context
36 f6fb3c6d Leszek Koltunski
37 2f35828c Leszek Koltunski
  void create()
38 f6fb3c6d Leszek Koltunski
    {
39 8ebbc730 Leszek Koltunski
    //////////////////////////////////////////////////////////////
40
    // COLOR
41
42 c7da4e65 leszek
    if( mColorCreated==NOT_CREATED_YET )
43 7cf783cb Leszek Koltunski
      {
44 8ebbc730 Leszek Koltunski
      GLES31.glGenTextures( mNumFBOs*mNumColors, mColorH, 0);
45
      GLES31.glGenFramebuffers(mNumFBOs, mFBOH, 0);
46 9ed80185 Leszek Koltunski
47 8ebbc730 Leszek Koltunski
      for(int i=0; i<mNumFBOs; i++)
48 9ed80185 Leszek Koltunski
        {
49 8ebbc730 Leszek Koltunski
        GLES31.glBindFramebuffer(GLES31.GL_FRAMEBUFFER, mFBOH[i]);
50
51
        for(int j=0; j<mNumColors; j++)
52
          {
53
          GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, mColorH[i*mNumColors+j]);
54
          GLES31.glTexParameteri(GLES31.GL_TEXTURE_2D, GLES31.GL_TEXTURE_WRAP_S, GLES31.GL_REPEAT);
55
          GLES31.glTexParameteri(GLES31.GL_TEXTURE_2D, GLES31.GL_TEXTURE_WRAP_T, GLES31.GL_REPEAT);
56
          GLES31.glTexParameterf(GLES31.GL_TEXTURE_2D, GLES31.GL_TEXTURE_MIN_FILTER, GLES31.GL_NEAREST);
57
          GLES31.glTexParameterf(GLES31.GL_TEXTURE_2D, GLES31.GL_TEXTURE_MAG_FILTER, GLES31.GL_LINEAR);
58
          GLES31.glTexImage2D(GLES31.GL_TEXTURE_2D, 0, GLES31.GL_RGBA, mRealWidth, mRealHeight, 0, GLES31.GL_RGBA, GLES31.GL_UNSIGNED_BYTE, null);
59
          }
60
61
        GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_COLOR_ATTACHMENT0, GLES31.GL_TEXTURE_2D, mColorH[i*mNumColors], 0);
62
        GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, 0);
63 9ed80185 Leszek Koltunski
        }
64 dedacd82 Leszek Koltunski
65 8ebbc730 Leszek Koltunski
      // TODO
66 c7da4e65 leszek
      mColorCreated = checkStatus("color");
67 8ebbc730 Leszek Koltunski
      GLES31.glBindFramebuffer(GLES31.GL_FRAMEBUFFER, 0);
68 7cf783cb Leszek Koltunski
      }
69 8ebbc730 Leszek Koltunski
70
    //////////////////////////////////////////////////////////////
71
    // DEPTH / STENCIL
72
73 89de975c leszek
    if( mDepthStencilCreated==NOT_CREATED_YET ) // we need to create a new DEPTH or STENCIL attachment
74 8c327653 Leszek Koltunski
      {
75 8ebbc730 Leszek Koltunski
      GLES31.glGenTextures(mNumFBOs, mDepthStencilH, 0);
76
77
      for(int i=0; i<mNumFBOs; i++)
78 65e83759 Leszek Koltunski
        {
79 8ebbc730 Leszek Koltunski
        GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, mDepthStencilH[i]);
80
        GLES31.glTexParameteri(GLES31.GL_TEXTURE_2D, GLES31.GL_TEXTURE_WRAP_S, GLES31.GL_REPEAT);
81
        GLES31.glTexParameteri(GLES31.GL_TEXTURE_2D, GLES31.GL_TEXTURE_WRAP_T, GLES31.GL_REPEAT);
82
        GLES31.glTexParameteri(GLES31.GL_TEXTURE_2D, GLES31.GL_TEXTURE_MIN_FILTER, GLES31.GL_NEAREST);
83
        GLES31.glTexParameteri(GLES31.GL_TEXTURE_2D, GLES31.GL_TEXTURE_MAG_FILTER, GLES31.GL_NEAREST);
84 89de975c leszek
85 8ebbc730 Leszek Koltunski
        if (mDepthStencil == DEPTH_NO_STENCIL)
86
          {
87
          GLES31.glTexImage2D(GLES31.GL_TEXTURE_2D, 0, GLES31.GL_DEPTH_COMPONENT, mRealWidth, mRealHeight, 0, GLES31.GL_DEPTH_COMPONENT, GLES31.GL_UNSIGNED_INT, null);
88
          }
89
        else if (mDepthStencil == BOTH_DEPTH_STENCIL)
90
          {
91
          GLES31.glTexImage2D(GLES31.GL_TEXTURE_2D, 0, GLES31.GL_DEPTH24_STENCIL8, mRealWidth, mRealHeight, 0, GLES31.GL_DEPTH_STENCIL, GLES31.GL_UNSIGNED_INT_24_8, null);
92
          }
93
        }
94 e6519ac8 Leszek Koltunski
      GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, 0);
95 8c327653 Leszek Koltunski
96 8ebbc730 Leszek Koltunski
      for(int i=0; i<mNumFBOs; i++)
97 65e83759 Leszek Koltunski
        {
98 8ebbc730 Leszek Koltunski
        GLES31.glBindFramebuffer(GLES31.GL_FRAMEBUFFER, mFBOH[i]);
99 89de975c leszek
100 8ebbc730 Leszek Koltunski
        if (mDepthStencil == DEPTH_NO_STENCIL)
101
          {
102
          GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_DEPTH_ATTACHMENT, GLES31.GL_TEXTURE_2D, mDepthStencilH[i], 0);
103
          }
104
        else if (mDepthStencil == BOTH_DEPTH_STENCIL)
105
          {
106
          GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_DEPTH_STENCIL_ATTACHMENT, GLES31.GL_TEXTURE_2D, mDepthStencilH[i], 0);
107
          }
108
        }
109 89de975c leszek
110 8ebbc730 Leszek Koltunski
      // TODO
111 89de975c leszek
      mDepthStencilCreated = checkStatus("depth");
112 8ebbc730 Leszek Koltunski
      GLES31.glBindFramebuffer(GLES31.GL_FRAMEBUFFER, 0);
113 8c327653 Leszek Koltunski
      }
114 8ebbc730 Leszek Koltunski
115
    //////////////////////////////////////////////////////////////
116
    // DETACH
117
118
    // TODO
119 89de975c leszek
    if( mDepthStencilCreated==DONT_CREATE && mDepthStencilH[0]>0 ) // we need to detach and recreate the DEPTH attachment.
120 8c327653 Leszek Koltunski
      {
121 68f96a01 leszek
      // OpenGL ES 3.0.5 spec, chapter 4.4.2.4 :
122
      // "Note that the texture image is specifically not detached from any other framebuffer objects.
123
      //  Detaching the texture image from any other framebuffer objects is the responsibility of the application."
124 75f95f8d leszek
125 8ebbc730 Leszek Koltunski
      for(int i=0; i<mNumFBOs; i++)
126
        {
127
        GLES31.glBindFramebuffer(GLES31.GL_FRAMEBUFFER, mFBOH[i]);
128
        GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_DEPTH_ATTACHMENT, GLES31.GL_TEXTURE_2D, 0, 0);
129
        GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_DEPTH_STENCIL_ATTACHMENT, GLES31.GL_TEXTURE_2D, 0, 0);
130
        mDepthStencilH[i]=0;
131
        }
132
133
      GLES31.glDeleteTextures(mNumFBOs, mDepthStencilH, 0);
134
      GLES31.glBindFramebuffer(GLES31.GL_FRAMEBUFFER, 0);
135 8c327653 Leszek Koltunski
      }
136 8337fa41 Leszek Koltunski
    }
137
138
///////////////////////////////////////////////////////////////////////////////////////////////////
139 8ebbc730 Leszek Koltunski
// TODO
140 8337fa41 Leszek Koltunski
141 c7da4e65 leszek
  private int checkStatus(String message)
142 8337fa41 Leszek Koltunski
    {
143 e6519ac8 Leszek Koltunski
    int status = GLES31.glCheckFramebufferStatus(GLES31.GL_FRAMEBUFFER);
144 8337fa41 Leszek Koltunski
145 e6519ac8 Leszek Koltunski
    if(status != GLES31.GL_FRAMEBUFFER_COMPLETE)
146 8337fa41 Leszek Koltunski
      {
147
      android.util.Log.e("DistortedFramebuffer", "FRAMEBUFFER INCOMPLETE, "+message+" error="+status);
148
149 e6519ac8 Leszek Koltunski
      GLES31.glDeleteTextures(1, mColorH, 0);
150
      GLES31.glDeleteTextures(1, mDepthStencilH, 0);
151
      GLES31.glDeleteFramebuffers(1, mFBOH, 0);
152 c7da4e65 leszek
      mFBOH[0]= 0;
153 8337fa41 Leszek Koltunski
154 c7da4e65 leszek
      return FAILED_TO_CREATE;
155 8337fa41 Leszek Koltunski
      }
156 8c327653 Leszek Koltunski
157 c7da4e65 leszek
    return CREATED;
158 f6fb3c6d Leszek Koltunski
    }
159
160
///////////////////////////////////////////////////////////////////////////////////////////////////
161 6537ba91 Leszek Koltunski
// Must be called from a thread holding OpenGL Context
162 f6fb3c6d Leszek Koltunski
163 2f35828c Leszek Koltunski
  void delete()
164 f6fb3c6d Leszek Koltunski
    {
165 c7da4e65 leszek
    if( mColorH[0]>0 )
166 e6cf7d50 Leszek Koltunski
      {
167 8ebbc730 Leszek Koltunski
      GLES31.glDeleteTextures(mNumFBOs*mNumColors, mColorH, 0);
168 c7da4e65 leszek
      mColorCreated = NOT_CREATED_YET;
169 8ebbc730 Leszek Koltunski
170
      for(int i=0; i<mNumFBOs*mNumColors; i++) mColorH[i] = 0;
171 5b959cc5 Leszek Koltunski
      }
172 bd3da5b2 Leszek Koltunski
173 5b959cc5 Leszek Koltunski
    if( mDepthStencilH[0]>0 )
174
      {
175 8ebbc730 Leszek Koltunski
      GLES31.glDeleteTextures(mNumFBOs, mDepthStencilH, 0);
176 5b959cc5 Leszek Koltunski
      mDepthStencilCreated = NOT_CREATED_YET;
177 8ebbc730 Leszek Koltunski
178
      for(int i=0; i<mNumFBOs; i++) mDepthStencilH[i] = 0;
179 e6cf7d50 Leszek Koltunski
      }
180 5b959cc5 Leszek Koltunski
181 8ebbc730 Leszek Koltunski
    GLES31.glDeleteFramebuffers(mNumFBOs, mFBOH, 0);
182
    for(int i=0; i<mNumFBOs; i++) mFBOH[i] = 0;
183 bd3da5b2 Leszek Koltunski
    }
184
185 4ebbb17a Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
186
// called from onDestroy(); mark OpenGL assets as 'not created'
187
188 2f35828c Leszek Koltunski
  void recreate()
189 4ebbb17a Leszek Koltunski
    {
190 05ecc6fe Leszek Koltunski
    if( mColorCreated!=DONT_CREATE )
191
      {
192
      mColorCreated = NOT_CREATED_YET;
193
      mColorH[0] = 0;
194
      }
195 89de975c leszek
    if( mDepthStencilCreated!=DONT_CREATE )
196 05ecc6fe Leszek Koltunski
      {
197 89de975c leszek
      mDepthStencilCreated = NOT_CREATED_YET;
198
      mDepthStencilH[0] = 0;
199 05ecc6fe Leszek Koltunski
      }
200 4ebbb17a Leszek Koltunski
    }
201
202 8ebbc730 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
203
204
  boolean setAsInput(int fbo, int texture)
205
    {
206
    if( texture>=0 && texture<mNumColors && fbo>=0 && fbo<mNumFBOs && mColorH[mNumColors*fbo + texture]>0 )
207
      {
208
      GLES31.glActiveTexture(GLES31.GL_TEXTURE0);
209
      GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, mColorH[mNumColors*fbo + texture]);
210
      return true;
211
      }
212
213
    return false;
214
    }
215
216 af27df87 leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
217 09ab7524 Leszek Koltunski
// create SYSTEM or TREE framebuffers (those are just like normal FBOs, just hold information
218
// that they were autocreated only for the Library's internal purposes (SYSTEM) or for using
219
// inside a Tree of DistortedNodes (TREE)
220
// SYSTEM surfaces do not get removed in onDestroy().
221 af27df87 leszek
222 9ed80185 Leszek Koltunski
  DistortedFramebuffer(int numcolors, int depthStencil, int type, int width, int height)
223 af27df87 leszek
    {
224 8ebbc730 Leszek Koltunski
    super(width,height,NOT_CREATED_YET,1,numcolors,depthStencil,NOT_CREATED_YET, type);
225
    }
226
227
///////////////////////////////////////////////////////////////////////////////////////////////////
228
// create a multi-framebuffer (1 object containing multiple FBOs)
229
230
  DistortedFramebuffer(int numfbos, int numcolors, int depthStencil, int type, int width, int height)
231
    {
232
    super(width,height,NOT_CREATED_YET,numfbos,numcolors,depthStencil,NOT_CREATED_YET, type);
233 af27df87 leszek
    }
234
235 f6fb3c6d Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
236
// PUBLIC API
237 dedacd82 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
238 cdd5e827 Leszek Koltunski
/**
239 9ed80185 Leszek Koltunski
 * Create new offscreen Framebuffer with configurable number of COLOR, DEPTH and STENCIL attachments.
240 cdd5e827 Leszek Koltunski
 *
241 9ed80185 Leszek Koltunski
 * @param width        Width of all the COLOR attachments.
242
 * @param height       Height of all the COLOR attachments.
243
 * @param numcolors    How many COLOR attachments to create?
244 89de975c leszek
 * @param depthStencil Add DEPTH or STENCIL attachment?
245 23eecbd9 Leszek Koltunski
 *                     Valid values: NO_DEPTH_NO_STENCIL, DEPTH_NO_STENCIL, BOTH_DEPTH_STENCIL.
246 cdd5e827 Leszek Koltunski
 */
247
  @SuppressWarnings("unused")
248 9ed80185 Leszek Koltunski
  public DistortedFramebuffer(int width, int height, int numcolors, int depthStencil)
249 cdd5e827 Leszek Koltunski
    {
250 8ebbc730 Leszek Koltunski
    super(width,height,NOT_CREATED_YET,1,numcolors,depthStencil,NOT_CREATED_YET,TYPE_USER);
251 cdd5e827 Leszek Koltunski
    }
252
253 b448e6b9 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
254 dedacd82 Leszek Koltunski
/**
255 c5369f1b leszek
 * Bind the underlying rectangle of pixels as a OpenGL Texture.
256 af4cc5db Leszek Koltunski
 *
257 a436ccc5 leszek
 * @return <code>true</code> if successful.
258 dedacd82 Leszek Koltunski
 */
259 c5369f1b leszek
  public boolean setAsInput()
260 b448e6b9 Leszek Koltunski
    {
261 c5369f1b leszek
    if( mColorH[0]>0 )
262
      {
263 e6519ac8 Leszek Koltunski
      GLES31.glActiveTexture(GLES31.GL_TEXTURE0);
264
      GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, mColorH[0]);
265 c5369f1b leszek
      return true;
266
      }
267
268
    return false;
269
    }
270 2e49718d Leszek Koltunski
271 1dfc9074 leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
272
/**
273
 * Bind the underlying rectangle of pixels as a OpenGL Texture.
274
 *
275
 * @return <code>true</code> if successful.
276
 */
277
  public boolean setAsInput(int texture)
278
    {
279
    if( texture>=0 && texture<mNumColors && mColorH[texture]>0 )
280
      {
281 e6519ac8 Leszek Koltunski
      GLES31.glActiveTexture(GLES31.GL_TEXTURE0);
282
      GLES31.glBindTexture(GLES31.GL_TEXTURE_2D, mColorH[texture]);
283 1dfc9074 leszek
      return true;
284
      }
285
286
    return false;
287
    }
288
289
///////////////////////////////////////////////////////////////////////////////////////////////////
290
291
  public void bindForOutput(int texture)
292
    {
293
    if( texture>=0 && texture<mNumColors && mColorH[texture]>0 )
294
      {
295 e6519ac8 Leszek Koltunski
      GLES31.glFramebufferTexture2D(GLES31.GL_FRAMEBUFFER, GLES31.GL_COLOR_ATTACHMENT0, GLES31.GL_TEXTURE_2D, mColorH[texture], 0);
296 1dfc9074 leszek
      }
297
    }
298
299 89de975c leszek
///////////////////////////////////////////////////////////////////////////////////////////////////
300
/**
301
 * Enable.disable DEPTH and STENCIL buffers.
302
 *
303 23eecbd9 Leszek Koltunski
 * @param depthStencil Valid values: NO_DEPTH_NO_STENCIL, DEPTH_NO_STENCIL, BOTH_DEPTH_STENCIL.
304 89de975c leszek
 */
305
  public void enableDepthStencil(int depthStencil)
306
    {
307 65e83759 Leszek Koltunski
    if( depthStencil != mDepthStencil )
308 89de975c leszek
      {
309
      mDepthStencil = depthStencil;
310
311 65e83759 Leszek Koltunski
      if( depthStencil!= NO_DEPTH_NO_STENCIL && mDepthStencilCreated==DONT_CREATE )
312 89de975c leszek
        {
313 65e83759 Leszek Koltunski
        mDepthStencilCreated = NOT_CREATED_YET;
314
        markForCreation();
315 89de975c leszek
        }
316 65e83759 Leszek Koltunski
      if( depthStencil== NO_DEPTH_NO_STENCIL && mDepthStencilCreated!=DONT_CREATE )
317
        {
318
        mDepthStencilCreated = DONT_CREATE;
319
        markForCreation();
320
        }
321 89de975c leszek
      }
322
    }
323
324 d1e740c5 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
325
/**
326 09d4f4b1 Leszek Koltunski
 * Return the ID of the Texture (COLOR attachment 0) that's backing this FBO.
327
 * <p>
328
 * Catch: this will only work if the library has had time to actually create the texture. Remember
329
 * that the texture gets created only on first render, thus creating a Texture object and immediately
330
 * calling this method will return an invalid (negative) result.
331
 *
332 ab12f06b Leszek Koltunski
 * @return If there was not a single render between creation of the Object and calling this method on
333
 *         it, return a negative value. Otherwise, return ID of COLOR attachment 0.
334 d1e740c5 Leszek Koltunski
 */
335 09d4f4b1 Leszek Koltunski
  public int getTextureID()
336 d1e740c5 Leszek Koltunski
    {
337 133cbb2b Leszek Koltunski
    return mColorH[0];
338 8c327653 Leszek Koltunski
    }
339 f6fb3c6d Leszek Koltunski
  }