File Source for ImageFiles.class.php

<?php
/**
* For including this file you have to define the constant "CLASSPATH".
* Because every include in the framework depends on the CLASSPATH definition.
* The CLASSPATH means the relative path to the folder that contains the
* framework GilliGan.
*
* @package filesystem
*/
if( !defined( "CLASSPATH" ) )
{
echo "<h3>You have to define the constant CLASSPATH!</h3>\r\n";
echo "Example: define( 'CLASSPATH', '../path/to/classes/' );\r\n";
exit();
}
/**
*
*/
include_once( CLASSPATH."filesystem/Files.class.php" );
/**
* A class to manage image files in a filesystemtree.
*
* @package filesystem
* @version 0.1.35
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @license http://www.gnu.org/copyleft/lesser.html
* GNU Lesser General Public License
* @copyright Copyright (c) 2005 Daniel PlÃ¼cken <daniel@debakel.net>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License.
*
* 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307 USA
*/
class ImageFiles extends Files
{
/**
* @access public
* @var string $kind
*/
var $kind = ""; // JPG, PNG or GIF
/**
* @access private
* @var string $width
*/
var $width = 0;
/**
* @access private
* @var string $height
*/
var $height = 0;
/**
* @access private
* @var resource $handle
*/
var $handle = null;
/**
* @access private
* @var resource $handle
*/
var $edit_handle = null;
/**
* The jpeg quality from 0 to 100.
*
* @access private
* @var string $jpeg_compression
*/
var $jpeg_compression = 60;
/**
* Constructor
*
* @version 1.12
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param string $path_or_width
* @param string $type_or_height
*/
function ImageFiles( $path_or_width, $type_or_height = "" )
{
if ( !preg_match( "!^\d+$!", $path_or_width ) )
$this->Files( $path_or_width );
if ( is_string( $this->filename ) )
{
if ( preg_match( "!^(JPG|GIF|PNG)$!i", $type_or_height ) )
$this->kind = strtoupper( $type_or_height );
else
{
$tmp_str = FilesystemToolkit::getFileSuffix( $this->filename );
if ( preg_match( "!jpe?g$!i", $tmp_str ) )
$this->kind = "JPG";
else
$this->kind = strtoupper( $tmp_str );
}
}
}
/**
* Creates a handle to this image to be able to manipulate the image data. The
* handle will be stored in $this->handle.
*
* @version 1.0
* @since 0.1.35
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return void
*/
function createHandle()
{
switch ( $this->kind )
{
case "JPG":
$this->handle = imagecreatefromjpeg(
$this->path."/".$this->filename
);
break;
case "PNG":
$this->handle = imagecreatefrompng(
$this->path."/".$this->filename
);
break;
case "GIF":
$this->handle = imagecreatefromgif(
$this->path."/".$this->filename
);
break;
default:
die ( "Not supported file format!" );
break;
}
}
/**
* Sets the comression quality for jpg between 0 (zero) and 100 (one hundred).
*
* @version 1.0
* @since 0.1.2
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param string $int
* @return void
*/
function setJPGCompression( $int )
{
$int = intval( $int );
if ( $int < 0 )
$int = 0;
else
if ( $int > 100 )
$int = 100;
$this->jpeg_compression = $int;
}
/**
* Sets the comression quality for jpg between 0 (zero) and 100 (one hundred).
* This method is an alias for the method setJPGCompression();
*
* @version 1.0
* @since 0.1.2
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @param string $int
* @return void
*/
function setJPEGCompression( $int )
{ $this->setJPGCompression( $int ); }
/**
* Scales the image to the given width and keeps the aspect ratio. Trys to
* preserve transparency info for GIFs & PNGs.
*
* @version 1.34
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @author Rob <?>
* @see http://www.php.net/manual/en/function.imagecolortransparent.php#78379
*
* @access public
* @param string $to_width
* @param string $smooth
*
* @return boolean
*/
function proportionalWidthScale( $to_width, $smooth = true )
{
if ( $this->handle == null )
$this->createHandle();
$act_width = $this->getWidth();
$act_height = $this->getHeight();
$dbl_aspect_ratio = $act_height / $act_width;
$to_height = $to_width * $dbl_aspect_ratio;
$this->edit_handle = imagecreatetruecolor( $to_width, $to_height );
// Transparency only available for GIFs & PNGs
// (Try to preserve transparency info)
if ( $this->kind == "PNG" || $this->kind == "GIF" )
{
$trnprt_indx = imagecolortransparent( $this->handle );
// If we have a specific transparent color
if ( $trnprt_indx >= 0 )
{
// Get the original image's transparent color's RGB values
$trnprt_color = imagecolorsforindex( $this->handle, $trnprt_indx );
// Allocate the same color in the new image resource
$trnprt_indx = imagecolorallocate(
$this->edit_handle,
$trnprt_color['red'],
$trnprt_color['green'],
$trnprt_color['blue']
);
// Completely fill the background of the new image with allocated
// color.
imagefill( $this->edit_handle, 0, 0, $trnprt_indx );
// Set the background color for new image to transparent
imagecolortransparent( $this->edit_handle, $trnprt_indx );
}
// Always make a transparent background color for PNGs that don't have
// one allocated already
else
if ( $this->kind == "PNG" )
{
// Turn off transparency blending (temporarily)
imagealphablending( $this->edit_handle, false );
// Create a new transparent color for image
$color = imagecolorallocatealpha( $this->edit_handle, 0, 0, 0, 127 );
// Completely fill the background of the new image with allocated
// color.
imagefill( $this->edit_handle, 0, 0, $color );
// Restore transparency blending
imagesavealpha( $this->edit_handle, true );
}
}
if ( $smooth )
{
$ret = imagecopyresampled (
$this->edit_handle, $this->handle,
0, 0, 0, 0,
$to_width, $to_height, $act_width, $act_height
);
$this->handle = $this->edit_handle;
$edit_done = true;
return $ret;
}
else
{
$ret = imagecopyresized(
$this->edit_handle, $this->handle,
0, 0, 0, 0,
$to_width, $to_height, $act_width, $act_height
);
$this->handle = $this->edit_handle;
$edit_done = true;
return $ret;
}
}
/**
* Scales the image to the given height and keeps the aspect ratio. Trys to
* preserve transparency info for GIFs & PNGs.
*
* @version 1.22
* @since 0.1.3
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @author Rob <?>
* @see http://www.php.net/manual/en/function.imagecolortransparent.php#78379
*
* @access public
* @param string $to_height
* @param string $smooth
*
* @return boolean
*/
function proportionalHeightScale( $to_height, $smooth = true )
{
if ( $this->handle == null )
$this->createHandle();
$act_width = $this->getWidth();
$act_height = $this->getHeight();
$dbl_aspect_ratio = $act_width / $act_height;
$to_width = $to_height * $dbl_aspect_ratio;
$this->edit_handle = imagecreatetruecolor( $to_width, $to_height );
// Transparency only available for GIFs & PNGs
// (Try to preserve transparency info)
if ( $this->kind == "PNG" || $this->kind == "GIF" )
{
$trnprt_indx = imagecolortransparent( $this->handle );
// If we have a specific transparent color
if ( $trnprt_indx >= 0 )
{
// Get the original image's transparent color's RGB values
$trnprt_color = imagecolorsforindex( $this->handle, $trnprt_indx );
// Allocate the same color in the new image resource
$trnprt_indx = imagecolorallocate(
$this->edit_handle,
$trnprt_color['red'],
$trnprt_color['green'],
$trnprt_color['blue']
);
// Completely fill the background of the new image with allocated
// color.
imagefill( $this->edit_handle, 0, 0, $trnprt_indx );
// Set the background color for new image to transparent
imagecolortransparent( $this->edit_handle, $trnprt_indx );
}
// Always make a transparent background color for PNGs that don't have
// one allocated already
else
if ( $this->kind == "PNG" )
{
// Turn off transparency blending (temporarily)
imagealphablending( $this->edit_handle, false );
// Create a new transparent color for image
$color = imagecolorallocatealpha( $this->edit_handle, 0, 0, 0, 127 );
// Completely fill the background of the new image with allocated
// color.
imagefill( $this->edit_handle, 0, 0, $color );
// Restore transparency blending
imagesavealpha( $this->edit_handle, true );
}
}
if ( $smooth )
{
$ret = imagecopyresampled (
$this->edit_handle, $this->handle,
0, 0, 0, 0,
$to_width, $to_height, $act_width, $act_height
);
$this->handle = $this->edit_handle;
$edit_done = true;
return $ret;
}
else
{
$ret = imagecopyresized(
$this->edit_handle, $this->handle,
0, 0, 0, 0,
$to_width, $to_height, $act_width, $act_height
);
$this->handle = $this->edit_handle;
$edit_done = true;
return $ret;
}
}
/**
* Returns the height of the image.
*
* @version 1.1
* @since 0.1.32
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return integer
*/
function getHeight()
{
if ( $this->handle != null )
return imagesy( $this->handle );
else
{
$tmp_arr = getimagesize( $this->path."/".$this->filename );
return $tmp_arr[1];
}
}
/**
* Returns the width of the image.
*
* @version 1.1
* @since 0.1.32
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return integer
*/
function getWidth()
{
if ( $this->handle != null )
return imagesx( $this->handle );
else
{
$tmp_arr = getimagesize( $this->path."/".$this->filename );
return $tmp_arr[0];
}
}
/**
* Returns the content of this image file object.
*
* @version 1.11
* @since 0.1.0
* @author Daniel PlÃ¼cken <daniel@debakel.net>
* @access public
* @return string
*/
function getContent()
{
if (
empty( $this->edit_handle )
&& !empty( $this->path )
&& !empty( $this->filename )
)
return FilesystemToolkit
::loadFileContent( $this->path."/".$this->filename );
ob_start();
if( empty( $this->edit_handle ) )
$tmp_h =& $this->handle;
else
$tmp_h =& $this->edit_handle;
switch( $this->kind )
{
case "JPG":
imagejpeg( $tmp_h, '', $this->jpeg_compression );
break;
case "GIF":
imagegif( $tmp_h );
break;
case "PNG":
imagepng( $tmp_h );
break;
}
$cont = ob_get_contents();
ob_end_clean();
return $cont;
}
}
?>

Source for file ImageFiles.class.php