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