package com.jogamp.opengl.util; import java.nio.ByteBuffer; import javax.media.nativewindow.util.Dimension; import javax.media.opengl.GL; import javax.media.opengl.GL2ES3; /** * A fairly direct port of Brian Paul's tile rendering library, found * at * http://www.mesa3d.org/brianp/TR.html . I've java-fied it, but * the functionality is the same. *

* Original code Copyright (C) 1997-2005 Brian Paul. Licensed under * BSD-compatible terms with permission of the author. See LICENSE.txt * for license information. *

*

* Enhanced for {@link GL2ES3}. *

* * @author ryanm, sgothel */ public class TileRenderer { protected static final boolean DEBUG = true; protected static final int DEFAULT_TILE_WIDTH = 256; protected static final int DEFAULT_TILE_HEIGHT = 256; protected static final int DEFAULT_TILE_BORDER = 0; /** * The width of a tile */ public static final int TR_TILE_WIDTH = 0; /** * The height of a tile */ public static final int TR_TILE_HEIGHT = 1; /** * The width of the border around the tiles */ public static final int TR_TILE_BORDER = 2; /** * The width of the final image */ public static final int TR_IMAGE_WIDTH = 3; /** * The height of the final image */ public static final int TR_IMAGE_HEIGHT = 4; /** * The number of rows of tiles */ public static final int TR_ROWS = 5; /** * The number of columns of tiles */ public static final int TR_COLUMNS = 6; /** * The current row number */ public static final int TR_CURRENT_ROW = 7; /** * The current column number */ public static final int TR_CURRENT_COLUMN = 8; /** * The width of the current tile */ public static final int TR_CURRENT_TILE_WIDTH = 9; /** * The height of the current tile */ public static final int TR_CURRENT_TILE_HEIGHT = 10; /** * The order that the rows are traversed */ public static final int TR_ROW_ORDER = 11; /** * Indicates we are traversing rows from the top to the bottom */ public static final int TR_TOP_TO_BOTTOM = 1; /** * Indicates we are traversing rows from the bottom to the top */ public static final int TR_BOTTOM_TO_TOP = 2; protected final Dimension imageSize = new Dimension(0, 0); protected final Dimension tileSize = new Dimension(DEFAULT_TILE_WIDTH, DEFAULT_TILE_HEIGHT); protected final Dimension tileSizeNB = new Dimension(DEFAULT_TILE_WIDTH - 2 * DEFAULT_TILE_BORDER, DEFAULT_TILE_HEIGHT - 2 * DEFAULT_TILE_BORDER); protected final int[] userViewport = new int[ 4 ]; protected final GLPixelStorageModes psm = new GLPixelStorageModes(); protected int tileBorder = DEFAULT_TILE_BORDER; protected int imageFormat; protected int imageType; protected ByteBuffer imageBuffer; protected int tileFormat; protected int tileType; protected ByteBuffer tileBuffer; protected int rowOrder = TR_BOTTOM_TO_TOP; protected int rows; protected int columns; protected int currentTile = -1; protected int currentTileWidth; protected int currentTileHeight; protected int currentRow; protected int currentColumn; protected PMVMatrixCallback pmvMatrixCB = null; public static interface PMVMatrixCallback { void reshapePMVMatrix(GL gl, int tileNum, int tileColumn, int tileRow, int tileX, int tileY, int tileWidth, int tileHeight, int imageWidth, int imageHeight); } /** * Creates a new TileRenderer object */ public TileRenderer() { } /** * Sets the size of the tiles to use in rendering. The actual * effective size of the tile depends on the border size, ie ( * width - 2*border ) * ( height - 2 * border ) * * @param width * The width of the tiles. Must not be larger than the GL * context * @param height * The height of the tiles. Must not be larger than the * GL context * @param border * The width of the borders on each tile. This is needed * to avoid artifacts when rendering lines or points with * thickness > 1. */ public final void setTileSize(int width, int height, int border) { assert ( border >= 0 ); assert ( width >= 1 ); assert ( height >= 1 ); assert ( width >= 2 * border ); assert ( height >= 2 * border ); tileBorder = border; tileSize.setWidth( width ); tileSize.setHeight( height ); tileSizeNB.setWidth( width - 2 * border ); tileSizeNB.setHeight( height - 2 * border ); setup(); } public final void setPMVMatrixCallback(PMVMatrixCallback pmvMatrixCB) { assert ( null != pmvMatrixCB ); this.pmvMatrixCB = pmvMatrixCB; } /** * Sets up the number of rows and columns needed */ protected final void setup() throws IllegalStateException { columns = ( imageSize.getWidth() + tileSizeNB.getWidth() - 1 ) / tileSizeNB.getWidth(); rows = ( imageSize.getHeight() + tileSizeNB.getHeight() - 1 ) / tileSizeNB.getHeight(); currentTile = 0; currentTileWidth = 0; currentTileHeight = 0; currentRow = 0; currentColumn = 0; assert columns >= 0; assert rows >= 0; } /** * Returns true if all tiles have been rendered or {@link #setup()} * has not been called, otherwise false. */ public final boolean eot() { return 0 > currentTile; } /** * Specify a buffer the tiles to be copied to. This is not * necessary for the creation of the final image, but useful if you * want to inspect each tile in turn. * * @param format * Interpreted as in glReadPixels * @param type * Interpreted as in glReadPixels * @param buffer * The buffer itself. Must be large enough to contain a * tile, minus any borders */ public final void setTileBuffer(int format, int type, ByteBuffer buffer) { tileFormat = format; tileType = type; tileBuffer = buffer; } /** * Sets the desired size of the final image * * @param width * The width of the final image * @param height * The height of the final image */ public final void setImageSize(int width, int height) { imageSize.setWidth(width); imageSize.setHeight(height); setup(); } /** * Sets the buffer in which to store the final image * * @param format * Interpreted as in glReadPixels * @param type * Interpreted as in glReadPixels * @param image * the buffer itself, must be large enough to hold the * final image */ public final void setImageBuffer(int format, int type, ByteBuffer buffer) { imageFormat = format; imageType = type; imageBuffer = buffer; } /** * Gets the parameters of this TileRenderer object * * @param param * The parameter that is to be retrieved * @return the value of the parameter */ public final int getParam(int param) { switch (param) { case TR_TILE_WIDTH: return tileSize.getWidth(); case TR_TILE_HEIGHT: return tileSize.getHeight(); case TR_TILE_BORDER: return tileBorder; case TR_IMAGE_WIDTH: return imageSize.getWidth(); case TR_IMAGE_HEIGHT: return imageSize.getHeight(); case TR_ROWS: return rows; case TR_COLUMNS: return columns; case TR_CURRENT_ROW: if( currentTile < 0 ) return -1; else return currentRow; case TR_CURRENT_COLUMN: if( currentTile < 0 ) return -1; else return currentColumn; case TR_CURRENT_TILE_WIDTH: return currentTileWidth; case TR_CURRENT_TILE_HEIGHT: return currentTileHeight; case TR_ROW_ORDER: return rowOrder; default: throw new IllegalArgumentException("Invalid enumerant as argument"); } } /** * Sets the order of row traversal * * @param order * The row traversal order, must be * eitherTR_TOP_TO_BOTTOM or TR_BOTTOM_TO_TOP */ public final void setRowOrder(int order) { if (order == TR_TOP_TO_BOTTOM || order == TR_BOTTOM_TO_TOP) { rowOrder = order; } else { throw new IllegalArgumentException("Must pass TR_TOP_TO_BOTTOM or TR_BOTTOM_TO_TOP"); } } /** * Begins rendering a tile. *

* The projection matrix stack should be * left alone after calling this method! *

* * @param gl The gl context */ public final void beginTile( GL2ES3 gl ) { if( 0 >= imageSize.getWidth() || 0 >= imageSize.getHeight() ) { throw new IllegalStateException("Image size has not been set"); } if( null == this.pmvMatrixCB ) { throw new IllegalStateException("pmvMatrixCB has not been set"); } if (currentTile <= 0) { setup(); /* * Save user's viewport, will be restored after last tile * rendered */ gl.glGetIntegerv( GL.GL_VIEWPORT, userViewport, 0 ); } final int preRow = currentRow; final int preColumn = currentColumn; /* which tile (by row and column) we're about to render */ if (rowOrder == TR_BOTTOM_TO_TOP) { currentRow = currentTile / columns; currentColumn = currentTile % columns; } else { currentRow = rows - ( currentTile / columns ) - 1; currentColumn = currentTile % columns; } assert ( currentRow < rows ); assert ( currentColumn < columns ); int border = tileBorder; int tH, tW; /* Compute actual size of this tile with border */ if (currentRow < rows - 1) { tH = tileSize.getHeight(); } else { tH = imageSize.getHeight() - ( rows - 1 ) * ( tileSizeNB.getHeight() ) + 2 * border; } if (currentColumn < columns - 1) { tW = tileSize.getWidth(); } else { tW = imageSize.getWidth() - ( columns - 1 ) * ( tileSizeNB.getWidth() ) + 2 * border; } final int tX = currentColumn * tileSizeNB.getWidth() - border; final int tY = currentRow * tileSizeNB.getHeight() - border; final int preTileWidth = currentTileWidth; final int preTileHeight = currentTileHeight; /* Save tile size, with border */ currentTileWidth = tW; currentTileHeight = tH; if( DEBUG ) { System.err.println("Tile["+currentTile+"]: ["+preColumn+"]["+preRow+"] "+preTileWidth+"x"+preTileHeight+ " -> ["+currentColumn+"]["+currentRow+"] "+tX+"/"+tY+", "+tW+"x"+tH+", image "+imageSize.getWidth()+"x"+imageSize.getHeight()); } gl.glViewport( 0, 0, tW, tH ); pmvMatrixCB.reshapePMVMatrix(gl, currentTile, currentColumn, currentRow, tX, tY, tW, tH, imageSize.getWidth(), imageSize.getHeight()); } /** * Must be called after rendering the scene * * @param gl * the gl context * @return true if there are more tiles to be rendered, false if * the final image is complete */ public boolean endTile( GL2ES3 gl ) { assert ( currentTile >= 0 ); // be sure OpenGL rendering is finished gl.glFlush(); // save current glPixelStore values psm.save(gl); final int tmp[] = new int[1]; if( tileBuffer != null ) { int srcX = tileBorder; int srcY = tileBorder; int srcWidth = tileSizeNB.getWidth(); int srcHeight = tileSizeNB.getHeight(); final int bytesPerPixel = GLBuffers.bytesPerPixel(tileFormat, tileType); final int readPixelSize = GLBuffers.sizeof(gl, tmp, bytesPerPixel, srcWidth, srcHeight, 1, true); tileBuffer.clear(); if( tileBuffer.limit() < readPixelSize ) { throw new IndexOutOfBoundsException("Required " + readPixelSize + " bytes of buffer, only had " + tileBuffer.limit()); } gl.glReadPixels( srcX, srcY, srcWidth, srcHeight, tileFormat, tileType, tileBuffer ); // be sure OpenGL rendering is finished gl.glFlush(); tileBuffer.position( readPixelSize ); tileBuffer.flip(); } if( imageBuffer != null ) { int srcX = tileBorder; int srcY = tileBorder; int srcWidth = currentTileWidth - 2 * tileBorder; int srcHeight = currentTileHeight - 2 * tileBorder; /* setup pixel store for glReadPixels */ final int rowLength = imageSize.getWidth(); psm.setPackRowLength(gl, rowLength); psm.setPackAlignment(gl, 1); /* read the tile into the final image */ final int bytesPerPixel = GLBuffers.bytesPerPixel(imageFormat, imageType); final int readPixelSize = GLBuffers.sizeof(gl, tmp, bytesPerPixel, srcWidth, srcHeight, 1, true); final int skipPixels = tileSizeNB.getWidth() * currentColumn; final int skipRows = tileSizeNB.getHeight() * currentRow; final int ibPos = ( skipPixels + ( skipRows * rowLength ) ) * bytesPerPixel; final int ibLim = ibPos + readPixelSize; imageBuffer.clear(); if( imageBuffer.limit() < ibLim ) { throw new IndexOutOfBoundsException("Required " + ibLim + " bytes of buffer, only had " + imageBuffer.limit()); } imageBuffer.position(ibPos); gl.glReadPixels( srcX, srcY, srcWidth, srcHeight, imageFormat, imageType, imageBuffer); // be sure OpenGL rendering is finished gl.glFlush(); imageBuffer.position( ibLim ); imageBuffer.flip(); } /* restore previous glPixelStore values */ psm.restore(gl); /* increment tile counter, return 1 if more tiles left to render */ currentTile++; if( currentTile >= rows * columns ) { /* restore user's viewport */ gl.glViewport( userViewport[ 0 ], userViewport[ 1 ], userViewport[ 2 ], userViewport[ 3 ] ); currentTile = -1; /* all done */ return false; } else { return true; } } }