Contents

richardpiazza/vectorplus

A library & utility for interacting with SVG documents.

Packages

VectorPlus

VectorPlus acts primarily as a wrapper over SwiftSVG providing extensions for interacting with:

  • CoreGraphics
  • UIKit
  • AppKit
  • SwiftUI

When linked to a target that supports one of these frameworks, multiple options become available.

CoreGraphics
  • CGMutablePath.addCommand(_:from:to:): Adds a Path.Command to the mutable path. The addition of the Rects allow for correct placement and scaling.
  • CGContext.render(path:from:to:) throws: Rendered a Path in the given context. Uses information about fills and strokes to fill and/or stroke the path.
UIKit
  • SVG.uiImage(size:) -> UIImage?: A CoreGraphics rendered UIImage representation of the SVG paths.
  • SVG.pngData(size:) -> Data?: A Data representation of the UIImage.
  • SVGImageView: A UIImageView subclass that supports the assignment of an SVG object. The .image will automatically be generated using the view bounds.
AppKit
  • SVG.nsImage(size:) -> NSImage?: A CoreGraphics rendered NSImage representation of the SVG paths.
  • SVG.pngData(size:) -> Data?: A Data representation of the NSImage.
SwiftUI
  • SVGView(svg:): A SwiftUI.View that renders a SVG document.

Command Line Interface

Inspect

Parses an SVG document and prints out the document description.

Convert

Parses an SVG document and creates a PNG rendered version of the Commands.

Supported conversion options are:

  • absolute: Translates all elements to 'absolute' paths.
  • symbols: Generates an Apple Symbols compatible SVG.
  • uikit: A UIImageView subclass that supports dynamic sizing.

Preview

macOS only

Parses an SVG document displaying the results in an Application window. Do to limitations, this sub-command is only available when the AppKit framework is present.

Render

macOS only

Parses an SVG document and creates a PNG rendered version of the Commands. Do to limitations, this sub-command is only available when the AppKit framework is present.

Package Metadata

Repository: richardpiazza/vectorplus

Default branch: main

README: README.md