img.ly SDK for Android is for creating stunning images with a nice selection of premium filters.
The img.ly Photo Editor SDK provides a variety of tools and functions for creating photo applications for Android. It is licensed under a proprietary license and intended to be used as better alternative for free software applications such as the GPUImage or similiar libraries. If you are interested in our SDK, please contact us.
ACS Component
A generic Android Camera Stack library which is based on the android.hardware.Camera API. Supports front and rear cam, HDR, flash modes and much more.
SDK Component
The img.ly core library for Android. Containing the OpenGL and toolset implementation.
UI Component
The default UI components consisting of LivePreview and Editor Activity.
PLUGIN Components
At the momment not implemented, it is for future use. For Example to embedding you Google Analytics.
No external non Google libraries needed or used by the SDK.
- com.android.support:recyclerview-v7:23.2.0'
- com.android.support:support-annotations:23.2.0'
- Android API Level 15+. Covers nearly 95% of all Android devices.
- Default UI for camera preview and editing. Based on Intents and Activities.
- Fast image export. Even with large images or slow devices the export is done in adequate time with background processing.
- Generic camera support. Integrated and featureful on the most Android phones.
- Crop, Rotate, Stickers, Text Placement, and Colorize. All essential photo editing functions wrapped into a simple, beautiful and customizable UI.
- 57 Stunning filters which are builtin and work out of the box.
- No native code. Our backend is Renderscript based with highlevel OpenGL support, therefore we dodge all the nasty native library problems other frameworks face.
- Tablet support. Works great on tablets.
- Photoshop LUT. Design color filters in Photoshop! With this feature it is possible to generate LUT (Look Up Table) color filters easily from different photo editing tools. Export and integrate them in minutes!
- Live Preview up to 21mpx. Filters can be previewed in high quality realtime on full camera resolution.
- Low memory footprint even with high resolution images.
- Extensible and customizable toolset interface. Add your own customized filters with Renderscript and modify tool properties yourself.
img.ly SDK for Android is a licensed library which can be used for different purposes.
Please see:
LICENSE.PROPIETARY for PROPIETARY usage.
© 9elements GmbH
Email
Homepage
Follow us on Twitter
Require a minimum deployment target of Android API 15 (4.0.4) and Device with HardwareLayer (for LivePreview) and LargeHeap Support (To operate and export large images)
There are few things we'll need to add here. See comments in the example code below.
DO NOT FORGET TO ADD RENDERSCRIPT SUPPORT!
apply plugin: 'com.android.application'
android {
/* Set the Compile SDK and the Build SDK min. at SDK 23 or grater. */
compileSdkVersion 23
buildToolsVersion '23.0.2'
/* If you update from SDK 22 and below, the ApacheHttp-Library are removed by Google,
* if you need the ApacheHttp-Library comment out the next this line */
// useLibrary 'org.apache.http.legacy'
defaultConfig {
/* Replace with your App-ID @see http://tools.android.com/tech-docs/new-build-system/applicationid-vs-packagename */
applicationId "my.domain.application"
/* Set the minimum supported SDK Version to 15 (Android 4.0.3) or higher */
minSdkVersion 15
/* Set the target SDK Version at minimum to 23 or higher */
targetSdkVersion 23
/* Set your own Version Code and Version name */
versionCode 1
versionName "1.0"
/* Don't forget this two lines, apart from that the app will crash! */
renderscriptTargetApi 20
renderscriptSupportModeEnabled true
}
/* Set Java Language level minimal to Java 1.7 or greater */
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_7
targetCompatibility JavaVersion.VERSION_1_7
}
...
}
dependencies {
/* Make sure you are import the latest SDK version */
compile 'ly.img.android:photo-editor-sdk:1.0.8'
}
...
Be also sure to sync your project with the Gradle files after making any edits.
For more information about gradle look at http://developer.android.com/tools/building/configuring-gradle.html
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.mymodule.app" >
<application
android:name=".Application"
... >
...
</application>
</manifest>
public class Application extends android.app.Application {
@Override
public void onCreate() {
super.onCreate();
ImgLySdk.init(this);
}
}This is what your Activity should look like. Follow the steps below to understand the individual workflow:
public class MainActivity extends Activity implements PermissionRequest.Response{
public static int CAMERA_PREVIEW_RESULT = 1;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
new CameraPreviewIntent(this)
.setExportDir(CameraPreviewIntent.Directory.DCIM, "ImgLyExample")
.setExportPrefix("example_")
.setEditorIntent(
new PhotoEditorIntent(this)
.setExportDir(PhotoEditorIntent.Directory.DCIM, "ImgLyExample")
.setExportPrefix("result_")
.destroySourceAfterSave(true)
)
.startActivityForResult(CAMERA_PREVIEW_RESULT);
}
@Override
protected void onActivityResult(int requestCode, int resultCode, android.content.Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (resultCode == RESULT_OK && requestCode == CAMERA_PREVIEW_RESULT) {
String path = data.getStringExtra(CameraPreviewActivity.RESULT_IMAGE_PATH);
Toast.makeText(this, "Image Save on: " + path, Toast.LENGTH_LONG).show();
}
}
//Important for Android 6.0 permisstion request, don't forget this!
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
PermissionRequest.onRequestPermissionsResult(requestCode, permissions, grantResults);
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
}
@Override
public void permissionGranted() {
}
@Override
public void permissionDenied() {
//The Permission whas rejected by the user, so the Editor was not opened because it can not save the result Image.
//TODO for you: Show a Hint to the User
}
}Do not forget to delegate the onRequestPermissionsResult to PermissionRequest.onRequestPermissionsResult. Apart from that it will not work on Android 6.0 and above
// Camera activity intent with customized editor access.
new CameraPreviewIntent(this)
.setExportPrefix("example_")
.setEditorIntent(
new PhotoEditorIntent(this)
.setExportDir(PhotoEditorIntent.Directory.DCIM, "ImgLyExample")
.setExportPrefix("result_")
.destroySourceAfterSave(true)
)
.setExportDir(CameraPreviewIntent.Directory.DCIM, "ImgLyExample")
.startActivityForResult(CAMERA_PREVIEW_RESULT);// Editor activity intent.
new PhotoEditorIntent(this)
.setSourceImagePath(imagePath)
.setExportDir(PhotoEditorIntent.Directory.DCIM, "ImgLyExample")
.setExportPrefix("result_")
.destroySourceAfterSave(true)
.startActivityForResult(CAMERA_PREVIEW_RESULT);// Toolset modifications can be done easily inside the Application class.
public class Application extends android.app.Application {
@Override
public void onCreate() {
super.onCreate();
ImgLySdk.init(this);
// Step1 get current configuration.
ArrayList<CropAspectConfig> cropConfig = PhotoEditorSdkConfig.getCropConfig();
// Step2 clear it.
cropConfig.clear();
// Step3 add the needed properties and filters for different tools.
cropConfig.add(new CropAspectConfig(R.string.imgly_crop_name_custom, R.drawable.icon_crop_custom, -1));
cropConfig.add(new CropAspectConfig(R.string.imgly_crop_name_4_3, R.drawable.icon_crop_4_3, 4/3));
// Step4 done!
// More examples:
ArrayList<ColorFilter> colorFilterConfig = PhotoEditorSdkConfig.getFilterConfig();
colorFilterConfig.clear();
colorFilterConfig.add(new NoneColorFilter());
colorFilterConfig.add(new ColorFilterBleached());
colorFilterConfig.add(new ColorFilterChest());
ArrayList<ImageStickerConfig> stickers = PhotoEditorSdkConfig.getStickerConfig();
stickers.clear();
}
}Some AndroidStudio decides to import PermissionRequest.Response from android.webkit.PermissionRequest. Make sure you import ly.img.android.ui.utilities.PermissionRequest.