SwiftyDraw is a simple, light-weight drawing framework written in Swift. SwiftyDraw is built using Core Gaphics and is very easy to implement.
- iOS 9.1+
- Swift 5.0
SwiftyDraw is available through CocoaPods. To install it, add the following line to your Podfile:
pod 'SwiftyDraw'SwiftyDraw is also available through Carthage. To install, add the following line to your Cartfile:
github "awalz/SwiftyDraw" "master"Simply copy the contents of the Source folder into your project.
Using SwiftyDraw is very simple:
Create a SwiftyDrawView and add it to your ViewController:
let drawView = SwiftyDrawView(frame: self.view.frame)
self.view.addSubview(drawView)By default, the view will automatically respond to touch gestures and begin drawing. The default brush is .default, which has a black color.
To disable drawing, simply set the isEnabled property to false:
drawView.isEnabled = falseFor drawing, we use Brush to keep track of styles like width, color, etc.. We have multiple different default brushes, you can use as follows:
drawView.brush = Brush.defaultThe default brushed are:
public static var `default`: Brush { get } // black, width 3
public static var thin : Brush { get } // black, width 2
public static var medium : Brush { get } // black, width 7
public static var thick : Brush { get } // black, width 10
public static var marker : Brush { get } // flat red-ish, width 10
public static var eraser : Brush { get } // clear, width 8; uses CGBlendMode to erase thingsSwiftyDrawView supports drawing-angle-adjusted brushes. This effectively means, if the user (using an Pencil) draws with the tip of the pencil, the brush will reduce its width a little. If the user draws at a very low angle, with the side of the pencil, the brush will be a little thicker.
You can modify this behavior by setting adjustedWidthFactor of a brush. If you increase the number (to, say, 5) the changes will increase. If you reduce the number to 0, the width will not be adjusted at all.
The default value is 1 which causes a slight de-/increase in width.
This is an opt-in feature. That means, in shouldBeginDrawingIn, you need to call drawingView.brush.adjustWidth(for: touch).
For more customization, you can modify the different properties of a brush to fit your needs.
The color of a line stroke can be changed by adjusting the color property of a brush. SwiftyDraw accepts any Color:
drawView.brush.color = Color(.red)or
drawView.brush.color = Color(UIColor(colorLiteralRed: 0.75, green: 0.50, blue: 0.88, alpha: 1.0))We have our own implementation of UIColor – Color – to be able to de-/encode it.
The width of a line stroke can be changed by adjusting the width property of a brush. SwiftyDraw accepts any positive CGFloat:
drawView.brush.width = 5.0The opacity of a line stroke can be changed by adjusting the lineOpacity property. SwiftyDraw accepts any CGFloat between 0 and 1:
drawView.brush.opacity = 0.5If you wish to clear the entire canvas, simply call the clear function:
drawView.clear()drawView.undo()...and redo:
drawView.redo()To en-/disable custom un- & redo buttons, you can use .canUndo and .canRedo.
Apple Pencil can be used for drawing in a SwiftyDrawView, just like a finger.
Special features, however, regarding Apple Pencil 2 are only supported on iOS 12.1 and above versions.
Apple Pencil interaction is enabled by default, but you can set drawView.isPencilInteractive to change that setting.
When double tapping the pencil, SwiftyDraw will check the user preferences set in the system. If the preference is set to switch to eraser, SwiftyDraw will switch between normal and erasing mode; if set to last used tool, SwiftyDraw will switch between current and previous brush.
SwiftyDraw has delegate functions to notify you when a user is interacting with a SwiftDrawView. To access these delegate methods, have your View Controller conform to the SwiftyDrawViewDelegate protocol:
class ViewController: UIViewController, SwiftyDrawViewDelegatefunc swiftyDraw(shouldBeginDrawingIn drawingView: SwiftyDrawView, using touch: UITouch) -> Bool
func swiftyDraw(didBeginDrawingIn drawingView: SwiftyDrawView, using touch: UITouch)
func swiftyDraw(isDrawingIn drawingView: SwiftyDrawView, using touch: UITouch)
func swiftyDraw(didFinishDrawingIn drawingView: SwiftyDrawView, using touch: UITouch)
func swiftyDraw(didCancelDrawingIn drawingView: SwiftyDrawView, using touch: UITouch)This project was built by Awalz and is mostly maintained & improved by LinusGeffarth.
If you'd like to propose any enhancements, bug fixes, etc., feel free to create a pull request or an issue respectively.
If you have any questions, or just want to say Hi!, you can reach me via Twitter, or email.
SwiftyDraw is available under the MIT license. See the LICENSE file for more info.