Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
bachonk committed Mar 25, 2017
1 parent 8ecdf7a commit 92b2795
Showing 1 changed file with 52 additions and 2 deletions.
54 changes: 52 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,52 @@
# InitialsImageView
A simple UIImageView extension for using initials as a profile image, written in swift
InitialsImageView
===================

An easy, helpful UIImageView extension that generates letter initials as a placeholder for user profile images, with a randomized background color

![Example screenshot](http://i.imgur.com/xSBjVQ7.png)

### Installation

##### CocoaPods

Add this spec to your podfile:

`pod "InitialsImageView"`

Check out the [official guide](http://guides.cocoapods.org/using/index.html) for getting started with CocoaPods.

##### Manual

1. Drag the `InitialsImageView.swift` file into your project
2. Enjoy!

### Usage

##### Methods

Call the following methods on any `UIImageView` instance to set the image:

+ `setImageForName(string: String, backgroundColor: UIColor?, circular: Bool, textAttributes: [String: AnyObject]?)`

`string` is the string used to generate the initials. This should be a user's full name if available.

`backgroundColor` is an optional parameter that sets the background color of the image. Pass in `nil` to have a color automatically generated for you.

`circular` is a boolean parameter that will automatically clip the image to a circle if enabled.

`textAttributes` is an optional dictionary of predefined character attributes for text. You can find the list of available keys in NSAttributedString

##### Example

```
let randomImage: UIImageView = UIImageView.init(frame: CGRect(x: self.view.bounds.midX - 40, y: self.view.bounds.midY - 80 - 40, width: 80, height: 80))
randomImage.setImageForName(string: "Michael Bluth", backgroundColor: nil, circular: true, textAttributes: nil)
```

### Saying Thanks

If you like this tool, show your support by downloading the free [Reach Contact List](https://itunes.apple.com/us/app/reach-your-contact-list/id898802540?mt=8) app that inspired it!

### License

Using the MIT license. See license file for details.

0 comments on commit 92b2795

Please sign in to comment.