Download the PHP package ryantxr/php-image without Composer
On this page you can find all versions of the php package ryantxr/php-image. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ryantxr/php-image
More information about ryantxr/php-image
Files in ryantxr/php-image
Package php-image
Short Description A PHP class wrapper for GD functions.
License MIT
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 php-image
PHP Image by ryantxr
A PHP class wrapper for GD image functions.
Overview
Requirements
- PHP 5.6+
- GD extension
Features
- Supports reading, writing, and converting GIF, JPEG, PNG, WEBP formats.
- Reads and writes files, data URIs, and image strings.
- Manipulation: crop, resize, overlay/watermark, adding TTF text
- Drawing: arc, border, dot, ellipse, line, polygon, rectangle, rounded rectangle
- Filters: blur, brighten, colorize, contrast, darken, desaturate, edge detect, emboss, invert, opacity, pixelate, sepia, sharpen, sketch
- Utilities: color adjustment, darken/lighten color, extract colors
- Properties: exif data, height/width, mime type, orientation
- Color arguments can be passed in as any CSS color (e.g.
LightBlue), a hex color, or an RGB(A) array. - Support for alpha-transparency (GIF, PNG, WEBP)
- Chainable methods
- Uses exceptions
- Load with Composer or manually (just one file)
- Semantic Versioning
Installation
Install with Composer:
Or include the library manually:
License
Licensed under the MIT license.
API
Order of awesomeness:
- Load an image
- Manipulate the image
- Save/output the image
API tips:
- Methods that return a Image object are chainable.
- You can pass a file or data URI to the constructor to avoid calling
fromFileorfromDataUri. - Static methods can be called with
$image::methodName()or\Ryantxr\Image::methodName(). - Colors can be a CSS color (e.g.
white), a hex string (e.g. '#ffffff'), or an RGBA array. - You can pipe transparency to
normalizeColorwhen you pass a CSS color or hex string:white|0.25
Constructor
__construct($width=null, $height=null, $color='transparent')
Makes a new object. If width and height are supplied then an underlying image resource will be created.
Loaders
fromDataUri($uri)
Loads an image from a data URI.
$uri(string) - A data URI.
Returns a Image object.
fromFile($file)
Loads an image from a file.
$file(string) - The image file to load.
Returns a Image object.
fromString($string)
Creates a new image from a string.
$string(string) - The raw image data as a string. Example:
Returns a Image object.
Savers
toDataUri($mimeType, $quality)
Generates a data URI.
$mimeType(string) - The image format to output as a mime type (defaults to the original mime type).$quality(int) - Image quality as a percentage (default 100).
Returns a string containing a data URI.
toDownload($filename, $mimeType, $quality)
Forces the image to be downloaded to the clients machine. Must be called before any output is sent to the screen.
$filename(string) - The filename (without path) to send to the client (e.g. 'image.jpeg').$mimeType(string) - The image format to output as a mime type (defaults to the original mime type).$quality(int) - Image quality as a percentage (default 100).
Returns a Image object.
toFile($file, $mimeType, $quality)
Writes the image to a file.
$mimeType(string) - The image format to output as a mime type (defaults to the original mime type).$quality(int) - Image quality as a percentage (default 100).
Returns a Image object.
toScreen($mimeType, $quality)
Outputs the image to the screen. Must be called before any output is sent to the screen.
$mimeType(string) - The image format to output as a mime type (defaults to the original mime type).$quality(int) - Image quality as a percentage (default 100).
Returns a Image object.
toString($mimeType, $quality)
Generates an image string.
$mimeType(string) - The image format to output as a mime type (defaults to the original mime type).$quality(int) - Image quality as a percentage (default 100).
Returns a Image object.
Utilities
getAspectRatio()
Gets the image's current aspect ratio.
Returns the aspect ratio as a float.
getExif()
Gets the image's exif data.
Returns an array of exif data or null if no data is available.
getHeight()
Gets the image's current height.
Returns the height as an integer.
getMimeType()
Gets the mime type of the loaded image.
Returns a mime type string.
getOrientation()
Gets the image's current orientation.
Returns a string: 'landscape', 'portrait', or 'square'
getWidth()
Gets the image's current width.
Returns the width as an integer.
copyResized($fromImage, $toX, $toY, $toWidth, $toHeight, $fromX, $fromY, $fromWidth, $fromHeight)
Copy another image on top this one.
$fromImageImage - other to copy from$toXint - left of destination area$toYint - top of destination area$toWidthint - width of destination area$toHeightint - height of destination area$fromXint - left of source area$fromYint - top of source area$fromWidthint - width of source area$fromHeightint - height of source area
alphaBlending()
Sets alpha blending
Manipulation
autoOrient()
Rotates an image so the orientation will be correct based on its exif data. It is safe to call this method on images that don't have exif data (no changes will be made). Returns a Image object.
bestFit($maxWidth, $maxHeight)
Proportionally resize the image to fit inside a specific width and height.
$maxWidth(int) - The maximum width the image can be.$maxHeight(int) - The maximum height the image can be.
Returns a Image object.
crop($x1, $y1, $x2, $y2)
Crop the image.
$x1- Top left x coordinate.$y1- Top left y coordinate.$x2- Bottom right x coordinate.$y2- Bottom right x coordinate.
Returns a Image object.
flip($direction)
Flip the image horizontally or vertically.
$direction(string) - The direction to flip: x|y|both
Returns a Image object.
maxColors($max, $dither)
Reduces the image to a maximum number of colors.
$max(int) - The maximum number of colors to use.$dither(bool) - Whether or not to use a dithering effect (default true).
Returns a Image object.
overlay($overlay, $anchor, $opacity, $xOffset, $yOffset)
Place an image on top of the current image.
$overlay(string|Image) - The image to overlay. This can be a filename, a data URI, or a Image object.$anchor(string) - The anchor point: 'center', 'top', 'bottom', 'left', 'right', 'top left', 'top right', 'bottom left', 'bottom right' (default 'center')$opacity(float) - The opacity level of the overlay 0-1 (default 1).$xOffset(int) - Horizontal offset in pixels (default 0).$yOffset(int) - Vertical offset in pixels (default 0).
Returns a Image object.
resize($width, $height)
Resize an image to the specified dimensions. If only one dimension is specified, the image will be resized proportionally.
$width(int) - The new image width.$height(int) - The new image height.
Returns a Image object.
rotate($angle, $backgroundColor)
Rotates the image.
$angle(int) - The angle of rotation (-360 - 360).$backgroundColor(string|array) - The background color to use for the uncovered zone area after rotation (default 'transparent').
Returns a Image object.
text($text, $options, &$boundary)
Adds text to the image.
$text(string) - The desired text.$options(array) - An array of options.fontFile(string) - The TrueType (or compatible) font file to use.size(int) - The size of the font in pixels (default 12).color(string|array) - The text color (default black).anchor(string) - The anchor point: 'center', 'top', 'bottom', 'left', 'right', 'top left', 'top right', 'bottom left', 'bottom right' (default 'center').xOffset(int) - The horizontal offset in pixels (default 0).yOffset(int) - The vertical offset in pixels (default 0).shadow(array) - Text shadow params.x(int) - Horizontal offset in pixels.y(int) - Vertical offset in pixels.color(string|array) - The text shadow color.
$boundary(array) - If passed, this variable will contain an array with coordinates that surround the text: [left, top, right, bottom, width, height]. This can be used for calculating the text's position after it gets added to the image.
Returns a Image object.
thumbnail($width, $height, $anchor)
Creates a thumbnail image. This function attempts to get the image as close to the provided dimensions as possible, then crops the remaining overflow to force the desired size. Useful for generating thumbnail images.
$width(int) - The thumbnail width.$height(int) - The thumbnail height.$anchor(string) - The anchor point: 'center', 'top', 'bottom', 'left', 'right', 'top left', 'top right', 'bottom left', 'bottom right' (default 'center').
Returns a Image object.
Drawing
arc($x, $y, $width, $height, $start, $end, $color, $thickness)
Draws an arc.
$x(int) - The x coordinate of the arc's center.$y(int) - The y coordinate of the arc's center.$width(int) - The width of the arc.$height(int) - The height of the arc.$start(int) - The start of the arc in degrees.$end(int) - The end of the arc in degrees.$color(string|array) - The arc color.$thickness(int|string) - Line thickness in pixels or 'filled' (default 1).
Returns a Image object.
border($color, $thickness)
Draws a border around the image.
$color(string|array) - The border color.$thickness(int) - The thickness of the border (default 1).
Returns a Image object.
dot($x, $y, $color)
Draws a single pixel dot.
$x(int) - The x coordinate of the dot.$y(int) - The y coordinate of the dot.$color(string|array) - The dot color.
Returns a Image object.
ellipse($x, $y, $width, $height, $angle, $color, $thickness)
Draws an ellipse.
- int
$x- The x coordinate of the center. - int
$y- The y coordinate of the center. - int
$width- The ellipse width. - int
$height- The ellipse height. - int
$angle- rotation angle 0-360 - string|array
$color- The ellipse color. - int|string
$thickness- Line thickness in pixels or 'filled' (default 1).
Returns a Image object.
fill($color)
Fills the image with a solid color.
$color(string|array) - The fill color.
Returns a Image object.
line($x1, $y1, $x2, $y2, $color, $thickness)
Draws a line.
$x1(int) - The x coordinate for the first point.$y1(int) - The y coordinate for the first point.$x2(int) - The x coordinate for the second point.$y2(int) - The y coordinate for the second point.$color(string|array) - The line color.$thickness(int) - The line thickness (default 1).
Returns a Image object.
polygon($vertices, $color, $thickness)
Draws a polygon.
-
$vertices(array) - The polygon's vertices in an array of x/y arrays. Example: $color(string|array) - The polygon color.$thickness(int|string) - Line thickness in pixels or 'filled' (default 1).
Returns a Image object.
rectangle($x1, $y1, $x2, $y2, $color, $thickness)
Draws a rectangle.
$x1(int) - The upper left x coordinate.$y1(int) - The upper left y coordinate.$x2(int) - The bottom right x coordinate.$y2(int) - The bottom right y coordinate.$color(string|array) - The rectangle color.$thickness(int|string) - Line thickness in pixels or 'filled' (default 1).
Returns a Image object.
roundedRectangle($x1, $y1, $x2, $y2, $radius, $color, $thickness)
Draws a rounded rectangle.
$x1(int) - The upper left x coordinate.$y1(int) - The upper left y coordinate.$x2(int) - The bottom right x coordinate.$y2(int) - The bottom right y coordinate.$radius(int) - The border radius in pixels.$color(string|array) - The rectangle color.$thickness(int|string) - Line thickness in pixels or 'filled' (default 1).
Returns a Image object.
Filters
blur($type, $passes)
Applies the blur filter.
$type(string) - The blur algorithm to use: 'selective', 'gaussian' (default 'gaussian').$passes(int) - The number of time to apply the filter, enhancing the effect (default 1).
Returns a Image object.
brighten($percentage)
Applies the brightness filter to brighten the image.
$percentage(int) - Percentage to brighten the image (0 - 100).
Returns a Image object.
colorize($color)
Applies the colorize filter.
$color(string|array) - The filter color.
Returns a Image object.
contrast($percentage)
Applies the contrast filter.
$percentage(int) - Percentage to adjust (-100 - 100).
Returns a Image object.
darken($percentage)
Applies the brightness filter to darken the image.
$percentage(int) - Percentage to darken the image (0 - 100).
Returns a Image object.
desaturate()
Applies the desaturate (grayscale) filter.
Returns a Image object.
duotone($lightColor, $darkColor)
Applies the duotone filter to the image.
$lightColor(string|array) - The lightest color in the duotone.$darkColor(string|array) - The darkest color in the duotone.
Returns a Image object.
edgeDetect()
Applies the edge detect filter.
Returns a Image object.
emboss()
Applies the emboss filter.
Returns a Image object.
invert()
Inverts the image's colors.
Returns a Image object.
opacity()
Changes the image's opacity level.
$opacity(float) - The desired opacity level (0 - 1).
Returns a Image object.
pixelate($size)
Applies the pixelate filter.
$size(int) - The size of the blocks in pixels (default 10).
Returns a Image object.
sepia()
Simulates a sepia effect by desaturating the image and applying a sepia tone.
Returns a Image object.
sharpen()
Sharpens the image.
Returns a Image object.
sketch()
Applies the mean remove filter to produce a sketch effect.
Returns a Image object.
Color utilities
(static) adjustColor($color, $red, $green, $blue, $alpha)
Adjusts a color by increasing/decreasing red/green/blue/alpha values independently.
$colorstring|array - The color to adjust.$redint - Red adjustment (-255 - 255).$greenint - Green adjustment (-255 - 255).$blueint - Blue adjustment (-255 - 255).$alphafloat - Alpha adjustment (-1 - 1).
Returns an RGBA color array.
(static) darkenColor($color, $amount)
Darkens a color.
$colorstring|array - The color to darken.$amountint - Amount to darken (0 - 255).
Returns an RGBA color array.
extractColors($count = 10, $backgroundColor = null)
Extracts colors from an image like a human would do.™ This method requires the third-party library \League\ColorExtractor. If you're using Composer, it will be installed for you automatically.
$countint - The max number of colors to extract (default 5).$backgroundColorstring|array - By default any pixel with alpha value greater than zero will be discarded. This is because transparent colors are not perceived as is. For example, fully transparent black would be seen white on a white background. So if you want to take transparency into account, you have to specify a default background color.
Returns an array of RGBA colors arrays.
getColorAt($x, $y)
Gets the RGBA value of a single pixel.
$xint - The horizontal position of the pixel.$yint - The vertical position of the pixel.
Returns an RGBA color array or false if the x/y position is off the canvas.
(static) lightenColor($color, $amount)
Lightens a color.
$colorstring|array - The color to lighten.$amountint - Amount to darken (0 - 255).
Returns an RGBA color array.
(static) normalizeColor($color)
Normalizes a hex or array color value to a well-formatted RGBA array.
$colorstring|array - A CSS color name, hex string, or an array [red, green, blue, alpha].
You can pipe alpha transparency through hex strings and color names. For example:
fff|0.50 <-- 50% white
red|0.25 <-- 25% red
Returns an array: [red, green, blue, alpha]
Exceptions
Image throws standard exceptions when things go wrong. You should always use a try/catch block around your code to properly handle them.
To check for specific errors, compare $err->getCode() to the defined error constants.
As a best practice, always use the defined constants instead of their integers values. The values will likely change in future versions, and WILL NOT be considered a breaking change.
ERR_FILE_NOT_FOUND- The specified file could not be found or loaded for some reason.ERR_FONT_FILE- The specified font file could not be loaded.ERR_FREETYPE_NOT_ENABLED- Freetype support is not enabled in your version of PHP.ERR_GD_NOT_ENABLED- The GD extension is not enabled in your version of PHP.ERR_LIB_NOT_LOADED- A required library has not been loaded.ERR_INVALID_COLOR- An invalid color value was passed as an argument.ERR_INVALID_DATA_URI- The specified data URI is not valid.ERR_INVALID_IMAGE- The specified image is not valid.ERR_UNSUPPORTED_FORMAT- The image format specified is not valid.ERR_WEBP_NOT_ENABLED- WEBP support is not enabled in your version of PHP.ERR_WRITE- Unable to write to the file system.ERR_OVERLAY- Param 1 of overlay function was not a string or Image object.
Useful Things To Know
-
Color arguments can be a CSS color name (e.g.
LightBlue), a hex color string (e.g.#0099dd), or an RGB(A) array (e.g.['red' => 255, 'green' => 0, 'blue' => 0, 'alpha' => 1]). - When
$thickness> 1, GD draws lines of the desired thickness from the center origin. For example, a rectangle drawn at [10, 10, 20, 20] with a thickness of 3 will actually be draw at [9, 9, 21, 21]. This is true for all shapes and is not a bug in the Image library.
Credits
Originally developed by Cory LaViska.
