Index: ui/gl/pixel_buffer.h |
diff --git a/ui/gl/pixel_buffer.h b/ui/gl/pixel_buffer.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..6b767aeae996fe00c73439320226719b96522652 |
--- /dev/null |
+++ b/ui/gl/pixel_buffer.h |
@@ -0,0 +1,50 @@ |
+// Copyright 2013 The Chromium Authors. All rights reserved. |
+// Use of this source code is governed by a BSD-style license that can be |
+// found in the LICENSE file. |
+ |
+#ifndef UI_GL_PIXEL_BUFFER_H_ |
+#define UI_GL_PIXEL_BUFFER_H_ |
+ |
+#include "base/basictypes.h" |
+#include "base/callback.h" |
+#include "base/memory/scoped_ptr.h" |
+ |
+namespace gfx { |
+class Size; |
+ |
+// Interface for creating and accessing a zero-copy pixel buffer. |
+// This design evolved from the generalization of GraphicBuffer API |
+// of Android framework. |
+// |
+// THREADING CONSIDERATIONS: |
+// |
+// This interface is thread-safe. However, multiple threads calling |
+// MapForWrite() simultaneously may result in undefined behavior |
+// and is not allowed. |
+class PixelBuffer { |
+ public: |
+ typedef base::Callback<scoped_ptr<gfx::PixelBuffer>(gfx::Size)> Create; |
+ |
+ // Frees a previously allocated buffer. Greeing a buffer that is still |
joth
2013/04/04 22:41:46
type: Freeing
kaanb
2013/04/04 22:58:44
Done.
|
+ // mapped in any process is undefined behavior. |
+ virtual ~PixelBuffer() {} |
+ |
+ // Maps the buffer so the client can write the bitmap data in |*vaddr| |
+ // subsequently. This call may block, for instance if the hardware needs |
+ // to finish rendering or if CPU caches need to be synchronized. |
+ virtual void MapForWrite(void** vaddr) = 0; |
+ |
+ // Unmaps the buffer. Called after all changes to the buffer are |
+ // completed. |
+ virtual void Unmap() = 0; |
+ |
+ // Returns the native pointer for the pixel buffer. |
+ virtual void* GetNativeBuffer() = 0; |
+ |
+ // Returns the stride in pixels for the pixel buffer. |
+ virtual uint32 GetStride() = 0; |
+}; |
+ |
+} // namespace gfx |
+ |
+#endif // UI_GL_PIXEL_BUFFER_H_ |