kawoou / Flexibleimage

FlexibleImage is implemented with the hope that anyone could easily develop an app that provides features such as Camera Filter and Theme. When you write code in the "Method Chaining" style, the effect is applied in the appropriate order.

You may want to see Examples section first if you'd like to see the actual code.

💡 Usage

Code

import UIKit

import FlexibleImage

/// Generate Example
let image1 = UIImage
    .circle(
        color: UIColor.blue,
        size: CGSize(width: 100, height: 100)
    )!
    
    .adjust()
    .offset(CGPoint(x: 25, y: 0))
    .margin(UIEdgeInsets(top: 5, left: 5, bottom: 5, right: 5))
    .padding(UIEdgeInsets(top: 15, left: 15, bottom: 15, right: 15))
    .normal(color: UIColor.white)
    .border(color: UIColor.red, lineWidth: 5, radius: 50)
    .image()!
    
    .adjust()
    .background(color: UIColor.darkGray)
    .image()


/// Effect Example
let image2 = UIImage(named: "macaron.jpg")!
    .adjust()
    .outputSize(CGSize(width: 250, height: 250))
    .exclusion(color: UIColor(red: 0, green: 0, blue: 0.352941176, alpha: 1.0))
    .linearDodge(color: UIColor(red: 0.125490196, green: 0.058823529, blue: 0.192156863, alpha: 1.0))
    .hardMix(color: UIColor(red: 0.3, green: 0.3, blue: 0.3, alpha: 1.0))
    .image()


/// Mix Example
let image3 = image2!.adjust()
    .append(
        image1!.adjust()
            .outputSize(CGSize(width: 250, height: 250))
            .alpha(0.5)
    )
    .image()

/// Clipping Example
let image4 = image3!.adjust()
    .corner(CornerType(25))
    .image()

/// Pipeline
let pipeline = ImagePipeline()
        .exclusion(color: UIColor(red: 0, green: 0, blue: 0.352941176, alpha: 1.0))
        .linearDodge(color: UIColor(red: 0.125490196, green: 0.058823529, blue: 0.192156863, alpha: 1.0))

let image5 = pipeline.image(image2)
let image6 = pipeline.image(image1)

Playground

Use CocoaPods command $ pod try FlexibleImage to try Playground!

🏗 Installation

CocoaPods (For iOS 8+ projects)

KWDrawerController is available on CocoaPods. Add the following to your Podfile:

/// Swift 3
pod 'FlexibleImage', '~> 1.7'

/// Swift 4
pod 'FlexibleImage', '~> 1.9'

Carthage (For iOS 8+ projects)

github "kawoou/FlexibleImage" ~> 1.9

Manually

You can either simply drag and drop the Sources folder into your existing project.

📕 Supported Features

Common

Filter

Blend

Post-processing

Generate

Pipeline (ImagePipeline class)

🎁 Example

• iOS APP Example
• iOS Playground Example
• macOS App Example
• macOS Playground Example
• tvOS App Example
• tvOS Playground Example

🏷 Changelog

• 1.0
  • First Release.
• 1.1
  • Add to clipping corner radius.
• 1.2
  • Support tvOS, macOS.
• 1.3
  • Support watchOS.
  • Added monochrome, sepia, vibrance, solarize, posterize filters.
  • Update resize methods.
• 1.4
  • Add blur filter.
  • Optimize build time.
  • Setup TravisCI
  • Support carthage.
• 1.5
  • Support Metal depending on the situation.
  • Added brightness, chromaKey, swizzling, contrast, gamma filters.
• 1.6 (Hotfix!)
  • Fix issue Metal library path on Cocoapods.
• 1.7
  • Pipelined implementation for stream processing.
  • Fix rendering bug due to image orientation (Thanks to Kwonyoon Kang)
• 1.8
  • Support for Swift 4 and Xcode 9
• 1.9
  • Support for Swift 4.1 and Xcode 9.3
• 1.10
  • Support for Swift 4.2 and Xcode 10

💻 Requirements

• iOS 8.0+
• tvOS 9.0+
• macOS 10.10+
• watchOS 2.0+
• Swift 3.0+

🔑 License

FlexibleImage is under MIT license. See the LICENSE file for more info.