2020-04-06 12:09:01 +03:00
|
|
|
/*
|
2022-02-03 22:01:19 +03:00
|
|
|
* Copyright (c) 2020-2022, Andreas Kling <kling@serenityos.org>
|
2022-03-04 21:02:10 +03:00
|
|
|
* Copyright (c) 2021-2022, Linus Groh <linusg@serenityos.org>
|
2020-04-06 12:09:01 +03:00
|
|
|
*
|
2021-04-22 11:24:48 +03:00
|
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
2020-04-06 12:09:01 +03:00
|
|
|
*/
|
|
|
|
|
2020-03-19 21:07:56 +03:00
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <AK/RefCounted.h>
|
2022-03-04 21:02:10 +03:00
|
|
|
#include <AK/Variant.h>
|
2020-04-12 20:22:42 +03:00
|
|
|
#include <LibGfx/AffineTransform.h>
|
2020-03-19 21:07:56 +03:00
|
|
|
#include <LibGfx/Color.h>
|
|
|
|
#include <LibGfx/Forward.h>
|
2020-05-06 10:26:47 +03:00
|
|
|
#include <LibGfx/Painter.h>
|
2020-04-16 22:06:03 +03:00
|
|
|
#include <LibGfx/Path.h>
|
2020-03-19 21:07:56 +03:00
|
|
|
#include <LibWeb/Bindings/Wrappable.h>
|
2021-04-14 23:29:14 +03:00
|
|
|
#include <LibWeb/DOM/ExceptionOr.h>
|
2022-02-03 22:08:27 +03:00
|
|
|
#include <LibWeb/HTML/CanvasGradient.h>
|
2021-12-31 01:15:38 +03:00
|
|
|
#include <LibWeb/Layout/InlineNode.h>
|
|
|
|
#include <LibWeb/Layout/LineBox.h>
|
2020-03-19 21:07:56 +03:00
|
|
|
|
2020-07-28 19:20:36 +03:00
|
|
|
namespace Web::HTML {
|
2020-03-19 21:07:56 +03:00
|
|
|
|
2022-03-04 21:02:10 +03:00
|
|
|
// 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<HTMLImageElement>, NonnullRefPtr<HTMLCanvasElement>>;
|
|
|
|
|
2020-03-19 21:07:56 +03:00
|
|
|
class CanvasRenderingContext2D
|
|
|
|
: public RefCounted<CanvasRenderingContext2D>
|
|
|
|
, public Bindings::Wrappable {
|
|
|
|
|
|
|
|
AK_MAKE_NONCOPYABLE(CanvasRenderingContext2D);
|
|
|
|
AK_MAKE_NONMOVABLE(CanvasRenderingContext2D);
|
|
|
|
|
|
|
|
public:
|
|
|
|
using WrapperType = Bindings::CanvasRenderingContext2DWrapper;
|
|
|
|
|
2021-04-23 17:46:57 +03:00
|
|
|
static NonnullRefPtr<CanvasRenderingContext2D> create(HTMLCanvasElement& element) { return adopt_ref(*new CanvasRenderingContext2D(element)); }
|
2020-03-19 21:07:56 +03:00
|
|
|
~CanvasRenderingContext2D();
|
|
|
|
|
|
|
|
void set_fill_style(String);
|
|
|
|
String fill_style() const;
|
|
|
|
|
2020-04-07 11:09:17 +03:00
|
|
|
void set_stroke_style(String);
|
|
|
|
String stroke_style() const;
|
|
|
|
|
2020-04-08 12:22:40 +03:00
|
|
|
void fill_rect(float x, float y, float width, float height);
|
|
|
|
void stroke_rect(float x, float y, float width, float height);
|
2021-03-15 21:40:42 +03:00
|
|
|
void clear_rect(float x, float y, float width, float height);
|
2020-04-14 21:38:44 +03:00
|
|
|
|
2022-03-05 21:54:22 +03:00
|
|
|
DOM::ExceptionOr<void> draw_image(CanvasImageSource const&, float destination_x, float destination_y);
|
|
|
|
DOM::ExceptionOr<void> draw_image(CanvasImageSource const&, float destination_x, float destination_y, float destination_width, float destination_height);
|
|
|
|
DOM::ExceptionOr<void> 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);
|
2020-04-14 21:38:44 +03:00
|
|
|
|
2020-04-08 12:22:40 +03:00
|
|
|
void scale(float sx, float sy);
|
|
|
|
void translate(float x, float y);
|
2020-06-26 19:26:18 +03:00
|
|
|
void rotate(float degrees);
|
2020-03-19 21:07:56 +03:00
|
|
|
|
2021-12-27 16:30:08 +03:00
|
|
|
void set_line_width(float line_width) { m_drawing_state.line_width = line_width; }
|
|
|
|
float line_width() const { return m_drawing_state.line_width; }
|
2020-04-16 22:06:03 +03:00
|
|
|
|
|
|
|
void begin_path();
|
|
|
|
void close_path();
|
|
|
|
void move_to(float x, float y);
|
|
|
|
void line_to(float x, float y);
|
2020-05-05 05:24:26 +03:00
|
|
|
void quadratic_curve_to(float cx, float cy, float x, float y);
|
2022-02-03 22:01:19 +03:00
|
|
|
void bezier_curve_to(double cp1x, double cp1y, double cp2x, double cp2y, double x, double y);
|
2021-04-15 17:11:13 +03:00
|
|
|
|
2021-04-15 20:38:43 +03:00
|
|
|
DOM::ExceptionOr<void> arc(float x, float y, float radius, float start_angle, float end_angle, bool counter_clockwise);
|
|
|
|
DOM::ExceptionOr<void> ellipse(float x, float y, float radius_x, float radius_y, float rotation, float start_angle, float end_angle, bool counter_clockwise);
|
2021-04-14 23:29:14 +03:00
|
|
|
void rect(float x, float y, float width, float height);
|
2020-04-16 22:06:03 +03:00
|
|
|
void stroke();
|
2020-06-22 19:39:22 +03:00
|
|
|
|
2021-04-15 20:36:10 +03:00
|
|
|
void fill_text(const String&, float x, float y, Optional<double> max_width);
|
2022-02-03 22:09:57 +03:00
|
|
|
void stroke_text(String const&, float x, float y, Optional<double> max_width);
|
2021-04-15 20:36:10 +03:00
|
|
|
|
2020-06-22 19:39:22 +03:00
|
|
|
// FIXME: We should only have one fill(), really. Fix the wrapper generator!
|
2020-05-06 10:26:47 +03:00
|
|
|
void fill(Gfx::Painter::WindingRule);
|
2020-06-22 19:39:22 +03:00
|
|
|
void fill(const String& fill_rule);
|
2020-04-16 22:06:03 +03:00
|
|
|
|
2020-06-22 19:39:22 +03:00
|
|
|
RefPtr<ImageData> create_image_data(int width, int height) const;
|
2022-03-04 21:07:35 +03:00
|
|
|
DOM::ExceptionOr<RefPtr<ImageData>> get_image_data(int x, int y, int width, int height) const;
|
2020-04-22 00:49:51 +03:00
|
|
|
void put_image_data(const ImageData&, float x, float y);
|
|
|
|
|
2021-12-27 16:31:23 +03:00
|
|
|
void save();
|
2021-12-27 16:32:31 +03:00
|
|
|
void restore();
|
2021-12-27 16:33:36 +03:00
|
|
|
void reset();
|
2021-12-27 16:35:38 +03:00
|
|
|
bool is_context_lost();
|
2021-12-27 16:33:36 +03:00
|
|
|
|
|
|
|
void reset_to_default_state();
|
2021-12-27 16:31:23 +03:00
|
|
|
|
2020-06-22 19:39:22 +03:00
|
|
|
HTMLCanvasElement* canvas() { return m_element; }
|
2020-05-21 02:09:31 +03:00
|
|
|
|
2021-12-31 01:15:38 +03:00
|
|
|
RefPtr<TextMetrics> measure_text(String const& text);
|
|
|
|
|
2022-02-03 22:08:27 +03:00
|
|
|
NonnullRefPtr<CanvasGradient> create_radial_gradient(double x0, double y0, double r0, double x1, double y1, double r1);
|
|
|
|
NonnullRefPtr<CanvasGradient> create_linear_gradient(double x0, double y0, double x1, double y1);
|
|
|
|
NonnullRefPtr<CanvasGradient> create_conic_gradient(double start_angle, double x, double y);
|
|
|
|
|
2020-03-19 21:07:56 +03:00
|
|
|
private:
|
|
|
|
explicit CanvasRenderingContext2D(HTMLCanvasElement&);
|
|
|
|
|
2021-12-31 01:15:38 +03:00
|
|
|
struct PreparedTextGlyph {
|
|
|
|
unsigned int c;
|
|
|
|
Gfx::IntPoint position;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct PreparedText {
|
|
|
|
Vector<PreparedTextGlyph> glyphs;
|
|
|
|
Gfx::TextAlignment physical_alignment;
|
|
|
|
Gfx::IntRect bounding_box;
|
|
|
|
};
|
|
|
|
|
2020-04-08 12:22:40 +03:00
|
|
|
void did_draw(const Gfx::FloatRect&);
|
2021-12-31 01:15:38 +03:00
|
|
|
PreparedText prepare_text(String const& text, float max_width = INFINITY);
|
2020-03-22 23:15:49 +03:00
|
|
|
|
2020-03-19 21:07:56 +03:00
|
|
|
OwnPtr<Gfx::Painter> painter();
|
|
|
|
|
|
|
|
WeakPtr<HTMLCanvasElement> m_element;
|
|
|
|
|
2021-12-27 16:30:08 +03:00
|
|
|
// 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;
|
2021-12-27 16:31:23 +03:00
|
|
|
Vector<DrawingState> m_drawing_state_stack;
|
2020-04-16 22:06:03 +03:00
|
|
|
|
2022-03-04 20:57:29 +03:00
|
|
|
// https://html.spec.whatwg.org/multipage/canvas.html#concept-canvas-origin-clean
|
|
|
|
bool m_origin_clean { true };
|
|
|
|
|
2021-12-27 16:35:38 +03:00
|
|
|
// https://html.spec.whatwg.org/multipage/canvas.html#concept-canvas-context-lost
|
|
|
|
bool m_context_lost { false };
|
|
|
|
|
2020-04-16 22:06:03 +03:00
|
|
|
Gfx::Path m_path;
|
2020-03-19 21:07:56 +03:00
|
|
|
};
|
|
|
|
|
2022-03-04 21:02:10 +03:00
|
|
|
enum class CanvasImageSourceUsability {
|
|
|
|
Bad,
|
|
|
|
Good,
|
|
|
|
};
|
|
|
|
|
|
|
|
DOM::ExceptionOr<CanvasImageSourceUsability> check_usability_of_image(CanvasImageSource const&);
|
|
|
|
bool image_is_not_origin_clean(CanvasImageSource const&);
|
|
|
|
|
2020-03-19 21:07:56 +03:00
|
|
|
}
|