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 static sk_sp<SkSVGDOM> MakeFromStream(SkStream& str); 57 58 /** 59 * Returns the root (outermost) SVG element. 60 */ getRoot()61 SkSVGSVG* getRoot() const { return fRoot.get(); } 62 63 /** 64 * Specify a "container size" for the SVG dom. 65 * 66 * This is used to resolve the initial viewport when the root SVG width/height are specified 67 * in relative units. 68 * 69 * If the root dimensions are in absolute units, then the container size has no effect since 70 * the initial viewport is fixed. 71 */ 72 void setContainerSize(const SkSize&); 73 74 /** 75 * DEPRECATED: use getRoot()->intrinsicSize() to query the root element intrinsic size. 76 * 77 * Returns the SVG dom container size. 78 * 79 * If the client specified a container size via setContainerSize(), then the same size is 80 * returned. 81 * 82 * When unspecified by clients, this returns the intrinsic size of the root element, as defined 83 * by its width/height attributes. If either width or height is specified in relative units 84 * (e.g. "100%"), then the corresponding intrinsic size dimension is zero. 85 */ 86 const SkSize& containerSize() const; 87 88 // Returns the node with the given id, or nullptr if not found. 89 sk_sp<SkSVGNode>* findNodeById(const char* id); 90 91 void render(SkCanvas*) const; 92 93 /** Render the node with the given id as if it were the only child of the root. */ 94 void renderNode(SkCanvas*, SkSVGPresentationContext&, const char* id) const; 95 96 private: 97 SkSVGDOM(sk_sp<SkSVGSVG>, 98 sk_sp<SkFontMgr>, 99 sk_sp<skresources::ResourceProvider>, 100 SkSVGIDMapper&&, 101 sk_sp<SkShapers::Factory>); 102 103 const sk_sp<SkSVGSVG> fRoot; 104 const sk_sp<SkFontMgr> fFontMgr; 105 const sk_sp<SkShapers::Factory> fTextShapingFactory; 106 const sk_sp<skresources::ResourceProvider> fResourceProvider; 107 const SkSVGIDMapper fIDMapper; 108 SkSize fContainerSize; 109 }; 110 111 #endif // SkSVGDOM_DEFINED 112