hernangonzalez / TouchDraw

A subclass of UIView which allows you to draw with your fingers.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

TouchDraw

Join the chat at https://gitter.im/dehli/TouchDraw

The TouchDraw module allows you to use the TouchDrawView class. This is a subclass of UIView which allows you to draw pictures with your finger.

Installation

The easiest way to include TouchDraw is by using CocoaPods and adding the following to your Podfile.

use_frameworks!
pod 'TouchDraw', '~> 1.2'

If you're not using CocoaPods, you can add the TouchDrawView.swift file to your project.

Usage

You can either programmatically add the TouchDrawView or add it using storyboards.

Storyboards

If using storyboards, you must add a UIView to your storyboard. Give it the TouchDrawView class, and TouchDraw module.

Storyboard class

Code

If programmatically adding the view, you can use the init(frame: CGRect) method to create a new instance of TouchDrawView. You must make sure to write import TouchDraw at the top of the class.

Customizing

When customizing the TouchDrawView you can setting its delegate. The container can conform to parts of TouchDrawViewDelegate, which has the following functions:

func undoEnabled() -> Void {
    // triggered when undo is enabled
    // (only if it was previously disabled)
}
func undoDisabled() -> Void {
    // triggered when undo is disabled
    // (only if it previously enabled)
}
func redoEnabled() -> Void {
    // triggered when redo is enabled
    // (only if it was previously disabled)
}
func redoDisabled() -> Void {
    // triggered when redo is disabled
    // (only if it previously enabled)
}
func clearEnabled() -> Void {
    // triggered when clear is enabled
    // (only if it was previously disabled)
}
func clearDisabled() -> Void {
    // triggered when clear is disabled
    // (only if it previously enabled)
}

The TouchDrawView exposes the following methods:

  • exportDrawing() -> UIImage
    • Exports a UIImage version of the drawing.
  • clearDrawing()
    • Clears the TouchDrawView.
  • undo()
    • Undo the last stroke.
  • redo()
    • Redo what was undone.
  • setColor(color: UIColor)
    • Sets the color of future strokes.
  • setWidth(width: CGFloat)
    • Sets the width of future strokes.
  • importStack(stack: [Stroke])
    • Set the TouchDrawView to have certain strokes (usually will be used in conjunction with exportStack().
  • exportStack() -> [Stroke]
    • Exports the strokes from a TouchDrawView so they can be imported later.

Demo

If you'd like to see this library in action, you can download the entire repository and open Demo/TouchDrawDemo.xcworkspace.

Demo/TouchDrawDemo/ViewController.swift is where most of its functionality is demonstrated.

Demo Screenshot

Contributors

If you'd like to see additional functionality, feel free to open up a new issue or submit a pull request if you'd like to author it yourself.

License

This package has the MIT license, which can be found here: LICENSE.

About

A subclass of UIView which allows you to draw with your fingers.

License:MIT License


Languages

Language:Swift 65.5%Language:Shell 26.2%Language:Ruby 5.1%Language:Objective-C 3.2%