Download the PHP package joomla/image without Composer
On this page you can find all versions of the php package joomla/image. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package image
Short Description Joomla Image Package
License GPL-2.0-or-later
Homepage https://github.com/joomla-framework/image
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package image
The Image Package 
This package comprises of 2 main classes, Image and ImageFilter which has 8 filter sub-classes that it can use to apply a desired filter to your image. Image depends on the GD php extension to be loaded on your server. More information on GD can be found at: https://www.php.net/manual/en/book.image.php
Manipulating images in raw PHP using the GD image* functions requires a lot of boilerplate code. The intent of this package is to handle those requirements and make it simple for developers to accomplish those tasks through easy to use (and remember) methods.
All classes in this package are supported by the auto-loader so can be invoked at any time.
Deprecated
The joomla/image package is deprecated with no future updates planned.
Construction
When creating a new Image object, the constructor will check that the gd extension is loaded, and throw a RuntimeException if it is not.
The constructor takes a single optional $source parameter. This argument can be one of two things:
- A variable containing an existing, valid image resource created using a
imagecreate*method. - A string containing a valid, absolute path to an image
If you choose the first option, the class sets the protected property $handle to the provided image resource.
If you choose the second option, the class will call the loadFile method, passing along the $source parameter.
Usage
Keep in mind that most public methods return a Image instance with a valid image handle for easy method chaining. The examples for each method will break each method call out to be able to comment on what the code is doing, but production code can be chained like so (if you prefer):
Since Platform version 12.3, there is a new destroy() method that gets called in appropriate places throughout the class which runs the imagedestroy function to free memory associated with an image handle. This method is called before each time an image handle is replaced (when $createNew is set to false) as well as in the class __descruct method as a final cleanup.
The resize method
Accepted Parameters
$width: The width of the resized image in pixels or a percentage.$height: The height of the resized image in pixels or a percentage.$createNew: If true the current image will be cloned, resized and returned; else the current image will be resized and returned.$scaleMethod: Which method to use for scaling
Example: Using Image::resize() to generate a resized image.
The crop method
Accepted Parameters
$width: The width of the image section to crop in pixels or a percentage.$height: The height of the image section to crop in pixels or a percentage.$left: The number of pixels from the left to start cropping.$top: The number of pixels from the top to start cropping.$createNew: If true the current image will be cloned, cropped and returned; else the current image will be cropped and returned.
Example: Using Image::crop() to generate a cropped image.
To crop in image after resizing it to maintain proportions use cropResize method with familiar arguments $width, $height and $createNew.
The createThumbs method
Accepted Parameters
$thumbSizes: String or array of strings. Example: $thumbSizes = array('150x75','250x150');$creationMethod: See Resize Methods below.$thumbsFolder: Destination for thumbnails. Passing null generates a thumbs folder in the loaded image's containing folder.
Example: Using Image::createThumbs() to generate thumbnails of an image.
In this example, we use the createThumbs method of Image. This method takes 2 parameters. The first parameter can be a string containing a single size in WIDTHxHEIGHT format, or it can be an array of sizes in the format (as shown in the example). The second parameter specifies the resize method. (See Resize Methods below)
To receive Image instances without saving them to disk, use generateThumbs method with arguments $thumbSizes and $creationMethod.
Resize Methods
The resize, createThumbs and generateThumbs methods take an optional parameter that defines what method to use when scaling an image.
This parameter can be one of the following:
Image::SCALE_FILL- Gives you a thumbnail of the exact size, stretched or squished to fit the parameters.Image::SCALE_INSIDE- Fits your thumbnail within your given parameters. It will not be any taller or wider than the size passed, whichever is larger.Image::SCALE_OUTSIDE- Fits your thumbnail to the given parameters. It will be as tall or as wide as the size passed, whichever is smaller.Image::SCALE_FIT- Fits your thumbnail to given boundaries maintaining aspect ratio. Result will be aligned vertically to center and horizontally to middle.Image::CROP- Gives you a thumbnail of the exact size, cropped from the center of the full sized image.Image::CROP_RESIZE- As above, but gives a clean resize and crop from center.
The toFile method
Accepted Parameters
$path: The filesystem path to save the image. When null, the raw image stream will be outputted directly.$type: The image type to save the file as (IMAGETYPE_GIF|IMAGETYPE_PNG|IMAGETYPE_JPEG).$options: The image type options to use in saving the file. Usequalitykey to set compression level (0..9 for PNGs and 0..100 for JPEGs)
Example: Using Image::toFile() to save the image as JPEG with 65 compression level
Example: Using Image::toFile() to retrieve data blob of an image.
Installation via Composer
Add "joomla/image": "2.0.*@dev" to the require block in your composer.json and then run composer install.
Alternatively, you can simply run the following from the command line:
If you want to include the test sources, use
