Skip to content

akreienbring/jr-crop

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jr-crop

A simple ionic plugin to crop your images, inspired by whatsapp and telegram.

  • Specifiy width and height of target
  • Supports image scaling by using the resample_hermite algorithm (Courtesy of viliusle, https://github.com/viliusle/Hermite-resize). See options.
  • Returns a canvas element with the new cropped image.

example

Simple enough, let's get started.

Import the static files jr-crop.js and jr-crop.css. Declare jrCrop as a dependency

.module('myModule', ['ionic', 'jrCrop'])

Inject jr-crop.

.controller('MyController', function($jrCrop) {

Call the crop function to open a new modal where the user can crop this image. Pass in the image url and targetsize. The function will return a promise that resolves when the user is done or fails when the user cancels.

$jrCrop.crop({
    url: url,
    width: 200,
    height: 200
}).then(function(canvas) {
    // success!
    var image = canvas.toDataURL();
}, function() {
    // User canceled or couldn't load image.
});

##Options You can add the following options when you call 'crop':

$jrCrop.crop({
    url: url,
    width: 200,
    height: 200,
    title: 'Move and Scale' //additional title,
	cancelText: 'Abort', //default is: 'Cancel'
	chooseText: 'OK', //default is 'Choose'
	allowRotation: true, //default is false
	buttonLocation: 'header', //default is 'footer'
	resizeWidth: 75, //if present then the image will be scaled to given width. Also used for resizeHight if that option is not present.
	resizeHight: 75, //if present then the image will be scaled to given height. Also used for resizeWidth if that option is not present.
});

Examples please!!

I got ya. Run bower install && npm install && npm test and visit localhost:8181. Great, now you can visit this from your phone too. It works best when packaged in cordova, as how you should use ionic anyway.

Support

Though I'm only supporting iOS, I did get reports that it's working well on Android. If it doesn't, feel free to fork and update my codebase. If you just want to leave your thoughts you can reply in the ionic forum topic.

Contributing

Open an issue or create a pull request. Please exclude the /dist files from your pull request.

Release History

  • 2015-04-05   v1.0.0   Breaking: jr-crop is now its own module, import it first. Support ionic v1.0.0 release candidate. Setting options will no longer overwrite the default options.
  • 2015-01-04   v0.1.1   Customize Cancel and Choose text.
  • 2014-12-14   v0.1.0   Release on bower, move from grunt to gulp, version numbering in header. Clean up examples and test server. Place the image in the center on initializing. Add maximum scale option. Hide picture overflow in modal at bigger viewport. Add example pictures as static files rather than from url.

About

A simple ionic plugin to crop your images

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 88.3%
  • HTML 8.0%
  • CSS 3.7%