/* * Copyright (c) 2020-2022, Andreas Kling * Copyright (c) 2021-2022, Linus Groh * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace Web::HTML { // https://html.spec.whatwg.org/multipage/canvas.html#canvasimagesource // NOTE: This is the Variant created by the IDL wrapper generator, and needs to be updated accordingly. using CanvasImageSource = Variant, JS::Handle>; class CanvasRenderingContext2D : public Bindings::PlatformObject , public CanvasPath , public CanvasState , public CanvasTransform , public CanvasFillStrokeStyles , public CanvasRect , public CanvasDrawPath , public CanvasText , public CanvasDrawImage , public CanvasImageData , public CanvasImageSmoothing , public CanvasPathDrawingStyles { WEB_PLATFORM_OBJECT(CanvasRenderingContext2D, Bindings::PlatformObject); public: static WebIDL::ExceptionOr> create(JS::Realm&, HTMLCanvasElement&); virtual ~CanvasRenderingContext2D() override; virtual void fill_rect(float x, float y, float width, float height) override; virtual void stroke_rect(float x, float y, float width, float height) override; virtual void clear_rect(float x, float y, float width, float height) override; virtual WebIDL::ExceptionOr draw_image_internal(CanvasImageSource const&, float source_x, float source_y, float source_width, float source_height, float destination_x, float destination_y, float destination_width, float destination_height) override; virtual void begin_path() override; virtual void stroke() override; virtual void stroke(Path2D const& path) override; virtual void fill_text(DeprecatedString const&, float x, float y, Optional max_width) override; virtual void stroke_text(DeprecatedString const&, float x, float y, Optional max_width) override; virtual void fill(DeprecatedString const& fill_rule) override; virtual void fill(Path2D& path, DeprecatedString const& fill_rule) override; virtual JS::GCPtr create_image_data(int width, int height) const override; virtual WebIDL::ExceptionOr> get_image_data(int x, int y, int width, int height) const override; virtual void put_image_data(ImageData const&, float x, float y) override; virtual void reset_to_default_state() override; JS::NonnullGCPtr canvas_for_binding() const; virtual JS::NonnullGCPtr measure_text(DeprecatedString const& text) override; virtual void clip(DeprecatedString const& fill_rule) override; virtual void clip(Path2D& path, DeprecatedString const& fill_rule) override; virtual bool image_smoothing_enabled() const override; virtual void set_image_smoothing_enabled(bool) override; virtual Bindings::ImageSmoothingQuality image_smoothing_quality() const override; virtual void set_image_smoothing_quality(Bindings::ImageSmoothingQuality) override; private: explicit CanvasRenderingContext2D(JS::Realm&, HTMLCanvasElement&); virtual JS::ThrowCompletionOr initialize(JS::Realm&) override; virtual void visit_edges(Cell::Visitor&) override; struct PreparedTextGlyph { String glyph; Gfx::IntPoint position; }; struct PreparedText { Vector glyphs; Gfx::TextAlignment physical_alignment; Gfx::IntRect bounding_box; }; void did_draw(Gfx::FloatRect const&); template void draw_clipped(TDrawFunction draw_function) { auto painter = this->antialiased_painter(); if (!painter.has_value()) return; ScopedCanvasPathClip clipper(painter->underlying_painter(), drawing_state().clip); auto draw_rect = draw_function(*painter); if (drawing_state().clip.has_value()) draw_rect.intersect(drawing_state().clip->path.bounding_box()); did_draw(draw_rect); } PreparedText prepare_text(DeprecatedString const& text, float max_width = INFINITY); Gfx::Painter* painter(); Optional antialiased_painter(); HTMLCanvasElement& canvas_element(); HTMLCanvasElement const& canvas_element() const; void stroke_internal(Gfx::Path const&); void fill_internal(Gfx::Path&, StringView fill_rule); void clip_internal(Gfx::Path&, StringView fill_rule); JS::NonnullGCPtr m_element; OwnPtr m_painter; // https://html.spec.whatwg.org/multipage/canvas.html#concept-canvas-origin-clean bool m_origin_clean { true }; }; enum class CanvasImageSourceUsability { Bad, Good, }; WebIDL::ExceptionOr check_usability_of_image(CanvasImageSource const&); bool image_is_not_origin_clean(CanvasImageSource const&); }