From 8c57740eae8c800bc0652cd89950d2ee5efa5d8f Mon Sep 17 00:00:00 2001
From: agoncalvesos <51172649+agoncalvesos@users.noreply.github.com>
Date: Thu, 18 Jul 2019 10:10:06 +0100
Subject: [PATCH] Update README.md
---
README.md | 88 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 88 insertions(+)
diff --git a/README.md b/README.md
index eba56b6..54f2ecb 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,89 @@
# image-editor-plugin
+
+This plugin defines a window.imageeditorplugin object, which supplies an interface to take pictures with the camera, get a picture from the gallery or use a base64 string, allowing the user to crop that picture, add text, emojis, stickets and share that picture. The edited image is then exported as base64, ready to be saved to a database.
+
+## Available features
+- Crop an image
+- Add emojis
+- Draw lines with a wide range of colors
+- Add stickers (android only)
+- Add text with a wide range of colors
+- Share that image with anyone
+
+## Installation
+
+```sh
+cordova plugin add https://github.com/agoncalvesos/image-editor-plugin.git
+```
+
+## editImageFromBase64
+Opens the image editor main screen, allowing the user to use all the features, on the base64 passed as input parameter
+
+```javascript
+windown.imageeditorplugin.editImageFromBase64(base64, onSuccess, onError);
+```
+
+## editImageFromCamera
+
+Opens the phone camera allowing the user to take a photo and edit it right away
+
+```javascript
+windown.imageeditorplugin.editImageFromCamera(onSuccess, onError);
+```
+
+## editImageFromGallery
+
+Opens the phone gallery allowing the user to choose a photo and edit it right away
+
+```javascript
+windown.imageeditorplugin.editImageFromGallery(onSuccess, onError);
+```
+
+## Description
+
+This cordova plugin was created to be used inside an OutSystems plugin, and allows the user to edit an image. Functions editImageFromBase64, editImageFromCamera and editImageFromGallery return a base64 string that can be saved in a database or shown to the user
+
+## Supported Platforms
+
+- Android 4.0 +
+- iOS 9.0 +
+
+## Example
+
+Create a button on your page
+
+```html
+
+
+
+
+```
+
+Then add click event
+
+```javascript
+document.getElementById(“testeditorbase64”).addEventListener(“click”, function(){
+ imageeditorplugin.editImageFromBase64(document.getElementById(“base64image”).src, function(base64){
+ document.getElementById(“base64image”).src = “data:image;base64,” + base64;
+ },onFail);
+});
+document.getElementById(“testeditorcamera”).addEventListener(“click”, function(){
+ imageeditorplugin.editImageFromCamera(function(base64){
+ document.getElementById(“base64image”).src = “data:image;base64,” + base64;
+ },onFail)
+});
+document.getElementById(“testeditorgallery”).addEventListener(“click”, function(){
+ imageeditorplugin.editImageFromGallery(function(base64){
+ document.getElementById(“base64image”).src = “data:image;base64,” + base64;
+ },onFail)
+});
+
+function onFail(message) {
+ console.log('plugin message: ' + message);
+}
+```
+
+# Credits
+Thanks to eventtus for the native source code for ios and android, available here:
+https://github.com/eventtus/photo-editor
+https://github.com/eventtus/photo-editor-android