Chromium Code Reviews| 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_ |