Description
A Photo Editor library with simple, easy support for image editing using paints,text,emoji and Sticker like stories.
PhotoEditor alternatives and similar packages
Based on the "Animations" category.
Alternatively, view PhotoEditor alternatives based on common mentions on social networks and blogs.
-
Lottie for Android, iOS, and React Native
Render After Effects animations natively on Android and iOS, Web, and React Native -
AndroidViewAnimations
Cute view animation collection. -
Material-Animations
Android Transition animations explanation with examples. -
UltimateAndroidReference
:rocket: Ultimate Android Reference - Your Road to Become a Better Android Developer -
AndroidImageSlider
An amazing and convenient Android image slider. -
ListViewAnimations
An Android library which allows developers to easily add animations to ListView items -
NineOldAndroids
Android library for using the Honeycomb animation API on all versions of the platform back to 1.0! -
Rebound
A Java library that models spring dynamics and adds real world physics to your app. -
shimmer-android
An easy, flexible way to add a shimmering effect to any view in an Android app. -
transitions-everywhere
Set of extra Transitions on top of Jetpack Transitions Library -
ChatKit for Android
Android library. Flexible components for chat UI implementation with flexible possibilities for styling, customizing and data management. Made by Stfalcon -
CircleIndicator
A lightweight indicator like in nexus 5 launcher -
android-flip
A component for flip animation on Android, which is similar to the effect in Flipboard iPhone/Android -
RecyclerViewItemAnimators
An Android library which provides simple Item animations to RecyclerView items -
Spotlight
Android Library that lights items for tutorials or walk-throughs etc... -
ViewPagerTransforms
Library containing common animations needed for transforming ViewPager scrolling for Android v13+. -
AnimationEasingFunctions
Android Animation Easing Functions. Let's make animation more real! -
android-ripple-background
A beautiful ripple animation for your app -
FabulousFilter
Android library to animate Floating Action Button to Bottom Sheet Dialog and vice-versa -
CircularReveal
Lollipop ViewAnimationUtils.createCircularReveal for everyone 4.0+ -
ShimmerLayout
DEPRECATED - Memory efficient shimmering effect for Android applications by Supercharge. -
Rich Path Animator
💪 Rich Android Path. 🤡 Draw as you want. 🎉 Animate much as you can. -
BaseAnimation
BaseAnimation network Android animation set, custom controls, nearly 200 kinds of source code! BaseAnimation, if a new version is updated automatically to remind everyone, I hope everyone will contribute their animated XML files or other source, together to create this open source app! -
Stfalcon ImageViewer
A simple and customizable Android full-screen image viewer with shared image transition support, "pinch to zoom" and "swipe to dismiss" gestures -
EasyAndroidAnimations
Easy Android Animations is an animation library that aims to make android animations easier, with 50+ builtin animations, it allows you to introduce many complex animation effects in your application with one or two lines of code. -
SpeedView
Dynamic Speedometer and Gauge for Android. amazing, powerful, and multi shape :zap: -
PreLollipopTransition
Simple tool which help you to implement activity and fragment transition for pre-Lollipop devices. -
ColorPickerView
🎨 Android colorpicker for getting colors from any images by tapping on the desired color. -
EasyFlipView
💳 A quick and easy flip view through which you can create views with two sides like credit cards, poker cards etc. -
TransitionPlayer
Android library to control Transition animates. A simple way to create a interactive animation. -
ArcAnimator
ArcAnimator helps to create arc transition animation: 2.3.+ -
WhatTodo
A Simple Todo app design in Flutter to keep track of your task on daily basis. Its build on BLoC Pattern. You can add a project, labels, and due-date to your task also you can sort your task on the basis of project, label, and dates -
FragmentAnimations
3D animation examples for support-v4 Fragment transition. -
Road Runner
Road Runner is a library for android which allow you to make your own loading animation using a SVG image -
EasingInterpolator
Thirty-one different easing animation interpolators for Android. -
TreeView
Android GraphView is used to display data in graph structures. -
Youtube UI/UX Animation
With MVVM Architecture pattern using Android Architecture Components This is a sample app demonstrating Youtube player animation using constraint layout -
AppIntroAnimation
AppIntroAnimation is a set of code snippets to make cool intro screen for your app with special Image Translation and Transformation animation effects. It is very easy to use and customize without adding third party library integrations. -
Dachshund Tab Layout
Extended Android Tab Layout with animated indicators that have continuous feedback. -
React Native Tabbar Interaction
Tabbar Component For React-Native -
TextFieldBoxes
Material Design text field that comes in a box, based on (OLD) Google Material Design guidelines. -
fab-transformation
Support Floating Action Button transformation for Android
Appwrite - The Open Source Firebase alternative introduces iOS support
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of PhotoEditor or a related project?
README
PhotoEditor
A Photo Editor library with simple, easy support for image editing using Paints, Text, Filters, Emoji and Sticker like stories.
Features
- Drawing on image with option to change its Brush's Color, Size, Opacity, Erasing and basic shapes.
- Apply Filter Effect on image using MediaEffect
- Adding/Editing Text with option to change its Color with Custom Fonts.
- Adding Emoji with Custom Emoji Fonts.
- Adding Images/Stickers
- Pinch to Scale and Rotate views.
- Undo and Redo for Brush and Views.
- Deleting Views
- Saving Photo after editing.
- More FAQ.
- Lesson Learned from building successful android library PhotoEditor: Droidcon Berlin 2021
Benefits
- Hassle free coding
- Increase efficiency
- Easy image editing
Getting Started
To start with this, we need to simply add the dependencies from mavenCentral()
in the gradle file of our app module like this
implementation 'com.burhanrashid52:photoeditor:2.0.0'
or we can also import the :photoeditor module from sample for further customization
Migrations
AndroidX
PhotoEditor v.1.0.0 is a migration to androidX and dropping the support of older support library. There are no API changes. If you find any issue migrating to v.1.0.0 , please follow this Guide. If you still facing the issue than you can always rollback to v.0.4.0. Any fix in PR are Welcome :)
Kotlin
PhotoEditor v.2.0.0 is fully migrated to Kotlin. You can use v.1.5.1 for the Java version. There are no breaking API changes in these two versions.
Setting up the View
First we need to add PhotoEditorView
in our xml layout
<ja.burhanrashid52.photoeditor.PhotoEditorView
android:id="@+id/photoEditorView"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:photo_src="@drawable/got_s" />
We can define our drawable or color resource directly using app:photo_src
We can set the image programmatically by getting source from PhotoEditorView
which will return a ImageView
so that we can load image from resources,file or (Picasso/Glide)
PhotoEditorView mPhotoEditorView = findViewById(R.id.photoEditorView);
mPhotoEditorView.getSource().setImageResource(R.drawable.got);
Building a PhotoEditor
To use the image editing feature we need to build a PhotoEditor which requires a Context and PhotoEditorView which we have to setup in our xml layout
//Use custom font using latest support library
Typeface mTextRobotoTf = ResourcesCompat.getFont(this, R.font.roboto_medium);
//loading font from asset
Typeface mEmojiTypeFace = Typeface.createFromAsset(getAssets(), "emojione-android.ttf");
mPhotoEditor = new PhotoEditor.Builder(this, mPhotoEditorView)
.setPinchTextScalable(true)
.setClipSourceImage(true)
.setDefaultTextTypeface(mTextRobotoTf)
.setDefaultEmojiTypeface(mEmojiTypeFace)
.build();
We can customize the properties in the PhotoEditor as per our requirement
Property | Usage |
---|---|
setPinchTextScalable() |
set false to disable pinch to zoom on text insertion. Default: true. |
setClipSourceImage() |
set true to clip the drawing brush to the source image. Default: false. |
setDefaultTextTypeface() |
set default text font to be added on image |
setDefaultEmojiTypeface() |
set default font specifc to add emojis |
That's it we are done with setting up our library
Drawing
We can customize our brush and paint with different set of property. To start drawing on image we need to enable the drawing mode
Type | Method |
---|---|
Enable/Disable | mPhotoEditor.setBrushDrawingMode(true); |
Shape (brush, line, oval, rectangle) | mPhotoEditor.addShape(shape) |
Shape size (px) | mPhotoEditor.setBrushSize(brushSize) or through the a ShapeBuilder |
Shape opacity (In %) | mPhotoEditor.setOpacity(opacity) or through the a ShapeBuilder |
Shape color | mPhotoEditor.setBrushColor(colorCode) or through the a ShapeBuilder |
Brush Eraser | mPhotoEditor.brushEraser() |
Note: Whenever we set any property of a brush for drawing it will automatically enable the drawing mode
Shapes
We can draw shapes from v.1.5.0. We use ShapeBuilder
to define shape and other properties.
mShapeBuilder = new ShapeBuilder()
.withShapeOpacity(100)
.withShapeType(ShapeType.OVAL)
.withShapeSize(50);
mPhotoEditor.setShape(mShapeBuilder)
For more details check ShapeBuilder.
Filter Effect
We can apply inbuild filter to the source images using
mPhotoEditor.setFilterEffect(PhotoFilter.BRIGHTNESS);
We can also apply custom effect using Custom.Builder
For more details check Custom Filters
Text
We can add the text with inputText and colorCode like this
mPhotoEditor.addText(inputText, colorCode);
It will take default fonts provided in the builder. If we want different fonts for different text we can set typeface with each text like this
mPhotoEditor.addText(mTypeface,inputText, colorCode);
In order to edit the text we need the view, which we will receive in our PhotoEditor callback. This callback will trigger when we Long Press the added text
mPhotoEditor.setOnPhotoEditorListener(new OnPhotoEditorListener() {
@Override
public void onEditTextChangeListener(View rootView, String text, int colorCode) {
}
});
Now we can edit the text with a view like this
mPhotoEditor.editText(rootView, inputText, colorCode);
If you want more customization on text. Please refer the wiki page for more details.
Emoji
We can add the Emoji by PhotoEditor.getEmojis(getActivity());
which will return a list of emojis unicode.
mPhotoEditor.addEmoji(emojiUnicode);
It will take default fonts provided in the builder. If we want different Emoji fonts for different emoji we can set typeface with each Emoji like this
mPhotoEditor.addEmoji(mEmojiTypeface,emojiUnicode);
Adding Images/Stickers
We need to provide a Bitmap to add our Images mPhotoEditor.addImage(bitmap);
Undo and Redo
mPhotoEditor.undo();
mPhotoEditor.redo();
Deleting
For deleting a Text/Emoji/Image we can click on the view to toggle the view highlighter box which will have a close icon. So, by clicking on the icon we can delete the view.
Saving
We need to provide a file with callback method when edited image is saved
mPhotoEditor.saveAsFile(filePath, new PhotoEditor.OnSaveListener() {
@Override
public void onSuccess(@NonNull String imagePath) {
Log.e("PhotoEditor","Image Saved Successfully");
}
@Override
public void onFailure(@NonNull Exception exception) {
Log.e("PhotoEditor","Failed to save Image");
}
});
For more detail check Saving
How to contribute?
- Check out contribution guidelines 👉CONTRIBUTING.md
Questions?🤔
FAQ
Can I use this library in my app for free?
Yes. It's an open-source library and free to use. If this library has saved your time then showing a little credit will increase my motivation towards making the library better :)
Does it support the CROP feature?
Currently, No. I started to build in branch PE-79. But due to time constraint, I drop the idea. Any PR related to CROP is welcomed :)
Facing issues in applying Filter?
The filter effect is applied using GlSurfaceView
and the implementation of this feature causing a lot of issues. Need to think of some other alternative solution. Here is the issue list.
Does is support in other platforms (iOS, Web, Flutter)?
No. Currently, the focus is on making the android library better. We don't have any plans for other Platform.
Other Know Issues
Image Scaling. Memory Issue in Filter.
Who is using PhotoEditor?
Note: I will be happy to add your app to the list. Please reach out to me with details. You know how to reach me :)
Credits
This project is inspired from PhotoEditorSDK
Buy a cup of coffee
If you found this project helpful or you learned something from the source code and want to thank me, consider buying me a cup of ☕️ BuyMeACoffee
Lesson Learned from building successful android library PhotoEditor: Droidcon Berlin 2021
Open source Support by JetBrains
MIT License
Copyright (c) 2022 Burhanuddin Rashid
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*Note that all licence references and agreements mentioned in the PhotoEditor README section above
are relevant to that project's source code only.