Add examples to README

README.md

@@ -8,10 +8,47 @@
 
 <img src="https://raw.githubusercontent.com/hyperoslo/Imaginary/master/Images/icon.png" alt="Brick Icon" align="right" />
 
+## Description
+
+Using remote images in an application is more or less a requirement these days.
+This process should be easy, straight-forward and hassle free, and with `Imaginary`, it is.
+With a narrow yet flexible public API, you can set images using URL's, add
+placeholders, pre-process images and use callbacks for when images are set.
+
 ## Usage
 
+### Set image with URL
+```swift
+let imageView: UIImageView()
+let imageURL: NSURL(string: "https://avatars2.githubusercontent.com/u/1340892?v=3&s=200")
+imageView.setImage(URL: imageURL)
+```
+
+### How to apply placeholder images
+```swift
+let imageView: UIImageView()
+let placeholder = UIImage(named: "PlaceholderImage")
+let imageURL: NSURL(string: "https://avatars2.githubusercontent.com/u/1340892?v=3&s=200")
+imageView.setImage(URL: imageURL, placeholder: placeholder)
+```
+
+### Pre-processing images
+```swift
+let imageView: UIImageView()
+let imageURL: NSURL(string: "https://avatars2.githubusercontent.com/u/1340892?v=3&s=200")
+imageView.setImage(URL: imageURL, preprocess: { image in
+  /// Apply pre-process here ...
+  return image
+})
+```
+
+### Callback when image is set to the image view
 ```swift
-<API>
+let imageView: UIImageView()
+let imageURL: NSURL(string: "https://avatars2.githubusercontent.com/u/1340892?v=3&s=200")
+imageView.setImage(URL: imageURL) { image in
+  /// This closure gets called when the image is set to the image view.
+}
 ```
 
 ## Installation