ThumborURL

A library to generate encrypted URLs for Thumbor in your iOS app.

Features

• Encrypts and signs Thumbor URLs
• Sets image manipulation options
  • Resize
  • Crop
  • Filters
  • Scale
  • Flipping
  • Detection
  • Trim
• Performs quickly

Installation

Cocoapods

1. Add pod ThumborURL to your Podfile.
2. pod install
3. import ThumborURL (Swift) or @import ThumborURL; (Objective-C).

Manually

1. Add https://github.com/square/ThumborURL.git as a submodule of your project.
2. Add thumborurl.xcodeproj as a subproject of your Xcode project.
3. Make the thumborurl library a dependency of your target.
4. Link the thumborurl library to your target.
5. #import <thumborurl/ThumborURL.h>

Usage

Swift

letimageURL=URL(string:"twitter.com/foo.png")!
letbaseURL=URL(string:"http://images.example.com")!
letsecurityKey="omg152"letoptions=TUOptions()
options.crop =CGRect(x:10, y:10, width:10, height:10)
options.smart =true
options.targetSize =CGSize(width:10, height:10)
options.fitIn =.normal
options.vflip =true
options.filters =[TUFilter(name:"watermark", argumentsArray:["blah.png","10","20","30"]),TUFilter(name:"watermark", argumentsArray:["baz.png","4","8","5"])]letthumborImageURL=NSURL.tu_secureURL(with: options, imageURL: imageURL, baseURL: baseURL, securityKey: securityKey)
// thumborImageURL = "http://images.example.com/9sG5VMXh7HoCgPlNH8AZx42y4fc=/10x10:20x20/fit-in/10x-10/smart/filters:watermark(blah.png,10,20,30):watermark(baz.png,4,8,5)/twitter.com/foo.png"

Objective-C

TUOptions *opts = [[TUOptions alloc] init];
NSURL *imageURL = [NSURLURLWithString:@"twitter.com/foo.png"];
NSURL *baseURL = [NSURLURLWithString:@"http://images.example.com"];
NSString *key = @"omg152";
opts.crop = CGRectMake(20, 20, 20, 20);
opts.smart = YES;
opts.targetSize = CGSizeMake(10, 10);
opts.fitIn = TUFitInNormal;
opts.vflip = YES;
opts.filters = @[[TUFilter filterWithName:@"watermark"arguments:@"blah.png", @"10", @"20", @"30", nil],
[TUFilter filterWithName:@"watermark"arguments:@"baz.png", @"4", @"8", @"15", nil]];
NSURL *thumborImageURL = [NSURLTU_secureURLWithOptions:opts imageURL:imageURL baseURL:baseURL securityKey:key];
// thumborImageURL is http://images.example.com/9sG5VMXh7HoCgPlNH8AZx42y4fc=/10x10:20x20/fit-in/10x-10/smart/filters:watermark(blah.png,10,20,30):watermark(baz.png,4,8,5)/twitter.com/foo.png