servo/components/script/dom/webgl_extensions/extension.rs

/* 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 https://mozilla.org/MPL/2.0/. */

use canvas_traits::webgl::WebGLVersion;

use super::WebGLExtensions;
use crate::dom::bindings::reflector::DomObject;
use crate::dom::bindings::root::DomRoot;
use crate::dom::bindings::trace::JSTraceable;
use crate::dom::webglrenderingcontext::WebGLRenderingContext;

/// Trait implemented by WebGL extensions.
pub trait WebGLExtension: Sized
where
    Self::Extension: DomObject + JSTraceable,
{
    #[crown::unrooted_must_root_lint::must_root]
    type Extension;

    /// Creates the DOM object of the WebGL extension.
    fn new(ctx: &WebGLRenderingContext) -> DomRoot<Self::Extension>;

    /// Returns which WebGL spec is this extension written against.
    fn spec() -> WebGLExtensionSpec;

    /// Checks if the extension is supported.
    fn is_supported(ext: &WebGLExtensions) -> bool;

    /// Enable the extension.
    fn enable(ext: &WebGLExtensions);

    /// Name of the WebGL Extension.
    fn name() -> &'static str;
}

pub enum WebGLExtensionSpec {
    /// Extensions written against both WebGL and WebGL2 specs.
    All,
    /// Extensions writen against a specific WebGL version spec.
    Specific(WebGLVersion),
}