OLD | NEW |
| (Empty) |
1 | |
2 /* | |
3 * Copyright 2014 Google Inc. | |
4 * | |
5 * Use of this source code is governed by a BSD-style license that can be | |
6 * found in the LICENSE file. | |
7 */ | |
8 | |
9 #ifndef GrGLNameAllocator_DEFINED | |
10 #define GrGLNameAllocator_DEFINED | |
11 | |
12 #include "SkRefCnt.h" | |
13 #include "gl/GrGLTypes.h" | |
14 | |
15 /** | |
16 * This class assumes ownership of an explicit range of OpenGL object names and | |
17 * manages allocations within that range. This allows the app to generate new | |
18 * objects on the client side without making round trips to the GL server. | |
19 */ | |
20 class GrGLNameAllocator { | |
21 public: | |
22 /** | |
23 * Constructs a name allocator that produces names within the explicit | |
24 * half-open range [firstName, end). Note that the caller will most likely | |
25 * need to call glGen* beforehand to reserve a range within the GL driver, | |
26 * and then invoke this constructor with that range. | |
27 * | |
28 * @param firstName The first name in the range owned by this class. Must be | |
29 greater than zero. | |
30 * @param endName The first past-the-end name beyond the range owned by | |
31 this class. Must be >= firstName. | |
32 */ | |
33 GrGLNameAllocator(GrGLuint firstName, GrGLuint endName); | |
34 | |
35 /** | |
36 * Destructs the name allocator. The caller is responsible for calling the | |
37 * appropriate glDelete* on the range if necessary. | |
38 */ | |
39 ~GrGLNameAllocator(); | |
40 | |
41 /** | |
42 * Return the beginning of this class's range. | |
43 * | |
44 * @return The first name in the range owned by this class. | |
45 */ | |
46 GrGLuint firstName() const { return fFirstName; } | |
47 | |
48 /** | |
49 * Return the end of this class's range. Note that endName() is not owned by | |
50 * this class. | |
51 * | |
52 * @return One plus the final name in the range owned by this class. | |
53 */ | |
54 GrGLuint endName() const { return fEndName; } | |
55 | |
56 /** | |
57 * Allocate an OpenGL object name from within this class's range. | |
58 * | |
59 * @return The name if one was available, | |
60 0 if all the names in the range were already in use. | |
61 */ | |
62 GrGLuint allocateName(); | |
63 | |
64 /** | |
65 * Free an OpenGL object name, allowing it to be returned by a future call | |
66 * to allocateName(). Note that the caller should most likely redefine the | |
67 * object as empty to deallocate any underlying GPU memory before calling | |
68 * this method (but not call glDelete*, since that would free up the name | |
69 * within the driver itself). | |
70 * | |
71 * @param name The object name to free. Not-allocated names are silently | |
72 * ignored the same way they are in the OpenGL spec. | |
73 */ | |
74 void free(GrGLuint name); | |
75 | |
76 private: | |
77 class SparseNameRange; | |
78 class SparseNameTree; | |
79 class ContiguousNameRange; | |
80 | |
81 const GrGLuint fFirstName; | |
82 const GrGLuint fEndName; | |
83 SkAutoTUnref<SparseNameRange> fAllocatedNames; | |
84 }; | |
85 | |
86 #endif | |
OLD | NEW |