OLD | NEW |
1 // Copyright 2013 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef UI_GL_ANDROID_SURFACE_TEXTURE_H_ | 5 #ifndef UI_GL_ANDROID_SURFACE_TEXTURE_H_ |
6 #define UI_GL_ANDROID_SURFACE_TEXTURE_H_ | 6 #define UI_GL_ANDROID_SURFACE_TEXTURE_H_ |
7 | 7 |
8 #include <jni.h> | 8 #include <jni.h> |
9 | 9 |
10 #include "base/android/scoped_java_ref.h" | 10 #include "base/android/scoped_java_ref.h" |
11 #include "base/callback.h" | 11 #include "base/callback.h" |
12 #include "base/memory/ref_counted.h" | 12 #include "base/memory/ref_counted.h" |
13 #include "ui/gl/gl_export.h" | 13 #include "ui/gl/gl_export.h" |
14 | 14 |
15 struct ANativeWindow; | 15 struct ANativeWindow; |
16 | 16 |
17 namespace gfx { | 17 namespace gfx { |
18 | 18 |
19 // This class serves as a bridge for native code to call java functions inside | 19 // This class serves as a bridge for native code to call java functions inside |
20 // android SurfaceTexture class. | 20 // android SurfaceTexture class. |
21 class GL_EXPORT SurfaceTexture | 21 class GL_EXPORT SurfaceTexture |
22 : public base::RefCountedThreadSafe<SurfaceTexture>{ | 22 : public base::RefCountedThreadSafe<SurfaceTexture>{ |
23 public: | 23 public: |
24 explicit SurfaceTexture(int texture_id); | 24 static scoped_refptr<SurfaceTexture> Create(int texture_id); |
| 25 |
| 26 static scoped_refptr<SurfaceTexture> CreateSingleBuffered(int texture_id); |
25 | 27 |
26 // Set the listener callback, which will be invoked on the same thread that | 28 // Set the listener callback, which will be invoked on the same thread that |
27 // is being called from here for registration. | 29 // is being called from here for registration. |
28 // Note: Since callbacks come in from Java objects that might outlive objects | 30 // 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 | 31 // being referenced from the callback, the only robust way here is to create |
30 // the callback from a weak pointer to your object. | 32 // the callback from a weak pointer to your object. |
31 void SetFrameAvailableCallback(const base::Closure& callback); | 33 void SetFrameAvailableCallback(const base::Closure& callback); |
32 | 34 |
33 // Update the texture image to the most recent frame from the image stream. | 35 // Update the texture image to the most recent frame from the image stream. |
34 void UpdateTexImage(); | 36 void UpdateTexImage(); |
35 | 37 |
| 38 // Release the texture content. This is needed only in single buffered mode |
| 39 // to allow the image content producer to take ownership |
| 40 // of the image buffer. |
| 41 // This is *only* supported on SurfaceTexture instantiated via |
| 42 // |CreateSingleBuffered(...)|. |
| 43 void ReleaseTexImage(); |
| 44 |
36 // Retrieve the 4x4 texture coordinate transform matrix associated with the | 45 // Retrieve the 4x4 texture coordinate transform matrix associated with the |
37 // texture image set by the most recent call to updateTexImage. | 46 // texture image set by the most recent call to updateTexImage. |
38 void GetTransformMatrix(float mtx[16]); | 47 void GetTransformMatrix(float mtx[16]); |
39 | 48 |
40 // Set the default size of the image buffers. | 49 // Set the default size of the image buffers. |
41 void SetDefaultBufferSize(int width, int height); | 50 void SetDefaultBufferSize(int width, int height); |
42 | 51 |
43 // Attach the SurfaceTexture to the texture currently bound to | 52 // Attach the SurfaceTexture to the texture currently bound to |
44 // GL_TEXTURE_EXTERNAL_OES. | 53 // GL_TEXTURE_EXTERNAL_OES. |
45 void AttachToGLContext(); | 54 void AttachToGLContext(); |
46 | 55 |
47 // Detaches the SurfaceTexture from the context that owns its current GL | 56 // Detaches the SurfaceTexture from the context that owns its current GL |
48 // texture. Must be called with that context current on the calling thread. | 57 // texture. Must be called with that context current on the calling thread. |
49 void DetachFromGLContext(); | 58 void DetachFromGLContext(); |
50 | 59 |
51 // Creates a native render surface for this surface texture. | 60 // Creates a native render surface for this surface texture. |
52 // The caller must release the underlying reference when done with the handle | 61 // The caller must release the underlying reference when done with the handle |
53 // by calling ANativeWindow_release(). | 62 // by calling ANativeWindow_release(). |
54 ANativeWindow* CreateSurface(); | 63 ANativeWindow* CreateSurface(); |
55 | 64 |
56 const base::android::JavaRef<jobject>& j_surface_texture() const { | 65 const base::android::JavaRef<jobject>& j_surface_texture() const { |
57 return j_surface_texture_; | 66 return j_surface_texture_; |
58 } | 67 } |
59 | 68 |
| 69 // This should only be used to guard the SurfaceTexture instantiated via |
| 70 // |CreateSingleBuffered(...)| |
| 71 static bool IsSingleBufferModeSupported(); |
| 72 |
60 static bool RegisterSurfaceTexture(JNIEnv* env); | 73 static bool RegisterSurfaceTexture(JNIEnv* env); |
61 | 74 |
| 75 protected: |
| 76 explicit SurfaceTexture( |
| 77 const base::android::ScopedJavaLocalRef<jobject>& j_surface_texture); |
| 78 |
62 private: | 79 private: |
63 friend class base::RefCountedThreadSafe<SurfaceTexture>; | 80 friend class base::RefCountedThreadSafe<SurfaceTexture>; |
64 ~SurfaceTexture(); | 81 ~SurfaceTexture(); |
65 | 82 |
66 // Java SurfaceTexture instance. | 83 // Java SurfaceTexture instance. |
67 base::android::ScopedJavaGlobalRef<jobject> j_surface_texture_; | 84 base::android::ScopedJavaGlobalRef<jobject> j_surface_texture_; |
68 | 85 |
69 DISALLOW_COPY_AND_ASSIGN(SurfaceTexture); | 86 DISALLOW_COPY_AND_ASSIGN(SurfaceTexture); |
70 }; | 87 }; |
71 | 88 |
72 } // namespace gfx | 89 } // namespace gfx |
73 | 90 |
74 #endif // UI_GL_ANDROID_SURFACE_TEXTURE_H_ | 91 #endif // UI_GL_ANDROID_SURFACE_TEXTURE_H_ |
OLD | NEW |