2017 © Pedro Peláez
 

library icofileloader

image

lordelph/icofileloader

  • Monday, April 2, 2018
  • by lordelph
  • Repository
  • 3 Watchers
  • 13 Stars
  • 2,691 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 11 Versions
  • 39 % Grown

The README.md

Elphin IcoFileLoader

![Software License][ico-license] Build Status ![Coverage Status][ico-scrutinizer] Quality Score, (*1)

This package provides a means to load and convert .ico files in a PHP application. It has no dependencies apart from gd for rendering., (*2)

The package has unit tests which verify support for 1bit, 4bit, 8bit, 24bit and 32bit .ico files, and the newer form of .ico files which can included embedded PNG files., (*3)

Installation

For recent php versions (8.*) IcoFileLoader is available via Composer:, (*4)

composer require lordelph/icofileloader

PHP 5.6 - 7.x

Earlier versions of php from 5.6 onwards can use version 2 of IcoFileLoader, (*5)

composer require lordelph/icofileloader:2.*

PHP 5.4 - 5.5

If you need to use php5.4 or php5.5, you must install the v1.* branch, (*6)

composer require lordelph/icofileloader:1.*

Usage

The IcoFileService class provides a one-shot method extractIcon. This should suit most use-cases where you simply want to get one image out of a .ico file., (*7)

It returns an image resource, which you can further manipulate with GD functions, e.g. save it to a file with imagepng, (*8)

For example, here's how you extract a 32x32 transparent image from an ico file:, (*9)

$loader = new Elphin\IcoFileLoader\IcoFileService;
$im = $loader->extractIcon('/path/to/icon.ico', 32, 32);

//$im is a GD image resource, so we could, for example, save this as a PNG
imagepng($im, '/path/to/output.png');

Render with background color

Instead of retaining the alpha channel from the icon, you can render with a background color instead - pass the required color as a renderer option as follows:, (*10)

$im = $loader->extractIcon('/path/to/icon.ico', 32, 32, ['background'=>'#FFFFFF']);

Extract icon at any size

The extractIcon method will try find an image in the icon which is the exact size you request at highest color depth it can find. If it can't, it will resize the best quality image in the icon. So, you can request any size you require..., (*11)

$im = $loader->extractIcon('/path/to/icon.ico', 100, 100);

Extract icon from a URL

As long you have the PHP fopen wrappers installed, you can pass a URL to extractIcon, (*12)

$im = $loader->extractIcon('https://assets-cdn.github.com/favicon.ico', 16, 16);

Extract icon from binary data

If you already have an ico file held as a binary string, extractIcon will cope with that just fine too:, (*13)

$data = file_get_contents('/path/to/icon.ico');
$im = $loader->extractIcon($data, 16, 16);

Lower level methods

If you want to do more than just extract a single image from an icon, you can use lower level methods of IcoFileService to inspect an .ico file and perform multiple renderings., (*14)

The fromFile, fromString and from methods will parse an ico file and return an Icon instance representing an icon and the images it contains., (*15)

You can iterate the images in icon, examine them, and render them with renderImage, (*16)

For example, here's how you could extract all the images in an icon and save them as individual files., (*17)

$icon = $loader->fromFile('/path/to/icon.ico');
foreach ($icon as $idx => $image) {
     $im=$loader->renderImage($image);

     $filename=sprintf('img%d-%dx%d.png', $idx, $image->width, $image->height);
     imagepng($im, $filename);

     printf("rendered %s as %s\n", $image->getDescription(), $filename);
}

Internals

The service is composed of a parser and a renderer, which can be injected into the service at runtime if you wanted to override them., (*18)

The current GdRenderer works by drawing individual pixels for BMP based icon images. This isn't going to be terribly fast. PHP 7.2 will have support for BMP images, and I'll add a renderer which takes advantage of that when it is released., (*19)

Testing

bash $ composer test, (*20)

Contributing

Please see CONTRIBUTING for details., (*21)

Credits

Thanks also to the PHP League's skeleton project from which this project's structure was derived., (*22)

License

The MIT License (MIT). Please see License File for more information., (*23)

Note: this was based on some classes originally written in 2005 by Diogo Resende. While these were originally provided on the PHPClasses site under a GPL license, Diogo kindly agreed to allow them to be licensed under an MIT license., (*24)

The Versions

02/04 2018

0.0.1

0.0.1.0

  Sources   Download

01/06 2017

dev-master

9999999-dev http://icofileloader.dixo.net/

High quality PHP package for reading and converting any .ico icon file, particularly website favicons

  Sources   Download

MIT

The Requires

  • php >=5.6.0
  • ext-gd *

 

The Development Requires

by Paul Dixon

icon extract load convert favicon ico

01/06 2017

2.0.1

2.0.1.0 http://icofileloader.dixo.net/

High quality PHP package for reading and converting any .ico icon file, particularly website favicons

  Sources   Download

MIT

The Requires

  • php >=5.6.0
  • ext-gd *

 

The Development Requires

by Paul Dixon

icon extract load convert favicon ico

14/05 2017

2.0.0

2.0.0.0 http://icofileloader.dixo.net/

High quality PHP package for reading and converting any .ico icon file, particularly website favicons

  Sources   Download

MIT

The Requires

  • php >=5.6.0
  • ext-gd *

 

The Development Requires

by Paul Dixon

icon extract load convert favicon ico

14/05 2017

dev-php54

dev-php54 http://icofileloader.dixo.net/

High quality PHP package for reading and converting any .ico icon file, particularly website favicons

  Sources   Download

MIT

The Requires

  • php >=5.4.0
  • ext-gd *

 

The Development Requires

by Paul Dixon

icon extract load convert favicon ico

14/05 2017

1.1.0

1.1.0.0 http://icofileloader.dixo.net/

High quality PHP package for reading and converting any .ico icon file, particularly website favicons

  Sources   Download

MIT

The Requires

  • php >=5.4.0
  • ext-gd *

 

The Development Requires

by Paul Dixon

icon extract load convert favicon ico

11/05 2017

1.0.2

1.0.2.0 http://icofileloader.dixo.net/

High quality PHP package for reading and converting any .ico icon file, particularly website favicons

  Sources   Download

MIT

The Requires

  • php >=5.6.0
  • ext-gd *

 

The Development Requires

by Paul Dixon

icon extract load convert favicon ico

24/01 2017

1.0.1

1.0.1.0 http://icofileloader.dixo.net/

PHP package for reading and converting .ico files, particularly website favicons

  Sources   Download

MIT

The Requires

  • php >=5.6.0
  • ext-gd *

 

The Development Requires

by Paul Dixon

icon extract load convert favicon ico

23/01 2017

1.0.0

1.0.0.0 http://icofileloader.dixo.net/

PHP package for reading and converting .ico files, particularly website favicons

  Sources   Download

MIT

The Requires

  • php >=5.6.0
  • ext-gd *

 

The Development Requires

by Paul Dixon

icon extract load convert favicon ico

22/01 2017

1.0.0-alpha

1.0.0.0-alpha https://github.com/lordelph/icofileloader

PHP package for reading .ico files, particularly website favicons

  Sources   Download

MIT

The Requires

  • php >=5.6.0
  • ext-gd *

 

The Development Requires

by Paul Dixon

icon extract load convert favicon ico

20/01 2017

0.0.2

0.0.2.0 https://github.com/lordelph/icofileloader

PHP package for reading .ico files, particularly website favicons

  Sources   Download

MIT

The Requires

  • php >=5.6.0
  • ext-gd *

 

The Development Requires

by Paul Dixon

icon extract load convert favicon ico