/* * Copyright (c) 2018-2021, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include namespace Gfx { class Painter { public: explicit Painter(Gfx::Bitmap&); ~Painter(); enum class LineStyle { Solid, Dotted, Dashed, }; void clear_rect(const IntRect&, Color); void fill_rect(const IntRect&, Color); void fill_rect_with_dither_pattern(const IntRect&, Color, Color); void fill_rect_with_checkerboard(const IntRect&, const IntSize&, Color color_dark, Color color_light); void fill_rect_with_gradient(Orientation, const IntRect&, Color gradient_start, Color gradient_end); void fill_rect_with_gradient(const IntRect&, Color gradient_start, Color gradient_end); void fill_ellipse(const IntRect&, Color); void draw_rect(const IntRect&, Color, bool without_corners = false); void draw_focus_rect(const IntRect&, Color); void draw_bitmap(const IntPoint&, const CharacterBitmap&, Color = Color()); void draw_bitmap(const IntPoint&, const GlyphBitmap&, Color = Color()); void draw_scaled_bitmap(const IntRect& dst_rect, const Gfx::Bitmap&, const IntRect& src_rect, float opacity = 1.0f); void draw_scaled_bitmap(const IntRect& dst_rect, const Gfx::Bitmap&, const FloatRect& src_rect, float opacity = 1.0f); void draw_triangle(const IntPoint&, const IntPoint&, const IntPoint&, Color); void draw_ellipse_intersecting(const IntRect&, Color, int thickness = 1); void set_pixel(const IntPoint&, Color); void set_pixel(int x, int y, Color color) { set_pixel({ x, y }, color); } void draw_line(const IntPoint&, const IntPoint&, Color, int thickness = 1, LineStyle style = LineStyle::Solid); void draw_quadratic_bezier_curve(const IntPoint& control_point, const IntPoint&, const IntPoint&, Color, int thickness = 1, LineStyle style = LineStyle::Solid); void draw_elliptical_arc(const IntPoint& p1, const IntPoint& p2, const IntPoint& center, const FloatPoint& radii, float x_axis_rotation, float theta_1, float theta_delta, Color, int thickness = 1, LineStyle style = LineStyle::Solid); void blit(const IntPoint&, const Gfx::Bitmap&, const IntRect& src_rect, float opacity = 1.0f, bool apply_alpha = true); void blit_dimmed(const IntPoint&, const Gfx::Bitmap&, const IntRect& src_rect); void blit_brightened(const IntPoint&, const Gfx::Bitmap&, const IntRect& src_rect); void blit_filtered(const IntPoint&, const Gfx::Bitmap&, const IntRect& src_rect, Function); void draw_tiled_bitmap(const IntRect& dst_rect, const Gfx::Bitmap&); void blit_offset(const IntPoint&, const Gfx::Bitmap&, const IntRect& src_rect, const IntPoint&); void blit_disabled(const IntPoint&, const Gfx::Bitmap&, const IntRect&, const Palette&); void blit_tiled(const IntRect&, const Gfx::Bitmap&, const IntRect& src_rect); void draw_text(const IntRect&, const StringView&, const Font&, TextAlignment = TextAlignment::TopLeft, Color = Color::Black, TextElision = TextElision::None); void draw_text(const IntRect&, const StringView&, TextAlignment = TextAlignment::TopLeft, Color = Color::Black, TextElision = TextElision::None); void draw_text(const IntRect&, const Utf32View&, const Font&, TextAlignment = TextAlignment::TopLeft, Color = Color::Black, TextElision = TextElision::None); void draw_text(const IntRect&, const Utf32View&, TextAlignment = TextAlignment::TopLeft, Color = Color::Black, TextElision = TextElision::None); void draw_text(Function, const IntRect&, const StringView&, const Font&, TextAlignment = TextAlignment::TopLeft, TextElision = TextElision::None); void draw_text(Function, const IntRect&, const Utf8View&, const Font&, TextAlignment = TextAlignment::TopLeft, TextElision = TextElision::None); void draw_text(Function, const IntRect&, const Utf32View&, const Font&, TextAlignment = TextAlignment::TopLeft, TextElision = TextElision::None); void draw_ui_text(const Gfx::IntRect&, const StringView&, const Gfx::Font&, TextAlignment, Gfx::Color); void draw_glyph(const IntPoint&, u32, Color); void draw_glyph(const IntPoint&, u32, const Font&, Color); void draw_emoji(const IntPoint&, const Gfx::Bitmap&, const Font&); void draw_glyph_or_emoji(const IntPoint&, u32 code_point, const Font&, Color); static void for_each_line_segment_on_bezier_curve(const FloatPoint& control_point, const FloatPoint& p1, const FloatPoint& p2, Function&); static void for_each_line_segment_on_bezier_curve(const FloatPoint& control_point, const FloatPoint& p1, const FloatPoint& p2, Function&&); static void for_each_line_segment_on_elliptical_arc(const FloatPoint& p1, const FloatPoint& p2, const FloatPoint& center, const FloatPoint radii, float x_axis_rotation, float theta_1, float theta_delta, Function&); static void for_each_line_segment_on_elliptical_arc(const FloatPoint& p1, const FloatPoint& p2, const FloatPoint& center, const FloatPoint radii, float x_axis_rotation, float theta_1, float theta_delta, Function&&); void stroke_path(const Path&, Color, int thickness); enum class WindingRule { Nonzero, EvenOdd, }; void fill_path(Path&, Color, WindingRule rule = WindingRule::Nonzero); const Font& font() const { return *state().font; } void set_font(const Font& font) { state().font = &font; } enum class DrawOp { Copy, Xor, Invert }; void set_draw_op(DrawOp op) { state().draw_op = op; } DrawOp draw_op() const { return state().draw_op; } void add_clip_rect(const IntRect& rect); void clear_clip_rect(); IntPoint translation() const { return transform().translation().to_type(); } template void translate(T dx, T dy) { transform().translate(static_cast(dx), static_cast(dy)); } template void translate(const Point& delta) { transform().translate(delta.template to_type()); } FloatPoint float_scale() const { return transform().scale(); } int scale() const; template void scale(T dx, T dy) { transform().scale(static_cast(dx), static_cast(dy)); } template void scale(const Point& delta) { transform().scale(delta.template to_type()); } Gfx::Bitmap* target() { return m_target.ptr(); } void save() { m_state_stack.append(m_state_stack.last()); } void restore() { VERIFY(m_state_stack.size() > 1); m_state_stack.take_last(); } IntRect clip_rect() const { return state().clip_rect; } protected: AffineTransform& transform() { return state().transform; } const AffineTransform& transform() const { return state().transform; } IntSize scaled(const IntSize& size) const { return IntSize { static_cast(size.width()) * float_scale().x(), static_cast(size.height()) * float_scale().y(), }; } IntRect scaled(const IntRect& rect) const { return IntRect { static_cast(rect.x()) * float_scale().x(), static_cast(rect.y()) * float_scale().y(), static_cast(rect.width()) * float_scale().x(), static_cast(rect.height()) * float_scale().y(), }; } IntRect to_physical(const IntRect& rect) { return rect.transformed(transform()).intersected(clip_rect()); } IntPoint to_physical(const IntPoint& point) { return point.transformed(transform()).constrained(clip_rect()); } void set_physical_pixel_with_draw_op(u32& pixel, const Color&); void fill_physical_scanline_with_draw_op(int y, int x, int width, const Color& color); void fill_rect_with_draw_op(const IntRect&, Color); void blit_with_opacity(const IntPoint&, const Gfx::Bitmap&, const IntRect& src_rect, float opacity, bool apply_alpha = true); void draw_physical_pixel(const IntPoint&, Color, IntSize thickness = { 1, 1 }); void fill_physical_rect(const IntRect&, Color); ALWAYS_INLINE bool has_integer_scale() const { return float_scale().x() == float_scale().y() && float_scale().x() == floorf(float_scale().x()); } struct State { const Font* font; AffineTransform transform; IntRect clip_rect; DrawOp draw_op; }; State& state() { return m_state_stack.last(); } const State& state() const { return m_state_stack.last(); } IntRect m_clip_origin; NonnullRefPtr m_target; Vector m_state_stack; }; class PainterStateSaver { public: explicit PainterStateSaver(Painter&); ~PainterStateSaver(); private: Painter& m_painter; }; String parse_ampersand_string(const StringView&, Optional* underline_offset = nullptr); }