Jcrop FAQ

Contents

What is this for?

Jcrop allows for implementing an image cropping interface in a web application, in a quick and easy way. This allows web designers and developers to implement a familiar interface in their web applications without requiring them to build and test their own widget. At the end of the day, if you are not in some way involved in website design or development, it's probably not of much interest to you.

Where might it be used?

Jcrop can benefit any website that uses uploaded images.

  • To select a thumbnail (or icon, avatar, etc) from a larger, uploaded image
  • To crop uploaded images in a CMS or similar application
  • In any application that requires visually selecting an area of an image

By combining various options, Jcrop could even be configured to not allow selection and act as a display to highlight areas of an image based on other interactions on a page. It's very versatile!

Can I use it on my site?

Jcrop is free software, released under the MIT license.

You are free to implement it on your website, in other applications, or anywhere you see fit. Are you ready to use Jcrop? Ample documentation and examples are available. Also, if you use Jcrop, would you be so kind as to drop us a line and let us know? We'd really appreciate it.

I found a bug...what now?

Read the Jcrop Tech Notes and make sure the issue is not discussed there. Also make sure that you are using a browser that is listed as compatible. If you have compatibility notes for older or unlisted browsers, let me know and I can update the list. If you still believe you've found a bug, we'd like to know about it. Please realize that some issues may be beyond the scope of what can be addressed in the design of Jcrop.

Who uses Jcrop?

Jcrop is used by

  • Popular open source applications, like Wordpress
  • Various plugins and other applications
  • Numerous websites and custom applications

For an (in)complete list of software and websites visit Jcrop Links.

Can I attach more than one function to an event?

You can only specify one function, but you can make a function that calls two or more other functions. Try one of these two methods for doing this: (they are actually the same) 

function doBoth(c) {
  showPreview(c);
  updateCoords(c);
};

$('#cropbox').Jcrop({
  onSelect: doBoth,
  onChange: doBoth
})

OR 

$('#cropbox').Jcrop({
  onSelect: function(c) { showPreview(c); updateCoords(c); },
  onChange: function(c) { showPreview(c); updateCoords(c); }
})

Alternatively, combine two or more functions into a single function and attach the new function.

Is it possible to crop an oval or a polygon?

The simple answer to this question is no. Unfortunately there are no plans to add these features to Jcrop, either. Jcrop aims to do one thing well, crop rectangles from larger images.

Retrieved from "http://www.deepliquid.com/content/Jcrop_FAQ.html"