Menu
▾
▴
[Java-game-lib-cvs] LWJGL/src/java/org/lwjgl/opengl RenderTexture.java,NONE,1.1 Pbuffer.java,1.10,1.11
|
From: <sp...@us...> - 2004-03-02 02:16:20
|
Update of /cvsroot/java-game-lib/LWJGL/src/java/org/lwjgl/opengl In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv3686 Modified Files: Pbuffer.java Added Files: RenderTexture.java Log Message: render-to-texture support --- NEW FILE: RenderTexture.java --- /* * Copyright (c) 2002 Lightweight Java Game Library Project * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are * met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * * Neither the name of 'Light Weight Java Game Library' nor the names of * its contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /* * Created by LWJGL. * User: spasi * Date: 2004-03-01 * Time: 23:24:38 */ package org.lwjgl.opengl; import org.lwjgl.BufferUtils; import java.nio.IntBuffer; /** * This class represents the state necessary for render-to-texture. */ public final class RenderTexture { // ---------------------------------------------------------------------------------- // ----------------------------- WGL_ARB_render_texture ----------------------------- // ---------------------------------------------------------------------------------- /* Accepted by the <piAttributes> parameter of wglGetPixelFormatAttribivARB, wglGetPixelFormatAttribfvARB, and the <piAttribIList> and <pfAttribIList> parameters of wglChoosePixelFormatARB: */ private static final int WGL_BIND_TO_TEXTURE_RGB_ARB = 0x2070; private static final int WGL_BIND_TO_TEXTURE_RGBA_ARB = 0x2071; /* Accepted by the <piAttribList> parameter of wglCreatePbufferARB and by the <iAttribute> parameter of wglQueryPbufferARB: */ private static final int WGL_TEXTURE_FORMAT_ARB = 0x2072; private static final int WGL_TEXTURE_TARGET_ARB = 0x2073; private static final int WGL_MIPMAP_TEXTURE_ARB = 0x2074; /* Accepted as a value in the <piAttribList> parameter of wglCreatePbufferARB and returned in the value parameter of wglQueryPbufferARB when <iAttribute> is WGL_TEXTURE_FORMAT_ARB: */ private static final int WGL_TEXTURE_RGB_ARB = 0x2075; private static final int WGL_TEXTURE_RGBA_ARB = 0x2076; /* Accepted as a value in the <piAttribList> parameter of wglCreatePbufferARB and returned in the value parameter of wglQueryPbufferARB when <iAttribute> is WGL_TEXTURE_TARGET_ARB: */ private static final int WGL_TEXTURE_CUBE_MAP_ARB = 0x2078; private static final int WGL_TEXTURE_1D_ARB = 0x2079; private static final int WGL_TEXTURE_2D_ARB = 0x207A; private static final int WGL_NO_TEXTURE_ARB = 0x2077; /* Accepted by the <piAttribList> parameter of wglSetPbufferAttribARB and by the <iAttribute> parameter of wglQueryPbufferARB: */ static final int WGL_MIPMAP_LEVEL_ARB = 0x207B; static final int WGL_CUBE_MAP_FACE_ARB = 0x207C; /* Accepted as a value in the <piAttribList> parameter of wglSetPbufferAttribARB and returned in the value parameter of wglQueryPbufferARB when <iAttribute> is WGL_CUBE_MAP_FACE_ARB: */ static final int WGL_TEXTURE_CUBE_MAP_POSITIVE_X_ARB = 0x207D; static final int WGL_TEXTURE_CUBE_MAP_NEGATIVE_X_ARB = 0x207E; static final int WGL_TEXTURE_CUBE_MAP_POSITIVE_Y_ARB = 0x207F; static final int WGL_TEXTURE_CUBE_MAP_NEGATIVE_Y_ARB = 0x2080; static final int WGL_TEXTURE_CUBE_MAP_POSITIVE_Z_ARB = 0x2081; static final int WGL_TEXTURE_CUBE_MAP_NEGATIVE_Z_ARB = 0x2082; /* Accepted by the <iBuffer> parameter of wglBindTexImageARB and wglReleaseTexImageARB: */ static final int WGL_FRONT_LEFT_ARB = 0x2083; static final int WGL_FRONT_RIGHT_ARB = 0x2084; static final int WGL_BACK_LEFT_ARB = 0x2085; static final int WGL_BACK_RIGHT_ARB = 0x2086; /* private static final int WGL_AUX0_ARB = 0x2087; private static final int WGL_AUX1_ARB = 0x2088; private static final int WGL_AUX2_ARB = 0x2089; private static final int WGL_AUX3_ARB = 0x208A; private static final int WGL_AUX4_ARB = 0x208B; private static final int WGL_AUX5_ARB = 0x208C; private static final int WGL_AUX6_ARB = 0x208D; private static final int WGL_AUX7_ARB = 0x208E; private static final int WGL_AUX8_ARB = 0x208F; private static final int WGL_AUX9_ARB = 0x2090; */ // ------------------------------------------------------------------------------------------- // ----------------------------- WGL_NV_render_texture_rectangle ----------------------------- // ------------------------------------------------------------------------------------------- /* Accepted by the <piAttributes> parameter of wglGetPixelFormatAttribivARB, wglGetPixelFormatAttribfvARB, and the <piAttribIList> and <pfAttribIList> parameters of wglChoosePixelFormatARB: */ private static final int WGL_BIND_TO_TEXTURE_RECTANGLE_RGB_NV = 0x20A0; private static final int WGL_BIND_TO_TEXTURE_RECTANGLE_RGBA_NV = 0x20A1; /* Accepted as a value in the <piAttribList> parameter of wglCreatePbufferARB and returned in the value parameter of wglQueryPbufferARB when <iAttribute> is WGL_TEXTURE_TARGET_ARB: */ private static final int WGL_TEXTURE_RECTANGLE_NV = 0x20A2; // --------------------------------------------------------------------------------------- // ----------------------------- WGL_NV_render_depth_texture ----------------------------- // --------------------------------------------------------------------------------------- /* Accepted by the <piAttributes> parameter of wglGetPixelFormatAttribivARB, wglGetPixelFormatAttribfvARB, and the <piAttribIList> and <pfAttribIList> parameters of wglChoosePixelFormatARB: */ private static final int WGL_BIND_TO_TEXTURE_DEPTH_NV = 0x20A3; private static final int WGL_BIND_TO_TEXTURE_RECTANGLE_DEPTH_NV = 0x20A4; /* Accepted by the <piAttribList> parameter of wglCreatePbufferARB and by the <iAttribute> parameter of wglQueryPbufferARB: */ private static final int WGL_DEPTH_TEXTURE_FORMAT_NV = 0x20A5; /* Accepted as a value in the <piAttribList> parameter of wglCreatePbufferARB and returned in the value parameter of wglQueryPbufferARB when <iAttribute> is WGL_DEPTH_TEXTURE_FORMAT_NV: */ private static final int WGL_TEXTURE_DEPTH_COMPONENT_NV = 0x20A6; /* Accepted by the <iBuffer> parameter of wglBindTexImageARB: */ static final int WGL_DEPTH_COMPONENT_NV = 0x20A7; /** * The TEXTURE_1D target. */ public static final int RENDER_TEXTURE_1D = WGL_TEXTURE_1D_ARB; /** * The TEXTURE_2D target. */ public static final int RENDER_TEXTURE_2D = WGL_TEXTURE_2D_ARB; /** * The TEXTURE_RECTANGLE target. */ public static final int RENDER_TEXTURE_RECTANGLE = WGL_TEXTURE_RECTANGLE_NV; /** * The TEXTURE_CUBE_MAP target. */ public static final int RENDER_TEXTURE_CUBE_MAP = WGL_TEXTURE_CUBE_MAP_ARB; IntBuffer pixelFormatCaps; IntBuffer pBufferAttribs; /** * Creates a RenderTexture object for enabling render-to-texture on a P-buffer. * <p/> * NOTE: Only one of useRGB and useRGBA can be true at the same time. * <p/> * NOTE: useRGB(A) and useDepth can be true at the same time, thus allowing two different render textures. * <p/> * NOTE: The target parameter can be one of the following: * <p/> * RENDER_TEXTURE_1D * RENDER_TEXTURE_2D * RENDER_TEXTURE_RECTANGLE * RENDER_TEXTURE_CUBE_MAP * * @param useRGB - When true the P-buffer can be used as an RGB render texture. * @param useRGBA - When true the P-buffer can be used as an RGBA render texture. * @param useDepth - When true the P-buffer can be used as a depth render texture. * @param isRectangle - When true rectangle textures will be allowed on the P-buffer. * @param target - The texture target of the render texture. * @param mipmaps - How many mipmap levels to allocate on the P-buffer. */ public RenderTexture(boolean useRGB, boolean useRGBA, boolean useDepth, boolean isRectangle, int target, int mipmaps) { if ( useRGB && useRGBA ) throw new IllegalArgumentException("A RenderTexture can't be both RGB and RGBA."); if ( mipmaps < 0 ) throw new IllegalArgumentException("The mipmap levels can't be negative."); if ( isRectangle && target != RENDER_TEXTURE_RECTANGLE ) throw new IllegalArgumentException("When the RenderTexture is rectangle the target must be RENDER_TEXTURE_RECTANGLE."); pixelFormatCaps = BufferUtils.createIntBuffer(4); pBufferAttribs = BufferUtils.createIntBuffer(8); if ( useRGB ) { pixelFormatCaps.put(isRectangle ? WGL_BIND_TO_TEXTURE_RECTANGLE_RGB_NV : WGL_BIND_TO_TEXTURE_RGB_ARB); pixelFormatCaps.put(GL11.GL_TRUE); pBufferAttribs.put(WGL_TEXTURE_FORMAT_ARB); pBufferAttribs.put(WGL_TEXTURE_RGB_ARB); } else if ( useRGBA ) { pixelFormatCaps.put(isRectangle ? WGL_BIND_TO_TEXTURE_RECTANGLE_RGBA_NV : WGL_BIND_TO_TEXTURE_RGBA_ARB); pixelFormatCaps.put(GL11.GL_TRUE); pBufferAttribs.put(WGL_TEXTURE_FORMAT_ARB); pBufferAttribs.put(WGL_TEXTURE_RGBA_ARB); } if ( useDepth ) { pixelFormatCaps.put(isRectangle ? WGL_BIND_TO_TEXTURE_RECTANGLE_DEPTH_NV : WGL_BIND_TO_TEXTURE_DEPTH_NV); pixelFormatCaps.put(GL11.GL_TRUE); pBufferAttribs.put(WGL_DEPTH_TEXTURE_FORMAT_NV); pBufferAttribs.put(WGL_TEXTURE_DEPTH_COMPONENT_NV); } pBufferAttribs.put(WGL_TEXTURE_TARGET_ARB); pBufferAttribs.put(target); if ( mipmaps != 0 ) { pBufferAttribs.put(WGL_MIPMAP_TEXTURE_ARB); pBufferAttribs.put(mipmaps); } pixelFormatCaps.flip(); pBufferAttribs.flip(); } } Index: Pbuffer.java =================================================================== RCS file: /cvsroot/java-game-lib/LWJGL/src/java/org/lwjgl/opengl/Pbuffer.java,v retrieving revision 1.10 retrieving revision 1.11 diff -u -d -r1.10 -r1.11 --- Pbuffer.java 23 Feb 2004 16:30:47 -0000 1.10 +++ Pbuffer.java 2 Mar 2004 01:57:03 -0000 1.11 @@ -34,33 +34,124 @@ import org.lwjgl.Sys; +import java.nio.IntBuffer; + /** * $Id$ - * + * <p/> * Pbuffer encapsulates an OpenGL pbuffer. - * - * Each instance of GL is only valid in the thread that creates it. - * In addition, only one instance of an OpenGL window or Pbuffer may be - * the current GL context in any one thread. To make a GL instance the - * current context, use makeCurrent(). + * <p/> + * Each instance of GL is only valid in the thread that creates it. In addition, only one instance of an OpenGL window or + * Pbuffer may be the current GL context in any one thread. To make a GL instance the current context, use makeCurrent(). * * @author elias_naur <eli...@us...> * @version $Revision$ */ public final class Pbuffer { - - public static final int PBUFFER_SUPPORTED = 1; - /** Current Pbuffer */ - private static Pbuffer currentBuffer = null; + /** + * Indicates that Pbuffers can be created. + */ + public static final int PBUFFER_SUPPORTED = 1 << 0; - /** Handle to the native GL rendering context */ + /** + * Indicates that Pbuffers can be used as render-textures. + */ + public static final int RENDER_TEXTURE_SUPPORTED = 1 << 1; + + /** + * Indicates that Pbuffers can be used as non-power-of-two render-textures. + */ + public static final int RENDER_TEXTURE_RECTANGLE_SUPPORTED = 1 << 2; + + /** + * Indicates that Pbuffers can be used as depth render-textures. + */ + public static final int RENDER_DEPTH_TEXTURE_SUPPORTED = 1 << 3; + + /** + * The render-to-texture mipmap level attribute. + */ + public static final int MIPMAP_LEVEL = RenderTexture.WGL_MIPMAP_LEVEL_ARB; + + /** + * The render-to-texture cube map face attribute. + */ + public static final int CUBE_MAP_FACE = RenderTexture.WGL_CUBE_MAP_FACE_ARB; + + /** + * The render-to-texture cube map positive X face value. + */ + public static final int TEXTURE_CUBE_MAP_POSITIVE_X = RenderTexture.WGL_TEXTURE_CUBE_MAP_POSITIVE_X_ARB; + + /** + * The render-to-texture cube map negative X face value. + */ + public static final int TEXTURE_CUBE_MAP_NEGATIVE_X = RenderTexture.WGL_TEXTURE_CUBE_MAP_NEGATIVE_X_ARB; + + /** + * The render-to-texture cube map positive Y face value. + */ + public static final int TEXTURE_CUBE_MAP_POSITIVE_Y = RenderTexture.WGL_TEXTURE_CUBE_MAP_POSITIVE_Y_ARB; + + /** + * The render-to-texture cube map negative Y face value. + */ + public static final int TEXTURE_CUBE_MAP_NEGATIVE_Y = RenderTexture.WGL_TEXTURE_CUBE_MAP_NEGATIVE_Y_ARB; + + /** + * The render-to-texture cube map positive Z face value. + */ + public static final int TEXTURE_CUBE_MAP_POSITIVE_Z = RenderTexture.WGL_TEXTURE_CUBE_MAP_POSITIVE_Z_ARB; + + /** + * The render-to-texture cube map negative Z face value. + */ + public static final int TEXTURE_CUBE_MAP_NEGATIVE_Z = RenderTexture.WGL_TEXTURE_CUBE_MAP_NEGATIVE_Z_ARB; + + /** + * The Pbuffer front left buffer. + */ + public static final int FRONT_LEFT_BUFFER = RenderTexture.WGL_FRONT_LEFT_ARB; + + /** + * The Pbuffer front right buffer. + */ + public static final int FRONT_RIGHT_BUFFER = RenderTexture.WGL_FRONT_RIGHT_ARB; + + /** + * The Pbuffer back left buffer. + */ + public static final int BACK_LEFT_BUFFER = RenderTexture.WGL_BACK_LEFT_ARB; + + /** + * The Pbuffer back right buffer. + */ + public static final int BACK_RIGHT_BUFFER = RenderTexture.WGL_BACK_RIGHT_ARB; + + /** + * The Pbuffer depth buffer. + */ + public static final int DEPTH_BUFFER = RenderTexture.WGL_DEPTH_COMPONENT_NV; + + /** + * Current Pbuffer + */ + private static Pbuffer currentBuffer; + + /** + * Handle to the native GL rendering context + */ private final int handle; - /** Width */ + /** + * Width + */ private final int width; - /** Height */ + /** + * Height + */ private final int height; static { @@ -68,37 +159,47 @@ } /** - * Construct an instance of a Pbuffer. If this fails then an Exception will be thrown. - * The buffer is single-buffered. - * - * NOTE: An OpenGL window must be created before a Pbuffer can be created. The Pbuffer will - * have its own context that shares display lists and textures with the OpenGL window context, - * but it will have its own OpenGL state. Therefore, state changes to a pbuffer will not be seen - * in the window context and vice versa. - * - * NOTE: Some OpenGL implementations requires the shared contexts to use the same pixel format. - * So if possible, use the same bpp, alpha, depth and stencil values used to create the main window. + * Construct an instance of a Pbuffer. If this fails then an Exception will be thrown. The buffer is single-buffered. + * <p/> + * NOTE: An OpenGL window must be created before a Pbuffer can be created. The Pbuffer will have its own context that shares + * display lists and textures with the OpenGL window context, but it will have its own OpenGL state. Therefore, state changes + * to a pbuffer will not be seen in the window context and vice versa. + * <p/> + * NOTE: Some OpenGL implementations requires the shared contexts to use the same pixel format. So if possible, use the same + * bpp, alpha, depth and stencil values used to create the main window. + * <p/> + * The renderTexture parameter defines the necessary state for enabling render-to-texture. When this parameter is null, + * render-to-texture is not available. Before using render-to-texture, the Pbuffer capabilities must be queried to ensure that + * it is supported. * - * @param width Pbuffer width - * @param height Pbuffer height - * @param bpp Minimum bits per pixel - * @param alpha Minimum bits per pixel in alpha buffer - * @param depth Minimum bits per pixel in depth buffer - * @param stencil Minimum bits per pixel in stencil buffer - * @param samples Minimum samples in multisample buffer (corresponds to GL_SAMPLES_ARB in GL_ARB_multisample spec). - Pass 0 to disable multisampling. This parameter is ignored if GL_ARB_multisample is not supported. + * @param width Pbuffer width + * @param height Pbuffer height + * @param bpp Minimum bits per pixel + * @param alpha Minimum bits per pixel in alpha buffer + * @param depth Minimum bits per pixel in depth buffer + * @param stencil Minimum bits per pixel in stencil buffer + * @param samples Minimum samples in multisample buffer (corresponds to GL_SAMPLES_ARB in GL_ARB_multisample spec). Pass + * 0 to disable multisampling. This parameter is ignored if GL_ARB_multisample is not supported. + * @param renderTexture */ - public Pbuffer(int width, int height, int bpp, int alpha, int depth, int stencil, int samples) throws Exception { + public Pbuffer(int width, int height, int bpp, int alpha, int depth, int stencil, int samples, RenderTexture renderTexture) throws Exception { this.width = width; this.height = height; - handle = nCreate(width, height, bpp, alpha, depth, stencil, samples); + + if ( renderTexture == null ) + handle = nCreate(width, height, bpp, alpha, depth, stencil, samples, null, 0, null, 0); + else + handle = nCreate(width, height, + bpp, alpha, depth, stencil, + samples, + renderTexture.pixelFormatCaps, renderTexture.pixelFormatCaps.limit(), + renderTexture.pBufferAttribs, renderTexture.pBufferAttribs.limit()); } /** - * Method to test for validity of the buffer. If this function returns true, - * the buffer contents is lost. The buffer can still be used, but the results are undefined. - * The application is expected to release the buffer if needed, destroy it and recreate a new - * buffer. + * Method to test for validity of the buffer. If this function returns true, the buffer contents is lost. The buffer can still + * be used, but the results are undefined. The application is expected to release the buffer if needed, destroy it and recreate + * a new buffer. * * @return true if the buffer is lost and destroyed, false if the buffer is valid. */ @@ -109,11 +210,10 @@ /** * Native method to test for buffer integrity */ - private native static boolean nIsBufferLost(int handle); + private static native boolean nIsBufferLost(int handle); /** - * Method to make the Pbuffer context current. All subsequent OpenGL - * calls will go to this buffer. + * Method to make the Pbuffer context current. All subsequent OpenGL calls will go to this buffer. */ public synchronized void makeCurrent() { currentBuffer = this; @@ -124,11 +224,10 @@ /** * Native method to make a pbuffer current. */ - private native static void nMakeCurrent(int handle); + private static native void nMakeCurrent(int handle); /** - * Gets the Pbuffer capabilities. Only the flag PBUFFER_SUPPORTED is - * available, and indicates that Pbuffers can be created. + * Gets the Pbuffer capabilities. * * @return a bitmask of Pbuffer capabilities. */ @@ -137,18 +236,15 @@ /** * Native method to create a Pbuffer */ - private native static int nCreate( - int width, - int height, - int bpp, - int alpha, - int depth, - int stencil, - int samples) throws Exception; + private static native int nCreate(int width, int height, + int bpp, int alpha, int depth, int stencil, + int samples, + IntBuffer pixelFormatCaps, int pixelFormatCapsSize, + IntBuffer pBufferAttribs, int pBufferAttribsSize) throws Exception; /** - * Destroys the Pbuffer. After this call, there will be no valid GL rendering context - - * regardless of whether this Pbuffer was the current rendering context or not. + * Destroys the Pbuffer. After this call, there will be no valid GL rendering context - regardless of whether this Pbuffer was + * the current rendering context or not. */ public synchronized void destroy() { makeCurrent(); @@ -159,21 +255,67 @@ /** * Natively destroy any GL-related stuff */ - private native static void nDestroy(int handle); - + private static native void nDestroy(int handle); + + // ----------------------------------------------------------------------------------------- + // ------------------------------- Render-to-Texture Methods ------------------------------- + // ----------------------------------------------------------------------------------------- + + /** + * Sets a render-to-texture attribute. + * <p/> + * The attrib parameter can be one of MIPMAP_LEVEL and CUBE_MAP_FACE. When the attrib parameter is CUBE_MAP_FACE then the value + * parameter can be on of the following: + * <p/> + * TEXTURE_CUBE_MAP_POSITIVE_X TEXTURE_CUBE_MAP_NEGATIVE_X TEXTURE_CUBE_MAP_POSITIVE_Y TEXTURE_CUBE_MAP_NEGATIVE_Y + * TEXTURE_CUBE_MAP_POSITIVE_Z TEXTURE_CUBE_MAP_NEGATIVE_Z + * + * @param attrib + * @param value + */ + public synchronized void setAttrib(int attrib, int value) { + nSetAttrib(handle, attrib, value); + } + + private static native void nSetAttrib(int handle, int attrib, int value); + + /** + * Binds the currently bound texture to the buffer specified. The buffer can be one of the following: + * <p/> + * FRONT_LEFT_BUFFER FRONT_RIGHT_BUFFER BACK_LEFT_BUFFER BACK_RIGHT_BUFFER DEPTH_BUFFER + * + * @param buffer + */ + public synchronized void bindTexImage(int buffer) { + nBindTexImage(handle, buffer); + } + + private static native void nBindTexImage(int handle, int buffer); + + /** + * Releases the currently bound texture from the buffer specified. + * + * @param buffer + */ + public synchronized void releaseTexImage(int buffer) { + nReleaseTexImage(handle, buffer); + } + + private static native void nReleaseTexImage(int handle, int buffer); + /** * @return Returns the height. */ public int getHeight() { return height; } - + /** * @return Returns the width. */ public int getWidth() { return width; } - - + + } |
