2017 © Pedro Peláez
 

library imageutil

A wrapper collection for GD library in PHP.

image

byjg/imageutil

A wrapper collection for GD library in PHP.

  • Thursday, December 7, 2017
  • by byjg
  • Repository
  • 1 Watchers
  • 11 Stars
  • 348 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 8 Versions
  • 1 % Grown

The README.md

ImageUtil Library

Build Status Opensource ByJG GitHub source GitHub license GitHub release, (*1)

ImageUtil is a PHP library that provides a collection of operations for image manipulation using the GD library. It simplifies tasks such as flipping, cropping, resizing, stamping, and more., (*2)

Installation

To install ImageUtil, use the following composer command:, (*3)

composer require "byjg/imageutil"

Supported Formats

ImageUtil supports the following image formats:, (*4)

  • GIF
  • JPEG
  • PNG
  • BMP
  • WEBP
  • SVG (Partial support. Primarily for converting SVG to other formats, not for SVG manipulation.)

Creating an Image

You can create an image from a file, URL, existing resource, or create an empty image:, (*5)

<?php
use ByJG\ImageUtil\ImageUtil;

// From a file
$img = ImageUtil::fromFile('path_to_image.png');

// From a URL
$img2 = ImageUtil::fromFile('https://somesite/someimage.jpg');

// From an existing resource image
$resourceImg = imagecreatetruecolor(200, 300);
$img3 = ImageUtil::fromResource($resourceImg);

// Or an empty image
$img4 = ImageUtil::empty(200, 300, new Color(255, 255, 255));

SVG Files

ImageUtil provides basic support for SVG files, primarily for converting SVG images to other GD-supported formats. It does not support all SVG features and does not support operations like resize, flip, etc., (*6)

<?php
use ByJG\ImageUtil\ImageUtil;

$img = ImageUtil::fromFile('path_to_image.svg');
$img->save('path_to_image.png');

Image Manipulation

ImageUtil provides several methods for image manipulation:, (*7)

  • Flip: Mirror the image vertically or horizontally.
  • Rotate: Rotate the image by a specified angle.
  • Resize: Resize the image to specified dimensions.
  • Resize Square: Resize the image to a square format while maintaining the aspect ratio. Any extra space is filled with the provided RGB color.
  • Resize AspectRatio: Resize the image while maintaining the aspect ratio. Any extra space is filled with the provided RGB color.
  • Stamp Image: Stamp another image onto the current image.
  • Write Text: Write text onto the image.
  • Crop Image: Crop the image from a specified point to another point.
  • Make Transparent: Make the image transparent. The transparent color must be provided.

See some examples here., (*8)

Saving and Restoring Changes

You can save the changes to the image, restore the image to its original state, or destroy the image resource:, (*9)

<?php
$img->save('filename.gif');
$img->restore();
$img->destroy();

Other Functions

ImageUtil also provides methods to get the image dimensions and the image resource:, (*10)

<?php
$width = $img->getWidth();
$height = $img->getHeight();
$resource = $img->getResource();

Dependencies

ImageUtil depends on the GD extension for PHP:, (*11)

flowchart TD  
    byjg/imageutil --> ext-gd

Open source ByJG, (*12)

The Versions

07/12 2017

dev-master

9999999-dev

A wrapper collection for GD library in PHP.

  Sources   Download

MIT

The Requires

  • ext-gd *

 

by João Gilberto Magalhães

07/12 2017

1.0.5

1.0.5.0

A wrapper collection for GD library in PHP.

  Sources   Download

MIT

The Requires

  • ext-gd *

 

by João Gilberto Magalhães

07/12 2017

1.0.5.x-dev

1.0.5.9999999-dev

A wrapper collection for GD library in PHP.

  Sources   Download

MIT

The Requires

  • ext-gd *

 

by João Gilberto Magalhães

17/04 2016

1.0.4

1.0.4.0

A wrapper collection for GD library in PHP.

  Sources   Download

MIT

The Requires

  • ext-gd *

 

by João Gilberto Magalhães

26/07 2015

1.0.3

1.0.3.0

A wrapper collection for GD library in PHP.

  Sources   Download

MIT

The Requires

  • ext-gd *

 

by João Gilberto Magalhães

20/07 2015

1.0.2

1.0.2.0

A wrapper collection for GD library in PHP.

  Sources   Download

MIT

The Requires

  • ext-gd *

 

by João Gilberto Magalhães

18/07 2015

1.0.1

1.0.1.0

A wrapper collection for GD library in PHP.

  Sources   Download

The Requires

  • ext-gd *

 

by João Gilberto Magalhães

27/05 2015

1.0.0

1.0.0.0

A wrapper collection for GD library in PHP.

  Sources   Download

The Requires

  • ext-gd *

 

by João Gilberto Magalhães