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
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
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
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.
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];
}
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
}
}];
}
Collage
Draw, Color splash
Real time effect camera
Dynamic sticker
Store (in-app purchase)
Design, coding: Dake, ArcRain, wysaid
Powered by fotor
FotorSDK-iOS is released under the MIT License, see LICENSE.