Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/ipraba/EPSignature

Signature component for iOS in Swift
https://github.com/ipraba/EPSignature

Last synced: about 2 months ago
JSON representation

Signature component for iOS in Swift

Lists

README 

        


  EPSignature




# EPSignature



Signature component for iOS written in Swift



[![Platform](https://img.shields.io/cocoapods/p/EPSignature.svg?style=flat)](http://cocoapods.org/pods/EPSignature)

[![Swift 4.0](https://img.shields.io/badge/Swift-4.0-orange.svg?style=flat)](https://developer.apple.com/swift/)

[![CI Status](https://travis-ci.org/ipraba/EPSignature.svg?branch=master)](https://travis-ci.org/ipraba/EPSignature)

[![Version](https://img.shields.io/cocoapods/v/EPSignature.svg?style=flat)](https://cocoapods.org/?q=EPsignature)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

[![License](http://img.shields.io/badge/license-MIT-33e0ff.svg)](https://github.com/ipraba/EPSignature/blob/master/LICENSE)

[![Twitter: @HaveYouMetPrabu](https://img.shields.io/badge/[email protected]?style=flat)](https://twitter.com/HaveYouMetPrabu)



### Preview

![Screenshot](https://raw.githubusercontent.com/ipraba/EPSignature/master/Screenshots/iPhone.png)    ![Screenshot](https://raw.githubusercontent.com/ipraba/EPSignature/master/Screenshots/iPad.png)



### Installation



##### [CocoaPods](http://cocoapods.org)



EPSignature is available through CocoaPods. To install it, simply add the following line to your Podfile:

```ruby

pod "EPSignature"

```



##### [Carthage](https://github.com/Carthage/Carthage#if-youre-building-for-ios)



To integrate EPSignature into your Xcode project using Carthage, specify it in your Cartfile:

```ruby

github "ipraba/EPSignature"

```



##### Manual Installation



Just drag and drop the files in `Pod/Classes` folder into your project



#### Features



1. User can draw the signature either by finger or by apple pencil

2. Ability to save the signature as default signature which can be retrieved later

3. Ability to load the saved signature

4. Works on both orientations(portrait and landscape)

5. Works on both iPhone and iPad devices

6. Also can be embedded in any container view

7. Can extract the signature as Image

8. Draws smoothly



### Initialization of EPSignatureViewController

```swift

let signatureVC = EPSignatureViewController(signatureDelegate: self, showsDate: true, showsSaveSignatureOption: true)

signatureVC.subtitleText = "I agree to the terms and conditions"

signatureVC.title = "John Doe"

let nav = UINavigationController(rootViewController: signatureVC)

presentViewController(nav, animated: true, completion: nil)

```



Note: You can also embed the signature view in any one of the container using the EPSignatureView



### Properties of EPSignatureViewController



Properties | Description

---- | ---------

**`showsDate`**|`Bool value that allows to show the date while signing`

**`showsSaveSignatureOption`**|`Bool value that allows the user to save the signature for future use`

**`signatureDelegate`**|`Delegate listening for events`

**`subtitleText`**|`Subtitle text for signature(Eg: Sign here)`

**`tintColor`**|`Tint color for the view controller. Applies for barbuttons, switches and actionsheet`



### Properties of EPSignatureView



Properties | Description

---- | ---------

**`strokeColor`**|`Stroke color of the signature`

**`strokeWidth`**|`Stroke width of the signature`

**`isSigned`**|`Bool value checks whether the user has signed or not`



### EPSignatureViewController Delegates

```swift

func epSignature(_: EPSignature.EPSignatureViewController, didCancel error: NSError)

func epSignature(_: EPSignature.EPSignatureViewController, didSign signatureImage: UIImage, boundingRect: CGRect)

```



Note: boundingRect will contain the bounds of the signed image retrieved. Crop using this rect to make shorter and small signature images



### License



EPSignature is available under the MIT license. See the [LICENSE](https://github.com/ipraba/EPSignature/blob/master/LICENSE) file for more info.



### Author



[@ipraba](https://github.com/ipraba)