/* * 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 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, NonnullRefPtr>; class CanvasRenderingContext2D : public RefCountForwarder , public Bindings::Wrappable , public CanvasPath { AK_MAKE_NONCOPYABLE(CanvasRenderingContext2D); AK_MAKE_NONMOVABLE(CanvasRenderingContext2D); public: using WrapperType = Bindings::CanvasRenderingContext2DWrapper; static NonnullRefPtr create(HTMLCanvasElement& element) { return adopt_ref(*new CanvasRenderingContext2D(element)); } ~CanvasRenderingContext2D(); void set_fill_style(String); String fill_style() const; void set_stroke_style(String); String stroke_style() const; void fill_rect(float x, float y, float width, float height); void stroke_rect(float x, float y, float width, float height); void clear_rect(float x, float y, float width, float height); DOM::ExceptionOr draw_image(CanvasImageSource const&, float destination_x, float destination_y); DOM::ExceptionOr draw_image(CanvasImageSource const&, float destination_x, float destination_y, float destination_width, float destination_height); DOM::ExceptionOr draw_image(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); void scale(float sx, float sy); void translate(float x, float y); void rotate(float degrees); void set_line_width(float line_width) { m_drawing_state.line_width = line_width; } float line_width() const { return m_drawing_state.line_width; } void begin_path(); void stroke(); void fill_text(String const&, float x, float y, Optional max_width); void stroke_text(String const&, float x, float y, Optional max_width); // FIXME: We should only have one fill(), really. Fix the wrapper generator! void fill(Gfx::Painter::WindingRule); void fill(String const& fill_rule); RefPtr create_image_data(int width, int height) const; DOM::ExceptionOr> get_image_data(int x, int y, int width, int height) const; void put_image_data(ImageData const&, float x, float y); void save(); void restore(); void reset(); bool is_context_lost(); void reset_to_default_state(); NonnullRefPtr canvas_for_binding() const; RefPtr measure_text(String const& text); NonnullRefPtr create_radial_gradient(double x0, double y0, double r0, double x1, double y1, double r1); NonnullRefPtr create_linear_gradient(double x0, double y0, double x1, double y1); NonnullRefPtr create_conic_gradient(double start_angle, double x, double y); void transform(double a, double b, double c, double d, double e, double f); void set_transform(double a, double b, double c, double d, double e, double f); void reset_transform(); void clip(); private: explicit CanvasRenderingContext2D(HTMLCanvasElement&); struct PreparedTextGlyph { unsigned int c; Gfx::IntPoint position; }; struct PreparedText { Vector glyphs; Gfx::TextAlignment physical_alignment; Gfx::IntRect bounding_box; }; void did_draw(Gfx::FloatRect const&); PreparedText prepare_text(String const& text, float max_width = INFINITY); OwnPtr painter(); HTMLCanvasElement& canvas_element(); HTMLCanvasElement const& canvas_element() const; // https://html.spec.whatwg.org/multipage/canvas.html#drawing-state struct DrawingState { Gfx::AffineTransform transform; Gfx::Color fill_style { Gfx::Color::Black }; Gfx::Color stroke_style { Gfx::Color::Black }; float line_width { 1 }; }; DrawingState m_drawing_state; Vector m_drawing_state_stack; // https://html.spec.whatwg.org/multipage/canvas.html#concept-canvas-origin-clean bool m_origin_clean { true }; // https://html.spec.whatwg.org/multipage/canvas.html#concept-canvas-context-lost bool m_context_lost { false }; }; enum class CanvasImageSourceUsability { Bad, Good, }; DOM::ExceptionOr check_usability_of_image(CanvasImageSource const&); bool image_is_not_origin_clean(CanvasImageSource const&); }