Transformations UI for iOS

To install our Swift Package, please follow the steps below:

Import TransformationsUI

import TransformationsUI

Instantiate TransformationsUI and set delegate

let transformationsUI = TransformationsUI()
transformationsUI.delegate = self

Add conformance to TransformationsUIDelegate

extension ViewController: TransformationsUIDelegate {
    func editorDismissed(with image: UIImage?) {
        if let image = image {
            // TODO: Do something with resulting image...
        }
    }
}

Present TransformationsUI view controller

extension ViewController: TransformationsUIDelegate {
    func editorDismissed(with image: UIImage?) {
        if let image = image {
            // TODO: Do something with resulting image...
        }
    }
}

Below you will find an exhaustive list of configurable properties and commands per module.

Modules may be enabled or disabled programmatically. Let’s see an example:

Defining the available modules

modules.all = [
    modules.transform,
    modules.filters,
    modules.adjustments
]

Module features may be enabled or disabled programmatically. Let’s see a few examples:

Allow only circle crop in transform module

modules.transform.cropCommands = [
    Modules.Transform.Commands.Crop(type: .none),
    Modules.Transform.Commands.Crop(type: .circle)
]

Disable extra commands in transform module

modules.transform.extraCommands = []

Define custom crop modes in transform module

// Keep original ratio
modules.transform.cropCommands.append(
    Modules.Transform.Commands.Crop(type: .rect, aspectRatio: .original)
)

// Keep 16:9 ratio
modules.transform.cropCommands.append(
    Modules.Transform.Commands.Crop(type: .rect, aspectRatio: .custom(CGSize(width: 16, height: 9)))
)

Define available filters in filters module

modules.filters.commands = [
    Modules.Filters.Commands.Filter(type: .chrome),
    Modules.Filters.Commands.Filter(type: .process),
    Modules.Filters.Commands.Filter(type: .instant)
]

Add extra available font families in text module

modules.text.availableFontFamilies.append(contentsOf: ["Optima Regular", "Symbol"])

Or you may want to replace available font families completely:

modules.text.availableFontFamilies = ["Optima Regular", "Symbol"]

Add stickers in stickers module

modules.sticker.stickers = [
    "Funny": (1...18).compactMap { UIImage(named: "stickers-funny-\($0)") },
    "Hilarious": (1...18).compactMap { UIImage(named: "stickers-hilarious-\($0)") },
    "Extravagant": (1...18).compactMap { UIImage(named: "stickers-extravagant-\($0)") },
    "Kick-ass": (1...18).compactMap { UIImage(named: "stickers-kickass-\($0)") }
]

To discover other module features that may be configured, enabled, or disabled, try Xcode’s autocompletion on your Modules objects.

Check the demo showcasing Transformations UI usage.