scratchfoundation/paper.js
1
0
Fork 0
mirror of https://github.com/scratchfoundation/paper.js.git synced 2025-01-03 19:45:44 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

Implement Raster#getSubRaster() and document both #getSubImage() and #getSubRaster().

Browse source
This commit is contained in:
Jürg Lehni 2013-08-14 12:14:28 -07:00
parent 1a1c2674fd
commit 5981ddf89f
1 changed files with 24 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
src/item/Raster.js
View file

@ -250,8 +250,9 @@ var Raster = Item.extend(/** @lends Raster# */{
/** /**
* The source of the raster, which can be set using a DOM Image, a Canvas, * The source of the raster, which can be set using a DOM Image, a Canvas,
* a data url, a string describing the URL to load the image from, or the * a data url, a string describing the URL to load the image from, or the
* ID of a DOM element to get the image from (either a DOM Image or a Canvas). * ID of a DOM element to get the image from (either a DOM Image or a
* Reading this property will return the url of the source image or a data-url. * Canvas). Reading this property will return the url of the source image or
* a data-url.
* *
* @bean * @bean
* @type HTMLImageElement|Canvas|String * @type HTMLImageElement|Canvas|String
@ -320,12 +321,14 @@ var Raster = Item.extend(/** @lends Raster# */{
return this._canvas || this._image; return this._canvas || this._image;
}, },
// DOCS: document Raster#getSubImage
/** /**
* Extracts a part of the Raster's content as a sub image, and returns it as
* a Canvas object.
*
* @param {Rectangle} rect the boundaries of the sub image in pixel * @param {Rectangle} rect the boundaries of the sub image in pixel
* coordinates * coordinates
* *
* @return {Canvas} * @return {Canvas} the sub image as a Canvas object
*/ */
getSubImage: function(rect) { getSubImage: function(rect) {
rect = Rectangle.read(arguments); rect = Rectangle.read(arguments);
@ -335,6 +338,23 @@ var Raster = Item.extend(/** @lends Raster# */{
return ctx.canvas; return ctx.canvas;
}, },
/**
* Extracts a part of the raster item's content as a new raster item, placed
* in exactly the same place as the original content.
*
* @param {Rectangle} rect the boundaries of the sub raster in pixel
* coordinates
*
* @return {Raster} the sub raster as a newly created raster item
*/
getSubRaster: function(rect) {
rect = Rectangle.read(arguments);
var raster = new Raster(this.getSubImage(rect));
raster.translate(rect.getCenter().subtract(this.getSize().divide(2)));
raster._matrix.preConcatenate(this._matrix);
return raster;
},
/** /**
* Returns a Base 64 encoded {@code data:} URL representation of the raster. * Returns a Base 64 encoded {@code data:} URL representation of the raster.
* *