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