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 |