Swift Package Index


A utility & library for converting SVG paths to Core Graphics images.


  • The latest stable release is 0.1.3. Released 7 months ago.
  • The last commit to main was about 1 month ago.

Swift Version Compatibility

  • 0.1.3 and main
    5.3
    5.2
    5.1
    5.0
    4.2
Full build results

Platform Compatibility

  • 0.1.3 and main
    iOS
    macOS(Intel)
    macOS(ARM)
    Linux
    tvOS
    watchOS
Full build results

VectorPlus

A utility & library for interacting with SVG documents.

Usage

VectorPlus is distributed using the Swift Package Manager. To install it into a project, add it as a dependency within your Package.swift manifest:

let package = Package(
    ...
    dependencies: [
        .package(url: "https://github.com/richardpiazza/VectorPlus.git", from: "0.1.0")
    ],
    ...
)

Then import the VectorPlus packages wherever you'd like to use it:

import VectorPlus

Packages

VectorPlus

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

  • CoreGraphics
  • UIKit
  • AppKit

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.

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.