commit
fe59015126
@ -0,0 +1,41 @@ |
||||
Attribution-Non-Commercial-Share Alike 2.0 UK: England & Wales |
||||
|
||||
http://creativecommons.org/licenses/by-nc-sa/2.0/uk/ |
||||
|
||||
You are free: |
||||
|
||||
* to copy, distribute, display, and perform the work |
||||
* to make derivative works |
||||
|
||||
|
||||
Under the following conditions: |
||||
|
||||
* Attribution — You must give the original author credit. |
||||
Attribute this work: |
||||
Information |
||||
What does "Attribute this work" mean? |
||||
The page you came from contained embedded licensing metadata, |
||||
including how the creator wishes to be attributed for re-use. |
||||
You can use the HTML here to cite the work. Doing so will |
||||
also include metadata on your page so that others can find the |
||||
original work as well. |
||||
|
||||
* Non-Commercial — You may not use this work for commercial |
||||
purposes. |
||||
* Share Alike — If you alter, transform, or build upon this |
||||
work, you may distribute the resulting work only under a |
||||
licence identical to this one. |
||||
|
||||
With the understanding that: |
||||
|
||||
* Waiver — Any of the above conditions can be waived if you get |
||||
permission from the copyright holder. |
||||
* Other Rights — In no way are any of the following rights |
||||
affected by the license: |
||||
o Your fair dealing or fair use rights; |
||||
o The author's moral rights; |
||||
o Rights other persons may have either in the work itself |
||||
or in how the work is used, such as publicity or privacy rights. |
||||
* Notice — For any reuse or distribution, you must make clear to |
||||
others the licence terms of this work. |
||||
|
@ -0,0 +1,15 @@ |
||||
jQuery.inview is licensed Attribution-Non-Commercial-Share Alike 2.0 but the |
||||
conditions has been waived by the author in the following tweet: |
||||
|
||||
https://twitter.com/#!/ChristopherBlum/status/148382899887013888 |
||||
|
||||
Saying: |
||||
|
||||
Thomas Tanghus @tanghus 18 Dec. 2011 |
||||
|
||||
@ChristopherBlum Hi. Is it OK if I use https://github.com/protonet/jquery.inview in ownCloud? Preferably under an AGPL license ;-) owncloud.org |
||||
|
||||
|
||||
Christopher Blum Christopher Blum @ChristopherBlum 18 Dec. 2011 |
||||
|
||||
@tanghus Feel free to! :) |
@ -0,0 +1,474 @@ |
||||
<?php |
||||
|
||||
/** |
||||
* ownCloud |
||||
* |
||||
* @author Thomas Tanghus |
||||
* @copyright 2011 Thomas Tanghus <thomas@tanghus.net> |
||||
* |
||||
* This library is free software; you can redistribute it and/or |
||||
* modify it under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE |
||||
* License as published by the Free Software Foundation; either |
||||
* version 3 of the License, or any later version. |
||||
* |
||||
* This library is distributed in the hope that it will be useful, |
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
||||
* GNU AFFERO GENERAL PUBLIC LICENSE for more details. |
||||
* |
||||
* You should have received a copy of the GNU Affero General Public |
||||
* License along with this library. If not, see <http://www.gnu.org/licenses/>. |
||||
* |
||||
*/ |
||||
|
||||
/** From user comments at http://dk2.php.net/manual/en/function.exif-imagetype.php |
||||
* Don't know if it can come in handy? |
||||
if ( ! function_exists( 'exif_imagetype' ) ) { |
||||
function exif_imagetype ( $filename ) { |
||||
if ( ( list($width, $height, $type, $attr) = getimagesize( $filename ) ) !== false ) { |
||||
return $type; |
||||
} |
||||
return false; |
||||
} |
||||
} |
||||
*/ |
||||
|
||||
function ellipsis($str, $maxlen) { |
||||
if (strlen($str) > $maxlen) { |
||||
$characters = floor($maxlen / 2); |
||||
return substr($str, 0, $characters) . '...' . substr($str, -1 * $characters); |
||||
} |
||||
return $str; |
||||
} |
||||
|
||||
/** |
||||
* Class for image manipulation |
||||
* Ideas: imagerotate, chunk_split(base64_encode()) |
||||
* |
||||
*/ |
||||
class OC_Image { |
||||
static private $resource = false; // tmp resource. |
||||
static private $destroy = false; // if the resource is created withing the object. |
||||
static private $imagetype = IMAGETYPE_PNG; // Default to png if file type isn't evident. |
||||
static private $filepath = null; |
||||
/** |
||||
* @brief Constructor. |
||||
* @param $imageref The path to a local file, a base64 encoded string or a resource created by an imagecreate* function. |
||||
* If a resource is passed it is the job of the caller to destroy it using imagedestroy($var) |
||||
* @returns bool False on error |
||||
*/ |
||||
function __construct($imageref = null) { |
||||
//OC_Log::write('core','OC_Image::__construct, start', OC_Log::DEBUG); |
||||
if(!extension_loaded('gd') || !function_exists('gd_info')) { |
||||
//if(!function_exists('imagecreatefromjpeg')) { |
||||
OC_Log::write('core','OC_Image::__construct, GD module not installed', OC_Log::ERROR); |
||||
return false; |
||||
} |
||||
if(!is_null($imageref)) { |
||||
self::load($imageref); |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* @brief Destructor. |
||||
*/ |
||||
function __destruct() { |
||||
if(is_resource(self::$resource) && self::$destroy) { |
||||
imagedestroy(self::$resource); // Why does this issue a warning. |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* @brief Determine whether the object contains an image resource. |
||||
* @returns bool |
||||
*/ |
||||
public function valid() { // apparently you can't name a method 'empty'... |
||||
$ret = is_resource(self::$resource); |
||||
return $ret; |
||||
} |
||||
|
||||
/** |
||||
* @brief Returns the MIME type of the image or an empty string if no image is loaded. |
||||
* @returns int |
||||
*/ |
||||
public function mimeType() { |
||||
return is_resource(self::$resource) ? image_type_to_mime_type(self::$imagetype) : ''; |
||||
} |
||||
|
||||
/** |
||||
* @brief Returns the width of the image or -1 if no image is loaded. |
||||
* @returns int |
||||
*/ |
||||
public function width() { |
||||
return is_resource(self::$resource) ? imagesx(self::$resource) : -1; |
||||
} |
||||
|
||||
/** |
||||
* @brief Returns the height of the image or -1 if no image is loaded. |
||||
* @returns int |
||||
*/ |
||||
public function height() { |
||||
return is_resource(self::$resource) ? imagesy(self::$resource) : -1; |
||||
} |
||||
|
||||
/** |
||||
* @brief Outputs the image. |
||||
* @returns bool |
||||
*/ |
||||
public function show() { |
||||
return $this->_output(); |
||||
} |
||||
|
||||
/** |
||||
* @brief Saves the image. |
||||
* @returns bool |
||||
*/ |
||||
|
||||
public function save($filepath=null) { |
||||
if($filepath === null && $this->filepath === null) { |
||||
OC_Log::write('core','OC_Image::save. save() called with no path.', OC_Log::ERROR); |
||||
return false; |
||||
} elseif($filepath === null && $this->filepath !== null) { |
||||
$filepath = $this->filepath; |
||||
} |
||||
return $this->_output($filepath, true); |
||||
} |
||||
|
||||
/** |
||||
* @brief Outputs/saves the image. |
||||
*/ |
||||
private function _output($filepath=null, $really=false) { |
||||
header('Content-Type: '.self::mimeType()); |
||||
if($really === false) { |
||||
$filepath = null; // Just being cautious ;-) |
||||
} else { |
||||
if(!is_writable(dirname($filepath))) { |
||||
OC_Log::write('core','OC_Image::save. Directory \''.dirname($filepath).'\' is not writable.', OC_Log::ERROR); |
||||
return false; |
||||
} elseif(is_writable(dirname($filepath)) && !is_writable($filepath)) { |
||||
OC_Log::write('core','OC_Image::save. File \''.$filepath.'\' is not writable.', OC_Log::ERROR); |
||||
return false; |
||||
} |
||||
} |
||||
$retval = false; |
||||
switch(self::$imagetype) { |
||||
case IMAGETYPE_GIF: |
||||
$retval = imagegif(self::$resource, $filepath); |
||||
break; |
||||
case IMAGETYPE_JPEG: |
||||
$retval = imagejpeg(self::$resource, $filepath); |
||||
break; |
||||
case IMAGETYPE_PNG: |
||||
$retval = imagepng(self::$resource, $filepath); |
||||
break; |
||||
case IMAGETYPE_XBM: |
||||
$retval = imagexbm(self::$resource, $filepath); |
||||
break; |
||||
case IMAGETYPE_WBMP: |
||||
case IMAGETYPE_BMP: |
||||
$retval = imagewbmp(self::$resource, $filepath); |
||||
break; |
||||
default: |
||||
$retval = imagepng(self::$resource, $filepath); |
||||
} |
||||
return $retval; |
||||
} |
||||
|
||||
/** |
||||
* @brief Prints the image when called as $image(). |
||||
*/ |
||||
public function __invoke() { |
||||
return self::show(); |
||||
} |
||||
|
||||
/** |
||||
* @returns Returns the image resource in any. |
||||
*/ |
||||
public function resource() { |
||||
return self::$resource; |
||||
} |
||||
|
||||
/** |
||||
* @returns Returns a base64 encoded string suitable for embedding in a VCard. |
||||
*/ |
||||
function __toString() { |
||||
ob_start(); |
||||
$res = imagepng(self::$resource); |
||||
if (!$res) { |
||||
OC_Log::write('core','OC_Image::_string. Error writing image',OC_Log::ERROR); |
||||
} |
||||
return chunk_split(base64_encode(ob_get_clean())); |
||||
} |
||||
|
||||
/** |
||||
* @brief Loads an image from a local file, a base64 encoded string or a resource created by an imagecreate* function. |
||||
* @param $imageref The path to a local file, a base64 encoded string or a resource created by an imagecreate* function. |
||||
* If a resource is passed it is the job of the caller to destroy it using imagedestroy($var) |
||||
* @returns An image resource or false on error |
||||
*/ |
||||
public function load($imageref) { |
||||
if(self::loadFromFile($imageref) !== false) { |
||||
return self::$resource; |
||||
} elseif(self::loadFromBase64($imageref) !== false) { |
||||
return self::$resource; |
||||
} elseif(self::loadFromData($imageref) !== false) { |
||||
return self::$resource; |
||||
} elseif(self::loadFromResource($imageref) !== false) { |
||||
return self::$resource; |
||||
} else { |
||||
OC_Log::write('core','OC_Image::load, couldn\'t load anything. Giving up!', OC_Log::DEBUG); |
||||
return false; |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* @brief Loads an image from a local file. |
||||
* @param $imageref The path to a local file. |
||||
* @returns An image resource or false on error |
||||
*/ |
||||
public function loadFromFile($imagepath=false) { |
||||
if(!is_file($imagepath) || !file_exists($imagepath) || !is_readable($imagepath)) { |
||||
// Debug output disabled because this method is tried before loadFromBase64? |
||||
OC_Log::write('core','OC_Image::loadFromFile, couldn\'t load: '.ellipsis($imagepath, 50), OC_Log::DEBUG); |
||||
return false; |
||||
} |
||||
$itype = exif_imagetype($imagepath); |
||||
switch($itype) { |
||||
case IMAGETYPE_GIF: |
||||
if (imagetypes() & IMG_GIF) { |
||||
self::$resource = imagecreatefromgif($imagepath); |
||||
} else { |
||||
OC_Log::write('core','OC_Image::loadFromFile, GIF images not supported: '.$imagepath, OC_Log::DEBUG); |
||||
} |
||||
break; |
||||
case IMAGETYPE_JPEG: |
||||
if (imagetypes() & IMG_JPG) { |
||||
self::$resource = imagecreatefromjpeg($imagepath); |
||||
} else { |
||||
OC_Log::write('core','OC_Image::loadFromFile, JPG images not supported: '.$imagepath, OC_Log::DEBUG); |
||||
} |
||||
break; |
||||
case IMAGETYPE_PNG: |
||||
if (imagetypes() & IMG_PNG) { |
||||
self::$resource = imagecreatefrompng($imagepath); |
||||
} else { |
||||
OC_Log::write('core','OC_Image::loadFromFile, PNG images not supported: '.$imagepath, OC_Log::DEBUG); |
||||
} |
||||
break; |
||||
case IMAGETYPE_XBM: |
||||
if (imagetypes() & IMG_XPM) { |
||||
self::$resource = imagecreatefromxbm($imagepath); |
||||
} else { |
||||
OC_Log::write('core','OC_Image::loadFromFile, XBM/XPM images not supported: '.$imagepath, OC_Log::DEBUG); |
||||
} |
||||
break; |
||||
case IMAGETYPE_WBMP: |
||||
case IMAGETYPE_BMP: |
||||
if (imagetypes() & IMG_WBMP) { |
||||
self::$resource = imagecreatefromwbmp($imagepath); |
||||
} else { |
||||
OC_Log::write('core','OC_Image::loadFromFile, (W)BMP images not supported: '.$imagepath, OC_Log::DEBUG); |
||||
} |
||||
break; |
||||
/* |
||||
case IMAGETYPE_TIFF_II: // (intel byte order) |
||||
break; |
||||
case IMAGETYPE_TIFF_MM: // (motorola byte order) |
||||
break; |
||||
case IMAGETYPE_JPC: |
||||
break; |
||||
case IMAGETYPE_JP2: |
||||
break; |
||||
case IMAGETYPE_JPX: |
||||
break; |
||||
case IMAGETYPE_JB2: |
||||
break; |
||||
case IMAGETYPE_SWC: |
||||
break; |
||||
case IMAGETYPE_IFF: |
||||
break; |
||||
case IMAGETYPE_ICO: |
||||
break; |
||||
case IMAGETYPE_SWF: |
||||
break; |
||||
case IMAGETYPE_PSD: |
||||
break; |
||||
*/ |
||||
default: |
||||
self::$resource = imagecreatefromstring(file_get_contents($imagepath)); |
||||
$itype = IMAGETYPE_PNG; |
||||
OC_Log::write('core','OC_Image::loadFromFile, Default', OC_Log::DEBUG); |
||||
break; |
||||
} |
||||
if($this->valid()) { |
||||
self::$imagetype = $itype; |
||||
self::$filepath = $imagepath; |
||||
self::$destroy = true; |
||||
} |
||||
return self::$resource; |
||||
} |
||||
|
||||
/** |
||||
* @brief Loads an image from a string of data. |
||||
* @param $str A string of image data as read from a file. |
||||
* @returns An image resource or false on error |
||||
*/ |
||||
public function loadFromData($str) { |
||||
if(is_resource($str)) { |
||||
return false; |
||||
} |
||||
self::$resource = imagecreatefromstring($str); |
||||
if(!self::$resource) { |
||||
OC_Log::write('core','OC_Image::loadFromData, couldn\'t load', OC_Log::DEBUG); |
||||
return false; |
||||
} |
||||
self::$destroy = true; |
||||
return self::$resource; |
||||
} |
||||
|
||||
/** |
||||
* @brief Loads an image from a base64 encoded string. |
||||
* @param $str A string base64 encoded string of image data. |
||||
* @returns An image resource or false on error |
||||
*/ |
||||
public function loadFromBase64($str) { |
||||
if(!is_string($str)) { |
||||
return false; |
||||
} |
||||
$data = base64_decode($str); |
||||
if($data) { // try to load from string data |
||||
self::$resource = imagecreatefromstring($data); |
||||
if(!self::$resource) { |
||||
OC_Log::write('core','OC_Image::loadFromBase64, couldn\'t load', OC_Log::DEBUG); |
||||
return false; |
||||
} |
||||
self::$destroy = true; |
||||
return self::$resource; |
||||
} else { |
||||
return false; |
||||
} |
||||
} |
||||
|
||||
/** |
||||
* @brief Checks if image resource is valid and assigns it to self::$resource. |
||||
* @param $res An image resource. |
||||
* @returns An image resource or false on error |
||||
*/ |
||||
public function loadFromResource($res) { |
||||
if(!is_resource($res)) { |
||||
return false; |
||||
} |
||||
self::$resource = $res; |
||||
} |
||||
|
||||
/** |
||||
* @brief Resizes the image preserving ratio. |
||||
* @param $maxsize The maximum size of either the width or height. |
||||
* @returns bool |
||||
*/ |
||||
public function resize($maxsize) { |
||||
if(!self::$resource) { |
||||
OC_Log::write('core','OC_Image::resize, No image loaded', OC_Log::ERROR); |
||||
return false; |
||||
} |
||||
$width_orig=imageSX(self::$resource); |
||||
$height_orig=imageSY(self::$resource); |
||||
$ratio_orig = $width_orig/$height_orig; |
||||
|
||||
if ($ratio_orig > 1) { |
||||
$new_height = round($maxsize/$ratio_orig); |
||||
$new_width = $maxsize; |
||||
} else { |
||||
$new_width = round($maxsize*$ratio_orig); |
||||
$new_height = $maxsize; |
||||
} |
||||
|
||||
$process = imagecreatetruecolor(round($new_width), round($new_height)); |
||||
if ($process == false) { |
||||
OC_Log::write('core','OC_Image::resize. Error creating true color image',OC_Log::ERROR); |
||||
imagedestroy($process); |
||||
return false; |
||||
} |
||||
|
||||
imagecopyresampled($process, self::$resource, 0, 0, 0, 0, $new_width, $new_height, $width_orig, $height_orig); |
||||
if ($process == false) { |
||||
OC_Log::write('core','OC_Image::resize. Error resampling process image '.$new_width.'x'.$new_height,OC_Log::ERROR); |
||||
imagedestroy($process); |
||||
return false; |
||||
} |
||||
self::$resource = $process; |
||||
return true; |
||||
} |
||||
|
||||
/** |
||||
* @brief Crops the image to the middle square. If the image is already square it just returns. |
||||
* @returns bool for success or failure |
||||
*/ |
||||
public function centerCrop() { |
||||
if(!self::$resource) { |
||||
OC_Log::write('core','OC_Image::centerCrop, No image loaded', OC_Log::ERROR); |
||||
return false; |
||||
} |
||||
$width_orig=imageSX(self::$resource); |
||||
$height_orig=imageSY(self::$resource); |
||||
if($width_orig === $height_orig) { |
||||
return true; |
||||
} |
||||
$ratio_orig = $width_orig/$height_orig; |
||||
$width = $height = min($width_orig, $height_orig); |
||||
|
||||
if ($ratio_orig > 1) { |
||||
$x = ($width_orig/2) - ($width/2); |
||||
$y = 0; |
||||
} else { |
||||
$y = ($height_orig/2) - ($height/2); |
||||
$x = 0; |
||||
} |
||||
$process = imagecreatetruecolor($width, $height); |
||||
if ($process == false) { |
||||
OC_Log::write('core','OC_Image::centerCrop. Error creating true color image',OC_Log::ERROR); |
||||
imagedestroy($process); |
||||
return false; |
||||
} |
||||
imagecopyresampled($process, self::$resource, 0, 0, $x, $y, $width, $height, $width, $height); |
||||
if ($process == false) { |
||||
OC_Log::write('core','OC_Image::centerCrop. Error resampling process image '.$width.'x'.$height,OC_Log::ERROR); |
||||
imagedestroy($process); |
||||
return false; |
||||
} |
||||
self::$resource = $process; |
||||
return true; |
||||
} |
||||
|
||||
/** |
||||
* @brief Crops the image from point $x$y with dimension $wx$h. |
||||
* @param $x Horizontal position |
||||
* @param $y Vertical position |
||||
* @param $w Width |
||||
* @param $h Hight |
||||
* @returns bool for success or failure |
||||
*/ |
||||
public function crop($x, $y, $w, $h) { |
||||
if(!self::$resource) { |
||||
OC_Log::write('core','OC_Image::crop, No image loaded', OC_Log::ERROR); |
||||
return false; |
||||
} |
||||
$width_orig=imageSX(self::$resource); |
||||
$height_orig=imageSY(self::$resource); |
||||
//OC_Log::write('core','OC_Image::crop. Original size: '.$width_orig.'x'.$height_orig, OC_Log::DEBUG); |
||||
$process = imagecreatetruecolor($w, $h); |
||||
if ($process == false) { |
||||
OC_Log::write('core','OC_Image::crop. Error creating true color image',OC_Log::ERROR); |
||||
imagedestroy($process); |
||||
return false; |
||||
} |
||||
imagecopyresampled($process, self::$resource, 0, 0, $x, $y, $w, $h, $w, $h); |
||||
if ($process == false) { |
||||
OC_Log::write('core','OC_Image::crop. Error resampling process image '.$w.'x'.$h,OC_Log::ERROR); |
||||
imagedestroy($process); |
||||
return false; |
||||
} |
||||
self::$resource = $process; |
||||
return true; |
||||
} |
||||
} |
Loading…
Reference in new issue