bevy / photo-editor-android

Photo Editor SDK contains a lot of features like edit, scale, rotate and draw on images like Instagram stories.
MIT License
550 stars 188 forks source link
android facebook image-processing instagram photo-editing photo-editor

PhotoEditorSDK

alt tag

It is an android image editing SDK with simple, easy support for image manipulation.


Features

Benefits


Installation

For Gradle :

Step 1 : Add it in your root build.gradle at the end of repositories

allprojects {
  repositories {
   ...
   maven { url 'https://jitpack.io' }
  }
}

Step 2 : Add the dependency

dependencies {
         compile 'com.github.eventtus:photo-editor-android:v1.0'
 }

For Maven :

Step 1 : Add it in your root build.gradle at the end of repositories

<repositories>
  <repository>
      <id>jitpack.io</id>
      <url>https://jitpack.io</url>
  </repository>
</repositories>

Step 2 : Add the dependency

<dependency>
     <groupId>com.github.eventtus</groupId>
     <artifactId>photo-editor-android</artifactId>
     <version>v1.0</version>
</dependency>

User Documentation :

  1. First of all you have to get instance of PhotoEditorSDK to initialize it and start calling the desired functions.

    photoEditorSDK = new PhotoEditorSDK.PhotoEditorSDKBuilder(PhotoEditorActivity.this)
    .parentView(parentImageRelativeLayout)
    //add parent image view
    .childView(photoEditImageView)
    //add the desired image view
    .deleteView(deleteRelativeLayout)
    //add the deleted view that will appear during the movement of the views
    .brushDrawingView(brushDrawingView)
    // add the brush drawing view that is responsible for drawing on the image view
    .buildPhotoEditorSDK();
    // build photo editor sdk
  2. To add Text on the image:

    photoEditorSDK.addText(text, colorCodeTextView);
  3. To add Image or Stickers:

    photoEditorSDK.addImage(image);
  4. To add Emoji:

    photoEditorSDK.addEmoji(emojiName, emojiFont);
  5. To Draw on the image:

    photoEditorSDK.setBrushDrawingMode(brushDrawingMode);
    // brushDrawingMode is false by default, true if you want to draw on the image view
  6. To change the Color and Size of the drawing view and the Size and the Color of the Eraser view:

    photoEditorSDK.setBrushSize(size);
    photoEditorSDK.setBrushColor(colorCode);
    photoEditorSDK.brushEraser();
    photoEditorSDK.setBrushEraserSize(brushEraserSize);
    photoEditorSDK.setBrushEraserColor(color);
  7. To Save the image after editing:

    photoEditorSDK.saveImage(folderName, imageName);
  8. To Undo the added Views (Image or Text):

    photoEditorSDK.viewUndo();
  9. To Clear All the added Views (Image or Text):

    photoEditorSDK.clearAllViews();
  10. To Clear All the added Drawing Views:

    photoEditorSDK.clearBrushAllViews();
  11. To listen on Added Views, Edit the added Text Views, Added and Removed Views and Start and Stop Moving Views. You can implement:

    photoEditorSDK.setOnPhotoEditorSDKListener(new OnPhotoEditorSDKListener() {
    @Override
    public void onEditTextChangeListener(String text, int colorCode) {
    
    }
    @Override
    public void onAddViewListener(ViewType viewType, int numberOfAddedViews) {
    
    }
    @Override
    public void onRemoveViewListener(int numberOfAddedViews) {
    
    }
    @Override
    public void onStartViewChangeListener(ViewType viewType) {
    
    }
    @Override
    public void onStopViewChangeListener(ViewType viewType) {
    
    }
    });

Contributing

We welcome contributions from other developers to help us make the SDK even better. Before you contribute there are a number of things that you should know please see CONTRIBUTING.md for details.

Credits

PhotoEditorSDK was originally written by Ahmed Adel. Project is maintained and funded by

Eventtus

License

Copyright (c) 2017 Eventtus, PhotoEditorSDK is released under the MIT license.