Add SVG import and rendering features

include/tgfx/core/FontStyle.h

@@ -0,0 +1,111 @@
+/////////////////////////////////////////////////////////////////////////////////////////////////
+//
+//  Tencent is pleased to support the open source community by making tgfx available.
+//
+//  Copyright (C) 2025 THL A29 Limited, a Tencent company. All rights reserved.
+//
+//  Licensed under the BSD 3-Clause License (the "License"); you may not use this file except
+//  in compliance with the License. You may obtain a copy of the License at
+//
+//      https://opensource.org/licenses/BSD-3-Clause
+//
+//  unless required by applicable law or agreed to in writing, software distributed under the
+//  license is distributed on an "as is" basis, without warranties or conditions of any kind,
+//  either express or implied. see the license for the specific language governing permissions
+//  and limitations under the license.
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////
+
+#pragma once
+
+#include <algorithm>
+#include <cstddef>
+#include <memory>
+#include <string>
+
+namespace tgfx {
+
+/**
+ * Font style object
+ */
+class FontStyle {
+ public:
+  enum class Weight {
+    Invisible,
+    Thin,
+    ExtraLight,
+    Light,
+    Normal,
+    Medium,
+    SemiBold,
+    Bold,
+    ExtraBold,
+    Black,
+    ExtraBlack,
+  };
+
+  enum class Width {
+    UltraCondensed,
+    ExtraCondensed,
+    Condensed,
+    SemiCondensed,
+    Normal,
+    SemiExpanded,
+    Expanded,
+    ExtraExpanded,
+    UltraExpanded,
+  };
+
+  enum class Slant {
+    Upright,
+    Italic,
+    Oblique,
+  };
+
+  constexpr FontStyle(Weight weight, Width width, Slant slant)
+      : value(static_cast<uint32_t>(std::clamp(weight, Weight::Invisible, Weight::ExtraBlack)) +
+              (static_cast<uint32_t>(std::clamp(width, Width::UltraCondensed, Width::UltraExpanded))
+               << 16) +
+              (static_cast<uint32_t>(std::clamp(slant, Slant::Upright, Slant::Oblique)) << 24)) {
+  }
+
+  constexpr FontStyle() : FontStyle{Weight::Normal, Width::Normal, Slant::Upright} {
+  }
+
+  bool operator==(const FontStyle& rhs) const {
+    return value == rhs.value;
+  }
+
+  Weight weight() const {
+    return static_cast<Weight>(value & 0xFFFF);
+  }
+
+  Width width() const {
+    return static_cast<Width>((value >> 16) & 0xFF);
+  }
+
+  Slant slant() const {
+    return static_cast<Slant>((value >> 24) & 0xFF);
+  }
+
+  static constexpr FontStyle Normal() {
+    return FontStyle(Weight::Normal, Width::Normal, Slant::Upright);
+  }
+
+  static constexpr FontStyle Bold() {
+    return FontStyle(Weight::Bold, Width::Normal, Slant::Upright);
+  }
+
+  static constexpr FontStyle Italic() {
+    return FontStyle(Weight::Normal, Width::Normal, Slant::Italic);
+  }
+
+  static constexpr FontStyle BoldItalic() {
+    return FontStyle(Weight::Bold, Width::Normal, Slant::Italic);
+  }
+
+ private:
+  uint32_t value;
+};
+
+}  // namespace tgfx

include/tgfx/core/Stream.h

@@ -20,6 +20,7 @@
 
 #include <memory>
 #include <string>
+#include "tgfx/core/Data.h"
 
 namespace tgfx {
 /**
@@ -35,6 +36,11 @@ class Stream {
    */
   static std::unique_ptr<Stream> MakeFromFile(const std::string& filePath);
 
+  /**
+   * Creates a stream from the specified data. Returns nullptr on failure.
+   */
+  static std::unique_ptr<Stream> MakeFromData(std::shared_ptr<Data> data);
+
   /**
    * Returns the total length of the stream. If this cannot be done, returns 0.
    */
@@ -64,6 +70,13 @@ class Stream {
    * beginning after this call returns.
    */
   virtual bool rewind() = 0;
+
+  /**
+   * Returns the starting address for the data. If this cannot be done, returns nullptr.
+   */
+  virtual const void* getMemoryBase() {
+    return nullptr;
+  }
 };
 
 /**

include/tgfx/core/Typeface.h

@@ -22,6 +22,7 @@
 #include <unordered_map>
 #include <vector>
 #include "tgfx/core/Data.h"
+#include "tgfx/core/FontStyle.h"
 
 namespace tgfx {
 /**
@@ -56,6 +57,9 @@ class Typeface {
   static std::shared_ptr<Typeface> MakeFromName(const std::string& fontFamily,
                                                 const std::string& fontStyle);
 
+  static std::shared_ptr<Typeface> MakeFromStyle(const std::string& fontFamily,
+                                                 FontStyle fontStyle);
+
   /**
    * Creates a new typeface for the given file path and ttc index. Returns nullptr if the typeface
    * can't be created.

include/tgfx/svg/FontManager.h

@@ -0,0 +1,57 @@
+/////////////////////////////////////////////////////////////////////////////////////////////////
+//
+//  Tencent is pleased to support the open source community by making tgfx available.
+//
+//  Copyright (C) 2025 THL A29 Limited, a Tencent company. All rights reserved.
+//
+//  Licensed under the BSD 3-Clause License (the "License"); you may not use this file except
+//  in compliance with the License. You may obtain a copy of the License at
+//
+//      https://opensource.org/licenses/BSD-3-Clause
+//
+//  unless required by applicable law or agreed to in writing, software distributed under the
+//  license is distributed on an "as is" basis, without warranties or conditions of any kind,
+//  either express or implied. see the license for the specific language governing permissions
+//  and limitations under the license.
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////
+
+#pragma once
+
+#include <cstddef>
+#include <memory>
+#include <string>
+#include "tgfx/core/FontStyle.h"
+#include "tgfx/core/Typeface.h"
+
+namespace tgfx {
+/**
+ * FontManager provides functionality to enumerate Typefaces and match them based on FontStyle.
+ */
+class FontManager {
+ public:
+  /**
+   * Destructor for FontManager
+   */
+  virtual ~FontManager() = default;
+
+  /**
+   * Match a font family name and style, and return the corresponding Typeface
+   */
+  std::shared_ptr<Typeface> matchTypeface(const std::string& familyName, FontStyle style) const;
+
+  /**
+   * Match a font family name, style, character, and language, and return the corresponding Typeface
+   */
+  std::shared_ptr<Typeface> getFallbackTypeface(const std::string& familyName, FontStyle style,
+                                                Unichar character) const;
+
+ private:
+  virtual std::shared_ptr<Typeface> onMatchTypeface(const std::string& familyName,
+                                                    FontStyle style) const = 0;
+  virtual std::shared_ptr<Typeface> onGetFallbackTypeface(const std::string& familyName,
+                                                          FontStyle style,
+                                                          Unichar character) const = 0;
+};
+
+}  // namespace tgfx

include/tgfx/svg/ResourceLoader.h

@@ -0,0 +1,52 @@
+/////////////////////////////////////////////////////////////////////////////////////////////////
+//
+//  Tencent is pleased to support the open source community by making tgfx available.
+//
+//  Copyright (C) 2025 THL A29 Limited, a Tencent company. All rights reserved.
+//
+//  Licensed under the BSD 3-Clause License (the "License"); you may not use this file except
+//  in compliance with the License. You may obtain a copy of the License at
+//
+//      https://opensource.org/licenses/BSD-3-Clause
+//
+//  unless required by applicable law or agreed to in writing, software distributed under the
+//  license is distributed on an "as is" basis, without warranties or conditions of any kind,
+//  either express or implied. see the license for the specific language governing permissions
+//  and limitations under the license.
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////
+
+#pragma once
+
+#include <memory>
+#include <string>
+#include "tgfx/core/Data.h"
+#include "tgfx/core/Image.h"
+
+namespace tgfx {
+
+/**
+ * ResourceLoader is an interface for loading resources (e.g. images, font) from
+ * external sources.
+ */
+class ResourceLoader {
+ public:
+  /**
+   * Data is a wrapper for raw data.
+   */
+  virtual ~ResourceLoader() = default;
+
+  /**
+   * Load a generic resource specified by |path| + |name|, and return as an Data object.
+   */
+  virtual std::shared_ptr<Data> load(const std::string& resourcePath,
+                                     const std::string& resourceName) const = 0;
+
+  /**
+   * Load an image asset specified by |path| + |name|, and returns the Image object.
+   */
+  virtual std::shared_ptr<Image> loadImage(const std::string& resourcePath,
+                                           const std::string& resourceName) const = 0;
+};
+
+}  // namespace tgfx

include/tgfx/svg/SVGAttribute.h

@@ -0,0 +1,118 @@
+/////////////////////////////////////////////////////////////////////////////////////////////////
+//
+//  Tencent is pleased to support the open source community by making tgfx available.
+//
+//  Copyright (C) 2024 THL A29 Limited, a Tencent company. All rights reserved.
+//
+//  Licensed under the BSD 3-Clause License (the "License"); you may not use this file except
+//  in compliance with the License. You may obtain a copy of the License at
+//
+//      https://opensource.org/licenses/BSD-3-Clause
+//
+//  unless required by applicable law or agreed to in writing, software distributed under the
+//  license is distributed on an "as is" basis, without warranties or conditions of any kind,
+//  either express or implied. see the license for the specific language governing permissions
+//  and limitations under the license.
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////
+
+#pragma once
+
+#include "tgfx/svg/SVGTypes.h"
+
+namespace tgfx {
+enum class SVGAttribute {
+  ClipRule,
+  Color,
+  ColorInterpolation,
+  ColorInterpolationFilters,
+  Cx,  // <circle>, <ellipse>, <radialGradient>: center x position
+  Cy,  // <circle>, <ellipse>, <radialGradient>: center y position
+  Fill,
+  FillOpacity,
+  FillRule,
+  Filter,
+  FilterUnits,
+  FontFamily,
+  FontSize,
+  FontStyle,
+  FontWeight,
+  Fx,  // <radialGradient>: focal point x position
+  Fy,  // <radialGradient>: focal point y position
+  GradientUnits,
+  GradientTransform,
+  Height,
+  Href,
+  Opacity,
+  Points,
+  PreserveAspectRatio,
+  R,   // <circle>, <radialGradient>: radius
+  Rx,  // <ellipse>,<rect>: horizontal (corner) radius
+  Ry,  // <ellipse>,<rect>: vertical (corner) radius
+  SpreadMethod,
+  Stroke,
+  StrokeDashArray,
+  StrokeDashOffset,
+  StrokeOpacity,
+  StrokeLineCap,
+  StrokeLineJoin,
+  StrokeMiterLimit,
+  StrokeWidth,
+  Transform,
+  Text,
+  TextAnchor,
+  ViewBox,
+  Visibility,
+  Width,
+  X,
+  X1,  // <line>: first endpoint x
+  X2,  // <line>: second endpoint x
+  Y,
+  Y1,  // <line>: first endpoint y
+  Y2,  // <line>: second endpoint y
+
+  Unknown,
+};
+
+struct SVGPresentationAttributes {
+  static SVGPresentationAttributes MakeInitial();
+
+  SVGProperty<SVGPaint, true> Fill;
+  SVGProperty<SVGNumberType, true> FillOpacity;
+  SVGProperty<SVGFillRule, true> FillRule;
+  SVGProperty<SVGFillRule, true> ClipRule;
+
+  SVGProperty<SVGPaint, true> Stroke;
+  SVGProperty<SVGDashArray, true> StrokeDashArray;
+  SVGProperty<SVGLength, true> StrokeDashOffset;
+  SVGProperty<SVGLineCap, true> StrokeLineCap;
+  SVGProperty<SVGLineJoin, true> StrokeLineJoin;
+  SVGProperty<SVGNumberType, true> StrokeMiterLimit;
+  SVGProperty<SVGNumberType, true> StrokeOpacity;
+  SVGProperty<SVGLength, true> StrokeWidth;
+
+  SVGProperty<SVGVisibility, true> Visibility;
+
+  SVGProperty<SVGColorType, true> Color;
+  SVGProperty<SVGColorspace, true> ColorInterpolation;
+  SVGProperty<SVGColorspace, true> ColorInterpolationFilters;
+
+  SVGProperty<SVGFontFamily, true> FontFamily;
+  SVGProperty<SVGFontStyle, true> FontStyle;
+  SVGProperty<SVGFontSize, true> FontSize;
+  SVGProperty<SVGFontWeight, true> FontWeight;
+  SVGProperty<SVGTextAnchor, true> TextAnchor;
+
+  // uninherited
+  SVGProperty<SVGNumberType, false> Opacity;
+  SVGProperty<SVGFuncIRI, false> ClipPath;
+  SVGProperty<SVGDisplay, false> Display;
+  SVGProperty<SVGFuncIRI, false> Mask;
+  SVGProperty<SVGFuncIRI, false> Filter;
+  SVGProperty<SVGColor, false> StopColor;
+  SVGProperty<SVGNumberType, false> StopOpacity;
+  SVGProperty<SVGColor, false> FloodColor;
+  SVGProperty<SVGNumberType, false> FloodOpacity;
+  SVGProperty<SVGColor, false> LightingColor;
+};
+}  // namespace tgfx