/src/mozilla-central/dom/canvas/OffscreenCanvas.h
Line | Count | Source (jump to first uncovered line) |
1 | | /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ |
2 | | /* vim:set ts=2 sw=2 sts=2 et cindent: */ |
3 | | /* This Source Code Form is subject to the terms of the Mozilla Public |
4 | | * License, v. 2.0. If a copy of the MPL was not distributed with this |
5 | | * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ |
6 | | |
7 | | #ifndef MOZILLA_DOM_OFFSCREENCANVAS_H_ |
8 | | #define MOZILLA_DOM_OFFSCREENCANVAS_H_ |
9 | | |
10 | | #include "gfxTypes.h" |
11 | | #include "mozilla/DOMEventTargetHelper.h" |
12 | | #include "mozilla/dom/DOMPrefs.h" |
13 | | #include "mozilla/layers/LayersTypes.h" |
14 | | #include "mozilla/RefPtr.h" |
15 | | #include "CanvasRenderingContextHelper.h" |
16 | | #include "nsCycleCollectionParticipant.h" |
17 | | |
18 | | struct JSContext; |
19 | | |
20 | | namespace mozilla { |
21 | | |
22 | | class ErrorResult; |
23 | | |
24 | | namespace layers { |
25 | | class AsyncCanvasRenderer; |
26 | | class CanvasClient; |
27 | | } // namespace layers |
28 | | |
29 | | namespace dom { |
30 | | class Blob; |
31 | | class ImageBitmap; |
32 | | |
33 | | // This is helper class for transferring OffscreenCanvas to worker thread. |
34 | | // Because OffscreenCanvas is not thread-safe. So we cannot pass Offscreen- |
35 | | // Canvas to worker thread directly. Thus, we create this helper class and |
36 | | // store necessary data in it then pass it to worker thread. |
37 | | struct OffscreenCanvasCloneData final |
38 | | { |
39 | | OffscreenCanvasCloneData(layers::AsyncCanvasRenderer* aRenderer, |
40 | | uint32_t aWidth, uint32_t aHeight, |
41 | | layers::LayersBackend aCompositorBackend, |
42 | | bool aNeutered, bool aIsWriteOnly); |
43 | | ~OffscreenCanvasCloneData(); |
44 | | |
45 | | RefPtr<layers::AsyncCanvasRenderer> mRenderer; |
46 | | uint32_t mWidth; |
47 | | uint32_t mHeight; |
48 | | layers::LayersBackend mCompositorBackendType; |
49 | | bool mNeutered; |
50 | | bool mIsWriteOnly; |
51 | | }; |
52 | | |
53 | | class OffscreenCanvas final : public DOMEventTargetHelper |
54 | | , public CanvasRenderingContextHelper |
55 | | { |
56 | | public: |
57 | | NS_DECL_ISUPPORTS_INHERITED |
58 | | NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(OffscreenCanvas, DOMEventTargetHelper) |
59 | | |
60 | | OffscreenCanvas(nsIGlobalObject* aGlobal, |
61 | | uint32_t aWidth, |
62 | | uint32_t aHeight, |
63 | | layers::LayersBackend aCompositorBackend, |
64 | | layers::AsyncCanvasRenderer* aRenderer); |
65 | | |
66 | | nsCOMPtr<nsIGlobalObject> GetParentObject() const { return GetOwnerGlobal(); } |
67 | | |
68 | | virtual JSObject* WrapObject(JSContext* aCx, |
69 | | JS::Handle<JSObject*> aGivenProto) override; |
70 | | |
71 | | static already_AddRefed<OffscreenCanvas> |
72 | | Constructor(const GlobalObject& aGlobal, |
73 | | uint32_t aWidth, |
74 | | uint32_t aHeight, |
75 | | ErrorResult& aRv); |
76 | | |
77 | | void ClearResources(); |
78 | | |
79 | | uint32_t Width() const |
80 | | { |
81 | | return mWidth; |
82 | | } |
83 | | |
84 | | uint32_t Height() const |
85 | | { |
86 | | return mHeight; |
87 | | } |
88 | | |
89 | | void SetWidth(uint32_t aWidth, ErrorResult& aRv) |
90 | | { |
91 | | if (mNeutered) { |
92 | | aRv.Throw(NS_ERROR_FAILURE); |
93 | | return; |
94 | | } |
95 | | |
96 | | if (mWidth != aWidth) { |
97 | | mWidth = aWidth; |
98 | | CanvasAttrChanged(); |
99 | | } |
100 | | } |
101 | | |
102 | | void SetHeight(uint32_t aHeight, ErrorResult& aRv) |
103 | | { |
104 | | if (mNeutered) { |
105 | | aRv.Throw(NS_ERROR_FAILURE); |
106 | | return; |
107 | | } |
108 | | |
109 | | if (mHeight != aHeight) { |
110 | | mHeight = aHeight; |
111 | | CanvasAttrChanged(); |
112 | | } |
113 | | } |
114 | | |
115 | | already_AddRefed<ImageBitmap> |
116 | | TransferToImageBitmap(ErrorResult& aRv); |
117 | | |
118 | | already_AddRefed<Promise> |
119 | | ToBlob(JSContext* aCx, |
120 | | const nsAString& aType, |
121 | | JS::Handle<JS::Value> aParams, |
122 | | ErrorResult& aRv); |
123 | | |
124 | | nsICanvasRenderingContextInternal* GetContext() const |
125 | | { |
126 | | return mCurrentContext; |
127 | | } |
128 | | |
129 | | already_AddRefed<gfx::SourceSurface> GetSurfaceSnapshot(gfxAlphaType* aOutAlphaType = nullptr); |
130 | | |
131 | | static already_AddRefed<OffscreenCanvas> |
132 | | CreateFromCloneData(nsIGlobalObject* aGlobal, OffscreenCanvasCloneData* aData); |
133 | | |
134 | | // Return true on main-thread, and return gfx.offscreencanvas.enabled |
135 | | // on worker thread. |
136 | | static bool PrefEnabledOnWorkerThread(JSContext* aCx, JSObject* aObj); |
137 | | |
138 | | OffscreenCanvasCloneData* ToCloneData(); |
139 | | |
140 | | void CommitFrameToCompositor(); |
141 | | |
142 | | virtual bool GetOpaqueAttr() override |
143 | 0 | { |
144 | 0 | return false; |
145 | 0 | } |
146 | | |
147 | | virtual nsIntSize GetWidthHeight() override |
148 | 0 | { |
149 | 0 | return nsIntSize(mWidth, mHeight); |
150 | 0 | } |
151 | | |
152 | | virtual already_AddRefed<nsICanvasRenderingContextInternal> |
153 | | CreateContext(CanvasContextType aContextType) override; |
154 | | |
155 | | virtual already_AddRefed<nsISupports> |
156 | | GetContext(JSContext* aCx, |
157 | | const nsAString& aContextId, |
158 | | JS::Handle<JS::Value> aContextOptions, |
159 | | ErrorResult& aRv) override; |
160 | | |
161 | | void SetNeutered() |
162 | | { |
163 | | mNeutered = true; |
164 | | } |
165 | | |
166 | | bool IsNeutered() const |
167 | | { |
168 | | return mNeutered; |
169 | | } |
170 | | |
171 | | void SetWriteOnly() |
172 | | { |
173 | | mIsWriteOnly = true; |
174 | | } |
175 | | |
176 | | bool IsWriteOnly() const |
177 | 0 | { |
178 | 0 | return mIsWriteOnly; |
179 | 0 | } |
180 | | |
181 | | layers::LayersBackend GetCompositorBackendType() const |
182 | | { |
183 | | return mCompositorBackendType; |
184 | | } |
185 | | |
186 | | private: |
187 | | ~OffscreenCanvas(); |
188 | | |
189 | | nsCOMPtr<nsIGlobalObject> GetGlobalObject(); |
190 | | |
191 | | void CanvasAttrChanged() |
192 | | { |
193 | | mAttrDirty = true; |
194 | | ErrorResult dummy; |
195 | | UpdateContext(nullptr, JS::NullHandleValue, dummy); |
196 | | } |
197 | | |
198 | | bool mAttrDirty; |
199 | | bool mNeutered; |
200 | | bool mIsWriteOnly; |
201 | | |
202 | | uint32_t mWidth; |
203 | | uint32_t mHeight; |
204 | | |
205 | | layers::LayersBackend mCompositorBackendType; |
206 | | |
207 | | RefPtr<layers::CanvasClient> mCanvasClient; |
208 | | RefPtr<layers::AsyncCanvasRenderer> mCanvasRenderer; |
209 | | }; |
210 | | |
211 | | } // namespace dom |
212 | | } // namespace mozilla |
213 | | |
214 | | #endif // MOZILLA_DOM_OFFSCREENCANVAS_H_ |