Transform.swift

Transform.swift offers a Swiftier API for applying transforms to UIView and its subclasses.

let scale = Transform.scale(sx: 0.5, sy: 0.5)
let rotate = Transform.rotate(rotation: .degrees(45))
let scaleAndRotate = scale + rotate
myView.transform += scaleAndRotate

myView.transform3D = .translate(tx: 40, ty: 0, tz: 100)

##Installation

####CocoaPods

Add the following to your Podfile:

use_frameworks!

pod 'Transform.swift', '~> 0.1.2'

####Carthage

Add the following to your Cartfile:

gitub "jhurray/Transform.swift" ~> 0.1.2

##Usage

Transform.swift exposes 3 enums, Transform, Transform3D, and Rotation.

###Rotation A convenience enum that allows the developer to easily define the rotation they want. The cases are pretty self explanitory.

• .degrees(degrees: CGFloat)
• .radians(radians: Double)
  • Takes a double to make it easier to pass the M_PI definitions from Darwin.C.Math

###Transform

• .identity
• .translate(tx: CGFloat, ty: CGFloat)
• .scale(sx: CGFloat, sy: CGFloat)
• .rotate(rotation: Rotation)
• .init(a: CGFloat, b: CGFloat, c: CGFloat, d: CGFloat, tx: CGFloat, ty: CGFloat) for the adventurous type 😎
• .custom(t: CGAffineTransform)

####Methods

A group of methods that calculate how the transform affects a CGRect, CGSize, and CGPoint respectively.

public func transformedRect(rect: CGRect) -> CGRect
public func transformedSize(size: CGSize) -> CGSize
public func transformedPoint(point: CGPoint) -> CGPoint

Returns the underlying CGAffineTransform

public var CGATransform: CGAffineTransform { get }

###Transform3D

• .identity
• .translate(tx: CGFloat, ty: CGFloat, tz: CGFloat)
• .scale(sx: CGFloat, sy: CGFloat, sz: CGFloat)
• .rotate(rotation: Rotation, x: CGFloat, y: CGFloat, z: CGFloat)
• .affine(t: CGAffineTransform)
• .custom(t: CATransform3D)

####Methods

Returns the underlying CATransform3D

public var CATransform : CATransform3D { get }

Returns true if the 3d transform can be converted into an affine transform, false if it cannot.

public var isAffine: Bool { get }

Returns the underlying CGAffineTransform. Will throw an error if the 3D transform cannot be converted into an affine transform.

public func affineTransform() throws -> CGAffineTransform 

###Shared Utilities

• Inverting: let inverted = t.inverted
• Identity Conformation: let isIdentity = t.isIdentity
• Concatenation: let scaleAndMove = scale.concat(.translate(tx: 40, ty: -100))

###Operators

• == Equality
  • Returns Bool
  • Transform == Transform
  • Transform == CGAffineTransform
  • Transform3D == Transform3D
  • Transform3D == CATransform3D
• + Additive
  • Returns the type being added
  • Transform + Transform
  • CGAffineTransform + CGAffineTransform
  • Transform3D + Transform3D
  • CATransform3D + CATransform3D
• += Assignment
  • Modifies the left variable of the operator
  • Transform += Transform
  • CGAffineTransform += Transform
  • Transform3D += Transform3D
  • CATransform3D += Transform3D
• <- Assignment
  • Assigns a value to the left variable of the operator
  • CGAffineTransform <- Transform
  • CATransform3D <- Transform3D
  • Semantics to assign the transform enum to the old API since you cant overload the = operator.

###UIView Extension Two variables have been added to UIView to add settable and gettable interfaces for Transform and Transform3D.

var affineTransform: Transform
var transform3D: Transform3D

##Contact Info Feel free to email me at jhurray33@gmail.com. I'd love to hear your thoughts on this, or see examples where this has been used.

You can also hit me up on twitter @JeffHurray.

##Contributing If you want to add functionality please open an issue and/or create a pull request.

##License Transform.swift is available under the MIT license. See the LICENSE file for more information.