Issue reading GDImage object using \Imagine\Gd\Imagine read() method

[jcogs-design]

Issue description

When trying to read an existing GDImage object into an Imagine\Gd\Imagine object I get an exception Variable does not contain a stream resource

Unclear from manual whether there is a way / how to insert a GDImage object into an Imagine object.

What version of Imagine are you using?

1.3.2

What's the PHP version you are using?

8.0.25

What's the imaging library you are using [gd/imagick/gmagick/any]?

GD2

What's the imaging library configuration

GD Version: "2.3.3" FreeType Support: true FreeType Linkage: "with freetype" GIF Read Support: true GIF Create Support: true JPEG Support: true PNG Support: true WBMP Support: true XPM Support: true XBM Support: true WebP Support: true BMP Support: true TGA Read Support: true JIS-mapped Japanese Font Support: false

Minimal PHP code to reproduce the error:

$gd_resource = imagecreatefromstring(file_get_contents($path)); // in php 8 creates a GDImage object
$imagine_object = new Imagine\Gd\Imagine(); // Creates new Imagine GD object
$imagine_object->read($gd_resource); // Throws an error 'Variable does not contain a stream resource'

[ausi]

Imagine\Gd\Imagine::read() can only handle resources that point to files, not GD resource objects.
So your code should probably look like this:

$file_contents = file_get_contents($path);
$imagine_object = new Imagine\Gd\Imagine();
$imagine_object->load($file_contents);

Or if you need to handle existing GD resources you could use the class factory to create an image from that:

$gd_resource = imagecreatefromstring(file_get_contents($path)); // in php 8 creates a GDImage object
(new Imagine\Factory\ClassFactory())->createImage(
    Imagine\Factory\ClassFactoryInterface::HANDLE_GD, 
    $gd_resource, 
    new Imagine\Image\Palette\RGB(), 
    new Imagine\Image\Metadata\MetadataBag(),
);

[jcogs-design]

Hi - that's super helpful thanks. Am just getting head around Imagine and finding the documentation quite terse: great as a reference for specific methods, but not so useful for getting a handle on approach used by library. Such illustrative information as I have found so far dates from 2011, and not useful for current version of library. Do you know if there are good sources of information on use of the library beyond the docs? Thanks!

[ausi]

Do you know if there are good sources of information on use of the library beyond the docs?

I don’t know. I usually read the source code directly to find out how it is meant to be used. ☺️