Coverage Report

Created: 2024-05-20 07:14

/src/skia/modules/svg/include/SkSVGDOM.h
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2016 Google Inc.
3
 *
4
 * Use of this source code is governed by a BSD-style license that can be
5
 * found in the LICENSE file.
6
 */
7
8
#ifndef SkSVGDOM_DEFINED
9
#define SkSVGDOM_DEFINED
10
11
#include "include/core/SkFontMgr.h"
12
#include "include/core/SkRefCnt.h"
13
#include "include/core/SkSize.h"
14
#include "include/private/base/SkTemplates.h"
15
#include "modules/skresources/include/SkResources.h"
16
#include "modules/skshaper/include/SkShaper_factory.h"
17
#include "modules/svg/include/SkSVGIDMapper.h"
18
19
class SkCanvas;
20
class SkDOM;
21
class SkStream;
22
class SkSVGNode;
23
struct SkSVGPresentationContext;
24
class SkSVGSVG;
25
26
class SK_API SkSVGDOM : public SkRefCnt {
27
public:
28
    class Builder final {
29
    public:
30
        /**
31
         * Specify a font manager for loading fonts (e.g. from the system) to render <text>
32
         * SVG nodes.
33
         * If this is not set, but a font is required as part of rendering, the text will
34
         * not be displayed.
35
         */
36
        Builder& setFontManager(sk_sp<SkFontMgr>);
37
38
        /**
39
         * Specify a resource provider for loading images etc.
40
         */
41
        Builder& setResourceProvider(sk_sp<skresources::ResourceProvider>);
42
43
        /**
44
         * Specify the callbacks for dealing with shaping text. See also
45
         * modules/skshaper/utils/FactoryHelpers.h
46
         */
47
        Builder& setTextShapingFactory(sk_sp<SkShapers::Factory>);
48
49
        sk_sp<SkSVGDOM> make(SkStream&) const;
50
51
    private:
52
        sk_sp<SkFontMgr>                             fFontMgr;
53
        sk_sp<skresources::ResourceProvider>         fResourceProvider;
54
        sk_sp<SkShapers::Factory>                    fTextShapingFactory;
55
    };
56
57
0
    static sk_sp<SkSVGDOM> MakeFromStream(SkStream& str) {
58
0
        return Builder().make(str);
59
0
    }
60
61
    /**
62
     * Returns the root (outermost) SVG element.
63
     */
64
0
    SkSVGSVG* getRoot() const { return fRoot.get(); }
65
66
    /**
67
     * Specify a "container size" for the SVG dom.
68
     *
69
     * This is used to resolve the initial viewport when the root SVG width/height are specified
70
     * in relative units.
71
     *
72
     * If the root dimensions are in absolute units, then the container size has no effect since
73
     * the initial viewport is fixed.
74
     */
75
    void setContainerSize(const SkSize&);
76
77
    /**
78
     * DEPRECATED: use getRoot()->intrinsicSize() to query the root element intrinsic size.
79
     *
80
     * Returns the SVG dom container size.
81
     *
82
     * If the client specified a container size via setContainerSize(), then the same size is
83
     * returned.
84
     *
85
     * When unspecified by clients, this returns the intrinsic size of the root element, as defined
86
     * by its width/height attributes.  If either width or height is specified in relative units
87
     * (e.g. "100%"), then the corresponding intrinsic size dimension is zero.
88
     */
89
    const SkSize& containerSize() const;
90
91
    // Returns the node with the given id, or nullptr if not found.
92
    sk_sp<SkSVGNode>* findNodeById(const char* id);
93
94
    void render(SkCanvas*) const;
95
96
    /** Render the node with the given id as if it were the only child of the root. */
97
    void renderNode(SkCanvas*, SkSVGPresentationContext&, const char* id) const;
98
99
private:
100
    SkSVGDOM(sk_sp<SkSVGSVG>,
101
             sk_sp<SkFontMgr>,
102
             sk_sp<skresources::ResourceProvider>,
103
             SkSVGIDMapper&&,
104
             sk_sp<SkShapers::Factory>);
105
106
    const sk_sp<SkSVGSVG>                       fRoot;
107
    const sk_sp<SkFontMgr>                      fFontMgr;
108
    const sk_sp<SkShapers::Factory>             fTextShapingFactory;
109
    const sk_sp<skresources::ResourceProvider>  fResourceProvider;
110
    const SkSVGIDMapper                         fIDMapper;
111
    SkSize                                      fContainerSize;
112
};
113
114
#endif // SkSVGDOM_DEFINED