dmonagle / SwiftyHaru

Object-oriented and safe cross-platform Swift wrapper for LibHaru — a library for creating PDF documents.

SwiftyHaru

SwiftyHaru is an object-oriented Swift wrapper for LibHaru, a C library for creating PDF documents. It brings the safety of Swift itself to the process of creating PDFs on different platforms like Linux, macOS, iOS, watchOS and tvOS.

Check out which features of LibHaru has already been implemented in FEATURES.md

Requirements

• Swift 3
• iOS 8.0+
• OSX 10.10+
• tvOS 9.0+
• watchOS 2.0+
• Ubuntu 14.04+

Installation

CocoaPods

For the latest release in CocoaPods add the following to your Podfile:

use_frameworks!

pod 'SwiftyHaru'

For the latest dev build:

use_frameworks!

pod 'SwiftyHaru', :git => 'https://github.com/WeirdMath/SwiftyHaru.git', :branch => 'dev'

Swift Package Manager

Add SwiftyHaru as a dependency to your Package.swift. For example:

let package = Package(
    name: "YourPackageName",
    dependencies: [
        .Package(url: "https://github.com/WeirdMath/SwiftyHaru.git", majorVersion: 0)
    ]
)

Documentation

Available here.

Getting started

import SwiftyHaru

// Initialize stuff
let document = PDFDocument()
let page = document.addPage(width: 600, height: 400)

// Construct a path
let path = Path()
    .moving(toX: 100, y: 100)
    .appendingLine(toX: 400, y: 100)
    .moving(toX: 500, y: 200)
    .appendingArc(x: 400, y: 200, radius: 100, beginningAngle: 90, endAngle: 180)
    .appendingCircle(x: 200, y: 200, radius: 50)
    .moving(toX: 500, y: 200)
    .appendingCurve(controlPoint1: Point(x: 400, y: 200),
                    controlPoint2: Point(x: 400, y: 300),
                    endPoint: Point(x: 500, y: 300))
    .closingSubpath()

// Paint the path
page.draw { context in
    
    context.strokeColor = .blue
    context.stroke(path)
}

// Put some text
page.draw { context in
    context.show(text: "Roses are red,\nViolets are blue,\nSugar is sweet,\nAnd so are you.",
                 atX: 300, y: 200)
}

Contributing

Building in macOS:

$ swift build -Xlinker -lz

Testing in macOS:

$ swift test -Xlinker -lz

Building in Ubuntu:

$ swift build -Xlinker -rpath=.build/debug/ -Xlinker -lz

Testing in Ubuntu:

$ swift test -Xlinker -rpath=.build/debug/ -Xlinker -lz