Skip to content

Cordova plugin to save base64 data as a png image into the device

License

Notifications You must be signed in to change notification settings

agomezmoron/cordova-save-image-gallery

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cordova saveImageGallery Plugin

Build Status

This plugin (based on devgeeks/Canvas2ImagePlugin) allows you to save base64 data as a png/jpg image into the device (iOS Photo Library, Android Gallery or WindowsPhone 8 Photo Album).

The plugin is a kind of fork of the Nexxa/cordova-base64-to-gallery/ but with a cleaner history and some extra features - like supporting saving into JPG, sending parameters in an easier way, etc.

Alerts

WP8 limitations

In this fork, the Android and iOS implementation were adapted but the WP8 cannot save images in PNG or reducing the quality of the images.

Usage (saveBase64Image)

Call the window.imageSaver.saveBase64Image() method using success and error callbacks and the passing the image's base64 in the options JSON:

Methods

window.imageSaver.saveBase64Image(options [,success, fail])

Param Type Default Description
options object *see below options
success function console.log success callback
fail function console.error fail callback

Available options

data

Base64 input String.

prefix

Saved file name prefix. Only works in Android and WP8.

Default: "img_"

mediaScanner

Android Media Scanner after file creation enabled or not. Only works in Android!

Default: true

format

Format to save the image. Allowed values 'JPG' and 'PNG'. Only supported for Android and iOS. Currently this option is ignored on Windows implementation.

Default: JPG

quality

Quality of the saved image. If you want to reduce the quality of the image, you are allow to do it. The value should be a number from 1 to 100. Only supported for Android and iOS. Currently this option is ignored on Windows implementation.

Default: 100

Example

function onDeviceReady() {
    var params = {data: base64String, prefix: 'myPrefix_', format: 'JPG', quality: 80, mediaScanner: true};
    window.imageSaver.saveBase64Image(params,
        function (filePath) {
          console.log('File saved on ' + filePath);
        },
        function (msg) {
          console.error(msg);
        }
      );
}

Usage (removeImageFromLibrary)

Call the window.imageSaver.removeImageFromLibrary() method using success and error callbacks and the passing the image URL in the options JSON:

Methods

window.imageSaver.removeImageFromLibrary(options [,success, fail])

Param Type Default Description
options object *see below options
success function console.log success callback
fail function console.error fail callback

Available options

data

File path input String.

Example

function onDeviceReady() {
    var params = {data: "/data/data/test.png"};
    window.imageSaver.removeImageFromLibrary(params,
        function (filePath) {
          console.log('File removed from ' + filePath);
        },
        function (msg) {
          console.error(msg);
        }
      );
}

Authors and contributors

About

Cordova plugin to save base64 data as a png image into the device

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 35.7%
  • Objective-C 30.0%
  • JavaScript 22.8%
  • C# 11.5%