| 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_GPU_MEMORY_BUFFER_H_ | 5 #ifndef GPU_COMMAND_BUFFER_CLIENT_GPU_MEMORY_BUFFER_H_ |
| 6 #define UI_GL_GPU_MEMORY_BUFFER_H_ | 6 #define GPU_COMMAND_BUFFER_CLIENT_GPU_MEMORY_BUFFER_H_ |
| 7 | 7 |
| 8 #include "base/basictypes.h" | 8 #include "base/basictypes.h" |
| 9 #include "base/callback.h" | 9 #include "base/callback.h" |
| 10 #include "base/memory/scoped_ptr.h" | 10 #include "base/memory/scoped_ptr.h" |
| 11 | 11 |
| 12 namespace gfx { | 12 namespace gfx { |
| 13 class Size; | 13 class Size; |
| 14 } |
| 15 |
| 16 namespace gpu { |
| 14 | 17 |
| 15 // Interface for creating and accessing a zero-copy GPU memory buffer. | 18 // Interface for creating and accessing a zero-copy GPU memory buffer. |
| 16 // This design evolved from the generalization of GraphicBuffer API | 19 // This design evolved from the generalization of GraphicBuffer API |
| 17 // of Android framework. | 20 // of Android framework. |
| 18 // | 21 // |
| 19 // THREADING CONSIDERATIONS: | 22 // THREADING CONSIDERATIONS: |
| 20 // | 23 // |
| 21 // This interface is thread-safe. However, multiple threads mapping | 24 // This interface is thread-safe. However, multiple threads mapping |
| 22 // a buffer for Write or ReadOrWrite simultaneously may result in undefined | 25 // a buffer for Write or ReadOrWrite simultaneously may result in undefined |
| 23 // behavior and is not allowed. | 26 // behavior and is not allowed. |
| 24 class GpuMemoryBuffer { | 27 class GpuMemoryBuffer { |
| 25 public: | 28 public: |
| 26 typedef base::Callback<scoped_ptr<gfx::GpuMemoryBuffer>(gfx::Size)> Creator; | 29 typedef base::Callback<scoped_ptr<GpuMemoryBuffer>(gfx::Size)> Creator; |
| 27 enum AccessMode { | 30 enum AccessMode { |
| 28 READ_ONLY, | 31 READ_ONLY, |
| 29 WRITE_ONLY, | 32 WRITE_ONLY, |
| 30 READ_OR_WRITE, | 33 READ_OR_WRITE, |
| 31 }; | 34 }; |
| 32 | 35 |
| 33 // Frees a previously allocated buffer. Freeing a buffer that is still | 36 // Frees a previously allocated buffer. Freeing a buffer that is still |
| 34 // mapped in any process is undefined behavior. | 37 // mapped in any process is undefined behavior. |
| 35 virtual ~GpuMemoryBuffer() {} | 38 virtual ~GpuMemoryBuffer() {} |
| 36 | 39 |
| 37 // Maps the buffer so the client can write the bitmap data in |*vaddr| | 40 // Maps the buffer so the client can write the bitmap data in |*vaddr| |
| 38 // subsequently. This call may block, for instance if the hardware needs | 41 // subsequently. This call may block, for instance if the hardware needs |
| 39 // to finish rendering or if CPU caches need to be synchronized. | 42 // to finish rendering or if CPU caches need to be synchronized. |
| 40 virtual void Map(AccessMode mode, void** vaddr) = 0; | 43 virtual void Map(AccessMode mode, void** vaddr) = 0; |
| 41 | 44 |
| 42 // Unmaps the buffer. Called after all changes to the buffer are | 45 // Unmaps the buffer. Called after all changes to the buffer are |
| 43 // completed. | 46 // completed. |
| 44 virtual void Unmap() = 0; | 47 virtual void Unmap() = 0; |
| 45 | 48 |
| 46 // Returns the native pointer for the buffer. | 49 // Returns the native pointer for the buffer. |
| 47 virtual void* GetNativeBuffer() = 0; | 50 virtual void* GetNativeBuffer() = 0; |
| 48 | 51 |
| 49 // Returns the stride in pixels for the buffer. | 52 // Returns the stride in pixels for the buffer. |
| 50 virtual uint32 GetStride() = 0; | 53 virtual uint32 GetStride() = 0; |
| 51 }; | 54 }; |
| 52 | 55 |
| 53 } // namespace gfx | 56 } // namespace gpu |
| 54 | 57 |
| 55 #endif // UI_GL_GPU_MEMORY_BUFFER_H_ | 58 #endif // GPU_COMMAND_BUFFER_CLIENT_GPU_MEMORY_BUFFER_H_ |
| OLD | NEW |