GImage PHP Canvas to Image: Create and compose canvas images from other images

Recommend this page to a friend!

Download

Info

Example

Files

Install with Composer

Download

Reputation

Support forum

Blog

Links

Ratings				Unique User Downloads		Download Rankings
59%				Total: 571		All time: 5,377 This week: 54

Version		License		PHP version		Categories
`canvas-image` 2.0.16		MIT/X Consortium ...		5.5		PHP 5, Graphics

Description

Author

Jose Luis Quintana

This package can create and compose canvas images from other images.

It provides classes for creating image objects defined by colored rectangles, images from files and text.

An additional canvas class can compose complex images using images defined by the other classes easier.

The composed images may be saved to files in the PNG and JPEG formats or displayed as the current script output.

Jose Luis Quintana

Performance

Level

Name:	Jose Luis Quintana `<contact>`
Classes:	2 packages by Jose Luis Quintana
Country:	Peru

Level 1

Example


<?php

/*

 * This file is part of GImage.

 *

 * (c) Jose Quintana <https://joseluisq.net>

 *

 * This source file is subject to the MIT license that is bundled

 * with this source code in the file LICENSE.

 */



/**

 * Creating a Presentation Card.

 *

 * @author Jose Quintana <https://joseluisq.net>

 */



namespace GImage\Examples;



use GImage\Image;

use GImage\Text;

use GImage\Figure;

use GImage\Canvas;



require __DIR__ . '/_config.php';

require __DIR__ . '/../tests/bootstrap.php';



// Creating an avatar image

$avatar_image = new Image();

$avatar_image

    // Image size (500x500)

    ->load('https://i.imgur.com/vLXIIoY.jpg')

    ->centerCrop(100, 100)

    ->setTop(60)

    ->setLeft(70);



$about_text = new Text("MY AWESOME PRESENTATION CARD\n~ BY GIMAGE ~");

$about_text->setSize(16)

    ->setWidth(300)

    ->setLeft(210)

    ->setLineHeight(1.5)

    ->setTop(75)

    ->setColor(204, 164, 116)

    ->setFontface(BASE_PATH . '/fonts/Lato-Lig.ttf');



$twitter_text = new Text('@joseluisq/gimage');

$twitter_text

    ->setSize(11)

    ->setWidth(70)

    ->setLeft(410)

    ->setTop(210)

    ->setColor(130, 127, 125)

    ->setFontface(BASE_PATH . '/fonts/Lato-Reg.ttf');



$canvas_figure = new Figure(550, 250);

$canvas_figure

    ->setBackgroundColor(47, 42, 39)

    ->create();



$avatar_box = new Figure($avatar_image->getWidth() + 16, $avatar_image->getHeight() + 17);

$avatar_box

    ->setBackgroundColor(63, 56, 52)

    ->setLeft($avatar_image->getLeft() - 7)

    ->setTop($avatar_image->getTop() - 8)

    ->create();



$avatar_box2 = new Figure($avatar_image->getWidth() + 3, $avatar_image->getHeight() + 19);

$avatar_box2

    ->setBackgroundColor(79, 72, 67)

    ->setLeft($avatar_image->getLeft() + 7)

    ->setTop($avatar_image->getTop() - 9)

    ->create();



$avatar_box3 = new Figure(120, 240);

$avatar_box3

    ->setBackgroundColor(63, 56, 52)

    ->create();



$line_vertical = new Figure(600, 10);

$line_vertical

    ->setBackgroundColor(119, 99, 77)

    ->setTop(240)

    ->create();



$line_horizontal = new Figure(1, 240);

$line_horizontal

    ->setBackgroundColor(79, 72, 67)

    ->setLeft(120)

    ->create();



$canvas = new Canvas($canvas_figure);

$canvas

    ->append([

        $line_horizontal,

        $avatar_box2,

        $avatar_box3,

        $avatar_box,

        $avatar_image,

        $about_text,

        $twitter_text,

        $line_vertical

    ])

    ->setQuality(100)

    ->toPNG()

    ->draw()

    ->save(__DIR__ . '/card.png');

Details

GImage

![](https://packagist.org/packages/joseluisq/gimage)

> A PHP library for easy image handling. ?

__GImage__ is a simple and small library based on PHP Image Processing and GD for processing images easily.

A simple presentation card with GImage

_Presentation card built with GImage - View code example_

Features

Load an image from a local path, URL or image resource.
Create shapes such as rectangles or ellipses with opacity.
Resize, scale or crop images proportionally.
Rotate images, shapes or texts.
Embed text with custom TTF fonts.
Compose a pool of images with `Canvas`.
Swap image formats such as JPEG, PNG or GIF.
Save images locally or output them on the browser.
Save several copies of the same image.
Render an image in memory and return its resource.

Requirements

GImage requires PHP 7.4 or a recent PHP version with the latest GD Extension.

Install

composer require joseluisq/gimage

Usage

Load an external PNG image and save it as JPG:

<?php

use GImage\Image;

// PNG image (600x199)
$url = 'https://i.imgur.com/G5MR088.png';

$arch = new Image();
$arch
    // Load from URL
    ->load($url)
    // Scale to 50% (300x99)
    ->scale(0.5)
    // Change the format to JPG
    ->toJPG()
    // Saving in local path
    ->save('arch.jpg');

See GImage Website for detailed usage instructions and more advanced examples.

Changelog

Check out the CHANGELOG.md file.

Examples

See code examples directory.

Development

Run tests

Via Composer

composer install
composer run-script test

Via Docker (multi PHP versions test)

make docker-tests

Contribution

Feel free to send some Pull request or file an issue.

License

This work is primarily distributed under the terms of the MIT license.

�2015-present Jose Quintana

Files (48)

File	Role	Description
`.github` (1 directory)
`docs` (2 files, 1 directory)
`examples` (11 files)
`src` (5 files)
`tests` (2 files)
`.php-cs-fixer.dist.php`	Example	Example script
`CHANGELOG.md`	Example	Example script
`composer.json`	Data	Auxiliary data
`LICENSE-MIT`	Lic.	License text
`Makefile`	Data	Auxiliary data
`phpunit.xml`	Data	Auxiliary data
`README.md`	Data	Auxiliary data

Files (48)

.github

File	Role	Description
`workflows` (1 file)

Files (48)

.github

workflows

File	Role	Description
`devel.yml`	Data	Auxiliary data

Files (48)

docs

File	Role	Description
`content` (4 files, 3 directories)
`mkdocs.yml`	Data	Auxiliary data
`README.md`	Doc.	Documentation

Files (48)

docs

content

File	Role	Description
`assets` (1 file)
`classes` (4 files)
`examples` (11 files)
`api.md`	Data	Auxiliary data
`build-documentation.md`	Data	Auxiliary data
`getting-started.md`	Example	Example script
`index.md`	Data	Auxiliary data

Files (48)

docs

content

assets

File	Role	Description
`style.css`	Data	Auxiliary data

Files (48)

docs

content

classes

File	Role	Description
`canvas.md`	Example	Example script
`figure.md`	Example	Example script
`image.md`	Example	Example script
`text.md`	Example	Example script

Files (48)

docs

content

examples

File	Role	Description
`composing-with-canvas.md`	Example	Example script
`creating-a-presentation-card.md`	Example	Example script
`creating-figures.md`	Example	Example script
`cropping.md`	Example	Example script
`image-resource-loading.md`	Example	Example script
`index.md`	Data	Auxiliary data
`render-images-in-memory.md`	Example	Example script
`resizing.md`	Example	Example script
`rotation.md`	Example	Example script
`swapping-formats.md`	Example	Example script
`text-embedding.md`	Example	Example script

Files (48)

examples

File	Role	Description
`card.php`	Example	Example script
`crop.php`	Example	Example script
`ellipse.php`	Example	Example script
`jpg2png.php`	Example	Example script
`README.md`	Doc.	Documentation
`rectangle.php`	Example	Example script
`render.php`	Example	Example script
`resource.php`	Example	Example script
`rotate.php`	Example	Example script
`text.php`	Example	Example script
`_config.php`	Aux.	Auxiliary script

Files (48)

src

File	Role	Description
`Canvas.php`	Class	Class source
`Figure.php`	Class	Class source
`Image.php`	Class	Class source
`Text.php`	Class	Class source
`Utils.php`	Class	Class source

Files (48)

tests

File	Role	Description
`bootstrap.php`	Aux.	Auxiliary script
`GImageTest.php`	Class	Class source

The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page.

Install with Composer

	canvas-image-2023-01-18.zip 40KB
	canvas-image-2023-01-18.tar.gz 22KB
	Install with Composer

Version Control

Unique User Downloads

Download Rankings

100%

Total:	571
This week:	0

All time:	5,377
This week:	54

User Ratings

User Comments (1)

	All time
Utility:	85%
Consistency:	85%
Documentation:	-
Examples:	80%
Tests:	-
Videos:	-
Overall:	59%
Rank:	1379

It is a nice Widget
10 years ago (Thomas Stoffregen)

80%

Applications that use this package

No pages of applications that use this class were specified.

If you know an application of this package, send a message to the author to add a link here.

About us

Advertise on this site

For more information send a message to info at phpclasses dot org.