/* * Copyright (C) 2012 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.webview.chromium; import android.view.DisplayList; import android.view.HardwareCanvas; import android.view.ViewRootImpl; import android.util.Log; import org.chromium.content.common.CleanupReference; // Simple Java abstraction and wrapper for the native DrawGLFunctor flow. // An instance of this class can be constructed, bound to a single view context (i.e. AwContennts) // and then drawn and detached from the view tree any number of times (using requestDrawGL and // detach respectively). Then when finished with, it can be explicitly released by calling // destroy() or will clean itself up as required via finalizer / CleanupReference. class DrawGLFunctor { private static final String TAG = DrawGLFunctor.class.getSimpleName(); // Pointer to native side instance private CleanupReference mCleanupReference; private DestroyRunnable mDestroyRunnable; public DrawGLFunctor(int viewContext) { mDestroyRunnable = new DestroyRunnable(nativeCreateGLFunctor(viewContext)); mCleanupReference = new CleanupReference(this, mDestroyRunnable); } public void destroy() { if (mCleanupReference != null) { mCleanupReference.cleanupNow(); mCleanupReference = null; mDestroyRunnable = null; } } public void detach() { mDestroyRunnable.detachNativeFunctor(); } public boolean requestDrawGL(HardwareCanvas canvas, ViewRootImpl viewRootImpl) { if (mDestroyRunnable.mNativeDrawGLFunctor == 0) { throw new RuntimeException("requested DrawGL on already destroyed DrawGLFunctor"); } mDestroyRunnable.mViewRootImpl = viewRootImpl; if (canvas != null) { int ret = canvas.callDrawGLFunction(mDestroyRunnable.mNativeDrawGLFunctor); if (ret != DisplayList.STATUS_DONE) { Log.e(TAG, "callDrawGLFunction error: " + ret); return false; } } else { viewRootImpl.attachFunctor(mDestroyRunnable.mNativeDrawGLFunctor); } return true; } public static void setChromiumAwDrawGLFunction(int functionPointer) { nativeSetChromiumAwDrawGLFunction(functionPointer); } // Holds the core resources of the class, everything required to correctly cleanup. // IMPORTANT: this class must not hold any reference back to the outer DrawGLFunctor // instance, as that will defeat GC of that object. private static final class DestroyRunnable implements Runnable { ViewRootImpl mViewRootImpl; int mNativeDrawGLFunctor; DestroyRunnable(int nativeDrawGLFunctor) { mNativeDrawGLFunctor = nativeDrawGLFunctor; } // Called when the outer DrawGLFunctor instance has been GC'ed, i.e this is its finalizer. @Override public void run() { detachNativeFunctor(); nativeDestroyGLFunctor(mNativeDrawGLFunctor); mNativeDrawGLFunctor = 0; } void detachNativeFunctor() { if (mNativeDrawGLFunctor != 0 && mViewRootImpl != null) { mViewRootImpl.detachFunctor(mNativeDrawGLFunctor); } mViewRootImpl = null; } } private static native int nativeCreateGLFunctor(int viewContext); private static native void nativeDestroyGLFunctor(int functor); private static native void nativeSetChromiumAwDrawGLFunction(int functionPointer); }