graphics.h

Go to the documentation of this file.

// SPDX-License-Identifier: GPL-2.0-or-later
/*
 * Display backend interface.
 * Copyright (C) 2022 PBS <pbs3141@gmail.com>
 * Released under GNU GPL v2+, read the file 'COPYING' for more information.
 */
 
#ifndef INKSCAPE_UI_WIDGET_CANVAS_GRAPHICS_H
#define INKSCAPE_UI_WIDGET_CANVAS_GRAPHICS_H
 
#include <cstdint>
#include <memory>
#include <optional>
#include <utility>
#include <vector>
 
#include <2geom/rect.h>
#include <cairomm/refptr.h>
#include "display/rendermode.h"
#include "fragment.h"
 
namespace Cairo {
class Context;
class ImageSurface;
} // namespace Cairo
 
namespace Inkscape::UI::Widget {
 
class Stores;
class Prefs;
 
struct PageInfo
{
    std::vector<Geom::Rect> pages;
};
 
class Graphics
{
public:
    // Creation/destruction.
    static std::unique_ptr<Graphics> create_gl   (Prefs const &prefs, Stores const &stores, PageInfo const &pi);
    static std::unique_ptr<Graphics> create_cairo(Prefs const &prefs, Stores const &stores, PageInfo const &pi);
    virtual ~Graphics() = default;
 
    // State updating.
    virtual void set_scale_factor(int) = 0; 
    virtual void set_outlines_enabled(bool) = 0; 
    virtual void set_background_in_stores(bool) = 0; 
 
    virtual void set_colours(std::uint32_t page, std::uint32_t desk, std::uint32_t border) = 0;
 
    // Store manipulation.
    virtual void recreate_store(Geom::IntPoint const &dims) = 0; 
    virtual void shift_store(Fragment const &dest) = 0; 
    virtual void swap_stores() = 0; 
    virtual void fast_snapshot_combine() = 0; 
    virtual void snapshot_combine(Fragment const &dest) = 0; 
    virtual void invalidate_snapshot() = 0; 
 
    // Misc.
    virtual bool is_opengl() const = 0; 
    virtual void invalidated_glstate() = 0; 
 
    // Tile drawing.
    virtual Cairo::RefPtr<Cairo::ImageSurface> request_tile_surface(Geom::IntRect const &rect, bool nogl) = 0;
    virtual void draw_tile(Fragment const &fragment, Cairo::RefPtr<Cairo::ImageSurface> surface, Cairo::RefPtr<Cairo::ImageSurface> outline_surface) = 0;
    virtual void junk_tile_surface(Cairo::RefPtr<Cairo::ImageSurface> surface) = 0;
 
    // Widget painting.
    struct PaintArgs
    {
        std::optional<Geom::Point> mouse;
        RenderMode render_mode{};
        SplitMode splitmode{};
        Geom::Point splitfrac;
        SplitDirection splitdir{};
        SplitDirection hoverdir{};
        double yaxisdir{};
    };
    virtual void paint_widget(Fragment const &view, PaintArgs const &args, Cairo::RefPtr<Cairo::Context> const &cr) = 0;
 
    // Static functions providing common functionality.
    static bool check_single_page(Fragment const &view, PageInfo const &pi);
    static std::pair<Geom::IntRect, Geom::IntRect> calc_splitview_cliprects(Geom::IntPoint const &size, Geom::Point const &splitfrac, SplitDirection splitdir);
    static void paint_splitview_controller(Geom::IntPoint const &size, Geom::Point const &splitfrac, SplitDirection splitdir, SplitDirection hoverdir, Cairo::RefPtr<Cairo::Context> const &cr);
    static void paint_background(Fragment const &fragment, PageInfo const &pi,
                                 std::uint32_t page, std::uint32_t desk,
                                 Cairo::RefPtr<Cairo::Context> const &cr);
};
 
} // namespace Inkscape::UI::Widget
 
#endif // INKSCAPE_UI_WIDGET_CANVAS_GRAPHICS_H
 
/*
  Local Variables:
  mode:c++
  c-file-style:"stroustrup"
  c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
  indent-tabs-mode:nil
  fill-column:99
  End:
*/
// vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4 :