/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 |