propane 3.4.0-java → 3.7.0.pre-java

data/src/main/java/processing/opengl/Texture.java

@@ -1,3 +1,5 @@
+/* -*- mode: java; c-basic-offset: 2; indent-tabs-mode: nil -*- */
+
 /*
   Part of the Processing project - http://processing.org
 
@@ -18,9 +20,11 @@
   Public License along with this library; if not, write to the
   Free Software Foundation, Inc., 59 Temple Place, Suite 330,
   Boston, MA  02111-1307  USA
- */
+*/
+
 package processing.opengl;
 
+import java.lang.reflect.InvocationTargetException;
 import processing.core.PApplet;
 import processing.core.PConstants;
 import processing.core.PGraphics;
@@ -34,1572 +38,1659 @@ import java.util.LinkedList;
 import java.util.NoSuchElementException;
 
 /**
- * This class wraps an OpenGL texture. By Andres Colubri
+ * This class wraps an OpenGL texture.
+ * By Andres Colubri
  *
  */
 public class Texture implements PConstants {
+  /**
+   * Texture with normalized UV.
+   */
+  protected static final int TEX2D   = 0;
+  /**
+   * Texture with un-normalized UV.
+   */
+  protected static final int TEXRECT = 1;
+
+  /** Point sampling: both magnification and minification filtering are set
+   * to nearest */
+  protected static final int POINT = 2;
+  /** Linear sampling: magnification filtering is nearest, minification set
+   * to linear */
+  protected static final int LINEAR = 3;
+  /** Bilinear sampling: both magnification filtering is set to linear and
+   * minification either to linear-mipmap-nearest (linear interpolation is used
+   * within a mipmap, but not between different mipmaps). */
+  protected static final int BILINEAR = 4;
+  /** Trilinear sampling: magnification filtering set to linear, minification to
+   * linear-mipmap-linear, which offers the best mipmap quality since linear
+   * interpolation to compute the value in each of two maps and then
+   * interpolates linearly between these two values. */
+  protected static final int TRILINEAR = 5;
+
+
+  // This constant controls how many times pixelBuffer and rgbaPixels can be
+  // accessed before they are not released anymore. The idea is that if they
+  // have been used only a few times, it doesn't make sense to keep them around.
+  protected static final int MAX_UPDATES = 10;
+
+  // The minimum amount of free JVM's memory (in MB) before pixelBuffer and
+  // rgbaPixels are released every time after they are used.
+  protected static final int MIN_MEMORY = 5;
+
+  public int width, height;
+
+  public int glName;
+  public int glTarget;
+  public int glFormat;
+  public int glMinFilter;
+  public int glMagFilter;
+  public int glWrapS;
+  public int glWrapT;
+  public int glWidth;
+  public int glHeight;
+  private GLResourceTexture glres;
+
+  protected PGraphicsOpenGL pg;
+  protected PGL pgl;                // The interface between Processing and OpenGL.
+  protected int context;            // The context that created this texture.
+  protected boolean colorBuffer;    // true if it is the color attachment of
+                                    // FrameBuffer object.
+
+  protected boolean usingMipmaps;
+  protected boolean usingRepeat;
+  protected float maxTexcoordU;
+  protected float maxTexcoordV;
+  protected boolean bound;
+
+  protected boolean invertedX;
+  protected boolean invertedY;
+
+  protected int[] rgbaPixels = null;
+  protected IntBuffer pixelBuffer = null;
+
+  protected int[] edgePixels = null;
+  protected IntBuffer edgeBuffer = null;
+
+  protected FrameBuffer tempFbo = null;
+  protected int pixBufUpdateCount = 0;
+  protected int rgbaPixUpdateCount = 0;
+
+  /** Modified portion of the texture */
+  protected boolean modified;
+  protected int mx1, my1, mx2, my2;
+
+  protected Object bufferSource;
+  protected LinkedList<BufferData> bufferCache = null;
+  protected LinkedList<BufferData> usedBuffers = null;
+  protected Method disposeBufferMethod;
+  public static final int MAX_BUFFER_CACHE_SIZE = 3;
+
+  ////////////////////////////////////////////////////////////
+
+  // Constructors.
+
+
+  public Texture(PGraphicsOpenGL pg) {
+    this.pg = pg;
+    pgl = pg.pgl;
+    context = pgl.createEmptyContext();
+
+    colorBuffer = false;
+
+    glName = 0;
+  }
+
+
+  /**
+   * Creates an instance of PTexture with size width x height.The texture is
+ initialized (empty) to that size.
+   * @param pg
+   * @param width  int
+   * @param height  int
+   */
+  public Texture(PGraphicsOpenGL pg, int width, int height) {
+    this(pg, width, height, new Parameters());
+  }
+
+
+  /**
+   * Creates an instance of PTexture with size width x height and with the
+   * specified parameters.The texture is initialized (empty) to that size.
+   * @param pg
+   * @param width int
+   * @param height int
+   * @param params Parameters
+   */
+  public Texture(PGraphicsOpenGL pg, int width, int height, Object params) {
+    this.pg = pg;
+    pgl = pg.pgl;
+    context = pgl.createEmptyContext();
+
+    colorBuffer = false;
+
+    glName = 0;
+
+    init(width, height, (Parameters)params);
+  }
+
+
+  ////////////////////////////////////////////////////////////
+
+  // Init, resize methods
+
+
+  /**
+   * Sets the size of the image and texture to width x height. If the texture is
+   * already initialized, it first destroys the current OpenGL texture object
+   * and then creates a new one with the specified size.
+   * @param width int
+   * @param height int
+   */
+  public void init(int width, int height) {
+    Parameters params;
+    if (0 < glName) {
+      // Re-initializing a pre-existing texture.
+      // We use the current parameters as default:
+      params = getParameters();
+    } else {
+      // Just built-in default parameters otherwise:
+      params = new Parameters();
+    }
+    init(width, height, params);
+  }
 
-    /**
-     * Texture with normalized UV.
-     */
-    protected static final int TEX2D = 0;
-    /**
-     * Texture with un-normalized UV.
-     */
-    protected static final int TEXRECT = 1;
 
-    /**
-     * Point sampling: both magnification and minification filtering are set to
-     * nearest
-     */
-    protected static final int POINT = 2;
-    /**
-     * Linear sampling: magnification filtering is nearest, minification set to
-     * linear
-     */
-    protected static final int LINEAR = 3;
-    /**
-     * Bilinear sampling: both magnification filtering is set to linear and
-     * minification either to linear-mipmap-nearest (linear interpolation is
-     * used within a mipmap, but not between different mipmaps).
-     */
-    protected static final int BILINEAR = 4;
-    /**
-     * Trilinear sampling: magnification filtering set to linear, minification
-     * to linear-mipmap-linear, which offers the best mipmap quality since
-     * linear interpolation to compute the value in each of two maps and then
-     * interpolates linearly between these two values.
-     */
-    protected static final int TRILINEAR = 5;
-
-    // This constant controls how many times pixelBuffer and rgbaPixels can be
-    // accessed before they are not released anymore. The idea is that if they
-    // have been used only a few times, it doesn't make sense to keep them around.
-    protected static final int MAX_UPDATES = 10;
-
-    // The minimum amount of free JVM's memory (in MB) before pixelBuffer and
-    // rgbaPixels are released every time after they are used.
-    protected static final int MIN_MEMORY = 5;
-
-    public int width, height;
-
-    public int glName;
-    public int glTarget;
-    public int glFormat;
-    public int glMinFilter;
-    public int glMagFilter;
-    public int glWrapS;
-    public int glWrapT;
-    public int glWidth;
-    public int glHeight;
-    private GLResourceTexture glres;
-
-    protected PGraphicsOpenGL pg;
-    protected PGL pgl;                // The interface between Processing and OpenGL.
-    protected int context;            // The context that created this texture.
-    protected boolean colorBuffer;    // true if it is the color attachment of
-    // FrameBuffer object.
-
-    protected boolean usingMipmaps;
-    protected boolean usingRepeat;
-    protected float maxTexcoordU;
-    protected float maxTexcoordV;
-    protected boolean bound;
-
-    protected boolean invertedX;
-    protected boolean invertedY;
-
-    protected int[] rgbaPixels = null;
-    protected IntBuffer pixelBuffer = null;
-
-    protected int[] edgePixels = null;
-    protected IntBuffer edgeBuffer = null;
-
-    protected FrameBuffer tempFbo = null;
-    protected int pixBufUpdateCount = 0;
-    protected int rgbaPixUpdateCount = 0;
+  /**
+   * Sets the size of the image and texture to width x height, and the
+   * parameters of the texture to params. If the texture is already initialized,
+   * it first destroys the current OpenGL texture object and then creates a new
+   * one with the specified size.
+   * @param width int
+   * @param height int
+   * @param params GLTextureParameters
+   */
+  public void init(int width, int height, Parameters params)  {
+    setParameters(params);
+    setSize(width, height);
+    allocate();
+  }
 
-    /**
-     * Modified portion of the texture
-     */
-    protected boolean modified;
-    protected int mx1, my1, mx2, my2;
 
-    protected Object bufferSource;
-    protected LinkedList<BufferData> bufferCache = null;
-    protected LinkedList<BufferData> usedBuffers = null;
-    protected Method disposeBufferMethod;
-    public static final int MAX_BUFFER_CACHE_SIZE = 3;
+  /**
+   * Initializes the texture using GL parameters
+   */
+  public void init(int width, int height,
+                   int glName, int glTarget, int glFormat,
+                   int glWidth, int glHeight,
+                   int glMinFilter, int glMagFilter,
+                   int glWrapS, int glWrapT) {
+    this.width = width;
+    this.height = height;
 
-    ////////////////////////////////////////////////////////////
-    // Constructors.
-    public Texture(PGraphicsOpenGL pg) {
-        this.pg = pg;
-        pgl = pg.pgl;
-        context = pgl.createEmptyContext();
+    this.glName = glName;
+    this.glTarget = glTarget;
+    this.glFormat = glFormat;
+    this.glWidth = glWidth;
+    this.glHeight = glHeight;
+    this.glMinFilter = glMinFilter;
+    this.glMagFilter = glMagFilter;
+    this.glWrapS = glWrapS;
+    this.glWrapT = glWrapT;
 
-        colorBuffer = false;
+    maxTexcoordU = (float)width / glWidth;
+    maxTexcoordV = (float)height / glHeight;
 
-        glName = 0;
-    }
+    usingMipmaps = glMinFilter == PGL.LINEAR_MIPMAP_NEAREST ||
+                   glMinFilter == PGL.LINEAR_MIPMAP_LINEAR;
 
-    /**
-     * Creates an instance of PTexture with size width x height. The texture is
-     * initialized (empty) to that size.
-     *
-     * @param width int
-     * @param height int
-     */
-    public Texture(PGraphicsOpenGL pg, int width, int height) {
-        this(pg, width, height, new Parameters());
-    }
+    usingRepeat = glWrapS == PGL.REPEAT || glWrapT == PGL.REPEAT;
+  }
 
-    /**
-     * Creates an instance of PTexture with size width x height and with the
-     * specified parameters. The texture is initialized (empty) to that size.
-     *
-     * @param width int
-     * @param height int
-     * @param params Parameters
-     */
-    public Texture(PGraphicsOpenGL pg, int width, int height, Object params) {
-        this.pg = pg;
-        pgl = pg.pgl;
-        context = pgl.createEmptyContext();
 
-        colorBuffer = false;
+  public void resize(int wide, int high) {
+    // Disposing current resources.
+    dispose();
 
-        glName = 0;
+    // Creating new texture with the appropriate size.
+    Texture tex = new Texture(pg, wide, high, getParameters());
 
-        init(width, height, (Parameters) params);
-    }
+    // Copying the contents of this texture into tex.
+    tex.set(this);
 
-    ////////////////////////////////////////////////////////////
-    // Init, resize methods
-    /**
-     * Sets the size of the image and texture to width x height. If the texture
-     * is already initialized, it first destroys the current OpenGL texture
-     * object and then creates a new one with the specified size.
-     *
-     * @param width int
-     * @param height int
-     */
-    public void init(int width, int height) {
-        Parameters params;
-        if (0 < glName) {
-            // Re-initializing a pre-existing texture.
-            // We use the current parameters as default:
-            params = getParameters();
-        } else {
-            // Just built-in default parameters otherwise:
-            params = new Parameters();
-        }
-        init(width, height, params);
-    }
+    // Now, overwriting "this" with tex.
+    copyObject(tex);
 
-    /**
-     * Sets the size of the image and texture to width x height, and the
-     * parameters of the texture to params. If the texture is already
-     * initialized, it first destroys the current OpenGL texture object and then
-     * creates a new one with the specified size.
-     *
-     * @param width int
-     * @param height int
-     * @param params GLTextureParameters
-     */
-    public void init(int width, int height, Parameters params) {
-        setParameters(params);
-        setSize(width, height);
-        allocate();
-    }
+    // Nullifying some utility objects so they are recreated with the
+    // appropriate size when needed.
+    tempFbo = null;
+  }
 
-    /**
-     * Initializes the texture using GL parameters
-     */
-    public void init(int width, int height,
-            int glName, int glTarget, int glFormat,
-            int glWidth, int glHeight,
-            int glMinFilter, int glMagFilter,
-            int glWrapS, int glWrapT) {
-        this.width = width;
-        this.height = height;
 
-        this.glName = glName;
-        this.glTarget = glTarget;
-        this.glFormat = glFormat;
-        this.glWidth = glWidth;
-        this.glHeight = glHeight;
-        this.glMinFilter = glMinFilter;
-        this.glMagFilter = glMagFilter;
-        this.glWrapS = glWrapS;
-        this.glWrapT = glWrapT;
+  /**
+   * Returns true if the texture has been initialized.
+   * @return boolean
+   */
+  public boolean available()  {
+    return 0 < glName;
+  }
 
-        maxTexcoordU = (float) width / glWidth;
-        maxTexcoordV = (float) height / glHeight;
 
-        usingMipmaps = glMinFilter == PGL.LINEAR_MIPMAP_NEAREST
-                || glMinFilter == PGL.LINEAR_MIPMAP_LINEAR;
+  ////////////////////////////////////////////////////////////
 
-        usingRepeat = glWrapS == PGL.REPEAT || glWrapT == PGL.REPEAT;
-    }
+  // Set methods
 
-    public void resize(int wide, int high) {
-        // Disposing current resources.
-        dispose();
 
-        // Creating new texture with the appropriate size.
-        Texture tex = new Texture(pg, wide, high, getParameters());
+  public void set(Texture tex) {
+    copyTexture(tex, 0, 0, tex.width, tex.height, true);
+  }
 
-        // Copying the contents of this texture into tex.
-        tex.set(this);
 
-        // Now, overwriting "this" with tex.
-        copyObject(tex);
+  public void set(Texture tex, int x, int y, int w, int h) {
+    copyTexture(tex, x, y, w, h, true);
+  }
 
-        // Nullifying some utility objects so they are recreated with the
-        // appropriate size when needed.
-        tempFbo = null;
-    }
 
-    /**
-     * Returns true if the texture has been initialized.
-     *
-     * @return boolean
-     */
-    public boolean available() {
-        return 0 < glName;
-    }
+  public void set(int texTarget, int texName, int texWidth, int texHeight,
+                  int w, int h) {
+    copyTexture(texTarget, texName, texWidth, texHeight, 0, 0, w, h, true);
+  }
 
-    ////////////////////////////////////////////////////////////
-    // Set methods
-    public void set(Texture tex) {
-        copyTexture(tex, 0, 0, tex.width, tex.height, true);
-    }
 
-    public void set(Texture tex, int x, int y, int w, int h) {
-        copyTexture(tex, x, y, w, h, true);
-    }
+  public void set(int texTarget, int texName, int texWidth, int texHeight,
+                  int target, int tex, int x, int y, int w, int h) {
+    copyTexture(texTarget, texName, texWidth, texHeight, x, y, w, h, true);
+  }
 
-    public void set(int texTarget, int texName, int texWidth, int texHeight,
-            int w, int h) {
-        copyTexture(texTarget, texName, texWidth, texHeight, 0, 0, w, h, true);
-    }
 
-    public void set(int texTarget, int texName, int texWidth, int texHeight,
-            int target, int tex, int x, int y, int w, int h) {
-        copyTexture(texTarget, texName, texWidth, texHeight, x, y, w, h, true);
-    }
+  public void set(int[] pixels) {
+    set(pixels, 0, 0, width, height, ARGB);
+  }
 
-    public void set(int[] pixels) {
-        set(pixels, 0, 0, width, height, ARGB);
-    }
 
-    public void set(int[] pixels, int format) {
-        set(pixels, 0, 0, width, height, format);
-    }
+  public void set(int[] pixels, int format) {
+    set(pixels, 0, 0, width, height, format);
+  }
 
-    public void set(int[] pixels, int x, int y, int w, int h) {
-        set(pixels, x, y, w, h, ARGB);
-    }
 
-    public void set(int[] pixels, int x, int y, int w, int h, int format) {
-        if (pixels == null) {
-            PGraphics.showWarning("The pixels array is null.");
-            return;
-        }
-        if (pixels.length < w * h) {
-            PGraphics.showWarning("The pixel array has a length of "
-                    + pixels.length + ", but it should be at least "
-                    + w * h);
-            return;
-        }
+  public void set(int[] pixels, int x, int y, int w, int h) {
+    set(pixels, x, y, w, h, ARGB);
+  }
 
-        if (pixels.length == 0 || w == 0 || h == 0) {
-            return;
-        }
 
-        boolean enabledTex = false;
-        if (!pgl.texturingIsEnabled(glTarget)) {
-            pgl.enableTexturing(glTarget);
-            enabledTex = true;
-        }
-        pgl.bindTexture(glTarget, glName);
+  public void set(int[] pixels, int x, int y, int w, int h, int format) {
+    if (pixels == null) {
+      PGraphics.showWarning("The pixels array is null.");
+      return;
+    }
+    if (pixels.length < w * h) {
+      PGraphics.showWarning("The pixel array has a length of " +
+                            pixels.length + ", but it should be at least " +
+                            w * h);
+      return;
+    }
 
-        loadPixels(w * h);
-        convertToRGBA(pixels, format, w, h);
-        if (invertedX) {
-            flipArrayOnX(rgbaPixels, 1);
-        }
-        if (invertedY) {
-            flipArrayOnY(rgbaPixels, 1);
-        }
-        updatePixelBuffer(rgbaPixels);
-        pgl.texSubImage2D(glTarget, 0, x, y, w, h, PGL.RGBA, PGL.UNSIGNED_BYTE,
-                pixelBuffer);
-        fillEdges(x, y, w, h);
-
-        if (usingMipmaps) {
-            if (PGraphicsOpenGL.autoMipmapGenSupported) {
-                pgl.generateMipmap(glTarget);
-            } else {
-                manualMipmap();
-            }
-        }
+    if (pixels.length == 0 || w == 0 || h == 0) {
+      return;
+    }
 
-        pgl.bindTexture(glTarget, 0);
-        if (enabledTex) {
-            pgl.disableTexturing(glTarget);
-        }
+    boolean enabledTex = false;
+    if (!pgl.texturingIsEnabled(glTarget)) {
+      pgl.enableTexturing(glTarget);
+      enabledTex = true;
+    }
+    pgl.bindTexture(glTarget, glName);
 
-        releasePixelBuffer();
-        releaseRGBAPixels();
+    loadPixels(w * h);
+    convertToRGBA(pixels, format, w, h);
+    if (invertedX) flipArrayOnX(rgbaPixels, 1);
+    if (invertedY) flipArrayOnY(rgbaPixels, 1);
+    updatePixelBuffer(rgbaPixels);
+    pgl.texSubImage2D(glTarget, 0, x, y, w, h, PGL.RGBA, PGL.UNSIGNED_BYTE,
+                      pixelBuffer);
+    fillEdges(x, y, w, h);
 
-        updateTexels(x, y, w, h);
+    if (usingMipmaps) {
+      if (PGraphicsOpenGL.autoMipmapGenSupported) {
+        pgl.generateMipmap(glTarget);
+      } else {
+        manualMipmap();
+      }
     }
 
-    ////////////////////////////////////////////////////////////
-    // Native set methods
-    public void setNative(int[] pixels) {
-        setNative(pixels, 0, 0, width, height);
+    pgl.bindTexture(glTarget, 0);
+    if (enabledTex) {
+      pgl.disableTexturing(glTarget);
     }
 
-    public void setNative(int[] pixels, int x, int y, int w, int h) {
-        updatePixelBuffer(pixels);
-        setNative(pixelBuffer, x, y, w, h);
-        releasePixelBuffer();
-    }
+    releasePixelBuffer();
+    releaseRGBAPixels();
 
-    public void setNative(IntBuffer pixBuf, int x, int y, int w, int h) {
-        if (pixBuf == null) {
-            pixBuf = null;
-            PGraphics.showWarning("The pixel buffer is null.");
-            return;
-        }
-        if (pixBuf.capacity() < w * h) {
-            PGraphics.showWarning("The pixel bufer has a length of "
-                    + pixBuf.capacity() + ", but it should be at least "
-                    + w * h);
-            return;
-        }
+    updateTexels(x, y, w, h);
+  }
 
-        if (pixBuf.capacity() == 0) {
-            // Nothing to do (means that w == h == 0) but not an erroneous situation
-            return;
-        }
 
-        boolean enabledTex = false;
-        if (!pgl.texturingIsEnabled(glTarget)) {
-            pgl.enableTexturing(glTarget);
-            enabledTex = true;
-        }
-        pgl.bindTexture(glTarget, glName);
-
-        pgl.texSubImage2D(glTarget, 0, x, y, w, h, PGL.RGBA, PGL.UNSIGNED_BYTE,
-                pixBuf);
-        fillEdges(x, y, w, h);
-
-        if (usingMipmaps) {
-            if (PGraphicsOpenGL.autoMipmapGenSupported) {
-                pgl.generateMipmap(glTarget);
-            } else {
-                manualMipmap();
-            }
-        }
-        pgl.bindTexture(glTarget, 0);
-        if (enabledTex) {
-            pgl.disableTexturing(glTarget);
-        }
+  ////////////////////////////////////////////////////////////
 
-        updateTexels(x, y, w, h);
-    }
+  // Native set methods
 
-    ////////////////////////////////////////////////////////////
-    // Get methods
-    /**
-     * Copy texture to pixels. Involves video memory to main memory transfer
-     * (slow).
-     */
-    public void get(int[] pixels) {
-        if (pixels == null) {
-            throw new RuntimeException("Trying to copy texture to null pixels array");
-        }
-        if (pixels.length != width * height) {
-            throw new RuntimeException("Trying to copy texture to pixels array of "
-                    + "wrong size");
-        }
 
-        if (tempFbo == null) {
-            tempFbo = new FrameBuffer(pg, glWidth, glHeight);
-        }
+  public void setNative(int[] pixels) {
+    setNative(pixels, 0, 0, width, height);
+  }
 
-        // Attaching the texture to the color buffer of a FBO, binding the FBO and
-        // reading the pixels from the current draw buffer (which is the color
-        // buffer of the FBO).
-        tempFbo.setColorBuffer(this);
-        pg.pushFramebuffer();
-        pg.setFramebuffer(tempFbo);
-        tempFbo.readPixels();
-        pg.popFramebuffer();
 
-        tempFbo.getPixels(pixels);
-        convertToARGB(pixels);
+  public void setNative(int[] pixels, int x, int y, int w, int h) {
+    updatePixelBuffer(pixels);
+    setNative(pixelBuffer, x, y, w, h);
+    releasePixelBuffer();
+  }
 
-        if (invertedX) {
-            flipArrayOnX(pixels, 1);
-        }
-        if (invertedY) {
-            flipArrayOnY(pixels, 1);
-        }
-    }
 
-    ////////////////////////////////////////////////////////////
-    // Put methods (the source texture is not resized to cover the entire
-    // destination).
-    public void put(Texture tex) {
-        copyTexture(tex, 0, 0, tex.width, tex.height, false);
+  public void setNative(IntBuffer pixBuf, int x, int y, int w, int h) {
+    if (pixBuf == null) {
+      pixBuf = null;
+      PGraphics.showWarning("The pixel buffer is null.");
+      return;
     }
-
-    public void put(Texture tex, int x, int y, int w, int h) {
-        copyTexture(tex, x, y, w, h, false);
+    if (pixBuf.capacity() < w * h) {
+      PGraphics.showWarning("The pixel bufer has a length of " +
+                            pixBuf.capacity()  + ", but it should be at least " +
+                            w * h);
+      return;
     }
 
-    public void put(int texTarget, int texName, int texWidth, int texHeight,
-            int w, int h) {
-        copyTexture(texTarget, texName, texWidth, texHeight, 0, 0, w, h, false);
+    if (pixBuf.capacity()  == 0) {
+      // Nothing to do (means that w == h == 0) but not an erroneous situation
+      return;
     }
 
-    public void put(int texTarget, int texName, int texWidth, int texHeight,
-            int target, int tex, int x, int y, int w, int h) {
-        copyTexture(texTarget, texName, texWidth, texHeight, x, y, w, h, false);
+    boolean enabledTex = false;
+    if (!pgl.texturingIsEnabled(glTarget)) {
+      pgl.enableTexturing(glTarget);
+      enabledTex = true;
     }
+    pgl.bindTexture(glTarget, glName);
 
-    ////////////////////////////////////////////////////////////
-    // Get OpenGL parameters
-    /**
-     * Returns true or false whether or not the texture is using mipmaps.
-     *
-     * @return boolean
-     */
-    public boolean usingMipmaps() {
-        return usingMipmaps;
-    }
-
-    public void usingMipmaps(boolean mipmaps, int sampling) {
-        int glMagFilter0 = glMagFilter;
-        int glMinFilter0 = glMinFilter;
-        if (mipmaps) {
-            if (sampling == POINT) {
-                glMagFilter = PGL.NEAREST;
-                glMinFilter = PGL.NEAREST;
-                usingMipmaps = false;
-            } else if (sampling == LINEAR) {
-                glMagFilter = PGL.NEAREST;
-                glMinFilter
-                        = PGL.MIPMAPS_ENABLED ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR;
-                usingMipmaps = true;
-            } else if (sampling == BILINEAR) {
-                glMagFilter = PGL.LINEAR;
-                glMinFilter
-                        = PGL.MIPMAPS_ENABLED ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR;
-                usingMipmaps = true;
-            } else if (sampling == TRILINEAR) {
-                glMagFilter = PGL.LINEAR;
-                glMinFilter
-                        = PGL.MIPMAPS_ENABLED ? PGL.LINEAR_MIPMAP_LINEAR : PGL.LINEAR;
-                usingMipmaps = true;
-            } else {
-                throw new RuntimeException("Unknown texture filtering mode");
-            }
-        } else {
-            usingMipmaps = false;
-            if (sampling == POINT) {
-                glMagFilter = PGL.NEAREST;
-                glMinFilter = PGL.NEAREST;
-            } else if (sampling == LINEAR) {
-                glMagFilter = PGL.NEAREST;
-                glMinFilter = PGL.LINEAR;
-            } else if (sampling == BILINEAR || sampling == TRILINEAR) {
-                glMagFilter = PGL.LINEAR;
-                glMinFilter = PGL.LINEAR;
-            } else {
-                throw new RuntimeException("Unknown texture filtering mode");
-            }
-        }
+    pgl.texSubImage2D(glTarget, 0, x, y, w, h, PGL.RGBA, PGL.UNSIGNED_BYTE,
+                      pixBuf);
+    fillEdges(x, y, w, h);
 
-        if (glMagFilter0 != glMagFilter || glMinFilter0 != glMinFilter) {
-            bind();
-            pgl.texParameteri(glTarget, PGL.TEXTURE_MIN_FILTER, glMinFilter);
-            pgl.texParameteri(glTarget, PGL.TEXTURE_MAG_FILTER, glMagFilter);
-            if (usingMipmaps) {
-                if (PGraphicsOpenGL.autoMipmapGenSupported) {
-                    pgl.generateMipmap(glTarget);
-                } else {
-                    manualMipmap();
-                }
-            }
-            unbind();
-        }
+    if (usingMipmaps) {
+      if (PGraphicsOpenGL.autoMipmapGenSupported) {
+        pgl.generateMipmap(glTarget);
+      } else {
+        manualMipmap();
+      }
     }
-
-    /**
-     * Returns true or false whether or not the texture is using repeat wrap
-     * mode along either U or V directions.
-     *
-     * @return boolean
-     */
-    public boolean usingRepeat() {
-        return usingRepeat;
+    pgl.bindTexture(glTarget, 0);
+    if (enabledTex) {
+      pgl.disableTexturing(glTarget);
     }
 
-    public void usingRepeat(boolean repeat) {
-        if (repeat) {
-            glWrapS = PGL.REPEAT;
-            glWrapT = PGL.REPEAT;
-            usingRepeat = true;
-        } else {
-            glWrapS = PGL.CLAMP_TO_EDGE;
-            glWrapT = PGL.CLAMP_TO_EDGE;
-            usingRepeat = false;
-        }
+    updateTexels(x, y, w, h);
+  }
 
-        bind();
-        pgl.texParameteri(glTarget, PGL.TEXTURE_WRAP_S, glWrapS);
-        pgl.texParameteri(glTarget, PGL.TEXTURE_WRAP_T, glWrapT);
-        unbind();
-    }
 
-    /**
-     * Returns the maximum possible value for the texture coordinate U
-     * (horizontal).
-     *
-     * @return float
-     */
-    public float maxTexcoordU() {
-        return maxTexcoordU;
-    }
+  ////////////////////////////////////////////////////////////
 
-    /**
-     * Returns the maximum possible value for the texture coordinate V
-     * (vertical).
-     *
-     * @return float
-     */
-    public float maxTexcoordV() {
-        return maxTexcoordV;
-    }
+  // Get methods
 
-    /**
-     * Returns true if the texture is inverted along the horizontal direction.
-     *
-     * @return boolean;
-     */
-    public boolean invertedX() {
-        return invertedX;
-    }
 
-    /**
-     * Sets the texture as inverted or not along the horizontal direction.
-     *
-     * @param v boolean;
-     */
-    public void invertedX(boolean v) {
-        invertedX = v;
+  /**
+   * Copy texture to pixels.Involves video memory to main memory transfer (slow).
+   * @param pixels
+   */
+  public void get(int[] pixels) {
+    if (pixels == null) {
+      throw new RuntimeException("Trying to copy texture to null pixels array");
     }
-
-    /**
-     * Returns true if the texture is inverted along the vertical direction.
-     *
-     * @return boolean;
-     */
-    public boolean invertedY() {
-        return invertedY;
+    if (pixels.length != width * height) {
+      throw new RuntimeException("Trying to copy texture to pixels array of " +
+                                 "wrong size");
     }
 
-    /**
-     * Sets the texture as inverted or not along the vertical direction.
-     *
-     * @param v boolean;
-     */
-    public void invertedY(boolean v) {
-        invertedY = v;
-    }
-
-    public int currentSampling() {
-        if (glMagFilter == PGL.NEAREST && glMinFilter == PGL.NEAREST) {
-            return POINT;
-        } else if (glMagFilter == PGL.NEAREST
-                && glMinFilter == (PGL.MIPMAPS_ENABLED ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR)) {
-            return LINEAR;
-        } else if (glMagFilter == PGL.LINEAR
-                && glMinFilter == (PGL.MIPMAPS_ENABLED ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR)) {
-            return BILINEAR;
-        } else if (glMagFilter == PGL.LINEAR
-                && glMinFilter == PGL.LINEAR_MIPMAP_LINEAR) {
-            return TRILINEAR;
-        } else {
-            return -1;
-        }
+    if (tempFbo == null) {
+      tempFbo = new FrameBuffer(pg, glWidth, glHeight);
     }
 
-    ////////////////////////////////////////////////////////////
-    // Bind/unbind
-    public void bind() {
-        // Binding a texture automatically enables texturing for the
-        // texture target from that moment onwards. Unbinding the texture
-        // won't disable texturing.
-        if (!pgl.texturingIsEnabled(glTarget)) {
-            pgl.enableTexturing(glTarget);
-        }
-        pgl.bindTexture(glTarget, glName);
-        bound = true;
-    }
-
-    public void unbind() {
-        if (pgl.textureIsBound(glTarget, glName)) {
-            // We don't want to unbind another texture
-            // that might be bound instead of this one.
-            if (!pgl.texturingIsEnabled(glTarget)) {
-                pgl.enableTexturing(glTarget);
-                pgl.bindTexture(glTarget, 0);
-                pgl.disableTexturing(glTarget);
-            } else {
-                pgl.bindTexture(glTarget, 0);
-            }
-        }
-        bound = false;
-    }
+    // Attaching the texture to the color buffer of a FBO, binding the FBO and
+    // reading the pixels from the current draw buffer (which is the color
+    // buffer of the FBO).
+    tempFbo.setColorBuffer(this);
+    pg.pushFramebuffer();
+    pg.setFramebuffer(tempFbo);
+    tempFbo.readPixels();
+    pg.popFramebuffer();
 
-    public boolean bound() {
-        // A true result might not necessarily mean that texturing is enabled
-        // (a texture can be bound to the target, but texturing is disabled).
-        return bound;
-    }
+    tempFbo.getPixels(pixels);
+    convertToARGB(pixels);
 
-    //////////////////////////////////////////////////////////////
-    // Modified flag
-    public boolean isModified() {
-        return modified;
-    }
+    if (invertedX) flipArrayOnX(pixels, 1);
+    if (invertedY) flipArrayOnY(pixels, 1);
+  }
 
-    public void setModified() {
-        modified = true;
-    }
 
-    public void setModified(boolean m) {
-        modified = m;
+  ////////////////////////////////////////////////////////////
+
+  // Put methods (the source texture is not resized to cover the entire
+  // destination).
+
+
+  public void put(Texture tex) {
+    copyTexture(tex, 0, 0, tex.width, tex.height, false);
+  }
+
+
+  public void put(Texture tex, int x, int y, int w, int h) {
+    copyTexture(tex, x, y, w, h, false);
+  }
+
+
+  public void put(int texTarget, int texName, int texWidth, int texHeight,
+                  int w, int h) {
+    copyTexture(texTarget, texName, texWidth, texHeight, 0, 0, w, h, false);
+  }
+
+
+  public void put(int texTarget, int texName, int texWidth, int texHeight,
+                  int target, int tex, int x, int y, int w, int h) {
+    copyTexture(texTarget, texName, texWidth, texHeight, x, y, w, h, false);
+  }
+
+
+  ////////////////////////////////////////////////////////////
+
+  // Get OpenGL parameters
+
+
+  /**
+   * Returns true or false whether or not the texture is using mipmaps.
+   * @return boolean
+   */
+  public boolean usingMipmaps()  {
+    return usingMipmaps;
+  }
+
+
+  public void usingMipmaps(boolean mipmaps, int sampling)  {
+    int glMagFilter0 = glMagFilter;
+    int glMinFilter0 = glMinFilter;
+    if (mipmaps) {
+      switch (sampling) {
+        case POINT:
+          glMagFilter = PGL.NEAREST;
+          glMinFilter = PGL.NEAREST;
+          usingMipmaps = false;
+          break;
+        case LINEAR:
+          glMagFilter = PGL.NEAREST;
+          glMinFilter =
+            PGL.MIPMAPS_ENABLED ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR;
+          usingMipmaps = true;
+          break;
+        case BILINEAR:
+          glMagFilter = PGL.LINEAR;
+          glMinFilter =
+            PGL.MIPMAPS_ENABLED ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR;
+          usingMipmaps = true;
+          break;
+        case TRILINEAR:
+          glMagFilter = PGL.LINEAR;
+          glMinFilter =
+            PGL.MIPMAPS_ENABLED ? PGL.LINEAR_MIPMAP_LINEAR : PGL.LINEAR;
+          usingMipmaps = true;
+          break;
+        default:
+          throw new RuntimeException("Unknown texture filtering mode");
+      }
+    } else {
+      usingMipmaps = false;
+      switch (sampling) {
+        case POINT:
+          glMagFilter = PGL.NEAREST;
+          glMinFilter = PGL.NEAREST;
+          break;
+        case LINEAR:
+          glMagFilter = PGL.NEAREST;
+          glMinFilter = PGL.LINEAR;
+          break;
+        case BILINEAR:
+        case TRILINEAR:
+          glMagFilter = PGL.LINEAR;
+          glMinFilter = PGL.LINEAR;
+          break;
+        default:
+          throw new RuntimeException("Unknown texture filtering mode");
+      }
+    }
+
+    if (glMagFilter0 != glMagFilter || glMinFilter0 != glMinFilter) {
+      bind();
+      pgl.texParameteri(glTarget, PGL.TEXTURE_MIN_FILTER, glMinFilter);
+      pgl.texParameteri(glTarget, PGL.TEXTURE_MAG_FILTER, glMagFilter);
+      if (usingMipmaps) {
+        if (PGraphicsOpenGL.autoMipmapGenSupported) {
+          pgl.generateMipmap(glTarget);
+        } else {
+          manualMipmap();
+        }
+      }
+      unbind();
+    }
+  }
+
+
+  /**
+   * Returns true or false whether or not the texture is using repeat wrap mode
+   * along either U or V directions.
+   * @return boolean
+   */
+  public boolean usingRepeat()  {
+    return usingRepeat;
+  }
+
+
+  public void usingRepeat(boolean repeat)  {
+    if (repeat) {
+      glWrapS = PGL.REPEAT;
+      glWrapT = PGL.REPEAT;
+      usingRepeat = true;
+    } else {
+      glWrapS = PGL.CLAMP_TO_EDGE;
+      glWrapT = PGL.CLAMP_TO_EDGE;
+      usingRepeat = false;
+    }
+
+    bind();
+    pgl.texParameteri(glTarget, PGL.TEXTURE_WRAP_S, glWrapS);
+    pgl.texParameteri(glTarget, PGL.TEXTURE_WRAP_T, glWrapT);
+    unbind();
+  }
+
+
+  /**
+   * Returns the maximum possible value for the texture coordinate U
+   * (horizontal).
+   * @return float
+   */
+  public float maxTexcoordU() {
+    return maxTexcoordU;
+  }
+
+
+  /**
+   * Returns the maximum possible value for the texture coordinate V (vertical).
+   * @return float
+   */
+  public float maxTexcoordV() {
+    return maxTexcoordV;
+  }
+
+
+  /**
+   * Returns true if the texture is inverted along the horizontal direction.
+   * @return boolean;
+   */
+  public boolean invertedX() {
+    return invertedX;
+  }
+
+
+  /**
+   * Sets the texture as inverted or not along the horizontal direction.
+   * @param v boolean;
+   */
+  public void invertedX(boolean v) {
+    invertedX = v;
+  }
+
+
+  /**
+   * Returns true if the texture is inverted along the vertical direction.
+   * @return boolean;
+   */
+  public boolean invertedY() {
+    return invertedY;
+  }
+
+
+  /**
+   * Sets the texture as inverted or not along the vertical direction.
+   * @param v boolean;
+   */
+  public void invertedY(boolean v) {
+    invertedY = v;
+  }
+
+
+  public int currentSampling() {
+    if (glMagFilter == PGL.NEAREST && glMinFilter == PGL.NEAREST) {
+      return POINT;
+    } else if (glMagFilter == PGL.NEAREST &&
+               glMinFilter == (PGL.MIPMAPS_ENABLED ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR)) {
+      return LINEAR;
+    } else if (glMagFilter == PGL.LINEAR &&
+               glMinFilter == (PGL.MIPMAPS_ENABLED ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR)) {
+      return BILINEAR;
+    } else if (glMagFilter == PGL.LINEAR &&
+               glMinFilter == PGL.LINEAR_MIPMAP_LINEAR) {
+      return TRILINEAR;
+    } else {
+      return -1;
+    }
+  }
+
+  ////////////////////////////////////////////////////////////
+
+  // Bind/unbind
+
+
+  public void bind() {
+    // Binding a texture automatically enables texturing for the
+    // texture target from that moment onwards. Unbinding the texture
+    // won't disable texturing.
+    if (!pgl.texturingIsEnabled(glTarget)) {
+      pgl.enableTexturing(glTarget);
+    }
+    pgl.bindTexture(glTarget, glName);
+    bound = true;
+  }
+
+
+  public void unbind() {
+    if (pgl.textureIsBound(glTarget, glName)) {
+      // We don't want to unbind another texture
+      // that might be bound instead of this one.
+      if (!pgl.texturingIsEnabled(glTarget)) {
+        pgl.enableTexturing(glTarget);
+        pgl.bindTexture(glTarget, 0);
+        pgl.disableTexturing(glTarget);
+      } else {
+        pgl.bindTexture(glTarget, 0);
+      }
     }
+    bound = false;
+  }
 
-    public int getModifiedX1() {
-        return mx1;
-    }
 
-    public int getModifiedX2() {
-        return mx2;
-    }
+  public boolean bound() {
+    // A true result might not necessarily mean that texturing is enabled
+    // (a texture can be bound to the target, but texturing is disabled).
+    return bound;
+  }
 
-    public int getModifiedY1() {
-        return my1;
-    }
 
-    public int getModifiedY2() {
-        return my2;
-    }
+  //////////////////////////////////////////////////////////////
 
-    public void updateTexels() {
-        updateTexelsImpl(0, 0, width, height);
-    }
+  // Modified flag
 
-    public void updateTexels(int x, int y, int w, int h) {
-        updateTexelsImpl(x, y, w, h);
-    }
 
-    protected void updateTexelsImpl(int x, int y, int w, int h) {
-        int x2 = x + w;
-        int y2 = y + h;
+  public boolean isModified() {
+    return modified;
+  }
 
-        if (!modified) {
-            mx1 = PApplet.max(0, x);
-            mx2 = PApplet.min(width - 1, x2);
-            my1 = PApplet.max(0, y);
-            my2 = PApplet.min(height - 1, y2);
-            modified = true;
 
-        } else {
-            if (x < mx1) {
-                mx1 = PApplet.max(0, x);
-            }
-            if (x > mx2) {
-                mx2 = PApplet.min(width - 1, x);
-            }
-            if (y < my1) {
-                my1 = PApplet.max(0, y);
-            }
-            if (y > my2) {
-                my2 = y;
-            }
-
-            if (x2 < mx1) {
-                mx1 = PApplet.max(0, x2);
-            }
-            if (x2 > mx2) {
-                mx2 = PApplet.min(width - 1, x2);
-            }
-            if (y2 < my1) {
-                my1 = PApplet.max(0, y2);
-            }
-            if (y2 > my2) {
-                my2 = PApplet.min(height - 1, y2);
-            }
-        }
-    }
+  public void setModified() {
+    modified = true;
+  }
 
-    protected void loadPixels(int len) {
-        if (rgbaPixels == null || rgbaPixels.length < len) {
-            rgbaPixels = new int[len];
-        }
-    }
 
-    protected void updatePixelBuffer(int[] pixels) {
-        pixelBuffer = PGL.updateIntBuffer(pixelBuffer, pixels, true);
-        pixBufUpdateCount++;
-    }
+  public void setModified(boolean m) {
+    modified = m;
+  }
 
-    protected void manualMipmap() {
-        // TODO: finish manual mipmap generation,
-        // https://github.com/processing/processing/issues/3335
-    }
 
-    ////////////////////////////////////////////////////////////
-    // Buffer sink interface.
-    public void setBufferSource(Object source) {
-        bufferSource = source;
-        getSourceMethods();
-    }
+  public int getModifiedX1() {
+    return mx1;
+  }
 
-    public void copyBufferFromSource(Object natRef, ByteBuffer byteBuf,
-            int w, int h) {
-        if (bufferCache == null) {
-            bufferCache = new LinkedList<BufferData>();
-        }
 
-        if (bufferCache.size() + 1 <= MAX_BUFFER_CACHE_SIZE) {
-            bufferCache.add(new BufferData(natRef, byteBuf.asIntBuffer(), w, h));
-        } else {
-            // The buffer cache reached the maximum size, so we just dispose
-            // the new buffer by adding it to the list of used buffers.
-            try {
-                usedBuffers.add(new BufferData(natRef, byteBuf.asIntBuffer(), w, h));
-            } catch (Exception e) {
-                e.printStackTrace();
-            }
-        }
-    }
+  public int getModifiedX2() {
+    return mx2;
+  }
 
-    public void disposeSourceBuffer() {
-        if (usedBuffers == null) {
-            return;
-        }
 
-        while (0 < usedBuffers.size()) {
-            BufferData data = null;
-            try {
-                data = usedBuffers.remove(0);
-            } catch (NoSuchElementException ex) {
-                PGraphics.showWarning("Cannot remove used buffer");
-            }
-            if (data != null) {
-                data.dispose();
-            }
-        }
-    }
+  public int getModifiedY1() {
+    return my1;
+  }
 
-    public void getBufferPixels(int[] pixels) {
-        // We get the buffer either from the used buffers or the cache, giving
-        // priority to the used buffers. Why? Because the used buffer was already
-        // transferred to the texture, so the pixels should be in sync with the
-        // texture.
-        BufferData data = null;
-        if (usedBuffers != null && 0 < usedBuffers.size()) {
-            data = usedBuffers.getLast();
-        } else if (bufferCache != null && 0 < bufferCache.size()) {
-            data = bufferCache.getLast();
-        }
-        if (data != null) {
-            if ((data.w != width) || (data.h != height)) {
-                init(data.w, data.h);
-            }
-
-            data.rgbBuf.rewind();
-            data.rgbBuf.get(pixels);
-            convertToARGB(pixels);
-
-            // In order to avoid a cached buffer to overwrite the texture when the
-            // renderer draws the texture, and hence put the pixels put of sync, we
-            // simply empty the cache.
-            if (usedBuffers == null) {
-                usedBuffers = new LinkedList<BufferData>();
-            }
-            while (0 < bufferCache.size()) {
-                data = bufferCache.remove(0);
-                usedBuffers.add(data);
-            }
-        }
-    }
 
-    public boolean hasBufferSource() {
-        return bufferSource != null;
-    }
+  public int getModifiedY2() {
+    return my2;
+  }
 
-    public boolean hasBuffers() {
-        return bufferSource != null && bufferCache != null
-                && 0 < bufferCache.size();
-    }
 
-    protected boolean bufferUpdate() {
-        BufferData data = null;
-        try {
-            data = bufferCache.remove(0);
-        } catch (NoSuchElementException ex) {
-            PGraphics.showWarning("Don't have pixel data to copy to texture");
-        }
+  public void updateTexels() {
+    updateTexelsImpl(0, 0, width, height);
+  }
 
-        if (data != null) {
-            if ((data.w != width) || (data.h != height)) {
-                init(data.w, data.h);
-            }
-            data.rgbBuf.rewind();
-            setNative(data.rgbBuf, 0, 0, width, height);
-
-            // Putting the buffer in the used buffers list to dispose at the end of
-            // draw.
-            if (usedBuffers == null) {
-                usedBuffers = new LinkedList<BufferData>();
-            }
-            usedBuffers.add(data);
-
-            return true;
-        } else {
-            return false;
-        }
-    }
 
-    protected void getSourceMethods() {
-        try {
-            disposeBufferMethod = bufferSource.getClass().
-                    getMethod("disposeBuffer", new Class[]{Object.class});
-        } catch (Exception e) {
-            throw new RuntimeException("Provided source object doesn't have a "
-                    + "disposeBuffer method.");
-        }
-    }
+  public void updateTexels(int x, int y, int w, int h) {
+    updateTexelsImpl(x, y, w, h);
+  }
 
-    ////////////////////////////////////////////////////////////
-    // Utilities
-    /**
-     * Flips intArray along the X axis.
-     *
-     * @param intArray int[]
-     * @param mult int
-     */
-    protected void flipArrayOnX(int[] intArray, int mult) {
-        int index = 0;
-        int xindex = mult * (width - 1);
-        for (int x = 0; x < width / 2; x++) {
-            for (int y = 0; y < height; y++) {
-                int i = index + mult * y * width;
-                int j = xindex + mult * y * width;
-
-                for (int c = 0; c < mult; c++) {
-                    int temp = intArray[i];
-                    intArray[i] = intArray[j];
-                    intArray[j] = temp;
-
-                    i++;
-                    j++;
-                }
-
-            }
-            index += mult;
-            xindex -= mult;
-        }
-    }
 
-    /**
-     * Flips intArray along the Y axis.
-     *
-     * @param intArray int[]
-     * @param mult int
-     */
-    protected void flipArrayOnY(int[] intArray, int mult) {
-        int index = 0;
-        int yindex = mult * (height - 1) * width;
-        for (int y = 0; y < height / 2; y++) {
-            for (int x = 0; x < mult * width; x++) {
-                int temp = intArray[index];
-                intArray[index] = intArray[yindex];
-                intArray[yindex] = temp;
-
-                index++;
-                yindex++;
-            }
-            yindex -= mult * width * 2;
-        }
-    }
+  protected void updateTexelsImpl(int x, int y, int w, int h) {
+    int x2 = x + w;
+    int y2 = y + h;
 
-    /**
-     * Reorders a pixel array in the given format into the order required by
-     * OpenGL (RGBA) and stores it into rgbaPixels. The width and height
-     * parameters are used in the YUV420 to RBGBA conversion.
-     *
-     * @param pixels int[]
-     * @param format int
-     * @param w int
-     * @param h int
-     */
-    protected void convertToRGBA(int[] pixels, int format, int w, int h) {
-        if (PGL.BIG_ENDIAN) {
-            switch (format) {
-                case ALPHA:
-                    // Converting from xxxA into RGBA. RGB is set to white
-                    // (0xFFFFFF, i.e.: (255, 255, 255))
-                    for (int i = 0; i < pixels.length; i++) {
-                        rgbaPixels[i] = 0xFFFFFF00 | pixels[i];
-                    }
-                    break;
-                case RGB:
-                    // Converting xRGB into RGBA. A is set to 0xFF (255, full opacity).
-                    for (int i = 0; i < pixels.length; i++) {
-                        int pixel = pixels[i];
-                        rgbaPixels[i] = (pixel << 8) | 0xFF;
-                    }
-                    break;
-                case ARGB:
-                    // Converting ARGB into RGBA. Shifting RGB to 8 bits to the left,
-                    // and bringing A to the first byte.
-                    for (int i = 0; i < pixels.length; i++) {
-                        int pixel = pixels[i];
-                        rgbaPixels[i] = (pixel << 8) | ((pixel >> 24) & 0xFF);
-                    }
-                    break;
-            }
-        } else {
-            // LITTLE_ENDIAN
-            // ARGB native, and RGBA opengl means ABGR on windows
-            // for the most part just need to swap two components here
-            // the sun.cpu.endian here might be "false", oddly enough..
-            // (that's why just using an "else", rather than check for "little")
-            switch (format) {
-                case ALPHA:
-                    // Converting xxxA into ARGB, with RGB set to white.
-                    for (int i = 0; i < pixels.length; i++) {
-                        rgbaPixels[i] = (pixels[i] << 24) | 0x00FFFFFF;
-                    }
-                    break;
-                case RGB:
-                    // We need to convert xRGB into ABGR,
-                    // so R and B must be swapped, and the x just made 0xFF.
-                    for (int i = 0; i < pixels.length; i++) {
-                        int pixel = pixels[i];
-                        rgbaPixels[i] = 0xFF000000
-                                | ((pixel & 0xFF) << 16) | ((pixel & 0xFF0000) >> 16)
-                                | (pixel & 0x0000FF00);
-                    }
-                    break;
-                case ARGB:
-                    // We need to convert ARGB into ABGR,
-                    // so R and B must be swapped, A and G just brought back in.
-                    for (int i = 0; i < pixels.length; i++) {
-                        int pixel = pixels[i];
-                        rgbaPixels[i] = ((pixel & 0xFF) << 16) | ((pixel & 0xFF0000) >> 16)
-                                | (pixel & 0xFF00FF00);
-                    }
-                    break;
-            }
-        }
-        rgbaPixUpdateCount++;
+    if (!modified) {
+      mx1 = PApplet.max(0, x);
+      mx2 = PApplet.min(width - 1, x2);
+      my1 = PApplet.max(0, y);
+      my2 = PApplet.min(height - 1, y2);
+      modified = true;
+
+    } else {
+      if (x < mx1) mx1 = PApplet.max(0, x);
+      if (x > mx2) mx2 = PApplet.min(width - 1, x);
+      if (y < my1) my1 = PApplet.max(0, y);
+      if (y > my2) my2 = y;
+
+      if (x2 < mx1) mx1 = PApplet.max(0, x2);
+      if (x2 > mx2) mx2 = PApplet.min(width - 1, x2);
+      if (y2 < my1) my1 = PApplet.max(0, y2);
+      if (y2 > my2) my2 = PApplet.min(height - 1, y2);
     }
+  }
 
-    /**
-     * Reorders an OpenGL pixel array (RGBA) into ARGB. The array must be of
-     * size width * height.
-     *
-     * @param pixels int[]
-     */
-    protected void convertToARGB(int[] pixels) {
-        int t = 0;
-        int p = 0;
-        if (PGL.BIG_ENDIAN) {
-            // RGBA to ARGB conversion: shifting RGB 8 bits to the right,
-            // and placing A 24 bits to the left.
-            for (int y = 0; y < height; y++) {
-                for (int x = 0; x < width; x++) {
-                    int pixel = pixels[p++];
-                    pixels[t++] = (pixel >>> 8) | ((pixel << 24) & 0xFF000000);
-                }
-            }
-        } else {
-            // We have to convert ABGR into ARGB, so R and B must be swapped,
-            // A and G just brought back in.
-            for (int y = 0; y < height; y++) {
-                for (int x = 0; x < width; x++) {
-                    int pixel = pixels[p++];
-                    pixels[t++] = ((pixel & 0xFF) << 16) | ((pixel & 0xFF0000) >> 16)
-                            | (pixel & 0xFF00FF00);
-                }
-            }
-        }
+
+  protected void loadPixels(int len) {
+    if (rgbaPixels == null || rgbaPixels.length < len) {
+      rgbaPixels = new int[len];
     }
+  }
 
-    ///////////////////////////////////////////////////////////
-    // Allocate/release texture.
-    protected void setSize(int w, int h) {
-        width = w;
-        height = h;
 
-        if (PGraphicsOpenGL.npotTexSupported) {
-            glWidth = w;
-            glHeight = h;
-        } else {
-            glWidth = PGL.nextPowerOfTwo(w);
-            glHeight = PGL.nextPowerOfTwo(h);
-        }
+  protected void updatePixelBuffer(int[] pixels) {
+    pixelBuffer = PGL.updateIntBuffer(pixelBuffer, pixels, true);
+    pixBufUpdateCount++;
+  }
 
-        if (glWidth > PGraphicsOpenGL.maxTextureSize
-                || glHeight > PGraphicsOpenGL.maxTextureSize) {
-            glWidth = glHeight = 0;
-            throw new RuntimeException("Image width and height cannot be"
-                    + " larger than "
-                    + PGraphicsOpenGL.maxTextureSize
-                    + " with this graphics card.");
-        }
 
-        // If non-power-of-two textures are not supported, and the specified width
-        // or height is non-power-of-two, then glWidth (glHeight) will be greater
-        // than w (h) because it is chosen to be the next power of two, and this
-        // quotient will give the appropriate maximum texture coordinate value given
-        // this situation.
-        maxTexcoordU = (float) width / glWidth;
-        maxTexcoordV = (float) height / glHeight;
-    }
+  protected void manualMipmap() {
+    // TODO: finish manual mipmap generation,
+    // https://github.com/processing/processing/issues/3335
+  }
 
-    /**
-     * Allocates the opengl texture object.
-     */
-    protected void allocate() {
-        dispose(); // Just in the case this object is being re-allocated.
 
-        boolean enabledTex = false;
-        if (!pgl.texturingIsEnabled(glTarget)) {
-            pgl.enableTexturing(glTarget);
-            enabledTex = true;
-        }
+  ////////////////////////////////////////////////////////////
 
-        context = pgl.getCurrentContext();
-        glres = new GLResourceTexture(this);
-
-        pgl.bindTexture(glTarget, glName);
-        pgl.texParameteri(glTarget, PGL.TEXTURE_MIN_FILTER, glMinFilter);
-        pgl.texParameteri(glTarget, PGL.TEXTURE_MAG_FILTER, glMagFilter);
-        pgl.texParameteri(glTarget, PGL.TEXTURE_WRAP_S, glWrapS);
-        pgl.texParameteri(glTarget, PGL.TEXTURE_WRAP_T, glWrapT);
-        if (PGraphicsOpenGL.anisoSamplingSupported) {
-            pgl.texParameterf(glTarget, PGL.TEXTURE_MAX_ANISOTROPY,
-                    PGraphicsOpenGL.maxAnisoAmount);
-        }
+  // Buffer sink interface.
 
-        // First, we use glTexImage2D to set the full size of the texture (glW/glH
-        // might be diff from w/h in the case that the GPU doesn't support NPOT
-        // textures)
-        pgl.texImage2D(glTarget, 0, glFormat, glWidth, glHeight, 0,
-                PGL.RGBA, PGL.UNSIGNED_BYTE, null);
 
-        // Makes sure that the texture buffer in video memory doesn't contain
-        // any garbage.
-        pgl.initTexture(glTarget, PGL.RGBA, width, height);
+  public void setBufferSource(Object source) {
+    bufferSource = source;
+    getSourceMethods();
+  }
 
-        pgl.bindTexture(glTarget, 0);
-        if (enabledTex) {
-            pgl.disableTexturing(glTarget);
-        }
-        bound = false;
-    }
 
-    /**
-     * Marks the texture object for deletion.
-     */
-    protected void dispose() {
-        if (glres != null) {
-            glres.dispose();
-            glres = null;
-            glName = 0;
-        }
+  public void copyBufferFromSource(Object natRef, ByteBuffer byteBuf,
+                                   int w, int h) {
+    if (bufferCache == null) {
+      bufferCache = new LinkedList<>();
     }
 
-    protected boolean contextIsOutdated() {
-        boolean outdated = !pgl.contextIsCurrent(context);
-        if (outdated) {
-            dispose();
-        }
-        return outdated;
+    if (bufferCache.size() + 1 <= MAX_BUFFER_CACHE_SIZE) {
+      bufferCache.add(new BufferData(natRef, byteBuf.asIntBuffer(), w, h));
+    } else {
+      // The buffer cache reached the maximum size, so we just dispose
+      // the new buffer by adding it to the list of used buffers.
+      try {
+        usedBuffers.add(new BufferData(natRef, byteBuf.asIntBuffer(), w, h));
+      } catch (Exception e) {
+      }
     }
+  }
 
-    public void colorBuffer(boolean value) {
-        colorBuffer = value;
+
+  public void disposeSourceBuffer() {
+    if (usedBuffers == null) return;
+
+    while (0 < usedBuffers.size()) {
+      BufferData data = null;
+      try {
+        data = usedBuffers.remove(0);
+      } catch (NoSuchElementException ex) {
+        PGraphics.showWarning("Cannot remove used buffer");
+      }
+      if (data != null) {
+        data.dispose();
+      }
     }
+  }
 
-    public boolean colorBuffer() {
-        return colorBuffer;
+  public void getBufferPixels(int[] pixels) {
+    // We get the buffer either from the used buffers or the cache, giving
+    // priority to the used buffers. Why? Because the used buffer was already
+    // transferred to the texture, so the pixels should be in sync with the
+    // texture.
+    BufferData data = null;
+    if (usedBuffers != null && 0 < usedBuffers.size()) {
+      data = usedBuffers.getLast();
+    } else if (bufferCache != null && 0 < bufferCache.size()) {
+      data = bufferCache.getLast();
     }
+    if (data != null) {
+      if ((data.w != width) || (data.h != height)) {
+        init(data.w, data.h);
+      }
 
-    ///////////////////////////////////////////////////////////
-    // Utilities.
-    // Copies source texture tex into this.
-    protected void copyTexture(Texture tex, int x, int y, int w, int h,
-            boolean scale) {
-        if (tex == null) {
-            throw new RuntimeException("Source texture is null");
-        }
+      data.rgbBuf.rewind();
+      data.rgbBuf.get(pixels);
+      convertToARGB(pixels);
 
-        if (tempFbo == null) {
-            tempFbo = new FrameBuffer(pg, glWidth, glHeight);
-        }
+      // In order to avoid a cached buffer to overwrite the texture when the
+      // renderer draws the texture, and hence put the pixels put of sync, we
+      // simply empty the cache.
+      if (usedBuffers == null) {
+        usedBuffers = new LinkedList<>();
+      }
+      while (0 < bufferCache.size()) {
+        data = bufferCache.remove(0);
+        usedBuffers.add(data);
+      }
+    }
+  }
 
-        // This texture is the color (destination) buffer of the FBO.
-        tempFbo.setColorBuffer(this);
-        tempFbo.disableDepthTest();
-
-        // FBO copy:
-        pg.pushFramebuffer();
-        pg.setFramebuffer(tempFbo);
-        // Replaces anything that this texture might contain in the area being
-        // replaced by the new one.
-        pg.pushStyle();
-        pg.blendMode(REPLACE);
-        if (scale) {
-            // Rendering tex into "this", and scaling the source rectangle
-            // to cover the entire destination region.
-            pgl.drawTexture(tex.glTarget, tex.glName, tex.glWidth, tex.glHeight,
-                    0, 0, tempFbo.width, tempFbo.height, 1,
-                    x, y, x + w, y + h, 0, 0, width, height);
 
-        } else {
-            // Rendering tex into "this" but without scaling so the contents
-            // of the source texture fall in the corresponding texels of the
-            // destination.
-            pgl.drawTexture(tex.glTarget, tex.glName, tex.glWidth, tex.glHeight,
-                    0, 0, tempFbo.width, tempFbo.height, 1,
-                    x, y, x + w, y + h, x, y, x + w, y + h);
-        }
-        pgl.flush(); // Needed to make sure that the change in this texture is
-        // available immediately.
-        pg.popStyle();
-        pg.popFramebuffer();
-        updateTexels(x, y, w, h);
-    }
-
-    // Copies source texture tex into this.
-    protected void copyTexture(int texTarget, int texName,
-            int texWidth, int texHeight,
-            int x, int y, int w, int h, boolean scale) {
-        if (tempFbo == null) {
-            tempFbo = new FrameBuffer(pg, glWidth, glHeight);
-        }
+  public boolean hasBufferSource() {
+    return bufferSource != null;
+  }
 
-        // This texture is the color (destination) buffer of the FBO.
-        tempFbo.setColorBuffer(this);
-        tempFbo.disableDepthTest();
-
-        // FBO copy:
-        pg.pushFramebuffer();
-        pg.setFramebuffer(tempFbo);
-        // Replaces anything that this texture might contain in the area being
-        // replaced by the new one.
-        pg.pushStyle();
-        pg.blendMode(REPLACE);
-        if (scale) {
-            // Rendering tex into "this", and scaling the source rectangle
-            // to cover the entire destination region.
-            pgl.drawTexture(texTarget, texName, texWidth, texHeight,
-                    0, 0, tempFbo.width, tempFbo.height,
-                    x, y, w, h, 0, 0, width, height);
 
-        } else {
-            // Rendering tex into "this" but without scaling so the contents
-            // of the source texture fall in the corresponding texels of the
-            // destination.
-            pgl.drawTexture(texTarget, texName, texWidth, texHeight,
-                    0, 0, tempFbo.width, tempFbo.height,
-                    x, y, w, h, x, y, w, h);
-        }
-        pgl.flush(); // Needed to make sure that the change in this texture is
-        // available immediately.
-        pg.popStyle();
-        pg.popFramebuffer();
-        updateTexels(x, y, w, h);
-    }
+  public boolean hasBuffers() {
+    return bufferSource != null && bufferCache != null &&
+           0 < bufferCache.size();
+  }
 
-    protected void copyObject(Texture src) {
-        // The OpenGL texture of this object is replaced with the one from the
-        // source object, so we delete the former to avoid resource wasting.
-        dispose();
 
-        width = src.width;
-        height = src.height;
+  protected boolean bufferUpdate() {
+    BufferData data = null;
+    try {
+      data = bufferCache.remove(0);
+    } catch (NoSuchElementException ex) {
+      PGraphics.showWarning("Don't have pixel data to copy to texture");
+    }
+
+    if (data != null) {
+      if ((data.w != width) || (data.h != height)) {
+        init(data.w, data.h);
+      }
+      data.rgbBuf.rewind();
+      setNative(data.rgbBuf, 0, 0, width, height);
+
+      // Putting the buffer in the used buffers list to dispose at the end of
+      // draw.
+      if (usedBuffers == null) {
+        usedBuffers = new LinkedList<>();
+      }
+      usedBuffers.add(data);
+
+      return true;
+    } else {
+      return false;
+    }
+  }
+
+
+  protected void getSourceMethods() {
+    try {
+      disposeBufferMethod = bufferSource.getClass().
+        getMethod("disposeBuffer", Object.class);
+    } catch (NoSuchMethodException | SecurityException e) {
+      throw new RuntimeException("Provided source object doesn't have a " +
+                                 "disposeBuffer method.");
+    }
+  }
+
+
+  ////////////////////////////////////////////////////////////
+
+  // Utilities
+
+
+  /**
+   * Flips intArray along the X axis.
+   * @param intArray int[]
+   * @param mult int
+   */
+  protected void flipArrayOnX(int[] intArray, int mult)  {
+    int index = 0;
+    int xindex = mult * (width - 1);
+    for (int x = 0; x < width / 2; x++) {
+      for (int y = 0; y < height; y++)  {
+        int i = index + mult * y * width;
+        int j = xindex + mult * y * width;
+
+        for (int c = 0; c < mult; c++) {
+          int temp = intArray[i];
+          intArray[i] = intArray[j];
+          intArray[j] = temp;
+
+          i++;
+          j++;
+        }
+
+      }
+      index += mult;
+      xindex -= mult;
+    }
+  }
+
+
+  /**
+   * Flips intArray along the Y axis.
+   * @param intArray int[]
+   * @param mult int
+   */
+  protected void flipArrayOnY(int[] intArray, int mult) {
+    int index = 0;
+    int yindex = mult * (height - 1) * width;
+    for (int y = 0; y < height / 2; y++) {
+      for (int x = 0; x < mult * width; x++) {
+        int temp = intArray[index];
+        intArray[index] = intArray[yindex];
+        intArray[yindex] = temp;
+
+        index++;
+        yindex++;
+      }
+      yindex -= mult * width * 2;
+    }
+  }
+
+
+  /**
+   * Reorders a pixel array in the given format into the order required by
+   * OpenGL (RGBA) and stores it into rgbaPixels. The width and height
+   * parameters are used in the YUV420 to RBGBA conversion.
+   * @param pixels int[]
+   * @param format int
+   * @param w int
+   * @param h int
+   */
+  protected void convertToRGBA(int[] pixels, int format, int w, int h)  {
+    if (PGL.BIG_ENDIAN)  {
+      switch (format) {
+      case ALPHA:
+        // Converting from xxxA into RGBA. RGB is set to white
+        // (0xFFFFFF, i.e.: (255, 255, 255))
+        for (int i = 0; i< pixels.length; i++) {
+          rgbaPixels[i] = 0xFFFFFF00 | pixels[i];
+        }
+        break;
+      case RGB:
+        // Converting xRGB into RGBA. A is set to 0xFF (255, full opacity).
+        for (int i = 0; i< pixels.length; i++) {
+          int pixel = pixels[i];
+          rgbaPixels[i] = (pixel << 8) | 0xFF;
+        }
+        break;
+      case ARGB:
+        // Converting ARGB into RGBA. Shifting RGB to 8 bits to the left,
+        // and bringing A to the first byte.
+        for (int i = 0; i< pixels.length; i++) {
+          int pixel = pixels[i];
+          rgbaPixels[i] = (pixel << 8) | ((pixel >> 24) & 0xFF);
+        }
+        break;
+      }
+    } else {
+      // LITTLE_ENDIAN
+      // ARGB native, and RGBA opengl means ABGR on windows
+      // for the most part just need to swap two components here
+      // the sun.cpu.endian here might be "false", oddly enough..
+      // (that's why just using an "else", rather than check for "little")
+      switch (format)  {
+      case ALPHA:
+        // Converting xxxA into ARGB, with RGB set to white.
+        for (int i = 0; i< pixels.length; i++) {
+          rgbaPixels[i] = (pixels[i] << 24) | 0x00FFFFFF;
+        }
+        break;
+      case RGB:
+        // We need to convert xRGB into ABGR,
+        // so R and B must be swapped, and the x just made 0xFF.
+        for (int i = 0; i< pixels.length; i++) {
+          int pixel = pixels[i];
+          rgbaPixels[i] = 0xFF000000 |
+                          ((pixel & 0xFF) << 16) | ((pixel & 0xFF0000) >> 16) |
+                          (pixel & 0x0000FF00);
+        }
+        break;
+      case ARGB:
+        // We need to convert ARGB into ABGR,
+        // so R and B must be swapped, A and G just brought back in.
+        for (int i = 0; i < pixels.length; i++) {
+          int pixel = pixels[i];
+          rgbaPixels[i] = ((pixel & 0xFF) << 16) | ((pixel & 0xFF0000) >> 16) |
+                          (pixel & 0xFF00FF00);
+        }
+        break;
+      }
+    }
+    rgbaPixUpdateCount++;
+  }
+
+
+  /**
+   * Reorders an OpenGL pixel array (RGBA) into ARGB. The array must be
+   * of size width * height.
+   * @param pixels int[]
+   */
+  protected void convertToARGB(int[] pixels) {
+    int t = 0;
+    int p = 0;
+    if (PGL.BIG_ENDIAN) {
+      // RGBA to ARGB conversion: shifting RGB 8 bits to the right,
+      // and placing A 24 bits to the left.
+      for (int y = 0; y < height; y++) {
+        for (int x = 0; x < width; x++) {
+          int pixel = pixels[p++];
+          pixels[t++] = (pixel >>> 8) | ((pixel << 24) & 0xFF000000);
+        }
+      }
+    } else {
+      // We have to convert ABGR into ARGB, so R and B must be swapped,
+      // A and G just brought back in.
+      for (int y = 0; y < height; y++) {
+        for (int x = 0; x < width; x++) {
+          int pixel = pixels[p++];
+          pixels[t++] = ((pixel & 0xFF) << 16) | ((pixel & 0xFF0000) >> 16) |
+                          (pixel & 0xFF00FF00);
+        }
+      }
+    }
+  }
+
+
+  ///////////////////////////////////////////////////////////
+
+  // Allocate/release texture.
+
+
+  protected void setSize(int w, int h) {
+    width = w;
+    height = h;
+
+    if (PGraphicsOpenGL.npotTexSupported) {
+      glWidth = w;
+      glHeight = h;
+    } else {
+      glWidth = PGL.nextPowerOfTwo(w);
+      glHeight = PGL.nextPowerOfTwo(h);
+    }
+
+    if (glWidth > PGraphicsOpenGL.maxTextureSize ||
+        glHeight > PGraphicsOpenGL.maxTextureSize) {
+      glWidth = glHeight = 0;
+      throw new RuntimeException("Image width and height cannot be" +
+                                 " larger than " +
+                                 PGraphicsOpenGL.maxTextureSize +
+                                 " with this graphics card.");
+    }
 
-        glName = src.glName;
-        glTarget = src.glTarget;
-        glFormat = src.glFormat;
-        glMinFilter = src.glMinFilter;
-        glMagFilter = src.glMagFilter;
+    // If non-power-of-two textures are not supported, and the specified width
+    // or height is non-power-of-two, then glWidth (glHeight) will be greater
+    // than w (h) because it is chosen to be the next power of two, and this
+    // quotient will give the appropriate maximum texture coordinate value given
+    // this situation.
+    maxTexcoordU = (float)width / glWidth;
+    maxTexcoordV = (float)height / glHeight;
+  }
 
-        glWidth = src.glWidth;
-        glHeight = src.glHeight;
 
-        usingMipmaps = src.usingMipmaps;
-        usingRepeat = src.usingRepeat;
-        maxTexcoordU = src.maxTexcoordU;
-        maxTexcoordV = src.maxTexcoordV;
+  /**
+   * Allocates the opengl texture object.
+   */
+  protected void allocate() {
+    dispose(); // Just in the case this object is being re-allocated.
 
-        invertedX = src.invertedX;
-        invertedY = src.invertedY;
+    boolean enabledTex = false;
+    if (!pgl.texturingIsEnabled(glTarget)) {
+      pgl.enableTexturing(glTarget);
+      enabledTex = true;
     }
 
-    // Releases the memory used by pixelBuffer either if the buffer hasn't been
-    // used many times yet, or if the JVM is running low in free memory.
-    protected void releasePixelBuffer() {
-        double freeMB = Runtime.getRuntime().freeMemory() / 1E6;
-        if (pixBufUpdateCount < MAX_UPDATES || freeMB < MIN_MEMORY) {
-            pixelBuffer = null;
-        }
-    }
+    context = pgl.getCurrentContext();
+    glres = new GLResourceTexture(this);
 
-    // Releases the memory used by rgbaPixels either if the array hasn't been
-    // used many times yet, or if the JVM is running low in free memory.
-    protected void releaseRGBAPixels() {
-        double freeMB = Runtime.getRuntime().freeMemory() / 1E6;
-        if (rgbaPixUpdateCount < MAX_UPDATES || freeMB < MIN_MEMORY) {
-            rgbaPixels = null;
-        }
+    pgl.bindTexture(glTarget, glName);
+    pgl.texParameteri(glTarget, PGL.TEXTURE_MIN_FILTER, glMinFilter);
+    pgl.texParameteri(glTarget, PGL.TEXTURE_MAG_FILTER, glMagFilter);
+    pgl.texParameteri(glTarget, PGL.TEXTURE_WRAP_S, glWrapS);
+    pgl.texParameteri(glTarget, PGL.TEXTURE_WRAP_T, glWrapT);
+    if (PGraphicsOpenGL.anisoSamplingSupported) {
+      pgl.texParameterf(glTarget, PGL.TEXTURE_MAX_ANISOTROPY,
+                        PGraphicsOpenGL.maxAnisoAmount);
     }
 
-    ///////////////////////////////////////////////////////////
-    // Parameter handling
-    public Parameters getParameters() {
-        Parameters res = new Parameters();
-
-        if (glTarget == PGL.TEXTURE_2D) {
-            res.target = TEX2D;
-        }
-
-        if (glFormat == PGL.RGB) {
-            res.format = RGB;
-        } else if (glFormat == PGL.RGBA) {
-            res.format = ARGB;
-        } else if (glFormat == PGL.ALPHA) {
-            res.format = ALPHA;
-        }
+    // First, we use glTexImage2D to set the full size of the texture (glW/glH
+    // might be diff from w/h in the case that the GPU doesn't support NPOT
+    // textures)
+    pgl.texImage2D(glTarget, 0, glFormat, glWidth, glHeight, 0,
+                   PGL.RGBA, PGL.UNSIGNED_BYTE, null);
 
-        if (glMagFilter == PGL.NEAREST && glMinFilter == PGL.NEAREST) {
-            res.sampling = POINT;
-            res.mipmaps = false;
-        } else if (glMagFilter == PGL.NEAREST && glMinFilter == PGL.LINEAR) {
-            res.sampling = LINEAR;
-            res.mipmaps = false;
-        } else if (glMagFilter == PGL.NEAREST
-                && glMinFilter == PGL.LINEAR_MIPMAP_NEAREST) {
-            res.sampling = LINEAR;
-            res.mipmaps = true;
-        } else if (glMagFilter == PGL.LINEAR && glMinFilter == PGL.LINEAR) {
-            res.sampling = BILINEAR;
-            res.mipmaps = false;
-        } else if (glMagFilter == PGL.LINEAR
-                && glMinFilter == PGL.LINEAR_MIPMAP_NEAREST) {
-            res.sampling = BILINEAR;
-            res.mipmaps = true;
-        } else if (glMagFilter == PGL.LINEAR
-                && glMinFilter == PGL.LINEAR_MIPMAP_LINEAR) {
-            res.sampling = TRILINEAR;
-            res.mipmaps = true;
-        }
+    // Makes sure that the texture buffer in video memory doesn't contain
+    // any garbage.
+    pgl.initTexture(glTarget, PGL.RGBA, width, height);
 
-        if (glWrapS == PGL.CLAMP_TO_EDGE) {
-            res.wrapU = CLAMP;
-        } else if (glWrapS == PGL.REPEAT) {
-            res.wrapU = REPEAT;
-        }
+    pgl.bindTexture(glTarget, 0);
+    if (enabledTex) {
+      pgl.disableTexturing(glTarget);
+    }
+    bound = false;
+  }
 
-        if (glWrapT == PGL.CLAMP_TO_EDGE) {
-            res.wrapV = CLAMP;
-        } else if (glWrapT == PGL.REPEAT) {
-            res.wrapV = REPEAT;
-        }
 
-        return res;
+  /**
+   * Marks the texture object for deletion.
+   */
+  protected void dispose() {
+    if (glres != null) {
+      glres.dispose();
+      glres = null;
+      glName = 0;
     }
+  }
 
-    /**
-     * Sets texture target and internal format according to the target and type
-     * specified.
-     *
-     * @param target int
-     * @param params GLTextureParameters
-     */
-    protected void setParameters(Parameters params) {
-        if (params.target == TEX2D) {
-            glTarget = PGL.TEXTURE_2D;
-        } else {
-            throw new RuntimeException("Unknown texture target");
-        }
 
-        if (params.format == RGB) {
-            glFormat = PGL.RGB;
-        } else if (params.format == ARGB) {
-            glFormat = PGL.RGBA;
-        } else if (params.format == ALPHA) {
-            glFormat = PGL.ALPHA;
-        } else {
-            throw new RuntimeException("Unknown texture format");
-        }
+  protected boolean contextIsOutdated() {
+    boolean outdated = !pgl.contextIsCurrent(context);
+    if (outdated) {
+      dispose();
+    }
+    return outdated;
+  }
 
-        boolean mipmaps = params.mipmaps && PGL.MIPMAPS_ENABLED;
-        if (mipmaps && !PGraphicsOpenGL.autoMipmapGenSupported) {
-            PGraphics.showWarning("Mipmaps were requested but automatic mipmap "
-                    + "generation is not supported and manual "
-                    + "generation still not implemented, so mipmaps "
-                    + "will be disabled.");
-            mipmaps = false;
-        }
 
-        if (params.sampling == POINT) {
-            glMagFilter = PGL.NEAREST;
-            glMinFilter = PGL.NEAREST;
-        } else if (params.sampling == LINEAR) {
-            glMagFilter = PGL.NEAREST;
-            glMinFilter = mipmaps ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR;
-        } else if (params.sampling == BILINEAR) {
-            glMagFilter = PGL.LINEAR;
-            glMinFilter = mipmaps ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR;
-        } else if (params.sampling == TRILINEAR) {
-            glMagFilter = PGL.LINEAR;
-            glMinFilter = mipmaps ? PGL.LINEAR_MIPMAP_LINEAR : PGL.LINEAR;
-        } else {
-            throw new RuntimeException("Unknown texture filtering mode");
-        }
+  public void colorBuffer(boolean value) {
+    colorBuffer = value;
+  }
+
+
+  public boolean colorBuffer() {
+    return colorBuffer;
+  }
+
+
+  ///////////////////////////////////////////////////////////
+
+  // Utilities.
+
+
+  // Copies source texture tex into this.
+  protected void copyTexture(Texture tex, int x, int y, int w, int h,
+                             boolean scale) {
+    if (tex == null) {
+      throw new RuntimeException("Source texture is null");
+    }
+
+    if (tempFbo == null) {
+      tempFbo = new FrameBuffer(pg, glWidth, glHeight);
+    }
+
+    // This texture is the color (destination) buffer of the FBO.
+    tempFbo.setColorBuffer(this);
+    tempFbo.disableDepthTest();
+
+    // FBO copy:
+    pg.pushFramebuffer();
+    pg.setFramebuffer(tempFbo);
+    // Replaces anything that this texture might contain in the area being
+    // replaced by the new one.
+    pg.pushStyle();
+    pg.blendMode(REPLACE);
+    if (scale) {
+      // Rendering tex into "this", and scaling the source rectangle
+      // to cover the entire destination region.
+      pgl.drawTexture(tex.glTarget, tex.glName, tex.glWidth, tex.glHeight,
+                      0, 0, tempFbo.width, tempFbo.height, 1,
+                      x, y, x + w, y + h, 0, 0, width, height);
+
+    } else {
+      // Rendering tex into "this" but without scaling so the contents
+      // of the source texture fall in the corresponding texels of the
+      // destination.
+      pgl.drawTexture(tex.glTarget, tex.glName, tex.glWidth, tex.glHeight,
+                      0, 0, tempFbo.width, tempFbo.height, 1,
+                      x, y, x + w, y + h, x, y, x + w, y + h);
+    }
+    pgl.flush(); // Needed to make sure that the change in this texture is
+                 // available immediately.
+    pg.popStyle();
+    pg.popFramebuffer();
+    updateTexels(x, y, w, h);
+  }
+
 
-        if (params.wrapU == CLAMP) {
-            glWrapS = PGL.CLAMP_TO_EDGE;
-        } else if (params.wrapU == REPEAT) {
-            glWrapS = PGL.REPEAT;
-        } else {
-            throw new RuntimeException("Unknown wrapping mode");
-        }
+  // Copies source texture tex into this.
+  protected void copyTexture(int texTarget, int texName,
+                             int texWidth, int texHeight,
+                             int x, int y, int w, int h, boolean scale) {
+    if (tempFbo == null) {
+      tempFbo = new FrameBuffer(pg, glWidth, glHeight);
+    }
 
-        if (params.wrapV == CLAMP) {
-            glWrapT = PGL.CLAMP_TO_EDGE;
-        } else if (params.wrapV == REPEAT) {
-            glWrapT = PGL.REPEAT;
-        } else {
-            throw new RuntimeException("Unknown wrapping mode");
-        }
+    // This texture is the color (destination) buffer of the FBO.
+    tempFbo.setColorBuffer(this);
+    tempFbo.disableDepthTest();
 
-        usingMipmaps = glMinFilter == PGL.LINEAR_MIPMAP_NEAREST
-                || glMinFilter == PGL.LINEAR_MIPMAP_LINEAR;
-
-        usingRepeat = glWrapS == PGL.REPEAT || glWrapT == PGL.REPEAT;
-
-        invertedX = false;
-        invertedY = false;
-    }
-
-    protected void fillEdges(int x, int y, int w, int h) {
-        if ((width < glWidth || height < glHeight) && (x + w == width || y + h == height)) {
-            if (x + w == width) {
-                int ew = glWidth - width;
-                edgePixels = new int[h * ew];
-                for (int i = 0; i < h; i++) {
-                    int c = rgbaPixels[i * w + (w - 1)];
-                    Arrays.fill(edgePixels, i * ew, (i + 1) * ew, c);
-                }
-                edgeBuffer = PGL.updateIntBuffer(edgeBuffer, edgePixels, true);
-                pgl.texSubImage2D(glTarget, 0, width, y, ew, h, PGL.RGBA,
-                        PGL.UNSIGNED_BYTE, edgeBuffer);
-            }
-
-            if (y + h == height) {
-                int eh = glHeight - height;
-                edgePixels = new int[eh * w];
-                for (int i = 0; i < eh; i++) {
-                    System.arraycopy(rgbaPixels, (h - 1) * w, edgePixels, i * w, w);
-                }
-                edgeBuffer = PGL.updateIntBuffer(edgeBuffer, edgePixels, true);
-                pgl.texSubImage2D(glTarget, 0, x, height, w, eh, PGL.RGBA,
-                        PGL.UNSIGNED_BYTE, edgeBuffer);
-            }
-
-            if (x + w == width && y + h == height) {
-                int ew = glWidth - width;
-                int eh = glHeight - height;
-                int c = rgbaPixels[w * h - 1];
-                edgePixels = new int[eh * ew];
-                Arrays.fill(edgePixels, 0, eh * ew, c);
-                edgeBuffer = PGL.updateIntBuffer(edgeBuffer, edgePixels, true);
-                pgl.texSubImage2D(glTarget, 0, width, height, ew, eh, PGL.RGBA,
-                        PGL.UNSIGNED_BYTE, edgeBuffer);
-            }
-        }
-    }
+    // FBO copy:
+    pg.pushFramebuffer();
+    pg.setFramebuffer(tempFbo);
+    // Replaces anything that this texture might contain in the area being
+    // replaced by the new one.
+    pg.pushStyle();
+    pg.blendMode(REPLACE);
+    if (scale) {
+      // Rendering tex into "this", and scaling the source rectangle
+      // to cover the entire destination region.
+      pgl.drawTexture(texTarget, texName, texWidth, texHeight,
+                      0, 0, tempFbo.width, tempFbo.height,
+                      x, y, w, h, 0, 0, width, height);
 
-    ///////////////////////////////////////////////////////////////////////////
-    // Parameters object
+    } else {
+      // Rendering tex into "this" but without scaling so the contents
+      // of the source texture fall in the corresponding texels of the
+      // destination.
+      pgl.drawTexture(texTarget, texName, texWidth, texHeight,
+                      0, 0, tempFbo.width, tempFbo.height,
+                      x, y, w, h, x, y, w, h);
+    }
+    pgl.flush(); // Needed to make sure that the change in this texture is
+                 // available immediately.
+    pg.popStyle();
+    pg.popFramebuffer();
+    updateTexels(x, y, w, h);
+  }
+
+
+  protected void copyObject(Texture src) {
+    // The OpenGL texture of this object is replaced with the one from the
+    // source object, so we delete the former to avoid resource wasting.
+    dispose();
+
+    width = src.width;
+    height = src.height;
+
+    glName = src.glName;
+    glTarget = src.glTarget;
+    glFormat = src.glFormat;
+    glMinFilter = src.glMinFilter;
+    glMagFilter = src.glMagFilter;
+
+    glWidth= src.glWidth;
+    glHeight = src.glHeight;
+
+    usingMipmaps = src.usingMipmaps;
+    usingRepeat = src.usingRepeat;
+    maxTexcoordU = src.maxTexcoordU;
+    maxTexcoordV = src.maxTexcoordV;
+
+    invertedX = src.invertedX;
+    invertedY = src.invertedY;
+  }
+
+
+  // Releases the memory used by pixelBuffer either if the buffer hasn't been
+  // used many times yet, or if the JVM is running low in free memory.
+  protected void releasePixelBuffer() {
+    double freeMB = Runtime.getRuntime().freeMemory() / 1E6;
+    if (pixBufUpdateCount < MAX_UPDATES || freeMB < MIN_MEMORY) {
+      pixelBuffer = null;
+    }
+  }
+
+
+  // Releases the memory used by rgbaPixels either if the array hasn't been
+  // used many times yet, or if the JVM is running low in free memory.
+  protected void releaseRGBAPixels() {
+    double freeMB = Runtime.getRuntime().freeMemory() / 1E6;
+    if (rgbaPixUpdateCount < MAX_UPDATES || freeMB < MIN_MEMORY) {
+      rgbaPixels = null;
+    }
+  }
+
+
+  ///////////////////////////////////////////////////////////
+
+  // Parameter handling
+
+
+  public Parameters getParameters() {
+    Parameters res = new Parameters();
+
+    if (glTarget == PGL.TEXTURE_2D)  {
+      res.target = TEX2D;
+    }
+
+    if (glFormat == PGL.RGB)  {
+      res.format = RGB;
+    } else  if (glFormat == PGL.RGBA) {
+      res.format = ARGB;
+    } else  if (glFormat == PGL.ALPHA) {
+      res.format = ALPHA;
+    }
+
+    if (glMagFilter == PGL.NEAREST && glMinFilter == PGL.NEAREST) {
+      res.sampling = POINT;
+      res.mipmaps = false;
+    } else if (glMagFilter == PGL.NEAREST && glMinFilter == PGL.LINEAR)  {
+      res.sampling = LINEAR;
+      res.mipmaps = false;
+    } else if (glMagFilter == PGL.NEAREST &&
+               glMinFilter == PGL.LINEAR_MIPMAP_NEAREST)  {
+      res.sampling = LINEAR;
+      res.mipmaps = true;
+    } else if (glMagFilter == PGL.LINEAR && glMinFilter == PGL.LINEAR)  {
+      res.sampling = BILINEAR;
+      res.mipmaps = false;
+    } else if (glMagFilter == PGL.LINEAR &&
+               glMinFilter == PGL.LINEAR_MIPMAP_NEAREST)  {
+      res.sampling = BILINEAR;
+      res.mipmaps = true;
+    } else if (glMagFilter == PGL.LINEAR &&
+               glMinFilter == PGL.LINEAR_MIPMAP_LINEAR) {
+      res.sampling = TRILINEAR;
+      res.mipmaps = true;
+    }
+
+    if (glWrapS == PGL.CLAMP_TO_EDGE) {
+      res.wrapU = CLAMP;
+    } else if (glWrapS == PGL.REPEAT) {
+      res.wrapU = REPEAT;
+    }
+
+    if (glWrapT == PGL.CLAMP_TO_EDGE) {
+      res.wrapV = CLAMP;
+    } else if (glWrapT == PGL.REPEAT) {
+      res.wrapV = REPEAT;
+    }
+
+    return res;
+  }
+
+
+  /**
+   * Sets texture target and internal format according to the target and
+   * type specified.
+   * @param params GLTextureParameters
+   */
+  protected void setParameters(Parameters params) {
+    if (params.target == TEX2D)  {
+        glTarget = PGL.TEXTURE_2D;
+    } else {
+      throw new RuntimeException("Unknown texture target");
+    }
+
+    switch (params.format) {
+      case RGB:
+        glFormat = PGL.RGB;
+        break;
+      case ARGB:
+        glFormat = PGL.RGBA;
+        break;
+      case ALPHA:
+        glFormat = PGL.ALPHA;
+        break;
+      default:
+        throw new RuntimeException("Unknown texture format");
+    }
+
+    boolean mipmaps = params.mipmaps && PGL.MIPMAPS_ENABLED;
+    if (mipmaps && !PGraphicsOpenGL.autoMipmapGenSupported) {
+      PGraphics.showWarning("Mipmaps were requested but automatic mipmap " +
+                            "generation is not supported and manual " +
+                            "generation still not implemented, so mipmaps " +
+                            "will be disabled.");
+      mipmaps = false;
+    }
+
+    switch (params.sampling) {
+      case POINT:
+        glMagFilter = PGL.NEAREST;
+        glMinFilter = PGL.NEAREST;
+        break;
+      case LINEAR:
+        glMagFilter = PGL.NEAREST;
+        glMinFilter = mipmaps ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR;
+        break;
+      case BILINEAR:
+        glMagFilter = PGL.LINEAR;
+        glMinFilter = mipmaps ? PGL.LINEAR_MIPMAP_NEAREST : PGL.LINEAR;
+        break;
+      case TRILINEAR:
+        glMagFilter = PGL.LINEAR;
+        glMinFilter = mipmaps ? PGL.LINEAR_MIPMAP_LINEAR : PGL.LINEAR;
+        break;
+      default:
+        throw new RuntimeException("Unknown texture filtering mode");
+    }
+
+    switch (params.wrapU) {
+      case CLAMP:
+        glWrapS = PGL.CLAMP_TO_EDGE;
+        break;
+      case REPEAT:
+        glWrapS = PGL.REPEAT;
+        break;
+      default:
+        throw new RuntimeException("Unknown wrapping mode");
+    }
+
+    switch (params.wrapV) {
+      case CLAMP:
+        glWrapT = PGL.CLAMP_TO_EDGE;
+        break;
+      case REPEAT:
+        glWrapT = PGL.REPEAT;
+        break;
+      default:
+        throw new RuntimeException("Unknown wrapping mode");
+    }
+
+    usingMipmaps = glMinFilter == PGL.LINEAR_MIPMAP_NEAREST ||
+                   glMinFilter == PGL.LINEAR_MIPMAP_LINEAR;
+
+    usingRepeat = glWrapS == PGL.REPEAT || glWrapT == PGL.REPEAT;
+
+    invertedX = false;
+    invertedY = false;
+  }
+
+
+  protected void fillEdges(int x, int y, int w, int h) {
+    if ((width < glWidth || height < glHeight) && (x + w == width || y + h == height)) {
+      if (x + w == width) {
+        int ew = glWidth - width;
+        edgePixels = new int[h * ew];
+        for (int i = 0; i < h; i++) {
+          int c = rgbaPixels[i * w + (w - 1)];
+          Arrays.fill(edgePixels, i * ew, (i + 1) * ew, c);
+        }
+        edgeBuffer = PGL.updateIntBuffer(edgeBuffer, edgePixels, true);
+        pgl.texSubImage2D(glTarget, 0, width, y, ew, h, PGL.RGBA,
+                          PGL.UNSIGNED_BYTE, edgeBuffer);
+      }
+
+      if (y + h == height) {
+        int eh = glHeight - height;
+        edgePixels = new int[eh * w];
+        for (int i = 0; i < eh; i++) {
+          System.arraycopy(rgbaPixels, (h - 1) * w, edgePixels, i * w, w);
+        }
+        edgeBuffer = PGL.updateIntBuffer(edgeBuffer, edgePixels, true);
+        pgl.texSubImage2D(glTarget, 0, x, height, w, eh, PGL.RGBA,
+                          PGL.UNSIGNED_BYTE, edgeBuffer);
+      }
+
+      if (x + w == width && y + h == height) {
+        int ew = glWidth - width;
+        int eh = glHeight - height;
+        int c = rgbaPixels[w * h - 1];
+        edgePixels = new int[eh * ew];
+        Arrays.fill(edgePixels, 0, eh * ew, c);
+        edgeBuffer = PGL.updateIntBuffer(edgeBuffer, edgePixels, true);
+        pgl.texSubImage2D(glTarget, 0, width, height, ew, eh, PGL.RGBA,
+                          PGL.UNSIGNED_BYTE, edgeBuffer);
+      }
+    }
+  }
+
+  ///////////////////////////////////////////////////////////////////////////
+
+  // Parameters object
+
+
+  /**
+   * This class stores the parameters for a texture: target, internal format,
+   * minimization filter and magnification filter.
+   */
+  static public class Parameters {
     /**
-     * This class stores the parameters for a texture: target, internal format,
-     * minimization filter and magnification filter.
+     * Texture target.
      */
-    static public class Parameters {
-
-        /**
-         * Texture target.
-         */
-        public int target;
-
-        /**
-         * Texture internal format.
-         */
-        public int format;
-
-        /**
-         * Texture filtering (POINT, LINEAR, BILINEAR or TRILINEAR).
-         */
-        public int sampling;
-
-        /**
-         * Use mipmaps or not.
-         */
-        public boolean mipmaps;
-
-        /**
-         * Wrapping mode along U.
-         */
-        public int wrapU;
-
-        /**
-         * Wrapping mode along V.
-         */
-        public int wrapV;
-
-        /**
-         * Sets all the parameters to default values.
-         */
-        public Parameters() {
-            this.target = TEX2D;
-            this.format = ARGB;
-            this.sampling = BILINEAR;
-            this.mipmaps = true;
-            this.wrapU = CLAMP;
-            this.wrapV = CLAMP;
-        }
-
-        public Parameters(int format) {
-            this.target = TEX2D;
-            this.format = format;
-            this.sampling = BILINEAR;
-            this.mipmaps = true;
-            this.wrapU = CLAMP;
-            this.wrapV = CLAMP;
-        }
-
-        public Parameters(int format, int sampling) {
-            this.target = TEX2D;
-            this.format = format;
-            this.sampling = sampling;
-            this.mipmaps = true;
-            this.wrapU = CLAMP;
-            this.wrapV = CLAMP;
-        }
-
-        public Parameters(int format, int sampling, boolean mipmaps) {
-            this.target = TEX2D;
-            this.format = format;
-            this.mipmaps = mipmaps;
-            if (sampling == TRILINEAR && !mipmaps) {
-                this.sampling = BILINEAR;
-            } else {
-                this.sampling = sampling;
-            }
-            this.wrapU = CLAMP;
-            this.wrapV = CLAMP;
-        }
-
-        public Parameters(int format, int sampling, boolean mipmaps, int wrap) {
-            this.target = TEX2D;
-            this.format = format;
-            this.mipmaps = mipmaps;
-            if (sampling == TRILINEAR && !mipmaps) {
-                this.sampling = BILINEAR;
-            } else {
-                this.sampling = sampling;
-            }
-            this.wrapU = wrap;
-            this.wrapV = wrap;
-        }
-
-        public Parameters(Parameters src) {
-            set(src);
-        }
+    public int target;
 
-        public void set(int format) {
-            this.format = format;
-        }
+    /**
+     * Texture internal format.
+     */
+    public int format;
 
-        public void set(int format, int sampling) {
-            this.format = format;
-            this.sampling = sampling;
-        }
+    /**
+     * Texture filtering (POINT, LINEAR, BILINEAR or TRILINEAR).
+     */
+    public int sampling;
 
-        public void set(int format, int sampling, boolean mipmaps) {
-            this.format = format;
-            this.sampling = sampling;
-            this.mipmaps = mipmaps;
-        }
+    /**
+     * Use mipmaps or not.
+     */
+    public boolean mipmaps;
 
-        public void set(Parameters src) {
-            this.target = src.target;
-            this.format = src.format;
-            this.sampling = src.sampling;
-            this.mipmaps = src.mipmaps;
-            this.wrapU = src.wrapU;
-            this.wrapV = src.wrapV;
-        }
-    }
+    /**
+     * Wrapping mode along U.
+     */
+    public int wrapU;
 
     /**
-     * This class stores a buffer copied from the buffer source.
-     *
+     * Wrapping mode along V.
      */
-    protected class BufferData {
-
-        int w, h;
-        // Native buffer object.
-        Object natBuf;
-        // Buffer viewed as int.
-        IntBuffer rgbBuf;
-
-        BufferData(Object nat, IntBuffer rgb, int w, int h) {
-            natBuf = nat;
-            rgbBuf = rgb;
-            this.w = w;
-            this.h = h;
-        }
+    public int wrapV;
 
-        void dispose() {
-            try {
-                // Disposing the native buffer.
-                disposeBufferMethod.invoke(bufferSource, new Object[]{natBuf});
-                natBuf = null;
-                rgbBuf = null;
-            } catch (Exception e) {
-                e.printStackTrace();
-            }
-        }
-    }
-}
+    /**
+     * Sets all the parameters to default values.
+     */
+    public Parameters() {
+      this.target = TEX2D;
+      this.format = ARGB;
+      this.sampling = BILINEAR;
+      this.mipmaps = true;
+      this.wrapU = CLAMP;
+      this.wrapV = CLAMP;
+    }
+
+    public Parameters(int format) {
+      this.target = TEX2D;
+      this.format = format;
+      this.sampling = BILINEAR;
+      this.mipmaps = true;
+      this.wrapU = CLAMP;
+      this.wrapV = CLAMP;
+    }
+
+    public Parameters(int format, int sampling) {
+      this.target = TEX2D;
+      this.format = format;
+      this.sampling = sampling;
+      this.mipmaps = true;
+      this.wrapU = CLAMP;
+      this.wrapV = CLAMP;
+    }
+
+    public Parameters(int format, int sampling, boolean mipmaps) {
+      this.target = TEX2D;
+      this.format = format;
+      this.mipmaps = mipmaps;
+      if (sampling == TRILINEAR && !mipmaps) {
+        this.sampling = BILINEAR;
+      } else {
+        this.sampling = sampling;
+      }
+      this.wrapU = CLAMP;
+      this.wrapV = CLAMP;
+    }
+
+    public Parameters(int format, int sampling, boolean mipmaps, int wrap) {
+      this.target = TEX2D;
+      this.format = format;
+      this.mipmaps = mipmaps;
+      if (sampling == TRILINEAR && !mipmaps) {
+        this.sampling = BILINEAR;
+      } else {
+        this.sampling = sampling;
+      }
+      this.wrapU = wrap;
+      this.wrapV = wrap;
+    }
+
+    public Parameters(Parameters src) {
+      set(src);
+    }
+
+    public void set(int format) {
+      this.format = format;
+    }
+
+    public void set(int format, int sampling) {
+      this.format = format;
+      this.sampling = sampling;
+    }
+
+    public void set(int format, int sampling, boolean mipmaps) {
+      this.format = format;
+      this.sampling = sampling;
+      this.mipmaps = mipmaps;
+    }
+
+    public void set(Parameters src) {
+      this.target = src.target;
+      this.format = src.format;
+      this.sampling = src.sampling;
+      this.mipmaps = src.mipmaps;
+      this.wrapU = src.wrapU;
+      this.wrapV = src.wrapV;
+    }
+  }
+
+  /**
+   * This class stores a buffer copied from the buffer source.
+   *
+   */
+  protected class BufferData {
+    int w, h;
+    // Native buffer object.
+    Object natBuf;
+    // Buffer viewed as int.
+    IntBuffer rgbBuf;
+
+    BufferData(Object nat, IntBuffer rgb, int w, int h) {
+      natBuf = nat;
+      rgbBuf = rgb;
+      this.w = w;
+      this.h = h;
+    }
+
+    void dispose() {
+      try {
+        // Disposing the native buffer.
+        disposeBufferMethod.invoke(bufferSource, natBuf);
+        natBuf = null;
+        rgbBuf = null;
+      } catch (IllegalAccessException | IllegalArgumentException | InvocationTargetException e) {
+      }
+    }
+  }
+}