kawoou/FlexibleImage — 821 Stars

Topics

#filter #image-processing #ios #macos #metal #playground #swift #tvos #watchos

Language breakdown

No language data available.

▸ Files click to expand

README

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

Example Image

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

| Type | Parameter | Comments | | ---- | --------- | -------- | | background() | Color | Background color. | | opacity() | Float | Change the transparency of the image. | | alphaProcess() | Bool | Whether to include an alpha value during image processing. | | ~~blendMode()~~ | ~~CGBlendMode~~ | (Deprecated) ~~Blend mode of the image~~ | | offset() | CGPoint | The position of the image to be a drawing. | | rotate() | radius: CGFloat
fixedSize: CGSize [Optional] | Rotate an image. | | size() | CGSize | The size of the image to be a drawing. | | outputSize() | CGSize | The size of a Output image. | | scaling() | CGSize | Scaling the image (ratio) | | margin() | EdgeInsets | Margin size | | padding() | EdgeInsets | Padding size | | corner() | CornerType | To clipping corner radius. | | border() | color: Color
lineWidth: CGFloat
radius: CGFloat | Drawing a border. | | image() | | Run the pipeline to create the Output image. |

Filter

| Type | Parameter | Comments | | ---- | --------- | -------- | | greyscale() | threshold: Float [Optional] | | | monochrome() | threshold: Float [Optional] | | | invert() | | | | sepia() | | | | vibrance() | vibrance: Float [Optional] | | | solarize() | threshold: Float [Optional] | | | posterize() | colorLevel: Float [Optional] | | | blur() | blurRadius: Float [Optional] | Not supported by watchOS. | | brightness() | brightness: Float [Optional] | | | chromaKey() | color: FIColor
threshold: Float [Optional]
smoothing: Float [Optional] | | | swizzling() | | | | contrast() | threshold: Float [Optional] | | | gamma() | gamma: Float [Optional] | |

Blend

| Type | Parameter | | ---- | --------- | | normal() | Color | | multiply() | Color | | lighten() | Color | | darken() | Color | | average() | Color | | add() | Color | | subtract() | Color | | difference() | Color | | negative() | Color | | screen() | Color | | exclusion() | Color | | overlay() | Color | | softLight() | Color | | hardLight() | Color | | colorDodge() | Color | | colorBurn() | Color | | linearDodge() | Color | | linearBurn() | Color | | linearLight() | Color | | vividLight() | Color | | pinLight() | Color | | hardMix() | Color | | reflect() | Color | | glow() | Color | | phoenix() | Color | | hue() | Color | | saturation() | Color | | color() | Color | | luminosity() | Color |

Post-processing

| Type | Parameter | Comments | | ---- | --------- | -------- | | algorithm() | AlgorithmType | Create an image by writing a formula directly on a pixel-by-pixel basis. | | custom() | ContextType | Add processing directly using Core Graphics. |

Generate

| Type | Comments | | ---- | -------- | | rect() | Create a rectangular image. | | circle() | Create a circle image. | | append() | Combine images to create a single image. |

Pipeline (`ImagePipeline` class)

| Type | Parameter | Return | Comments | | ---- | --------- | ------ | -------- | | image() | FIImage | FIImage? | Create the Output image. | | image() | CGImage | CGImage? | Create the Output image. | | image() | CVImageBuffer | CGImage? | Create the Output image. |

🎁 Example

🏷 Changelog