/* * Copyright (c) 2004, 2008, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation.  Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package sun.java2d.opengl; import sun.java2d.pipe.BufferedContext;import sun.java2d.pipe.RenderBuffer;import sun.java2d.pipe.RenderQueue;import sun.java2d.pipe.hw.ContextCapabilities;import static sun.java2d.pipe.BufferedOpCodes.*;import static sun.java2d.pipe.hw.ContextCapabilities.*; /** * Note that the RenderQueue lock must be acquired before calling any of * the methods in this class. */public class OGLContext extends BufferedContext {     private final OGLGraphicsConfig config;     OGLContext(RenderQueue rq, OGLGraphicsConfig config) {        super(rq);        this.config = config;    }     /**     * Convenience method that delegates to setScratchSurface() below.     */    static void setScratchSurface(OGLGraphicsConfig gc) {        setScratchSurface(gc.getNativeConfigInfo());    }     /**     * Makes the given GraphicsConfig's context current to its associated     * "scratch surface".  Each GraphicsConfig maintains a native context     * (GLXContext on Unix, HGLRC on Windows) as well as a native pbuffer     * known as the "scratch surface".  By making the context current to the     * scratch surface, we are assured that we have a current context for     * the relevant GraphicsConfig, and can therefore perform operations     * depending on the capabilities of that GraphicsConfig.  For example,     * if the GraphicsConfig supports the GL_ARB_texture_non_power_of_two     * extension, then we should be able to make a non-pow2 texture for this     * GraphicsConfig once we make the context current to the scratch surface.     *     * This method should be used for operations with an OpenGL texture     * as the destination surface (e.g. a sw->texture blit loop), or in those     * situations where we may not otherwise have a current context (e.g.     * when disposing a texture-based surface).     */    static void setScratchSurface(long pConfigInfo) {        // assert OGLRenderQueue.getInstance().lock.isHeldByCurrentThread();         // invalidate the current context        currentContext = null;         // set the scratch context        OGLRenderQueue rq = OGLRenderQueue.getInstance();        RenderBuffer buf = rq.getBuffer();        rq.ensureCapacityAndAlignment(12, 4);        buf.putInt(SET_SCRATCH_SURFACE);        buf.putLong(pConfigInfo);    }     /**     * Invalidates the currentContext field to ensure that we properly     * revalidate the OGLContext (make it current, etc.) next time through     * the validate() method.  This is typically invoked from methods     * that affect the current context state (e.g. disposing a context or     * surface).     */    static void invalidateCurrentContext() {        // assert OGLRenderQueue.getInstance().lock.isHeldByCurrentThread();         // invalidate the current Java-level context so that we        // revalidate everything the next time around        if (currentContext != null) {            currentContext.invalidateContext();            currentContext = null;        }         // invalidate the context reference at the native level, and        // then flush the queue so that we have no pending operations        // dependent on the current context        OGLRenderQueue rq = OGLRenderQueue.getInstance();        rq.ensureCapacity(4);        rq.getBuffer().putInt(INVALIDATE_CONTEXT);        rq.flushNow();    }     public RenderQueue getRenderQueue() {        return OGLRenderQueue.getInstance();    }     /**     * Returns a string representing adapter id (vendor, renderer, version).     * Must be called on the rendering thread.     *     * @return an id string for the adapter     */    static final native String getOGLIdString();     @Override    public void saveState() {        // assert rq.lock.isHeldByCurrentThread();         // reset all attributes of this and current contexts        invalidateContext();        invalidateCurrentContext();         setScratchSurface(config);         // save the state on the native level        rq.ensureCapacity(4);        buf.putInt(SAVE_STATE);        rq.flushNow();    }     @Override    public void restoreState() {        // assert rq.lock.isHeldByCurrentThread();         // reset all attributes of this and current contexts        invalidateContext();        invalidateCurrentContext();         setScratchSurface(config);         // restore the state on the native level        rq.ensureCapacity(4);        buf.putInt(RESTORE_STATE);        rq.flushNow();    }     static class OGLContextCaps extends ContextCapabilities {        /**         * Indicates the presence of the GL_EXT_framebuffer_object extension.         * This cap will only be set if the fbobject system property has been         * enabled and we are able to create an FBO with depth buffer.         */        static final int CAPS_EXT_FBOBJECT     =                (CAPS_RT_TEXTURE_ALPHA | CAPS_RT_TEXTURE_OPAQUE);        /** Indicates that the context supports a stored alpha channel. */        static final int CAPS_STORED_ALPHA     = CAPS_RT_PLAIN_ALPHA;        /** Indicates that the context is doublebuffered. */        static final int CAPS_DOUBLEBUFFERED   = (FIRST_PRIVATE_CAP << 0);        /**         * Indicates the presence of the GL_ARB_fragment_shader extension.         * This cap will only be set if the lcdshader system property has been         * enabled and the hardware supports the minimum number of texture units         */        static final int CAPS_EXT_LCD_SHADER   = (FIRST_PRIVATE_CAP << 1);        /**         * Indicates the presence of the GL_ARB_fragment_shader extension.         * This cap will only be set if the biopshader system property has been         * enabled and the hardware meets our minimum requirements.         */        static final int CAPS_EXT_BIOP_SHADER  = (FIRST_PRIVATE_CAP << 2);        /**         * Indicates the presence of the GL_ARB_fragment_shader extension.         * This cap will only be set if the gradshader system property has been         * enabled and the hardware meets our minimum requirements.         */        static final int CAPS_EXT_GRAD_SHADER  = (FIRST_PRIVATE_CAP << 3);        /** Indicates the presence of the GL_ARB_texture_rectangle extension. */        static final int CAPS_EXT_TEXRECT      = (FIRST_PRIVATE_CAP << 4);         OGLContextCaps(int caps, String adapterId) {            super(caps, adapterId);        }         @Override        public String toString() {            StringBuffer buf = new StringBuffer(super.toString());            if ((caps & CAPS_EXT_FBOBJECT) != 0) {                buf.append("CAPS_EXT_FBOBJECT|");            }            if ((caps & CAPS_STORED_ALPHA) != 0) {                buf.append("CAPS_STORED_ALPHA|");            }            if ((caps & CAPS_DOUBLEBUFFERED) != 0) {                buf.append("CAPS_DOUBLEBUFFERED|");            }            if ((caps & CAPS_EXT_LCD_SHADER) != 0) {                buf.append("CAPS_EXT_LCD_SHADER|");            }            if ((caps & CAPS_EXT_BIOP_SHADER) != 0) {                buf.append("CAPS_BIOP_SHADER|");            }            if ((caps & CAPS_EXT_GRAD_SHADER) != 0) {                buf.append("CAPS_EXT_GRAD_SHADER|");            }            if ((caps & CAPS_EXT_TEXRECT) != 0) {                buf.append("CAPS_EXT_TEXRECT|");            }            return buf.toString();        }    }}