gecko-dev/dom/canvas/ClientWebGLContext.h

2207 строки
76 KiB
C++

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef CLIENTWEBGLCONTEXT_H_
#define CLIENTWEBGLCONTEXT_H_
#include "GLConsts.h"
#include "mozilla/dom/ImageData.h"
#include "mozilla/Range.h"
#include "mozilla/RefCounted.h"
#include "nsICanvasRenderingContextInternal.h"
#include "nsWrapperCache.h"
#include "mozilla/dom/WebGLRenderingContextBinding.h"
#include "mozilla/dom/WebGL2RenderingContextBinding.h"
#include "WebGLFormats.h"
#include "WebGLStrongTypes.h"
#include "WebGLTypes.h"
#include "mozilla/Logging.h"
#include "WebGLCrossProcessCommandQueue.h"
#include "WebGLCommandQueue.h"
#include <memory>
#include <unordered_map>
#include <unordered_set>
#include <vector>
#ifndef WEBGL_BRIDGE_LOG_
# define WEBGL_BRIDGE_LOG_(lvl, ...) \
MOZ_LOG(mozilla::gWebGLBridgeLog, lvl, (__VA_ARGS__))
# define WEBGL_BRIDGE_LOGV(...) \
WEBGL_BRIDGE_LOG_(LogLevel::Verbose, __VA_ARGS__)
# define WEBGL_BRIDGE_LOGD(...) WEBGL_BRIDGE_LOG_(LogLevel::Debug, __VA_ARGS__)
# define WEBGL_BRIDGE_LOGI(...) WEBGL_BRIDGE_LOG_(LogLevel::Info, __VA_ARGS__)
# define WEBGL_BRIDGE_LOGE(...) WEBGL_BRIDGE_LOG_(LogLevel::Error, __VA_ARGS__)
#endif // WEBGL_BRIDGE_LOG_
namespace mozilla {
class ClientWebGLExtensionBase;
namespace dom {
class WebGLChild;
}
namespace layers {
class SharedSurfaceTextureClient;
}
namespace webgl {
class TexUnpackBlob;
class TexUnpackBytes;
} // namespace webgl
////////////////////////////////////
class WebGLActiveInfoJS final : public RefCounted<WebGLActiveInfoJS> {
public:
MOZ_DECLARE_REFCOUNTED_TYPENAME(WebGLActiveInfoJS)
const webgl::ActiveInfo mInfo;
explicit WebGLActiveInfoJS(const webgl::ActiveInfo& info) : mInfo(info) {}
virtual ~WebGLActiveInfoJS() = default;
// -
// WebIDL attributes
GLint Size() const { return static_cast<GLint>(mInfo.elemCount); }
GLenum Type() const { return mInfo.elemType; }
void GetName(nsString& retval) const {
retval = NS_ConvertUTF8toUTF16(mInfo.name.c_str());
}
bool WrapObject(JSContext*, JS::Handle<JSObject*>,
JS::MutableHandle<JSObject*>);
};
class WebGLShaderPrecisionFormatJS final
: public RefCounted<WebGLShaderPrecisionFormatJS> {
public:
MOZ_DECLARE_REFCOUNTED_TYPENAME(WebGLShaderPrecisionFormatJS)
const webgl::ShaderPrecisionFormat mInfo;
explicit WebGLShaderPrecisionFormatJS(
const webgl::ShaderPrecisionFormat& info)
: mInfo(info) {}
virtual ~WebGLShaderPrecisionFormatJS() = default;
GLint RangeMin() const { return mInfo.rangeMin; }
GLint RangeMax() const { return mInfo.rangeMax; }
GLint Precision() const { return mInfo.precision; }
bool WrapObject(JSContext*, JS::Handle<JSObject*>,
JS::MutableHandle<JSObject*>);
};
// -----------------------
class ClientWebGLContext;
class WebGLBufferJS;
class WebGLFramebufferJS;
class WebGLProgramJS;
class WebGLQueryJS;
class WebGLRenderbufferJS;
class WebGLSamplerJS;
class WebGLShaderJS;
class WebGLTextureJS;
class WebGLTransformFeedbackJS;
class WebGLVertexArrayJS;
namespace webgl {
struct LinkResult;
class ProgramKeepAlive final {
friend class mozilla::WebGLProgramJS;
WebGLProgramJS* mParent;
public:
explicit ProgramKeepAlive(WebGLProgramJS& parent) : mParent(&parent) {}
~ProgramKeepAlive();
};
class ShaderKeepAlive final {
friend class mozilla::WebGLShaderJS;
const WebGLShaderJS* mParent;
public:
explicit ShaderKeepAlive(const WebGLShaderJS& parent) : mParent(&parent) {}
~ShaderKeepAlive();
};
class ContextGenerationInfo final {
private:
ObjectId mLastId = 0;
public:
webgl::ExtensionBits mEnabledExtensions;
RefPtr<WebGLProgramJS> mCurrentProgram;
std::shared_ptr<webgl::ProgramKeepAlive> mProgramKeepAlive;
mutable std::shared_ptr<webgl::LinkResult> mActiveLinkResult;
RefPtr<WebGLTransformFeedbackJS> mDefaultTfo;
RefPtr<WebGLVertexArrayJS> mDefaultVao;
std::unordered_map<GLenum, RefPtr<WebGLBufferJS>> mBoundBufferByTarget;
std::vector<RefPtr<WebGLBufferJS>> mBoundUbos;
RefPtr<WebGLFramebufferJS> mBoundDrawFb;
RefPtr<WebGLFramebufferJS> mBoundReadFb;
RefPtr<WebGLRenderbufferJS> mBoundRb;
RefPtr<WebGLTransformFeedbackJS> mBoundTfo;
RefPtr<WebGLVertexArrayJS> mBoundVao;
std::unordered_map<GLenum, RefPtr<WebGLQueryJS>> mCurrentQueryByTarget;
struct TexUnit final {
RefPtr<WebGLSamplerJS> sampler;
std::unordered_map<GLenum, RefPtr<WebGLTextureJS>> texByTarget;
};
uint32_t mActiveTexUnit = 0;
std::vector<TexUnit> mTexUnits;
bool mTfActiveAndNotPaused = false;
std::vector<TypedQuad> mGenericVertexAttribs;
std::array<bool, 4> mColorWriteMask = {{true, true, true, true}};
std::array<int32_t, 4> mScissor = {};
std::array<int32_t, 4> mViewport = {};
std::array<float, 4> mClearColor = {{0, 0, 0, 0}};
std::array<float, 4> mBlendColor = {{0, 0, 0, 0}};
std::array<float, 2> mDepthRange = {{0, 1}};
webgl::PixelPackState mPixelPackState;
std::vector<GLenum> mCompressedTextureFormats;
Maybe<uvec2> mDrawingBufferSize;
ObjectId NextId() { return mLastId += 1; }
};
// -
struct RemotingData final {
// In the cross process case, the WebGL actor's ownership relationship looks
// like this:
// ---------------------------------------------------------------------
// | ClientWebGLContext -> WebGLChild -> WebGLParent -> HostWebGLContext
// ---------------------------------------------------------------------
//
// where 'A -> B' means "A owns B"
RefPtr<mozilla::dom::WebGLChild> mWebGLChild;
UniquePtr<ClientWebGLCommandSourceP> mCommandSourcePcq;
UniquePtr<ClientWebGLCommandSourceI> mCommandSourceIpdl;
};
struct NotLostData final {
ClientWebGLContext& context;
webgl::InitContextResult info;
Maybe<RemotingData> outOfProcess;
UniquePtr<HostWebGLContext> inProcess;
webgl::ContextGenerationInfo state;
std::array<RefPtr<ClientWebGLExtensionBase>, EnumValue(WebGLExtensionID::Max)>
extensions;
explicit NotLostData(ClientWebGLContext& context);
~NotLostData();
};
// -
class ObjectJS {
friend ClientWebGLContext;
public:
const std::weak_ptr<NotLostData> mGeneration;
const ObjectId mId;
protected:
bool mDeleteRequested = false;
explicit ObjectJS(const ClientWebGLContext&);
virtual ~ObjectJS() = default;
public:
ClientWebGLContext* Context() const {
const auto locked = mGeneration.lock();
if (!locked) return nullptr;
return &(locked->context);
}
ClientWebGLContext* GetParentObject() const { return Context(); }
// A la carte:
bool IsForContext(const ClientWebGLContext&) const;
virtual bool IsDeleted() const { return mDeleteRequested; }
bool IsUsable(const ClientWebGLContext& context) const {
return IsForContext(context) && !IsDeleted();
}
// The workhorse:
bool ValidateUsable(const ClientWebGLContext& context,
const char* const argName) const {
if (MOZ_LIKELY(IsUsable(context))) return true;
WarnInvalidUse(context, argName);
return false;
}
// Use by DeleteFoo:
bool ValidateForContext(const ClientWebGLContext& context,
const char* const argName) const;
private:
void WarnInvalidUse(const ClientWebGLContext&, const char* argName) const;
// The enum is INVALID_VALUE for Program/Shader :(
virtual GLenum ErrorOnDeleted() const { return LOCAL_GL_INVALID_OPERATION; }
};
} // namespace webgl
// -------------------------
class WebGLBufferJS final : public nsWrapperCache, public webgl::ObjectJS {
friend class ClientWebGLContext;
webgl::BufferKind mKind =
webgl::BufferKind::Undefined; // !IsBuffer until Bind
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLBufferJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLBufferJS)
explicit WebGLBufferJS(const ClientWebGLContext& webgl)
: webgl::ObjectJS(webgl) {}
private:
~WebGLBufferJS() = default;
public:
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
class WebGLFramebufferJS final : public nsWrapperCache, public webgl::ObjectJS {
friend class ClientWebGLContext;
public:
struct Attachment final {
RefPtr<WebGLRenderbufferJS> rb;
RefPtr<WebGLTextureJS> tex;
};
private:
bool mHasBeenBound = false; // !IsFramebuffer until Bind
std::unordered_map<GLenum, Attachment> mAttachments;
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLFramebufferJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLFramebufferJS)
explicit WebGLFramebufferJS(const ClientWebGLContext&, bool opaque = false);
const bool mOpaque;
bool mInOpaqueRAF = false;
private:
~WebGLFramebufferJS() = default;
void EnsureColorAttachments();
public:
Attachment* GetAttachment(const GLenum slotEnum) {
auto ret = MaybeFind(mAttachments, slotEnum);
if (!ret) {
EnsureColorAttachments();
ret = MaybeFind(mAttachments, slotEnum);
}
return ret;
}
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
class WebGLProgramJS final : public nsWrapperCache, public webgl::ObjectJS {
friend class ClientWebGLContext;
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLProgramJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLProgramJS)
// Must come first!
// If the REFCOUNTING macro isn't declared first, the AddRef at
// mInnerRef->js will panic when REFCOUNTING's "owning thread" var is still
// uninitialized.
struct Attachment final {
RefPtr<WebGLShaderJS> shader;
std::shared_ptr<webgl::ShaderKeepAlive> keepAlive;
};
private:
std::shared_ptr<webgl::ProgramKeepAlive> mKeepAlive;
const std::weak_ptr<webgl::ProgramKeepAlive> mKeepAliveWeak;
std::unordered_map<GLenum, Attachment> mNextLink_Shaders;
bool mLastValidate = false;
mutable std::shared_ptr<webgl::LinkResult>
mResult; // Never null, often defaulted.
struct UniformLocInfo final {
const uint32_t location;
const GLenum elemType;
};
mutable Maybe<std::unordered_map<std::string, UniformLocInfo>>
mUniformLocByName;
mutable std::vector<uint32_t> mUniformBlockBindings;
std::unordered_set<const WebGLTransformFeedbackJS*> mActiveTfos;
explicit WebGLProgramJS(const ClientWebGLContext&);
~WebGLProgramJS() {
mKeepAlive = nullptr; // Try to delete.
const auto& maybe = mKeepAliveWeak.lock();
if (maybe) {
maybe->mParent = nullptr;
}
}
public:
bool IsDeleted() const override { return !mKeepAliveWeak.lock(); }
GLenum ErrorOnDeleted() const override { return LOCAL_GL_INVALID_VALUE; }
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
class WebGLQueryJS final : public nsWrapperCache, public webgl::ObjectJS {
friend class ClientWebGLContext;
GLenum mTarget = 0; // !IsQuery until Bind
bool mIsFullyDeleted = false;
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLQueryJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLQueryJS)
explicit WebGLQueryJS(const ClientWebGLContext& webgl)
: webgl::ObjectJS(webgl) {}
private:
~WebGLQueryJS() = default;
public:
bool IsDeleted() const override { return mIsFullyDeleted; }
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
class WebGLRenderbufferJS final : public nsWrapperCache,
public webgl::ObjectJS {
friend class ClientWebGLContext;
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLRenderbufferJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLRenderbufferJS)
private:
bool mHasBeenBound = false; // !IsRenderbuffer until Bind
explicit WebGLRenderbufferJS(const ClientWebGLContext& webgl)
: webgl::ObjectJS(webgl) {}
~WebGLRenderbufferJS() = default;
public:
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
class WebGLSamplerJS final : public nsWrapperCache, public webgl::ObjectJS {
// IsSampler without Bind
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLSamplerJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLSamplerJS)
explicit WebGLSamplerJS(const ClientWebGLContext& webgl)
: webgl::ObjectJS(webgl) {}
private:
~WebGLSamplerJS() = default;
public:
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
class WebGLShaderJS final : public nsWrapperCache, public webgl::ObjectJS {
friend class ClientWebGLContext;
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLShaderJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLShaderJS)
private:
const GLenum mType;
std::string mSource;
std::shared_ptr<webgl::ShaderKeepAlive> mKeepAlive;
const std::weak_ptr<webgl::ShaderKeepAlive> mKeepAliveWeak;
mutable webgl::CompileResult mResult;
WebGLShaderJS(const ClientWebGLContext&, GLenum type);
~WebGLShaderJS() {
mKeepAlive = nullptr; // Try to delete.
const auto& maybe = mKeepAliveWeak.lock();
if (maybe) {
maybe->mParent = nullptr;
}
}
public:
bool IsDeleted() const override { return !mKeepAliveWeak.lock(); }
GLenum ErrorOnDeleted() const override { return LOCAL_GL_INVALID_VALUE; }
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
class WebGLSyncJS final : public nsWrapperCache, public webgl::ObjectJS {
friend class ClientWebGLContext;
bool mSignaled = false;
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLSyncJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLSyncJS)
explicit WebGLSyncJS(const ClientWebGLContext& webgl)
: webgl::ObjectJS(webgl) {}
private:
~WebGLSyncJS() = default;
public:
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
class WebGLTextureJS final : public nsWrapperCache, public webgl::ObjectJS {
friend class ClientWebGLContext;
GLenum mTarget = 0; // !IsTexture until Bind
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLTextureJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLTextureJS)
explicit WebGLTextureJS(const ClientWebGLContext& webgl)
: webgl::ObjectJS(webgl) {}
private:
~WebGLTextureJS() = default;
public:
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
class WebGLTransformFeedbackJS final : public nsWrapperCache,
public webgl::ObjectJS {
friend class ClientWebGLContext;
bool mHasBeenBound = false; // !IsTransformFeedback until Bind
bool mActiveOrPaused = false;
std::vector<RefPtr<WebGLBufferJS>> mAttribBuffers;
RefPtr<WebGLProgramJS> mActiveProgram;
std::shared_ptr<webgl::ProgramKeepAlive> mActiveProgramKeepAlive;
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLTransformFeedbackJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLTransformFeedbackJS)
explicit WebGLTransformFeedbackJS(const ClientWebGLContext&);
private:
~WebGLTransformFeedbackJS() = default;
public:
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
std::array<uint16_t, 3> ValidUploadElemTypes(GLenum);
class WebGLUniformLocationJS final : public nsWrapperCache,
public webgl::ObjectJS {
friend class ClientWebGLContext;
const std::weak_ptr<webgl::LinkResult> mParent;
const uint32_t mLocation;
const std::array<uint16_t, 3> mValidUploadElemTypes;
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLUniformLocationJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLUniformLocationJS)
WebGLUniformLocationJS(const ClientWebGLContext& webgl,
std::weak_ptr<webgl::LinkResult> parent, uint32_t loc,
GLenum elemType)
: webgl::ObjectJS(webgl),
mParent(parent),
mLocation(loc),
mValidUploadElemTypes(ValidUploadElemTypes(elemType)) {}
private:
~WebGLUniformLocationJS() = default;
public:
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
// -
class WebGLVertexArrayJS final : public nsWrapperCache, public webgl::ObjectJS {
friend class ClientWebGLContext;
bool mHasBeenBound = false; // !IsVertexArray until Bind
RefPtr<WebGLBufferJS> mIndexBuffer;
std::vector<RefPtr<WebGLBufferJS>> mAttribBuffers;
public:
NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(WebGLVertexArrayJS)
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_NATIVE_CLASS(WebGLVertexArrayJS)
explicit WebGLVertexArrayJS(const ClientWebGLContext&);
private:
~WebGLVertexArrayJS() = default;
public:
JSObject* WrapObject(JSContext*, JS::Handle<JSObject*>) override;
};
////////////////////////////////////
typedef dom::MaybeSharedFloat32ArrayOrUnrestrictedFloatSequence Float32ListU;
typedef dom::MaybeSharedInt32ArrayOrLongSequence Int32ListU;
typedef dom::MaybeSharedUint32ArrayOrUnsignedLongSequence Uint32ListU;
inline Range<const float> MakeRange(const Float32ListU& list) {
if (list.IsFloat32Array()) return MakeRangeAbv(list.GetAsFloat32Array());
return MakeRange(list.GetAsUnrestrictedFloatSequence());
}
inline Range<const int32_t> MakeRange(const Int32ListU& list) {
if (list.IsInt32Array()) return MakeRangeAbv(list.GetAsInt32Array());
return MakeRange(list.GetAsLongSequence());
}
inline Range<const uint32_t> MakeRange(const Uint32ListU& list) {
if (list.IsUint32Array()) return MakeRangeAbv(list.GetAsUint32Array());
return MakeRange(list.GetAsUnsignedLongSequence());
}
template <typename T>
inline Range<const uint8_t> MakeByteRange(const T& x) {
const auto typed = MakeRange(x);
return Range<const uint8_t>(
reinterpret_cast<const uint8_t*>(typed.begin().get()),
typed.length() * sizeof(typed[0]));
}
// -
struct TexImageSourceAdapter final : public TexImageSource {
TexImageSourceAdapter(const dom::Nullable<dom::ArrayBufferView>* maybeView,
ErrorResult*) {
if (!maybeView->IsNull()) {
mView = &(maybeView->Value());
}
}
TexImageSourceAdapter(const dom::Nullable<dom::ArrayBufferView>* maybeView,
GLuint viewElemOffset) {
if (!maybeView->IsNull()) {
mView = &(maybeView->Value());
}
mViewElemOffset = viewElemOffset;
}
TexImageSourceAdapter(const dom::ArrayBufferView* view, ErrorResult*) {
mView = view;
}
TexImageSourceAdapter(const dom::ArrayBufferView* view, GLuint viewElemOffset,
GLuint viewElemLengthOverride = 0) {
mView = view;
mViewElemOffset = viewElemOffset;
mViewElemLengthOverride = viewElemLengthOverride;
}
explicit TexImageSourceAdapter(const WebGLintptr* pboOffset,
GLuint ignored1 = 0, GLuint ignored2 = 0) {
mPboOffset = pboOffset;
}
TexImageSourceAdapter(const WebGLintptr* pboOffset, ErrorResult* ignored) {
mPboOffset = pboOffset;
}
TexImageSourceAdapter(const dom::ImageBitmap* imageBitmap,
ErrorResult* out_error) {
mImageBitmap = imageBitmap;
mOut_error = out_error;
}
TexImageSourceAdapter(const dom::ImageData* imageData, ErrorResult*) {
mImageData = imageData;
}
TexImageSourceAdapter(const dom::Element* domElem,
ErrorResult* const out_error) {
mDomElem = domElem;
mOut_error = out_error;
}
};
/**
* Base class for all IDL implementations of WebGLContext
*/
class ClientWebGLContext final : public nsICanvasRenderingContextInternal,
public nsWrapperCache,
public SupportsWeakPtr<ClientWebGLContext> {
friend class WebGLContextUserData;
friend class webgl::ObjectJS;
friend class webgl::ProgramKeepAlive;
friend class webgl::ShaderKeepAlive;
public:
MOZ_DECLARE_WEAKREFERENCE_TYPENAME(ClientWebGLContext)
// ----------------------------- Lifetime and DOM ---------------------------
public:
NS_DECL_CYCLE_COLLECTING_ISUPPORTS
NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_CLASS(ClientWebGLContext)
JSObject* WrapObject(JSContext* cx,
JS::Handle<JSObject*> givenProto) override {
if (mIsWebGL2) {
return dom::WebGL2RenderingContext_Binding::Wrap(cx, this, givenProto);
}
return dom::WebGLRenderingContext_Binding::Wrap(cx, this, givenProto);
}
// -
public:
const bool mIsWebGL2;
explicit ClientWebGLContext(bool webgl2);
private:
virtual ~ClientWebGLContext();
const RefPtr<ClientWebGLExtensionLoseContext> mExtLoseContext;
webgl::LossStatus mLossStatus = webgl::LossStatus::Ready;
bool mAwaitingRestore = false;
// -
private:
std::shared_ptr<webgl::NotLostData> mNotLost;
mutable GLenum mNextError = 0;
public:
const auto& Limits() const { return mNotLost->info.limits; }
// https://www.khronos.org/registry/webgl/specs/latest/1.0/#actual-context-parameters
const WebGLContextOptions& ActualContextParameters() const {
MOZ_ASSERT(mNotLost != nullptr);
return mNotLost->info.options;
}
auto& State() { return mNotLost->state; }
const auto& State() const {
return const_cast<ClientWebGLContext*>(this)->State();
}
// -
public:
void EmulateLoseContext();
void OnContextLoss(webgl::ContextLossReason);
void RestoreContext(webgl::LossStatus requiredStatus);
private:
bool DispatchEvent(const nsAString&) const;
void Event_webglcontextlost();
void Event_webglcontextrestored();
bool CreateHostContext(const uvec2& requestedSize);
void ThrowEvent_WebGLContextCreationError(const std::string&) const;
public:
void MarkCanvasDirty() { Invalidate(); }
mozilla::dom::WebGLChild* GetChild() const {
if (!mNotLost) return nullptr;
if (!mNotLost->outOfProcess) return nullptr;
return mNotLost->outOfProcess->mWebGLChild.get();
}
// -------------------------------------------------------------------------
// Client WebGL API call tracking and error message reporting
// -------------------------------------------------------------------------
public:
// Remembers the WebGL function that is lowest on the stack for client-side
// error generation.
class FuncScope final {
public:
const ClientWebGLContext& mWebGL;
const char* const mFuncName;
const FuncScopeId mId;
FuncScope(const ClientWebGLContext& webgl, const char* funcName)
: mWebGL(webgl),
mFuncName(funcName),
mId(FuncScopeId::FuncScopeIdError) {
// Only set if an "outer" scope hasn't already been set.
if (!mWebGL.mFuncScope) {
mWebGL.mFuncScope = this;
}
}
FuncScope(const ClientWebGLContext* webgl, FuncScopeId aId)
: mWebGL(*webgl), mFuncName(GetFuncScopeName(aId)), mId(aId) {
mWebGL.mFuncScope = this;
}
~FuncScope() {
if (this == mWebGL.mFuncScope) {
mWebGL.mFuncScope = nullptr;
}
}
};
protected:
// The scope of the function at the top of the current WebGL function call
// stack
mutable FuncScope* mFuncScope = nullptr;
const auto& CurFuncScope() const { return *mFuncScope; }
FuncScopeId GetFuncScopeId() const {
return mFuncScope ? mFuncScope->mId : FuncScopeId::FuncScopeIdError;
}
const char* FuncName() const {
return mFuncScope ? mFuncScope->mFuncName : nullptr;
}
public:
template <typename... Args>
void EnqueueError(const GLenum error, const char* const format,
const Args&... args) const {
MOZ_ASSERT(FuncName());
nsCString text;
text.AppendPrintf("WebGL warning: %s: ", FuncName());
#ifdef __clang__
# pragma clang diagnostic push
# pragma clang diagnostic ignored "-Wformat-security"
#elif defined(__GNUC__)
# pragma GCC diagnostic push
# pragma GCC diagnostic ignored "-Wformat-security"
#endif
text.AppendPrintf(format, args...);
#ifdef __clang__
# pragma clang diagnostic pop
#elif defined(__GNUC__)
# pragma GCC diagnostic pop
#endif
EnqueueErrorImpl(error, text);
}
template <typename... Args>
void EnqueueWarning(const char* const format, const Args&... args) const {
EnqueueError(0, format, args...);
}
void EnqueueError_ArgEnum(const char* argName,
GLenum val) const; // Cold code.
private:
void EnqueueErrorImpl(GLenum errorOrZero, const nsACString&) const;
public:
bool ValidateArrayBufferView(const dom::ArrayBufferView& view,
GLuint elemOffset, GLuint elemCountOverride,
const GLenum errorEnum,
uint8_t** const out_bytes,
size_t* const out_byteLen) const;
protected:
template <typename T>
bool ValidateNonNull(const char* const argName,
const dom::Nullable<T>& maybe) const {
if (maybe.IsNull()) {
EnqueueError(LOCAL_GL_INVALID_VALUE, "%s: Cannot be null.", argName);
return false;
}
return true;
}
bool ValidateNonNegative(const char* argName, int64_t val) const {
if (MOZ_UNLIKELY(val < 0)) {
EnqueueError(LOCAL_GL_INVALID_VALUE, "`%s` must be non-negative.",
argName);
return false;
}
return true;
}
bool ValidateViewType(GLenum unpackType, const TexImageSource& src) const;
Maybe<uvec3> ValidateExtents(GLsizei width, GLsizei height, GLsizei depth,
GLint border) const;
// -------------------------------------------------------------------------
// nsICanvasRenderingContextInternal / nsAPostRefreshObserver
// -------------------------------------------------------------------------
public:
already_AddRefed<layers::Layer> GetCanvasLayer(
nsDisplayListBuilder* builder, layers::Layer* oldLayer,
layers::LayerManager* manager) override;
bool InitializeCanvasRenderer(nsDisplayListBuilder* aBuilder,
layers::CanvasRenderer* aRenderer) override;
// Note that 'clean' here refers to its invalidation state, not the
// contents of the buffer.
bool IsContextCleanForFrameCapture() override {
return !mCapturedFrameInvalidated;
}
void MarkContextClean() override { mInvalidated = false; }
void MarkContextCleanForFrameCapture() override {
mCapturedFrameInvalidated = false;
}
void OnMemoryPressure() override;
NS_IMETHOD
SetContextOptions(JSContext* cx, JS::Handle<JS::Value> options,
ErrorResult& aRvForDictionaryInit) override;
NS_IMETHOD
SetDimensions(int32_t width, int32_t height) override;
bool UpdateWebRenderCanvasData(
nsDisplayListBuilder* aBuilder,
layers::WebRenderCanvasData* aCanvasData) override;
bool UpdateCompositableHandle(LayerTransactionChild* aLayerTransaction,
CompositableHandle aHandle) override;
// ------
int32_t GetWidth() override { return AutoAssertCast(DrawingBufferSize().x); }
int32_t GetHeight() override { return AutoAssertCast(DrawingBufferSize().y); }
NS_IMETHOD InitializeWithDrawTarget(nsIDocShell*,
NotNull<gfx::DrawTarget*>) override {
return NS_ERROR_NOT_IMPLEMENTED;
}
NS_IMETHOD Reset() override {
/* (InitializeWithSurface) */
return NS_ERROR_NOT_IMPLEMENTED;
}
UniquePtr<uint8_t[]> GetImageBuffer(int32_t* out_format) override;
NS_IMETHOD GetInputStream(const char* mimeType,
const nsAString& encoderOptions,
nsIInputStream** out_stream) override;
already_AddRefed<mozilla::gfx::SourceSurface> GetSurfaceSnapshot(
gfxAlphaType* out_alphaType) override;
void SetOpaqueValueFromOpaqueAttr(bool) override{};
bool GetIsOpaque() override { return !mInitialOptions->alpha; }
NS_IMETHOD SetIsIPC(bool) override { return NS_ERROR_NOT_IMPLEMENTED; }
/**
* An abstract base class to be implemented by callers wanting to be notified
* that a refresh has occurred. Callers must ensure an observer is removed
* before it is destroyed.
*/
void DidRefresh() override;
NS_IMETHOD Redraw(const gfxRect&) override {
return NS_ERROR_NOT_IMPLEMENTED;
}
// ------
void Invalidate();
protected:
layers::LayersBackend GetCompositorBackendType() const;
bool mInvalidated = false;
bool mCapturedFrameInvalidated = false;
// -------------------------------------------------------------------------
// WebGLRenderingContext Basic Properties and Methods
// -------------------------------------------------------------------------
public:
dom::HTMLCanvasElement* GetCanvas() const { return mCanvasElement; }
void Commit();
void GetCanvas(
dom::Nullable<dom::OwningHTMLCanvasElementOrOffscreenCanvas>& retval);
GLsizei DrawingBufferWidth() {
const FuncScope funcScope(*this, "drawingBufferWidth");
return AutoAssertCast(DrawingBufferSize().x);
}
GLsizei DrawingBufferHeight() {
const FuncScope funcScope(*this, "drawingBufferHeight");
return AutoAssertCast(DrawingBufferSize().y);
}
void GetContextAttributes(dom::Nullable<dom::WebGLContextAttributes>& retval);
void Present();
RefPtr<layers::SharedSurfaceTextureClient> GetVRFrame(
const WebGLFramebufferJS*) const;
void ClearVRFrame() const;
private:
uvec2 DrawingBufferSize();
ICRData mSurfaceInfo;
void AfterDrawCall() {
if (!mNotLost) return;
const auto& state = State();
const bool isBackbuffer = !state.mBoundDrawFb;
if (isBackbuffer) {
Invalidate();
}
}
// -------------------------------------------------------------------------
// Client-side helper methods. Dispatch to a Host method.
// -------------------------------------------------------------------------
// ------------------------- GL State -------------------------
public:
bool IsContextLost() const { return !mNotLost; }
void Disable(GLenum cap) const;
void Enable(GLenum cap) const;
bool IsEnabled(GLenum cap) const;
void GetParameter(JSContext* cx, GLenum pname,
JS::MutableHandle<JS::Value> retval, ErrorResult& rv,
bool debug = false);
void GetBufferParameter(JSContext* cx, GLenum target, GLenum pname,
JS::MutableHandle<JS::Value> retval) const;
void GetFramebufferAttachmentParameter(JSContext* cx, GLenum target,
GLenum attachment, GLenum pname,
JS::MutableHandle<JS::Value> retval,
ErrorResult& rv) const;
void GetRenderbufferParameter(JSContext* cx, GLenum target, GLenum pname,
JS::MutableHandle<JS::Value> retval) const;
void GetIndexedParameter(JSContext* cx, GLenum target, GLuint index,
JS::MutableHandleValue retval,
ErrorResult& rv) const;
already_AddRefed<WebGLShaderPrecisionFormatJS> GetShaderPrecisionFormat(
GLenum shadertype, GLenum precisiontype);
void UseProgram(WebGLProgramJS*);
void ValidateProgram(WebGLProgramJS&) const;
// -
already_AddRefed<WebGLBufferJS> CreateBuffer() const;
already_AddRefed<WebGLFramebufferJS> CreateFramebuffer() const;
already_AddRefed<WebGLFramebufferJS> CreateOpaqueFramebuffer(
const webgl::OpaqueFramebufferOptions&) const;
already_AddRefed<WebGLProgramJS> CreateProgram() const;
already_AddRefed<WebGLQueryJS> CreateQuery() const;
already_AddRefed<WebGLRenderbufferJS> CreateRenderbuffer() const;
already_AddRefed<WebGLSamplerJS> CreateSampler() const;
already_AddRefed<WebGLShaderJS> CreateShader(GLenum type) const;
already_AddRefed<WebGLSyncJS> FenceSync(GLenum condition,
GLbitfield flags) const;
already_AddRefed<WebGLTextureJS> CreateTexture() const;
already_AddRefed<WebGLTransformFeedbackJS> CreateTransformFeedback() const;
already_AddRefed<WebGLVertexArrayJS> CreateVertexArray() const;
void DeleteBuffer(WebGLBufferJS*);
void DeleteFramebuffer(WebGLFramebufferJS*, bool canDeleteOpaque = false);
void DeleteProgram(WebGLProgramJS*) const;
void DeleteQuery(WebGLQueryJS*);
void DeleteRenderbuffer(WebGLRenderbufferJS*);
void DeleteSampler(WebGLSamplerJS*);
void DeleteShader(WebGLShaderJS*) const;
void DeleteSync(WebGLSyncJS*) const;
void DeleteTexture(WebGLTextureJS*);
void DeleteTransformFeedback(WebGLTransformFeedbackJS*);
void DeleteVertexArray(WebGLVertexArrayJS*);
private:
void DoDeleteProgram(WebGLProgramJS&) const;
void DoDeleteShader(const WebGLShaderJS&) const;
public:
// -
bool IsBuffer(const WebGLBufferJS*) const;
bool IsFramebuffer(const WebGLFramebufferJS*) const;
bool IsProgram(const WebGLProgramJS*) const;
bool IsQuery(const WebGLQueryJS*) const;
bool IsRenderbuffer(const WebGLRenderbufferJS*) const;
bool IsSampler(const WebGLSamplerJS*) const;
bool IsShader(const WebGLShaderJS*) const;
bool IsSync(const WebGLSyncJS*) const;
bool IsTexture(const WebGLTextureJS*) const;
bool IsTransformFeedback(const WebGLTransformFeedbackJS*) const;
bool IsVertexArray(const WebGLVertexArrayJS*) const;
// -
// WebGLProgramJS
private:
const webgl::LinkResult& GetLinkResult(const WebGLProgramJS&) const;
public:
void AttachShader(WebGLProgramJS&, WebGLShaderJS&) const;
void BindAttribLocation(WebGLProgramJS&, GLuint location,
const nsAString& name) const;
void DetachShader(WebGLProgramJS&, const WebGLShaderJS&) const;
void GetAttachedShaders(
const WebGLProgramJS&,
dom::Nullable<nsTArray<RefPtr<WebGLShaderJS>>>& retval) const;
void LinkProgram(WebGLProgramJS&) const;
void TransformFeedbackVaryings(WebGLProgramJS&,
const dom::Sequence<nsString>& varyings,
GLenum bufferMode) const;
void UniformBlockBinding(WebGLProgramJS&, GLuint blockIndex,
GLuint blockBinding) const;
// Link result reflection
already_AddRefed<WebGLActiveInfoJS> GetActiveAttrib(const WebGLProgramJS&,
GLuint index);
already_AddRefed<WebGLActiveInfoJS> GetActiveUniform(const WebGLProgramJS&,
GLuint index);
void GetActiveUniformBlockName(const WebGLProgramJS&,
GLuint uniformBlockIndex,
nsAString& retval) const;
void GetActiveUniformBlockParameter(JSContext* cx, const WebGLProgramJS&,
GLuint uniformBlockIndex, GLenum pname,
JS::MutableHandle<JS::Value> retval,
ErrorResult& rv);
void GetActiveUniforms(JSContext*, const WebGLProgramJS&,
const dom::Sequence<GLuint>& uniformIndices,
GLenum pname,
JS::MutableHandle<JS::Value> retval) const;
GLint GetAttribLocation(const WebGLProgramJS&, const nsAString& name) const;
GLint GetFragDataLocation(const WebGLProgramJS&, const nsAString& name) const;
void GetProgramInfoLog(const WebGLProgramJS& prog, nsAString& retval) const;
void GetProgramParameter(JSContext*, const WebGLProgramJS&, GLenum pname,
JS::MutableHandle<JS::Value> retval) const;
already_AddRefed<WebGLActiveInfoJS> GetTransformFeedbackVarying(
const WebGLProgramJS&, GLuint index);
GLuint GetUniformBlockIndex(const WebGLProgramJS&,
const nsAString& uniformBlockName) const;
void GetUniformIndices(const WebGLProgramJS&,
const dom::Sequence<nsString>& uniformNames,
dom::Nullable<nsTArray<GLuint>>& retval) const;
// WebGLUniformLocationJS
already_AddRefed<WebGLUniformLocationJS> GetUniformLocation(
const WebGLProgramJS&, const nsAString& name) const;
void GetUniform(JSContext*, const WebGLProgramJS&,
const WebGLUniformLocationJS&,
JS::MutableHandle<JS::Value> retval);
// -
// WebGLShaderJS
private:
const webgl::CompileResult& GetCompileResult(const WebGLShaderJS&) const;
public:
void CompileShader(WebGLShaderJS&) const;
void GetShaderInfoLog(const WebGLShaderJS&, nsAString& retval) const;
void GetShaderParameter(JSContext*, const WebGLShaderJS&, GLenum pname,
JS::MutableHandle<JS::Value> retval) const;
void GetShaderSource(const WebGLShaderJS&, nsAString& retval) const;
void GetTranslatedShaderSource(const WebGLShaderJS& shader,
nsAString& retval) const;
void ShaderSource(WebGLShaderJS&, const nsAString&) const;
// -
void BindFramebuffer(GLenum target, WebGLFramebufferJS*);
void BlendColor(GLclampf r, GLclampf g, GLclampf b, GLclampf a);
// -
void BlendEquation(GLenum mode) { BlendEquationSeparate(mode, mode); }
void BlendFunc(GLenum sfactor, GLenum dfactor) {
BlendFuncSeparate(sfactor, dfactor, sfactor, dfactor);
}
void BlendEquationSeparate(GLenum modeRGB, GLenum modeAlpha);
void BlendFuncSeparate(GLenum srcRGB, GLenum dstRGB, GLenum srcAlpha,
GLenum dstAlpha);
// -
GLenum CheckFramebufferStatus(GLenum target);
void Clear(GLbitfield mask);
// -
private:
void ClearBufferTv(GLenum buffer, GLint drawBuffer, webgl::AttribBaseType,
const Range<const uint8_t>& view, GLuint srcElemOffset);
public:
void ClearBufferfv(GLenum buffer, GLint drawBuffer, const Float32ListU& list,
GLuint srcElemOffset) {
ClearBufferTv(buffer, drawBuffer, webgl::AttribBaseType::Float,
MakeByteRange(list), srcElemOffset);
}
void ClearBufferiv(GLenum buffer, GLint drawBuffer, const Int32ListU& list,
GLuint srcElemOffset) {
ClearBufferTv(buffer, drawBuffer, webgl::AttribBaseType::Int,
MakeByteRange(list), srcElemOffset);
}
void ClearBufferuiv(GLenum buffer, GLint drawBuffer, const Uint32ListU& list,
GLuint srcElemOffset) {
ClearBufferTv(buffer, drawBuffer, webgl::AttribBaseType::Uint,
MakeByteRange(list), srcElemOffset);
}
// -
void ClearBufferfi(GLenum buffer, GLint drawBuffer, GLfloat depth,
GLint stencil);
void ClearColor(GLclampf r, GLclampf g, GLclampf b, GLclampf a);
void ClearDepth(GLclampf v);
void ClearStencil(GLint v);
void ColorMask(WebGLboolean r, WebGLboolean g, WebGLboolean b,
WebGLboolean a);
void CullFace(GLenum face);
void DepthFunc(GLenum func);
void DepthMask(WebGLboolean b);
void DepthRange(GLclampf zNear, GLclampf zFar);
void Flush();
void Finish();
void FrontFace(GLenum mode);
GLenum GetError();
void Hint(GLenum target, GLenum mode);
void LineWidth(GLfloat width);
void PixelStorei(GLenum pname, GLint param);
void PolygonOffset(GLfloat factor, GLfloat units);
void SampleCoverage(GLclampf value, WebGLboolean invert);
void Scissor(GLint x, GLint y, GLsizei width, GLsizei height);
// -
void StencilFunc(GLenum func, GLint ref, GLuint mask) {
StencilFuncSeparate(LOCAL_GL_FRONT_AND_BACK, func, ref, mask);
}
void StencilMask(GLuint mask) {
StencilMaskSeparate(LOCAL_GL_FRONT_AND_BACK, mask);
}
void StencilOp(GLenum sfail, GLenum dpfail, GLenum dppass) {
StencilOpSeparate(LOCAL_GL_FRONT_AND_BACK, sfail, dpfail, dppass);
}
void StencilFuncSeparate(GLenum face, GLenum func, GLint ref, GLuint mask);
void StencilMaskSeparate(GLenum face, GLuint mask);
void StencilOpSeparate(GLenum face, GLenum sfail, GLenum dpfail,
GLenum dppass);
// -
void Viewport(GLint x, GLint y, GLsizei width, GLsizei height);
// ------------------------- Buffer Objects -------------------------
public:
void BindBuffer(GLenum target, WebGLBufferJS*);
// -
private:
void BindBufferRangeImpl(const GLenum target, const GLuint index,
WebGLBufferJS* const buffer, const uint64_t offset,
const uint64_t size);
public:
void BindBufferBase(const GLenum target, const GLuint index,
WebGLBufferJS* const buffer) {
const FuncScope funcScope(*this, "bindBufferBase");
if (IsContextLost()) return;
BindBufferRangeImpl(target, index, buffer, 0, 0);
}
void BindBufferRange(const GLenum target, const GLuint index,
WebGLBufferJS* const buffer, const WebGLintptr offset,
const WebGLsizeiptr size) {
const FuncScope funcScope(*this, "bindBufferRange");
if (IsContextLost()) return;
if (buffer) {
if (!ValidateNonNegative("offset", offset)) return;
if (size < 1) {
EnqueueError(LOCAL_GL_INVALID_VALUE,
"`size` must be positive for non-null `buffer`.");
return;
}
}
BindBufferRangeImpl(target, index, buffer, static_cast<uint64_t>(offset),
static_cast<uint64_t>(size));
}
// -
void CopyBufferSubData(GLenum readTarget, GLenum writeTarget,
GLintptr readOffset, GLintptr writeOffset,
GLsizeiptr size);
void BufferData(GLenum target, WebGLsizeiptr size, GLenum usage);
void BufferData(GLenum target,
const dom::Nullable<dom::ArrayBuffer>& maybeSrc,
GLenum usage);
void BufferData(GLenum target, const dom::ArrayBufferView& srcData,
GLenum usage, GLuint srcElemOffset = 0,
GLuint srcElemCountOverride = 0);
void BufferSubData(GLenum target, WebGLsizeiptr dstByteOffset,
const dom::ArrayBufferView& src, GLuint srcElemOffset = 0,
GLuint srcElemCountOverride = 0);
void BufferSubData(GLenum target, WebGLsizeiptr dstByteOffset,
const dom::ArrayBuffer& src);
void GetBufferSubData(GLenum target, GLintptr srcByteOffset,
const dom::ArrayBufferView& dstData,
GLuint dstElemOffset, GLuint dstElemCountOverride);
// -------------------------- Framebuffer Objects --------------------------
void BlitFramebuffer(GLint srcX0, GLint srcY0, GLint srcX1, GLint srcY1,
GLint dstX0, GLint dstY0, GLint dstX1, GLint dstY1,
GLbitfield mask, GLenum filter);
// -
private:
// `bindTarget` if non-zero allows initializing the rb/tex with that target.
void FramebufferAttach(GLenum target, GLenum attachEnum, GLenum bindTarget,
WebGLRenderbufferJS*, WebGLTextureJS*,
uint32_t mipLevel, uint32_t zLayer,
uint32_t numViewLayers) const;
public:
void FramebufferRenderbuffer(GLenum target, GLenum attachSlot,
GLenum rbTarget, WebGLRenderbufferJS* rb) const {
const FuncScope funcScope(*this, "framebufferRenderbuffer");
if (IsContextLost()) return;
if (rbTarget != LOCAL_GL_RENDERBUFFER) {
EnqueueError_ArgEnum("rbTarget", rbTarget);
return;
}
FramebufferAttach(target, attachSlot, rbTarget, rb, nullptr, 0, 0, 0);
}
void FramebufferTexture2D(GLenum target, GLenum attachSlot,
GLenum texImageTarget, WebGLTextureJS*,
GLint mipLevel) const;
void FramebufferTextureLayer(GLenum target, GLenum attachSlot,
WebGLTextureJS* tex, GLint mipLevel,
GLint zLayer) const {
const FuncScope funcScope(*this, "framebufferTextureLayer");
if (IsContextLost()) return;
FramebufferAttach(target, attachSlot, 0, nullptr, tex,
static_cast<uint32_t>(mipLevel),
static_cast<uint32_t>(zLayer), 0);
}
void FramebufferTextureMultiview(GLenum target, GLenum attachSlot,
WebGLTextureJS* tex, GLint mipLevel,
GLint zLayerBase,
GLsizei numViewLayers) const {
const FuncScope funcScope(*this, "framebufferTextureMultiview");
if (IsContextLost()) return;
if (tex && numViewLayers < 1) {
EnqueueError(LOCAL_GL_INVALID_VALUE, "`numViewLayers` must be >=1.");
return;
}
FramebufferAttach(target, attachSlot, 0, nullptr, tex,
static_cast<uint32_t>(mipLevel),
static_cast<uint32_t>(zLayerBase),
static_cast<uint32_t>(numViewLayers));
}
// -
void InvalidateFramebuffer(GLenum target,
const dom::Sequence<GLenum>& attachments,
ErrorResult& unused);
void InvalidateSubFramebuffer(GLenum target,
const dom::Sequence<GLenum>& attachments,
GLint x, GLint y, GLsizei width, GLsizei height,
ErrorResult& unused);
void ReadBuffer(GLenum mode);
// ----------------------- Renderbuffer objects -----------------------
void GetInternalformatParameter(JSContext* cx, GLenum target,
GLenum internalformat, GLenum pname,
JS::MutableHandleValue retval,
ErrorResult& rv);
void BindRenderbuffer(GLenum target, WebGLRenderbufferJS*);
void RenderbufferStorage(GLenum target, GLenum internalFormat, GLsizei width,
GLsizei height) const {
RenderbufferStorageMultisample(target, 0, internalFormat, width, height);
}
void RenderbufferStorageMultisample(GLenum target, GLsizei samples,
GLenum internalFormat, GLsizei width,
GLsizei height) const;
// --------------------------- Texture objects ---------------------------
void ActiveTexture(GLenum texUnit);
void BindTexture(GLenum texTarget, WebGLTextureJS*);
void GenerateMipmap(GLenum texTarget) const;
void GetTexParameter(JSContext* cx, GLenum texTarget, GLenum pname,
JS::MutableHandle<JS::Value> retval) const;
void TexParameterf(GLenum texTarget, GLenum pname, GLfloat param);
void TexParameteri(GLenum texTarget, GLenum pname, GLint param);
// -
private:
void TexStorage(uint8_t funcDims, GLenum target, GLsizei levels,
GLenum internalFormat, const ivec3& size) const;
// Primitive tex upload functions
void TexImage(uint8_t funcDims, GLenum target, GLint level,
GLenum respecFormat, const ivec3& offset, const ivec3& size,
GLint border, const webgl::PackingInfo& pi,
const TexImageSource& src) const;
void CompressedTexImage(bool sub, uint8_t funcDims, GLenum target,
GLint level, GLenum format, const ivec3& offset,
const ivec3& size, GLint border,
const TexImageSource& src,
GLsizei pboImageSize) const;
void CopyTexImage(uint8_t funcDims, GLenum target, GLint level,
GLenum respecFormat, const ivec3& dstOffset,
const ivec2& srcOffset, const ivec2& size,
GLint border) const;
public:
void TexStorage2D(GLenum target, GLsizei levels, GLenum internalFormat,
GLsizei width, GLsizei height) const {
TexStorage(2, target, levels, internalFormat, {width, height, 1});
}
void TexStorage3D(GLenum target, GLsizei levels, GLenum internalFormat,
GLsizei width, GLsizei height, GLsizei depth) const {
TexStorage(3, target, levels, internalFormat, {width, height, depth});
}
////////////////////////////////////
template <typename T> // TexImageSource or WebGLintptr
void TexImage2D(GLenum target, GLint level, GLenum internalFormat,
GLsizei width, GLsizei height, GLint border,
GLenum unpackFormat, GLenum unpackType, const T& anySrc,
ErrorResult& out_error) const {
const TexImageSourceAdapter src(&anySrc, &out_error);
TexImage(2, target, level, internalFormat, {0, 0, 0}, {width, height, 1},
border, {unpackFormat, unpackType}, src);
}
void TexImage2D(GLenum target, GLint level, GLenum internalFormat,
GLsizei width, GLsizei height, GLint border,
GLenum unpackFormat, GLenum unpackType,
const dom::ArrayBufferView& view, GLuint viewElemOffset,
ErrorResult&) const {
const TexImageSourceAdapter src(&view, viewElemOffset);
TexImage(2, target, level, internalFormat, {0, 0, 0}, {width, height, 1},
border, {unpackFormat, unpackType}, src);
}
// -
template <typename T> // TexImageSource or WebGLintptr
void TexSubImage2D(GLenum target, GLint level, GLint xOffset, GLint yOffset,
GLsizei width, GLsizei height, GLenum unpackFormat,
GLenum unpackType, const T& anySrc,
ErrorResult& out_error) const {
const TexImageSourceAdapter src(&anySrc, &out_error);
TexImage(2, target, level, 0, {xOffset, yOffset, 0}, {width, height, 1}, 0,
{unpackFormat, unpackType}, src);
}
void TexSubImage2D(GLenum target, GLint level, GLint xOffset, GLint yOffset,
GLsizei width, GLsizei height, GLenum unpackFormat,
GLenum unpackType, const dom::ArrayBufferView& view,
GLuint viewElemOffset, ErrorResult&) const {
const TexImageSourceAdapter src(&view, viewElemOffset);
TexImage(2, target, level, 0, {xOffset, yOffset, 0}, {width, height, 1}, 0,
{unpackFormat, unpackType}, src);
}
// -
template <typename T> // TexImageSource or WebGLintptr
void TexImage3D(GLenum target, GLint level, GLenum internalFormat,
GLsizei width, GLsizei height, GLsizei depth, GLint border,
GLenum unpackFormat, GLenum unpackType, const T& anySrc,
ErrorResult& out_error) const {
const TexImageSourceAdapter src(&anySrc, &out_error);
TexImage(3, target, level, internalFormat, {0, 0, 0},
{width, height, depth}, border, {unpackFormat, unpackType}, src);
}
void TexImage3D(GLenum target, GLint level, GLenum internalFormat,
GLsizei width, GLsizei height, GLsizei depth, GLint border,
GLenum unpackFormat, GLenum unpackType,
const dom::ArrayBufferView& view, GLuint viewElemOffset,
ErrorResult&) const {
const TexImageSourceAdapter src(&view, viewElemOffset);
TexImage(3, target, level, internalFormat, {0, 0, 0},
{width, height, depth}, border, {unpackFormat, unpackType}, src);
}
// -
template <typename T> // TexImageSource or WebGLintptr
void TexSubImage3D(GLenum target, GLint level, GLint xOffset, GLint yOffset,
GLint zOffset, GLsizei width, GLsizei height,
GLsizei depth, GLenum unpackFormat, GLenum unpackType,
const T& anySrc, ErrorResult& out_error) const {
const TexImageSourceAdapter src(&anySrc, &out_error);
TexImage(3, target, level, 0, {xOffset, yOffset, zOffset},
{width, height, depth}, 0, {unpackFormat, unpackType}, src);
}
void TexSubImage3D(GLenum target, GLint level, GLint xOffset, GLint yOffset,
GLint zOffset, GLsizei width, GLsizei height,
GLsizei depth, GLenum unpackFormat, GLenum unpackType,
const dom::Nullable<dom::ArrayBufferView>& maybeSrcView,
GLuint srcElemOffset, ErrorResult&) const {
const TexImageSourceAdapter src(&maybeSrcView, srcElemOffset);
TexImage(3, target, level, 0, {xOffset, yOffset, zOffset},
{width, height, depth}, 0, {unpackFormat, unpackType}, src);
}
////////////////////////////////////
public:
void CompressedTexImage2D(GLenum target, GLint level, GLenum internalFormat,
GLsizei width, GLsizei height, GLint border,
GLsizei imageSize, WebGLintptr offset) const {
const TexImageSourceAdapter src(&offset);
CompressedTexImage(false, 2, target, level, internalFormat, {0, 0, 0},
{width, height, 1}, border, src, imageSize);
}
void CompressedTexImage2D(GLenum target, GLint level, GLenum internalFormat,
GLsizei width, GLsizei height, GLint border,
const dom::ArrayBufferView& view,
GLuint viewElemOffset = 0,
GLuint viewElemLengthOverride = 0) const {
const TexImageSourceAdapter src(&view, viewElemOffset,
viewElemLengthOverride);
CompressedTexImage(false, 2, target, level, internalFormat, {0, 0, 0},
{width, height, 1}, border, src, 0);
}
// -
void CompressedTexSubImage2D(GLenum target, GLint level, GLint xOffset,
GLint yOffset, GLsizei width, GLsizei height,
GLenum unpackFormat, GLsizei imageSize,
WebGLintptr offset) const {
const TexImageSourceAdapter src(&offset);
CompressedTexImage(true, 2, target, level, unpackFormat,
{xOffset, yOffset, 0}, {width, height, 1}, 0, src,
imageSize);
}
void CompressedTexSubImage2D(GLenum target, GLint level, GLint xOffset,
GLint yOffset, GLsizei width, GLsizei height,
GLenum unpackFormat,
const dom::ArrayBufferView& view,
GLuint viewElemOffset = 0,
GLuint viewElemLengthOverride = 0) const {
const TexImageSourceAdapter src(&view, viewElemOffset,
viewElemLengthOverride);
CompressedTexImage(true, 2, target, level, unpackFormat,
{xOffset, yOffset, 0}, {width, height, 1}, 0, src, 0);
}
// -
void CompressedTexImage3D(GLenum target, GLint level, GLenum internalFormat,
GLsizei width, GLsizei height, GLsizei depth,
GLint border, GLsizei imageSize,
WebGLintptr offset) const {
const TexImageSourceAdapter src(&offset);
CompressedTexImage(false, 3, target, level, internalFormat, {0, 0, 0},
{width, height, depth}, border, src, imageSize);
}
void CompressedTexImage3D(GLenum target, GLint level, GLenum internalFormat,
GLsizei width, GLsizei height, GLsizei depth,
GLint border, const dom::ArrayBufferView& view,
GLuint viewElemOffset = 0,
GLuint viewElemLengthOverride = 0) const {
const TexImageSourceAdapter src(&view, viewElemOffset,
viewElemLengthOverride);
CompressedTexImage(false, 3, target, level, internalFormat, {0, 0, 0},
{width, height, depth}, border, src, 0);
}
// -
void CompressedTexSubImage3D(GLenum target, GLint level, GLint xOffset,
GLint yOffset, GLint zOffset, GLsizei width,
GLsizei height, GLsizei depth,
GLenum unpackFormat, GLsizei imageSize,
WebGLintptr offset) const {
const TexImageSourceAdapter src(&offset);
CompressedTexImage(true, 3, target, level, unpackFormat,
{xOffset, yOffset, zOffset}, {width, height, depth}, 0,
src, imageSize);
}
void CompressedTexSubImage3D(GLenum target, GLint level, GLint xOffset,
GLint yOffset, GLint zOffset, GLsizei width,
GLsizei height, GLsizei depth,
GLenum unpackFormat,
const dom::ArrayBufferView& view,
GLuint viewElemOffset = 0,
GLuint viewElemLengthOverride = 0) const {
const TexImageSourceAdapter src(&view, viewElemOffset,
viewElemLengthOverride);
CompressedTexImage(true, 3, target, level, unpackFormat,
{xOffset, yOffset, zOffset}, {width, height, depth}, 0,
src, 0);
}
// --------------------
void CopyTexImage2D(GLenum target, GLint level, GLenum internalFormat,
GLint x, GLint y, GLsizei width, GLsizei height,
GLint border) const {
CopyTexImage(2, target, level, internalFormat, {0, 0, 0}, {x, y},
{width, height}, border);
}
void CopyTexSubImage2D(GLenum target, GLint level, GLint xOffset,
GLint yOffset, GLint x, GLint y, GLsizei width,
GLsizei height) const {
CopyTexImage(2, target, level, 0, {xOffset, yOffset, 0}, {x, y},
{width, height}, 0);
}
void CopyTexSubImage3D(GLenum target, GLint level, GLint xOffset,
GLint yOffset, GLint zOffset, GLint x, GLint y,
GLsizei width, GLsizei height) const {
CopyTexImage(3, target, level, 0, {xOffset, yOffset, zOffset}, {x, y},
{width, height}, 0);
}
// -------------------
// Forward legacy TexImageSource uploads for default width/height
template <typename TexImageSourceT>
void TexImage2D(GLenum target, GLint level, GLenum internalFormat,
GLenum unpackFormat, GLenum unpackType,
const TexImageSourceT& anySrc, ErrorResult& out_error) const {
TexImage2D(target, level, internalFormat, 0, 0, 0, unpackFormat, unpackType,
anySrc, out_error);
}
template <typename TexImageSourceT>
void TexSubImage2D(GLenum target, GLint level, GLint xOffset, GLint yOffset,
GLenum unpackFormat, GLenum unpackType,
const TexImageSourceT& anySrc,
ErrorResult& out_error) const {
TexSubImage2D(target, level, xOffset, yOffset, 0, 0, unpackFormat,
unpackType, anySrc, out_error);
}
// =========================================================================
// ------------------------ Uniforms and attributes ------------------------
public:
void GetVertexAttrib(JSContext* cx, GLuint index, GLenum pname,
JS::MutableHandle<JS::Value> retval, ErrorResult& rv);
private:
const webgl::LinkResult* GetActiveLinkResult() const {
const auto& state = State();
if (state.mCurrentProgram) {
(void)GetLinkResult(*state.mCurrentProgram);
}
return state.mActiveLinkResult.get();
}
void UniformData(GLenum funcElemType, const WebGLUniformLocationJS* const loc,
bool transpose, const Range<const uint8_t>& bytes,
GLuint elemOffset = 0, GLuint elemCountOverride = 0) const;
// -
template <typename T>
Maybe<Range<T>> ValidateSubrange(const Range<T>& data, size_t elemOffset,
size_t elemLengthOverride = 0) const {
auto ret = data;
if (elemOffset > ret.length()) {
EnqueueError(LOCAL_GL_INVALID_VALUE,
"`elemOffset` too large for `data`.");
return {};
}
ret = {ret.begin() + elemOffset, ret.end()};
if (elemLengthOverride) {
if (elemLengthOverride > ret.length()) {
EnqueueError(
LOCAL_GL_INVALID_VALUE,
"`elemLengthOverride` too large for `data` and `elemOffset`.");
return {};
}
ret = {ret.begin().get(), elemLengthOverride};
}
return Some(ret);
}
public:
#define _(T, type_t, TYPE) \
void Uniform1##T(const WebGLUniformLocationJS* const loc, type_t x) const { \
const type_t arr[] = {x}; \
UniformData(TYPE, loc, false, MakeByteRange(arr)); \
} \
void Uniform2##T(const WebGLUniformLocationJS* const loc, type_t x, \
type_t y) const { \
const type_t arr[] = {x, y}; \
UniformData(TYPE##_VEC2, loc, false, MakeByteRange(arr)); \
} \
void Uniform3##T(const WebGLUniformLocationJS* const loc, type_t x, \
type_t y, type_t z) const { \
const type_t arr[] = {x, y, z}; \
UniformData(TYPE##_VEC3, loc, false, MakeByteRange(arr)); \
} \
void Uniform4##T(const WebGLUniformLocationJS* const loc, type_t x, \
type_t y, type_t z, type_t w) const { \
const type_t arr[] = {x, y, z, w}; \
UniformData(TYPE##_VEC4, loc, false, MakeByteRange(arr)); \
}
_(f, float, LOCAL_GL_FLOAT)
_(i, int32_t, LOCAL_GL_INT)
_(ui, uint32_t, LOCAL_GL_UNSIGNED_INT)
#undef _
// -
#define _(NT, TypeListU, TYPE) \
void Uniform##NT##v(const WebGLUniformLocationJS* const loc, \
const TypeListU& list, GLuint elemOffset = 0, \
GLuint elemCountOverride = 0) const { \
UniformData(TYPE, loc, false, MakeByteRange(list), elemOffset, \
elemCountOverride); \
}
_(1f, Float32ListU, LOCAL_GL_FLOAT)
_(2f, Float32ListU, LOCAL_GL_FLOAT_VEC2)
_(3f, Float32ListU, LOCAL_GL_FLOAT_VEC3)
_(4f, Float32ListU, LOCAL_GL_FLOAT_VEC4)
_(1i, Int32ListU, LOCAL_GL_INT)
_(2i, Int32ListU, LOCAL_GL_INT_VEC2)
_(3i, Int32ListU, LOCAL_GL_INT_VEC3)
_(4i, Int32ListU, LOCAL_GL_INT_VEC4)
_(1ui, Uint32ListU, LOCAL_GL_UNSIGNED_INT)
_(2ui, Uint32ListU, LOCAL_GL_UNSIGNED_INT_VEC2)
_(3ui, Uint32ListU, LOCAL_GL_UNSIGNED_INT_VEC3)
_(4ui, Uint32ListU, LOCAL_GL_UNSIGNED_INT_VEC4)
#undef _
// -
#define _(X) \
void UniformMatrix##X##fv(const WebGLUniformLocationJS* loc, bool transpose, \
const Float32ListU& list, GLuint elemOffset = 0, \
GLuint elemCountOverride = 0) const { \
UniformData(LOCAL_GL_FLOAT_MAT##X, loc, transpose, MakeByteRange(list), \
elemOffset, elemCountOverride); \
}
_(2)
_(2x3)
_(2x4)
_(3x2)
_(3)
_(3x4)
_(4x2)
_(4x3)
_(4)
#undef _
// -
void EnableVertexAttribArray(GLuint index);
void DisableVertexAttribArray(GLuint index);
WebGLsizeiptr GetVertexAttribOffset(GLuint index, GLenum pname);
// -
private:
void VertexAttrib4Tv(GLuint index, webgl::AttribBaseType,
const Range<const uint8_t>&);
public:
void VertexAttrib1f(GLuint index, GLfloat x) {
VertexAttrib4f(index, x, 0, 0, 1);
}
void VertexAttrib2f(GLuint index, GLfloat x, GLfloat y) {
VertexAttrib4f(index, x, y, 0, 1);
}
void VertexAttrib3f(GLuint index, GLfloat x, GLfloat y, GLfloat z) {
VertexAttrib4f(index, x, y, z, 1);
}
void VertexAttrib4f(GLuint index, GLfloat x, GLfloat y, GLfloat z,
GLfloat w) {
const float arr[4] = {x, y, z, w};
VertexAttrib4Tv(index, webgl::AttribBaseType::Float, MakeByteRange(arr));
}
// -
void VertexAttrib1fv(const GLuint index, const Float32ListU& list) {
const FuncScope funcScope(*this, "vertexAttrib1fv");
if (IsContextLost()) return;
const auto range = MakeRange(list);
if (range.length() < 1) {
EnqueueError(LOCAL_GL_INVALID_VALUE, "Length of `list` must be >=1.");
return;
}
VertexAttrib1f(index, range[0]);
}
void VertexAttrib2fv(const GLuint index, const Float32ListU& list) {
const FuncScope funcScope(*this, "vertexAttrib1fv");
if (IsContextLost()) return;
const auto range = MakeRange(list);
if (range.length() < 2) {
EnqueueError(LOCAL_GL_INVALID_VALUE, "Length of `list` must be >=2.");
return;
}
VertexAttrib2f(index, range[0], range[1]);
}
void VertexAttrib3fv(const GLuint index, const Float32ListU& list) {
const FuncScope funcScope(*this, "vertexAttrib1fv");
if (IsContextLost()) return;
const auto range = MakeRange(list);
if (range.length() < 3) {
EnqueueError(LOCAL_GL_INVALID_VALUE, "Length of `list` must be >=3.");
return;
}
VertexAttrib3f(index, range[0], range[1], range[2]);
}
void VertexAttrib4fv(GLuint index, const Float32ListU& list) {
VertexAttrib4Tv(index, webgl::AttribBaseType::Float, MakeByteRange(list));
}
void VertexAttribI4iv(GLuint index, const Int32ListU& list) {
VertexAttrib4Tv(index, webgl::AttribBaseType::Int, MakeByteRange(list));
}
void VertexAttribI4uiv(GLuint index, const Uint32ListU& list) {
VertexAttrib4Tv(index, webgl::AttribBaseType::Uint, MakeByteRange(list));
}
void VertexAttribI4i(GLuint index, GLint x, GLint y, GLint z, GLint w) {
const int32_t arr[4] = {x, y, z, w};
VertexAttrib4Tv(index, webgl::AttribBaseType::Int, MakeByteRange(arr));
}
void VertexAttribI4ui(GLuint index, GLuint x, GLuint y, GLuint z, GLuint w) {
const uint32_t arr[4] = {x, y, z, w};
VertexAttrib4Tv(index, webgl::AttribBaseType::Uint, MakeByteRange(arr));
}
private:
void VertexAttribPointerImpl(bool isFuncInt, GLuint index, GLint size,
GLenum type, WebGLboolean normalized,
GLsizei iStride, WebGLintptr iByteOffset);
public:
void VertexAttribIPointer(GLuint index, GLint size, GLenum type,
GLsizei stride, WebGLintptr byteOffset) {
VertexAttribPointerImpl(true, index, size, type, false, stride, byteOffset);
}
void VertexAttribPointer(GLuint index, GLint size, GLenum type,
WebGLboolean normalized, GLsizei stride,
WebGLintptr byteOffset) {
VertexAttribPointerImpl(false, index, size, type, normalized, stride,
byteOffset);
}
// -------------------------------- Drawing -------------------------------
public:
void DrawArrays(GLenum mode, GLint first, GLsizei count) {
DrawArraysInstanced(mode, first, count, 1, FuncScopeId::drawArrays);
}
void DrawElements(GLenum mode, GLsizei count, GLenum type,
WebGLintptr byteOffset) {
DrawElementsInstanced(mode, count, type, byteOffset, 1,
FuncScopeId::drawElements);
}
void DrawRangeElements(GLenum mode, GLuint start, GLuint end, GLsizei count,
GLenum type, WebGLintptr byteOffset) {
const FuncScope funcScope(*this, "drawRangeElements");
if (end < start) {
EnqueueError(LOCAL_GL_INVALID_VALUE, "end must be >= start.");
return;
}
DrawElementsInstanced(mode, count, type, byteOffset, 1,
FuncScopeId::drawRangeElements);
}
// ------------------------------ Readback -------------------------------
public:
void ReadPixels(GLint x, GLint y, GLsizei width, GLsizei height,
GLenum format, GLenum type,
const dom::Nullable<dom::ArrayBufferView>& maybeView,
dom::CallerType aCallerType, ErrorResult& out_error) const {
const FuncScope funcScope(*this, "readPixels");
if (!ValidateNonNull("pixels", maybeView)) return;
ReadPixels(x, y, width, height, format, type, maybeView.Value(), 0,
aCallerType, out_error);
}
void ReadPixels(GLint x, GLint y, GLsizei width, GLsizei height,
GLenum format, GLenum type, WebGLsizeiptr offset,
dom::CallerType aCallerType, ErrorResult& out_error) const;
void ReadPixels(GLint x, GLint y, GLsizei width, GLsizei height,
GLenum format, GLenum type,
const dom::ArrayBufferView& dstData, GLuint dstElemOffset,
dom::CallerType aCallerType, ErrorResult& out_error) const;
protected:
bool ReadPixels_SharedPrecheck(dom::CallerType aCallerType,
ErrorResult& out_error) const;
// ------------------------------ Vertex Array ------------------------------
public:
void BindVertexArray(WebGLVertexArrayJS*);
void DrawArraysInstanced(GLenum mode, GLint first, GLsizei count,
GLsizei primcount,
FuncScopeId aFuncId = FuncScopeId::drawArrays);
void DrawElementsInstanced(
GLenum mode, GLsizei count, GLenum type, WebGLintptr offset,
GLsizei primcount,
FuncScopeId aFuncId = FuncScopeId::drawElementsInstanced);
void VertexAttribDivisor(GLuint index, GLuint divisor);
// --------------------------------- GL Query
// ---------------------------------
public:
void GetQuery(JSContext*, GLenum target, GLenum pname,
JS::MutableHandleValue retval) const;
void GetQueryParameter(JSContext*, WebGLQueryJS&, GLenum pname,
JS::MutableHandleValue retval) const;
void BeginQuery(GLenum target, WebGLQueryJS&);
void EndQuery(GLenum target);
void QueryCounter(WebGLQueryJS&, GLenum target) const;
// -------------------------------- Sampler -------------------------------
void GetSamplerParameter(JSContext*, const WebGLSamplerJS&, GLenum pname,
JS::MutableHandleValue retval) const;
void BindSampler(GLuint unit, WebGLSamplerJS*);
void SamplerParameteri(WebGLSamplerJS&, GLenum pname, GLint param) const;
void SamplerParameterf(WebGLSamplerJS&, GLenum pname, GLfloat param) const;
// ------------------------------- GL Sync ---------------------------------
GLenum ClientWaitSync(WebGLSyncJS&, GLbitfield flags, GLuint64 timeout) const;
void GetSyncParameter(JSContext*, WebGLSyncJS&, GLenum pname,
JS::MutableHandleValue retval) const;
void WaitSync(const WebGLSyncJS&, GLbitfield flags, GLint64 timeout) const;
// -------------------------- Transform Feedback ---------------------------
void BindTransformFeedback(GLenum target, WebGLTransformFeedbackJS*);
void BeginTransformFeedback(GLenum primitiveMode);
void EndTransformFeedback();
void PauseTransformFeedback();
void ResumeTransformFeedback();
// -------------------------- Opaque Framebuffers ---------------------------
void SetFramebufferIsInOpaqueRAF(WebGLFramebufferJS*, bool);
// ------------------------------ Extensions ------------------------------
public:
void GetSupportedExtensions(dom::Nullable<nsTArray<nsString>>& retval,
dom::CallerType callerType) const;
bool IsSupported(WebGLExtensionID, dom::CallerType callerType =
dom::CallerType::NonSystem) const;
void GetExtension(JSContext* cx, const nsAString& name,
JS::MutableHandle<JSObject*> retval,
dom::CallerType callerType, ErrorResult& rv);
protected:
RefPtr<ClientWebGLExtensionBase> GetExtension(WebGLExtensionID ext,
dom::CallerType callerType);
void RequestExtension(WebGLExtensionID) const;
public:
bool IsExtensionEnabled(const WebGLExtensionID id) const {
return bool(mNotLost->extensions[EnumValue(id)]);
}
void AddCompressedFormat(GLenum);
// ---------------------------- Misc Extensions ----------------------------
public:
void DrawBuffers(const dom::Sequence<GLenum>& buffers);
void GetSupportedProfilesASTC(
dom::Nullable<nsTArray<nsString>>& retval) const;
void MOZDebugGetParameter(JSContext* cx, GLenum pname,
JS::MutableHandle<JS::Value> retval,
ErrorResult& rv) {
GetParameter(cx, pname, retval, rv, true);
}
// -------------------------------------------------------------------------
// Client-side methods. Calls in the Host are forwarded to the client.
// -------------------------------------------------------------------------
public:
void JsWarning(const std::string&) const;
// -------------------------------------------------------------------------
// The cross-process communication mechanism
// -------------------------------------------------------------------------
protected:
/*
template <size_t command, typename... Args>
void DispatchAsync(Args&&... aArgs) const {
const auto& oop = *mNotLost->outOfProcess;
QueueStatus status = oop.mCommandSource->RunAsyncCommand(command,
aArgs...);
if (!IsSuccess(status)) { if (status == QueueStatus::kOOMError) {
JsWarning("Ran out-of-memory during WebGL IPC.");
}
// Not much to do but shut down. Since this was a Pcq failure and
// may have been catastrophic, we don't try to revive it. Make sure to
// post "webglcontextlost"
MOZ_ASSERT_UNREACHABLE(
"TODO: Make this shut down the context, actors, everything.");
}
}
template <size_t command, typename ReturnType, typename... Args>
ReturnType DispatchSync(Args&&... aArgs) const {
const auto& oop = *mNotLost->outOfProcess;
ReturnType returnValue;
QueueStatus status =
oop.mCommandSource->RunSyncCommand(command, returnValue, aArgs...);
if (!IsSuccess(status)) {
if (status == QueueStatus::kOOMError) {
JsWarning("Ran out-of-memory during WebGL IPC.");
}
// Not much to do but shut down. Since this was a Pcq failure and
// may have been catastrophic, we don't try to revive it. Make sure to
// post "webglcontextlost"
MOZ_ASSERT_UNREACHABLE(
"TODO: Make this shut down the context, actors, everything.");
}
return returnValue;
}
template <size_t command, typename... Args>
void DispatchVoidSync(Args&&... aArgs) const {
const auto& oop = *mNotLost->outOfProcess;
const auto status =
oop.mCommandSource->RunVoidSyncCommand(command, aArgs...);
if (!IsSuccess(status)) {
if (status == QueueStatus::kOOMError) {
JsWarning("Ran out-of-memory during WebGL IPC.");
}
// Not much to do but shut down. Since this was a Pcq failure and
// may have been catastrophic, we don't try to revive it. Make sure to
// post "webglcontextlost"
MOZ_ASSERT_UNREACHABLE(
"TODO: Make this shut down the context, actors, everything.");
}
}
*/
template <typename ReturnType>
friend struct WebGLClientDispatcher;
template <typename MethodType, MethodType method, typename ReturnType,
typename... Args>
friend ReturnType RunOn(const ClientWebGLContext& context, Args&&... aArgs);
// If we are running WebGL in this process then call the HostWebGLContext
// method directly. Otherwise, dispatch over IPC.
// template <typename MethodType, MethodType method,
// typename ReturnType = typename
// FunctionTypeTraits<MethodType>::ReturnType, size_t Id =
// WebGLMethodDispatcher::Id<MethodType, method>(), typename... Args>
// ReturnType Run(Args&&... aArgs) const;
template <
typename MethodType, MethodType method,
typename ReturnType = typename FunctionTypeTraits<MethodType>::ReturnType,
typename... Args>
ReturnType Run(Args&&... aArgs) const;
// -------------------------------------------------------------------------
// Helpers for DOM operations, composition, actors, etc
// -------------------------------------------------------------------------
public:
WebGLPixelStore GetPixelStore() { return mPixelStore; }
const WebGLPixelStore GetPixelStore() const { return mPixelStore; }
// https://immersive-web.github.io/webxr/#xr-compatible
bool IsXRCompatible() const;
already_AddRefed<dom::Promise> MakeXRCompatible(ErrorResult& aRv);
protected:
bool ShouldResistFingerprinting() const;
// Prepare the context for capture before compositing
void BeginComposition();
// Clean up the context after captured for compositing
void EndComposition();
mozilla::dom::Document* GetOwnerDoc() const;
bool mResetLayer = true;
Maybe<const WebGLContextOptions> mInitialOptions;
WebGLPixelStore mPixelStore;
};
// used by DOM bindings in conjunction with GetParentObject
inline nsISupports* ToSupports(ClientWebGLContext* webgl) {
return static_cast<nsICanvasRenderingContextInternal*>(webgl);
}
const char* GetExtensionName(WebGLExtensionID);
// -
inline bool webgl::ObjectJS::IsForContext(
const ClientWebGLContext& context) const {
const auto& notLost = context.mNotLost;
if (!notLost) return false;
if (notLost.get() != mGeneration.lock().get()) return false;
return true;
}
void AutoJsWarning(const std::string& utf8);
} // namespace mozilla
#endif // CLIENTWEBGLCONTEXT_H_