FotorSDK-iOS

FotorSDK is a complete set of photo editing tools comes standard in Fotor’s all-platform SDK. You can select the tools that are best for your app, or use them all.

Get more info and downloads of FotorSDK (for iOS and Android) via the FotorSDK mobile portal

Click here for official documentation for FotorSDK-iOS

Installing

The easiest way to use FotorSDK is to add all the files in the FotorSDK-iOS group (or directory) into your app with "Create groups for any added folders" option of Xcode.

Add the following frameworks to your project (Build Phases > Link Binary With Libraries): AssetsLibrary, AVFoundation, CoreGraphics, CoreMedia, GLKit, OpenGLES, libc++.dylib, libsdtc++.dylib.

Add the linker flags to your project (Build Settings > Linking > other Linker Flags): -ObjC.

Detail Illustration Description

Or git submodule

Alternatively, you should be able to setup a git submodule and reference the files in your Xcode project.

git submodule add https://github.com/Fotor/FotorSDK-iOS.git

Usage

Getting started with FotorSDK-iOS is dead simple. Just initialize it with an UIimage and set a delegate. Then you can use it as a usual ViewController. Demo apps

#import "EIPhotoSDK.h"

@interface ViewController() <EIPhotoSDKEditorControllerDelegate>
{
	NSMutableArray *_editorSessions;
}

@end

- (void)launchPhotoEditorWithImage:(UIImage *)editingResImage highResolutionImage:(UIImage *)highResImage
{
    EIPhotoSDKEditorController *ctrler = [EIPhotoSDK photoEditorControllerWithImage:editingResImage error:NULL];
    ctrler.editorDelegate = self;
    
    // If a high res image is passed, create the high res context with the image and the photo editor.
    if (nil != highResImage) {
        [self setupHighResContextForPhotoEditor:ctrler withImage:highResImage];
    }
    
    // Present the photo editor.
    [self presentViewController:ctrler animated:YES completion:nil];
}

- (void)setupHighResContextForPhotoEditor:(EIPhotoSDKEditorController *)photoEditor withImage:(UIImage *)highResImage
{
    // Capture a reference to the editor's session, which internally tracks user actions on a photo.
    EIPhotoSDKSession *session = [photoEditor session];
    [_editorSessions addObject:session];
    
    EIPhotoSDKContext *context = [session createContextWithImage:highResImage];
    [context renderWithBegin:nil complete:^(UIImage *result, BOOL completed) {
        if (nil != result) {
            // now, you got the result image 
        }
    }];
}

When used with UIImagePickerController, EIPhotoSDKEditorController can be made to function as a part of the picker by to call the launchPhotoEditorWithImage:highResolutionImage: above.

#pragma mark - UIImageController delegate

- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info
{
    NSURL *assetURL = info[UIImagePickerControllerReferenceURL];
    void(^completion)(void)  = ^(void){
        
        ALAssetsLibrary *assetsLibrary = [[ALAssetsLibrary alloc] init];
        [assetsLibrary assetForURL:assetURL resultBlock:^(ALAsset *asset) {
            if (asset){
                UIImage *screenImage = [self editingResImageForAsset:asset];
                UIImage *fullResolutionImage = [self highResImageForAsset:asset];
                [self launchPhotoEditorWithImage:screenImage highResolutionImage:fullResolutionImage];
                _noPhotoView.hidden = YES;
            }
        } failureBlock:^(NSError *error) {
            [[[UIAlertView alloc] initWithTitle:NSLocalizedString(@"Error", nil)
                                        message:NSLocalizedString(@"Please enable access to your device's photos.", nil)
                                       delegate:nil
                              cancelButtonTitle:NSLocalizedString(@"OK", nil)
                              otherButtonTitles:nil] show];
        }];
    };
    
    [self dismissViewControllerAnimated:YES completion:completion];
}


#pragma mark - ALAssets Helper Methods

- (UIImage *)editingResImageForAsset:(ALAsset *)asset
{
    CGImageRef image = [[asset defaultRepresentation] fullScreenImage];
    return [UIImage imageWithCGImage:image scale:1.0 orientation:UIImageOrientationUp];
}

- (UIImage *)highResImageForAsset:(ALAsset*)asset
{
    ALAssetRepresentation * representation = [asset defaultRepresentation];
    
    CGImageRef image = [representation fullResolutionImage];
    UIImageOrientation orientation = (UIImageOrientation)[representation orientation];
    CGFloat scale = [representation scale];
    
    return [UIImage imageWithCGImage:image scale:scale orientation:orientation];
}

After a image has been edited, the editor will call delegate's photoEditor:didFinishedWithImage: method. The delegate's method is required to receive edited image.

#pragma mark - EIPhotoSDKEditorControllerDelegate

- (void)photoEditor:(EIPhotoSDKEditorController *)editor didFinishedWithImage:(UIImage *)image
{
    _imageView.image = image;
    [editor dismissViewControllerAnimated:YES completion:nil];
}

Additionally, the optional delegate's photoEditorDidCancel: method is provided for when you want to catch the cancel callback.

For more detail, please see Demo apps.

Customizing

Menu customization

Editor menu tools can customize using EIPhotoEditorCustomization's setToolOrder method.

- (void)setPhotoEditorCustomizationOptions
{
    /*
    // set status bar hidden here, when editor opened
    [EIPhotoEditorCustomization setStatusBarHidden:NO];
     */
    
    /*
    // set status bar style when status bar not hide, only available for iOS7 and later
    [EIPhotoEditorCustomization setStatusBarStyle:UIStatusBarStyleLightContent];
     */

    /*
    // set supported orientation on ipad, default is UIInterfaceOrientationMaskAll
    if (UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPad) {
        [EIPhotoEditorCustomization setSupportedIpadOrientationMask:UIInterfaceOrientationMaskLandscape];
    }
     */
    
    // set editor toolbar supported module, you can specify all the moduls in EIPhotoEditorCustomization in any order, or skip any of them
    [EIPhotoEditorCustomization setToolOrder:@[kEIEnhance, kEIScene, kEIBaseAdjust, kEIAdvanceAdjust, kEIEffect, kEIRotate, kEICrop, kEIFrame, kEISticker, kEIText, kEITiltshift]];
}

then you update the launchPhotoEditorWithImage:highResolutionImage: method above like this:

- (void)launchPhotoEditorWithImage:(UIImage *)editingResImage highResolutionImage:(UIImage *)highResImage
{
 // Customize the editor's apperance. The customization options really only need to be set once in this case since they are never changing, so we used dispatch once here.
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        [self setPhotoEditorCustomizationOptions];
    });
    
    [_editorSessions removeAllObjects];
    
    EIPhotoSDKEditorController *ctrler = [EIPhotoSDK photoEditorControllerWithImage:editingResImage error:NULL];
    ctrler.editorDelegate = self;
    
    // If a high res image is passed, create the high res context with the image and the photo editor.
    if (nil != highResImage) {
        [self setupHighResContextForPhotoEditor:ctrler withImage:highResImage];
    }
    
    // Present the photo editor.
    [self presentViewController:ctrler animated:YES completion:nil];
}

Specify Output image size

You can set Output image size with EIPhotoSDKContext's createContextWithImage:maxPixelSize: method

- (void)setupHighResContextForPhotoEditor:(EIPhotoSDKEditorController *)photoEditor withImage:(UIImage *)highResImage
{
    // Capture a reference to the editor's session, which internally tracks user actions on a photo.
    EIPhotoSDKSession *session = [photoEditor session];
    [_editorSessions addObject:session];
    
    EIPhotoSDKContext *context = [session createContextWithImage:highResImage maxPixelSize:MAXFLOAT];
    [context renderWithBegin:nil complete:^(UIImage *result, BOOL completed) {
        if (nil != result) {
            // now, you got the result image 
        }
    }];
}

TODO

Collage

Draw, Color splash

Real time effect camera

Dynamic sticker

Store (in-app purchase)

Credits

Design, coding: Dake, ArcRain, wysaid

Powered by fotor

License

FotorSDK-iOS is released under the MIT License, see LICENSE.