Project

General

Profile

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

library / src / main / java / org / distorted / library / DistortedFramebuffer.java @ cc0734e7

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
package org.distorted.library;
21
22
import android.opengl.GLES20;
23
import android.opengl.Matrix;
24
25 8e34674e Leszek Koltunski
import java.util.Iterator;
26
import java.util.LinkedList;
27
28 f6fb3c6d Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
29 dedacd82 Leszek Koltunski
/**
30
 * Class which represents a OpenGL Framebuffer object.
31 71c3fecc Leszek Koltunski
 * <p>
32 65362dd4 Leszek Koltunski
 * User is able to create either Framebuffers from objects already constructed outside
33
 * of the library (the first constructor; primary use case: the screen) or an offscreen
34 e0b6c593 Leszek Koltunski
 * FBOs.
35 71c3fecc Leszek Koltunski
 * <p>
36 e0b6c593 Leszek Koltunski
 * Keep all objects created in a static LinkedList. The point: we need to be able to mark
37 8e34674e Leszek Koltunski
 * Framebuffers for deletion, and delete all marked objects later at a convenient time (that's
38
 * because we can only delete from a thread that holds the OpenGL context so here we provide a
39 65362dd4 Leszek Koltunski
 * framework where one is able to mark for deletion at any time and actual deletion takes place
40 8e34674e Leszek Koltunski
 * on the next render).
41 dedacd82 Leszek Koltunski
 */
42 ed13a5de Leszek Koltunski
public class DistortedFramebuffer
43 f6fb3c6d Leszek Koltunski
  {
44 8c327653 Leszek Koltunski
  private static final int FAILED_TO_CREATE = -1;
45
  private static final int NOT_CREATED_YET  = -2;
46
  private static final int DONT_CREATE      = -3;
47 f6fb3c6d Leszek Koltunski
48 8e34674e Leszek Koltunski
  private static boolean mListMarked = false;
49
  private static LinkedList<DistortedFramebuffer> mList = new LinkedList<>();
50
51 8c327653 Leszek Koltunski
  private int[] colorIds = new int[1];
52
  private int[] depthIds = new int[1];
53
  private int[] fboIds   = new int[1];
54 7304d89f Leszek Koltunski
55 8e34674e Leszek Koltunski
  private boolean mMarked;
56 8c327653 Leszek Koltunski
  private boolean mDepthWanted;
57 8e34674e Leszek Koltunski
58 86eb00a9 Leszek Koltunski
  private int mTexWidth, mTexHeight;
59
60 da99dd30 Leszek Koltunski
  // Projection stuff
61
  private float mX, mY, mFOV;
62 e6cf7d50 Leszek Koltunski
  int mWidth,mHeight,mDepth;
63
  float mDistance;
64 f6fb3c6d Leszek Koltunski
  float[] mProjectionMatrix;
65 bd3da5b2 Leszek Koltunski
66 f6fb3c6d Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
67 6537ba91 Leszek Koltunski
// Must be called from a thread holding OpenGL Context
68 f6fb3c6d Leszek Koltunski
69 8337fa41 Leszek Koltunski
  void createFBO()
70 f6fb3c6d Leszek Koltunski
    {
71 8c327653 Leszek Koltunski
    if( colorIds[0]==NOT_CREATED_YET )
72 7cf783cb Leszek Koltunski
      {
73 8c327653 Leszek Koltunski
      GLES20.glGenTextures(1, colorIds, 0);
74
      GLES20.glBindTexture(GLES20.GL_TEXTURE_2D, colorIds[0]);
75 7cf783cb Leszek Koltunski
      GLES20.glTexParameteri(GLES20.GL_TEXTURE_2D, GLES20.GL_TEXTURE_WRAP_S, GLES20.GL_REPEAT);
76
      GLES20.glTexParameteri(GLES20.GL_TEXTURE_2D, GLES20.GL_TEXTURE_WRAP_T, GLES20.GL_REPEAT);
77 8337fa41 Leszek Koltunski
      GLES20.glTexParameterf(GLES20.GL_TEXTURE_2D, GLES20.GL_TEXTURE_MIN_FILTER, GLES20.GL_NEAREST);
78
      GLES20.glTexParameterf(GLES20.GL_TEXTURE_2D, GLES20.GL_TEXTURE_MAG_FILTER, GLES20.GL_LINEAR);
79 86eb00a9 Leszek Koltunski
      GLES20.glTexImage2D(GLES20.GL_TEXTURE_2D, 0, GLES20.GL_RGBA, mTexWidth, mTexHeight, 0, GLES20.GL_RGBA, GLES20.GL_UNSIGNED_BYTE, null);
80 f6fb3c6d Leszek Koltunski
81 7cf783cb Leszek Koltunski
      GLES20.glGenFramebuffers(1, fboIds, 0);
82
      GLES20.glBindFramebuffer(GLES20.GL_FRAMEBUFFER, fboIds[0]);
83 8c327653 Leszek Koltunski
      GLES20.glFramebufferTexture2D(GLES20.GL_FRAMEBUFFER, GLES20.GL_COLOR_ATTACHMENT0, GLES20.GL_TEXTURE_2D, colorIds[0], 0);
84 dedacd82 Leszek Koltunski
85 8337fa41 Leszek Koltunski
      checkStatus("color");
86 7cf783cb Leszek Koltunski
      }
87 86eb00a9 Leszek Koltunski
    if( mDepthWanted && depthIds[0]==NOT_CREATED_YET ) // we need to create a new DEPTH attachment
88 8c327653 Leszek Koltunski
      {
89
      GLES20.glGenTextures(1, depthIds, 0);
90
      GLES20.glBindTexture(GLES20.GL_TEXTURE_2D, depthIds[0]);
91
      GLES20.glTexParameteri(GLES20.GL_TEXTURE_2D, GLES20.GL_TEXTURE_WRAP_S, GLES20.GL_REPEAT);
92
      GLES20.glTexParameteri(GLES20.GL_TEXTURE_2D, GLES20.GL_TEXTURE_WRAP_T, GLES20.GL_REPEAT);
93
      GLES20.glTexParameteri(GLES20.GL_TEXTURE_2D, GLES20.GL_TEXTURE_MIN_FILTER, GLES20.GL_NEAREST);
94
      GLES20.glTexParameteri(GLES20.GL_TEXTURE_2D, GLES20.GL_TEXTURE_MAG_FILTER, GLES20.GL_NEAREST);
95 86eb00a9 Leszek Koltunski
      GLES20.glTexImage2D(GLES20.GL_TEXTURE_2D, 0, GLES20.GL_DEPTH_COMPONENT, mTexWidth, mTexHeight, 0, GLES20.GL_DEPTH_COMPONENT, GLES20.GL_UNSIGNED_SHORT, null);
96 8c327653 Leszek Koltunski
97
      GLES20.glBindFramebuffer(GLES20.GL_FRAMEBUFFER, fboIds[0]);
98
      GLES20.glFramebufferTexture2D(GLES20.GL_FRAMEBUFFER, GLES20.GL_DEPTH_ATTACHMENT, GLES20.GL_TEXTURE_2D, depthIds[0], 0);
99
100 8337fa41 Leszek Koltunski
      checkStatus("depth");
101 8c327653 Leszek Koltunski
      }
102
    if( !mDepthWanted && depthIds[0]!=NOT_CREATED_YET ) // we need to detach and destroy the DEPTH attachment.
103
      {
104
      GLES20.glDeleteTextures(1, depthIds, 0);
105
      depthIds[0]=NOT_CREATED_YET;
106
      }
107 8337fa41 Leszek Koltunski
    }
108
109
///////////////////////////////////////////////////////////////////////////////////////////////////
110
111
  private boolean checkStatus(String message)
112
    {
113
    int status = GLES20.glCheckFramebufferStatus(GLES20.GL_FRAMEBUFFER);
114
115
    if(status != GLES20.GL_FRAMEBUFFER_COMPLETE)
116
      {
117
      android.util.Log.e("DistortedFramebuffer", "FRAMEBUFFER INCOMPLETE, "+message+" error="+status);
118
119
      GLES20.glDeleteTextures(1, colorIds, 0);
120
      GLES20.glDeleteTextures(1, depthIds, 0);
121
      GLES20.glDeleteFramebuffers(1, fboIds, 0);
122
      fboIds[0]   = 0;
123
      colorIds[0] = FAILED_TO_CREATE;
124
      depthIds[0] = FAILED_TO_CREATE;
125
126
      return false;
127
      }
128 8c327653 Leszek Koltunski
129 f6fb3c6d Leszek Koltunski
    return true;
130
    }
131
132
///////////////////////////////////////////////////////////////////////////////////////////////////
133 6537ba91 Leszek Koltunski
// Must be called from a thread holding OpenGL Context
134 f6fb3c6d Leszek Koltunski
135
  private void deleteFBO()
136
    {
137 8c327653 Leszek Koltunski
    if( colorIds[0]>=0 )
138 e6cf7d50 Leszek Koltunski
      {
139 46e25345 Leszek Koltunski
      //android.util.Log.e("FBO", "deleting ("+mWidth+","+mHeight+") "+fboIds[0]);
140 f6fb3c6d Leszek Koltunski
141 8c327653 Leszek Koltunski
      if( depthIds[0]>=0 )
142
        {
143
        GLES20.glDeleteTextures(1, depthIds, 0);
144
        depthIds[0]=NOT_CREATED_YET;
145
        }
146
147
      GLES20.glDeleteTextures(1, colorIds, 0);
148
      colorIds[0] = NOT_CREATED_YET;
149 bd3da5b2 Leszek Koltunski
150 8c327653 Leszek Koltunski
      GLES20.glDeleteFramebuffers(1, fboIds, 0);
151 e6cf7d50 Leszek Koltunski
      fboIds[0] = 0;
152
      }
153 bd3da5b2 Leszek Koltunski
154
    mMarked = false;
155
    }
156
157 da99dd30 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
158
159
  void setAsOutput()
160
    {
161
    GLES20.glBindFramebuffer(GLES20.GL_FRAMEBUFFER, fboIds[0]);
162 8c327653 Leszek Koltunski
163
    if( depthIds[0]!=NOT_CREATED_YET )
164
      {
165
      GLES20.glEnable(GLES20.GL_DEPTH_TEST);
166
      GLES20.glDepthMask(true);
167
      }
168
    else
169
      {
170
      GLES20.glDisable(GLES20.GL_DEPTH_TEST);
171
      GLES20.glDepthMask(false);
172
      }
173 da99dd30 Leszek Koltunski
    }
174
175
///////////////////////////////////////////////////////////////////////////////////////////////////
176
177
  void setAsInput()
178
    {
179 8c327653 Leszek Koltunski
    GLES20.glBindTexture(GLES20.GL_TEXTURE_2D, colorIds[0]);
180 da99dd30 Leszek Koltunski
    }
181
182 09d4f4b1 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
183
184
  private void createProjection()
185
    {
186
    if( mWidth>0 && mHeight>1 )
187
      {
188
      if( mFOV>0.0f )  // perspective projection
189
        {
190
        float left   = (-mX-mWidth /2.0f)/mHeight;
191
        float right  = (-mX+mWidth /2.0f)/mHeight;
192
        float bottom = (-mY-mHeight/2.0f)/mHeight;
193
        float top    = (-mY+mHeight/2.0f)/mHeight;
194
        float near   = (top-bottom) / (2.0f*(float)Math.tan(mFOV*Math.PI/360));
195
        mDistance    = mHeight*near/(top-bottom);
196
        float far    = 2*mDistance-near;
197
        mDepth       = (int)((far-near)/2);
198
199
        Matrix.frustumM(mProjectionMatrix, 0, left, right, bottom, top, near, far);
200
        }
201
      else             // parallel projection
202
        {
203
        float left   = -mX-mWidth /2.0f;
204
        float right  = -mX+mWidth /2.0f;
205
        float bottom = -mY-mHeight/2.0f;
206
        float top    = -mY+mHeight/2.0f;
207
        float near   = (mWidth+mHeight)/2;
208
        mDistance    = 2*near;
209
        float far    = 3*near;
210
        mDepth       = (int)near;
211
212
        Matrix.orthoM(mProjectionMatrix, 0, left, right, bottom, top, near, far);
213
        }
214
      }
215
    }
216
217 8e34674e Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
218
219 7b8086eb Leszek Koltunski
  static synchronized void onDestroy()
220 8e34674e Leszek Koltunski
    {
221 02de77c9 Leszek Koltunski
    for( DistortedFramebuffer fbo : mList)
222
      {
223
      if( fbo.colorIds[0]!=DONT_CREATE ) fbo.colorIds[0] = NOT_CREATED_YET;
224
      if( fbo.mDepthWanted             ) fbo.depthIds[0] = NOT_CREATED_YET;
225
      }
226 8e34674e Leszek Koltunski
    }
227
228
///////////////////////////////////////////////////////////////////////////////////////////////////
229
// must be called form a thread holding OpenGL Context
230
231 d6e94c84 Leszek Koltunski
  private static synchronized void deleteAllMarked()
232 8e34674e Leszek Koltunski
    {
233
    if( mListMarked )
234
      {
235
      DistortedFramebuffer tmp;
236
      Iterator<DistortedFramebuffer> iterator = mList.iterator();
237
238
      while(iterator.hasNext())
239
        {
240
        tmp = iterator.next();
241
242
        if( tmp.mMarked )
243
          {
244 e6cf7d50 Leszek Koltunski
          tmp.deleteFBO();
245 8e34674e Leszek Koltunski
          iterator.remove();
246
          }
247
        }
248
249
      mListMarked = false;
250
      }
251
    }
252 57578636 Leszek Koltunski
253 86eb00a9 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
254
// if new size fits into the size of the underlying Texture, just change the projection without
255
// reallocating the Texture. Otherwise, we need to reallocate.
256
//
257
// Must be called form a thread holding the OpenGL context.
258
259
  void resizeFast(int width, int height)
260
    {
261
    if( mWidth!=width || mHeight!=height )
262
      {
263
      mWidth = width;
264
      mHeight= height;
265
266
      createProjection();
267
268
      if( mWidth>mTexWidth || mHeight>mTexHeight )
269
        {
270
        mTexWidth = mWidth;
271
        mTexHeight= mHeight;
272
        deleteFBO();
273
        }
274
      }
275 cc0734e7 Leszek Koltunski
276
    createFBO();
277 86eb00a9 Leszek Koltunski
    }
278
279 f6fb3c6d Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
280
// PUBLIC API
281 dedacd82 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
282
/**
283 57578636 Leszek Koltunski
 * Create a new offscreen Framebuffer.
284 dedacd82 Leszek Koltunski
 *
285
 * @param width Width of the COLOR attachment.
286
 * @param height Height of the COLOR attachment.
287
 */
288 1942537e Leszek Koltunski
  @SuppressWarnings("unused")
289 ed13a5de Leszek Koltunski
  public DistortedFramebuffer(int width, int height)
290 f6fb3c6d Leszek Koltunski
    {
291
    mProjectionMatrix = new float[16];
292
293 8c327653 Leszek Koltunski
    mHeight     = height;
294
    mWidth      = width;
295 86eb00a9 Leszek Koltunski
    mTexHeight  = height;
296
    mTexWidth   = width;
297 8c327653 Leszek Koltunski
    mFOV        = 60.0f;
298
    mX          = 0.0f;
299
    mY          = 0.0f;
300
    mMarked     = false;
301
    mDepthWanted= false;
302
303
    fboIds[0]  =-1;
304
    colorIds[0]= NOT_CREATED_YET;
305
    depthIds[0]= NOT_CREATED_YET;
306 bd3da5b2 Leszek Koltunski
307 f6fb3c6d Leszek Koltunski
    createProjection();
308 86eb00a9 Leszek Koltunski
309
    mList.add(this);
310 f6fb3c6d Leszek Koltunski
    }
311
312 b448e6b9 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
313 dedacd82 Leszek Koltunski
/**
314 57578636 Leszek Koltunski
 * Create a new Framebuffer from an already created OpenGL Framebuffer.
315
 * <p>
316
 * Has to be followed by a 'resize()' to set the size.
317 dedacd82 Leszek Koltunski
 *
318
 * @param fbo the ID of a OpenGL Framebuffer object. Typically 0 (the screen)
319
 */
320 ed13a5de Leszek Koltunski
  public DistortedFramebuffer(int fbo)
321 b448e6b9 Leszek Koltunski
    {
322
    mProjectionMatrix = new float[16];
323
324 8c327653 Leszek Koltunski
    mFOV        = 60.0f;
325
    mX          = 0.0f;
326
    mY          = 0.0f;
327
    mMarked     = false;
328
    mDepthWanted= true;
329
330
    fboIds[0]  = fbo;
331
    colorIds[0]= DONT_CREATE;
332
    depthIds[0]= DONT_CREATE;
333
    }
334
335
///////////////////////////////////////////////////////////////////////////////////////////////////
336
/**
337
 * Create a new DEPTH buffer and attach it or (param=false) detach an existing DEPTh attachment and destroy it.
338
 *
339
 * @param hasDepthAttachment <bold>true</bold> if we want to attach a new DEPTH buffer to the FBO.<br>
340
 *                           <bold>false</bold> if we want to detach the DEPTH attachment.
341
 */
342
  public void setDepthAttachment(boolean hasDepthAttachment)
343
    {
344
    mDepthWanted = hasDepthAttachment;
345 b448e6b9 Leszek Koltunski
    }
346
347 a0f644b7 Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
348 8c327653 Leszek Koltunski
349 a0f644b7 Leszek Koltunski
/**
350 05403bba Leszek Koltunski
 * Draw the (texture,mesh,effects) object to the Framebuffer.
351 a0f644b7 Leszek Koltunski
 * <p>
352 d254d550 Leszek Koltunski
 * Must be called from a thread holding OpenGL Context.
353 a0f644b7 Leszek Koltunski
 *
354
 * @param tex input Texture to use.
355 05403bba Leszek Koltunski
 * @param mesh Class descendant from MeshObject
356 a0f644b7 Leszek Koltunski
 * @param effects The DistortedEffects to use when rendering
357
 * @param time Current time, in milliseconds.
358
 */
359 05403bba Leszek Koltunski
  public void renderTo(DistortedTexture tex, MeshObject mesh, DistortedEffects effects, long time)
360 a0f644b7 Leszek Koltunski
    {
361
    tex.createTexture();
362 e7a20702 Leszek Koltunski
    tex.setAsInput();
363 86eb00a9 Leszek Koltunski
    DistortedFramebuffer.deleteAllMarked();
364
    DistortedTexture.deleteAllMarked();
365 a0f644b7 Leszek Koltunski
    createFBO();
366 8c327653 Leszek Koltunski
    setAsOutput();
367 05403bba Leszek Koltunski
    effects.drawPriv(tex.mHalfX, tex.mHalfY, mesh, this, time);
368 a0f644b7 Leszek Koltunski
    }
369
370
///////////////////////////////////////////////////////////////////////////////////////////////////
371 52358355 Leszek Koltunski
/**
372 05403bba Leszek Koltunski
 * Draw the (framebuffer,mesh,effects) object to the Framebuffer.
373 52358355 Leszek Koltunski
 * <p>
374 d254d550 Leszek Koltunski
 * Must be called from a thread holding OpenGL Context.
375 52358355 Leszek Koltunski
 *
376 432442f9 Leszek Koltunski
 * @param fbo The Framebuffer (previously created with the first constructor, drawing FROM the screen
377 a0700272 Leszek Koltunski
 *            is unsupported!) whose COLOR attachment 0 will be used as input texture.
378 484a52a7 Leszek Koltunski
 *            Please note that rendering from an FBO to itself is unsupported by OpenGL!
379 05403bba Leszek Koltunski
 * @param mesh Class descendant from MeshObject
380 52358355 Leszek Koltunski
 * @param effects The DistortedEffects to use when rendering
381
 * @param time Current time, in milliseconds.
382
 */
383 05403bba Leszek Koltunski
  public void renderTo(DistortedFramebuffer fbo, MeshObject mesh, DistortedEffects effects, long time)
384 52358355 Leszek Koltunski
    {
385
    fbo.createFBO();
386
387 8c327653 Leszek Koltunski
    if( fbo.colorIds[0]>0 )    // fbo created with the first constructor
388 52358355 Leszek Koltunski
      {
389 86eb00a9 Leszek Koltunski
      DistortedFramebuffer.deleteAllMarked();
390
      DistortedTexture.deleteAllMarked();
391 52358355 Leszek Koltunski
      createFBO();
392 8c327653 Leszek Koltunski
      setAsOutput();
393
      GLES20.glBindTexture(GLES20.GL_TEXTURE_2D, fbo.colorIds[0]);
394 05403bba Leszek Koltunski
      effects.drawPriv(fbo.mWidth/2, fbo.mHeight/2, mesh, this, time);
395 52358355 Leszek Koltunski
      }
396
    }
397
398
///////////////////////////////////////////////////////////////////////////////////////////////////
399 a0f644b7 Leszek Koltunski
/**
400
 * Draws the Tree, and all its children, to the Framebuffer.
401
 * <p>
402 d254d550 Leszek Koltunski
 * Must be called from a thread holding OpenGL Context.
403 a0f644b7 Leszek Koltunski
 *
404
 * @param dt DistortedTree to render.
405
 * @param time Current time, in milliseconds. This will be passed to all the Effects stored in the Tree.
406
 */
407
  public void renderTo(DistortedTree dt, long time)
408
    {
409 86eb00a9 Leszek Koltunski
    DistortedFramebuffer.deleteAllMarked();
410
    DistortedTexture.deleteAllMarked();
411 a0f644b7 Leszek Koltunski
    createFBO();
412 8c327653 Leszek Koltunski
    setAsOutput();
413 a0f644b7 Leszek Koltunski
    dt.drawRecursive(time,this);
414
    }
415
416 f6fb3c6d Leszek Koltunski
///////////////////////////////////////////////////////////////////////////////////////////////////
417 dedacd82 Leszek Koltunski
/**
418
 * Mark the underlying OpenGL object for deletion. Actual deletion will take place on the next render.
419
 */
420 bd3da5b2 Leszek Koltunski
  public void markForDeletion()
421 f6fb3c6d Leszek Koltunski
    {
422 46e25345 Leszek Koltunski
    //android.util.Log.e("FBO", "marking for deletion ("+mWidth+","+mHeight+") "+fboIds[0]);
423 16d8b8f3 Leszek Koltunski
424 8e34674e Leszek Koltunski
    mListMarked = true;
425
    mMarked     = true;
426 f6fb3c6d Leszek Koltunski
    }
427
428
///////////////////////////////////////////////////////////////////////////////////////////////////
429 dedacd82 Leszek Koltunski
/**
430
 * Create new Projection matrix.
431
 *
432
 * @param fov Vertical 'field of view' of the Projection frustrum (in degrees).
433 46a52b78 Leszek Koltunski
 * @param x X-coordinate of the point at which our camera looks at. 0 is the center.
434
 * @param y Y-coordinate of the point at which our camera looks at. 0 is the center.
435 dedacd82 Leszek Koltunski
 */
436
  public void setProjection(float fov, float x, float y)
437 f6fb3c6d Leszek Koltunski
    {
438 dedacd82 Leszek Koltunski
    mFOV = fov;
439 f6fb3c6d Leszek Koltunski
    mX   = x;
440
    mY   = y;
441
442
    createProjection();
443
    }
444
445
///////////////////////////////////////////////////////////////////////////////////////////////////
446 dedacd82 Leszek Koltunski
/**
447
 * Resize the underlying Framebuffer.
448
 *
449
 * As the Framebuffer is not created until the first render, typical usage of this API is actually
450
 * to set the size of an not-yet-created Framebuffer of an object that has been created with the
451
 * second constructor.
452 71c3fecc Leszek Koltunski
 * <p>
453 65362dd4 Leszek Koltunski
 * Fully creating an object, rendering to it, then resizing mid-render is also possible. Actual
454
 * resize takes place on the next render.
455 dedacd82 Leszek Koltunski
 *
456
 * @param width The new width.
457
 * @param height The new height.
458
 */
459 f6fb3c6d Leszek Koltunski
  public void resize(int width, int height)
460
    {
461 bd3da5b2 Leszek Koltunski
    if( mWidth!=width || mHeight!=height )
462
      {
463 86eb00a9 Leszek Koltunski
      mWidth    = width;
464
      mHeight   = height;
465
      mTexWidth = width;
466
      mTexHeight= height;
467 f6fb3c6d Leszek Koltunski
468 bd3da5b2 Leszek Koltunski
      createProjection();
469 f6fb3c6d Leszek Koltunski
470 8c327653 Leszek Koltunski
      if( colorIds[0]>0 ) markForDeletion();
471 bd3da5b2 Leszek Koltunski
      }
472 f6fb3c6d Leszek Koltunski
    }
473 d1e740c5 Leszek Koltunski
474
///////////////////////////////////////////////////////////////////////////////////////////////////
475
/**
476 09d4f4b1 Leszek Koltunski
 * Return the ID of the Texture (COLOR attachment 0) that's backing this FBO.
477
 * <p>
478
 * Catch: this will only work if the library has had time to actually create the texture. Remember
479
 * that the texture gets created only on first render, thus creating a Texture object and immediately
480
 * calling this method will return an invalid (negative) result.
481
 *
482 ab12f06b Leszek Koltunski
 * @return If there was not a single render between creation of the Object and calling this method on
483
 *         it, return a negative value. Otherwise, return ID of COLOR attachment 0.
484 d1e740c5 Leszek Koltunski
 */
485 09d4f4b1 Leszek Koltunski
  public int getTextureID()
486 d1e740c5 Leszek Koltunski
    {
487 8c327653 Leszek Koltunski
    return colorIds[0];
488
    }
489
490
///////////////////////////////////////////////////////////////////////////////////////////////////
491
/**
492
 * Return true if the FBO contains a DEPTH attachment.
493
 *
494
 * @return <bold>true</bold> if the FBO contains a DEPTH attachment.
495
 */
496
  public boolean hasDepth()
497
    {
498
    return mDepthWanted;
499 d1e740c5 Leszek Koltunski
    }
500 f6fb3c6d Leszek Koltunski
  }