1 // Copyright 2013 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef UI_GL_ANDROID_SURFACE_TEXTURE_H_
6 #define UI_GL_ANDROID_SURFACE_TEXTURE_H_
10 #include "base/android/scoped_java_ref.h"
11 #include "base/callback.h"
12 #include "base/memory/ref_counted.h"
13 #include "ui/gl/gl_export.h"
19 // This class serves as a bridge for native code to call java functions inside
20 // android SurfaceTexture class.
21 class GL_EXPORT SurfaceTexture
22 : public base::RefCountedThreadSafe
<SurfaceTexture
>{
24 static scoped_refptr
<SurfaceTexture
> Create(int texture_id
);
26 // Set the listener callback, which will be invoked on the same thread that
27 // is being called from here for registration.
28 // Note: Since callbacks come in from Java objects that might outlive objects
29 // being referenced from the callback, the only robust way here is to create
30 // the callback from a weak pointer to your object.
31 void SetFrameAvailableCallback(const base::Closure
& callback
);
33 // Update the texture image to the most recent frame from the image stream.
34 void UpdateTexImage();
36 // Retrieve the 4x4 texture coordinate transform matrix associated with the
37 // texture image set by the most recent call to updateTexImage.
38 void GetTransformMatrix(float mtx
[16]);
40 // Attach the SurfaceTexture to the texture currently bound to
41 // GL_TEXTURE_EXTERNAL_OES.
42 void AttachToGLContext();
44 // Detaches the SurfaceTexture from the context that owns its current GL
45 // texture. Must be called with that context current on the calling thread.
46 void DetachFromGLContext();
48 // Creates a native render surface for this surface texture.
49 // The caller must release the underlying reference when done with the handle
50 // by calling ANativeWindow_release().
51 ANativeWindow
* CreateSurface();
53 const base::android::JavaRef
<jobject
>& j_surface_texture() const {
54 return j_surface_texture_
;
57 static bool RegisterSurfaceTexture(JNIEnv
* env
);
60 explicit SurfaceTexture(
61 const base::android::ScopedJavaLocalRef
<jobject
>& j_surface_texture
);
64 friend class base::RefCountedThreadSafe
<SurfaceTexture
>;
67 // Java SurfaceTexture instance.
68 base::android::ScopedJavaGlobalRef
<jobject
> j_surface_texture_
;
70 DISALLOW_COPY_AND_ASSIGN(SurfaceTexture
);
75 #endif // UI_GL_ANDROID_SURFACE_TEXTURE_H_