1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
/*
* Copyright (C) 2009 Apple Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef THIRD_PARTY_BLINK_RENDERER_MODULES_WEBGL_WEBGL_OBJECT_H_
#define THIRD_PARTY_BLINK_RENDERER_MODULES_WEBGL_WEBGL_OBJECT_H_
#include "third_party/blink/renderer/platform/bindings/dom_wrapper_world.h"
#include "third_party/blink/renderer/platform/bindings/script_wrappable.h"
#include "third_party/blink/renderer/platform/heap/prefinalizer.h"
#include "third_party/khronos/GLES2/gl2.h"
namespace gpu::gles2 {
class GLES2Interface;
}
namespace blink {
class WebGLContextObjectSupport;
template <typename T>
GLuint ObjectOrZero(const T* object) {
return object ? object->Object() : 0;
}
template <typename T>
GLuint ObjectNonZero(const T* object) {
GLuint result = object->Object();
DCHECK(result);
return result;
}
class WebGLObject : public ScriptWrappable {
DEFINE_WRAPPERTYPEINFO();
// WebGLObjects are pre-finalized, and the WebGLRenderingContextBase
// is specifically not. This is done in order to allow WebGLObjects to
// refer back to their owning context in their destructor to delete their
// resources if they are GC'd before the context is.
USING_PRE_FINALIZER(WebGLObject, Dispose);
public:
WebGLObject(const WebGLObject&) = delete;
WebGLObject& operator=(const WebGLObject&) = delete;
// We can't call virtual functions like deleteObjectImpl in this class's
// destructor; doing so results in a pure virtual function call. Further,
// making this destructor non-virtual is complicated with respect to
// Oilpan tracing. Therefore this destructor is declared virtual, but is
// empty, and the code that would have gone into its body is called by
// subclasses via Dispose().
~WebGLObject() override;
WebGLContextObjectSupport* Context() const { return context_.Get(); }
// deleteObject may not always delete the OpenGL resource. For programs and
// shaders, deletion is delayed until they are no longer attached.
void DeleteObject(gpu::gles2::GLES2Interface*);
void OnAttached() { ++attachment_count_; }
void OnDetached(gpu::gles2::GLES2Interface*);
// This indicates whether the client side has already issued a delete call,
// not whether the OpenGL resource is deleted. Object()==0, or !HasObject(),
// indicates that the OpenGL resource has been deleted.
bool MarkedForDeletion() const { return marked_for_deletion_; }
// True if this object belongs to the group or context.
bool Validate(const WebGLContextObjectSupport*) const;
// A reference is returned so it can be made a pointer for glDelete* calls
const GLuint& Object() const { return object_; }
bool HasObject() const { return object_ != 0; }
virtual bool IsRenderbuffer() const { return false; }
virtual bool IsTexture() const { return false; }
void Trace(Visitor*) const override;
protected:
explicit WebGLObject(WebGLContextObjectSupport*);
// Must be called only once to set the GL object this JS wrapper wraps.
void SetObject(GLuint object);
// Used to remove the handle when an unowned object becomes unavailable.
void ResetUnownedObject();
// DeleteObjectImpl is called exactly once to delete the OpenGL resource.
virtual void DeleteObjectImpl(gpu::gles2::GLES2Interface*) = 0;
void Detach();
void DetachAndDeleteObject();
// Runs the pre-finalization sequence -- what would be in the destructor
// of the base class, if it could be. Must be called no more than once.
void Dispose();
// Indicates to subclasses that the destructor is being run.
bool DestructionInProgress() const;
private:
Member<WebGLContextObjectSupport> context_;
GLuint object_ = 0;
// This was the number of context losses of the object's associated
// WebGLContext at the time this object was created.
uint32_t cached_number_of_context_losses_;
unsigned attachment_count_ = 0;
// Indicates whether the WebGL context's deletion function for this object
// (deleteBuffer, deleteTexture, etc.) has been called. It does *not* indicate
// whether the underlying OpenGL resource has been destroyed; !HasObject()
// indicates that.
bool marked_for_deletion_ = false;
// Indicates whether the destructor has been entered and we therefore
// need to be careful in subclasses to not touch other on-heap objects.
bool destruction_in_progress_ = false;
};
} // namespace blink
#endif // THIRD_PARTY_BLINK_RENDERER_MODULES_WEBGL_WEBGL_OBJECT_H_
|
