PHP: imagecreatefrompng - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

imagecreatefromstring imagecreatefromjpeg

Last updated: Sat, 27 Jan 2007

view this page in

# imagecreatefrompng

(PHP 3 >= 3.0.13, PHP 4, PHP 5)

imagecreatefrompng -- Create a new image from file or URL

## Описание

resource imagecreatefrompng ( string filename )

imagecreatefrompng() returns an image identifier representing the image obtained from the given filename.

imagecreatefrompng() returns an empty string on failure. It also outputs an error message, which unfortunately displays as a broken link in a browser. To ease debugging the following example will produce an error PNG:

Пример 1. Example to handle an error during creation

`<?php
function LoadPNG($imgname)
{
$im = @imagecreatefrompng($imgname); /* Attempt to open */
if (!$im) { /* See if it failed */
$im = imagecreatetruecolor(150, 30); /* Create a blank image */
$bgc = imagecolorallocate($im, 255, 255, 255);
$tc = imagecolorallocate($im, 0, 0, 0);
imagefilledrectangle($im, 0, 0, 150, 30, $bgc);
/* Output an errmsg */
imagestring($im, 1, 5, 5, "Error loading $imgname", $tc);
}
return $im;
}
header("Content-Type: image/png");
$img = LoadPNG("bogus.image");
imagepng($img);
?>`

Результатом выполнения данного примера будет что-то подобное:

> Подсказка: Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция "fopen wrappers". Смотрите более подробную информацию об определении имени файла в описании функции fopen(), а также список поддерживаемых протоколов URL в Прил. M.

## Список параметров

`filename`

  Path to the PNG image

## Возвращаемые значения

Returns an image resource identifier on success, `FALSE` on errors.

## Примечания

Внимание
Версии `PHP` для Windows до PHP 4.3.0 не поддерживают возможность использования удаленных файлов этой функцией даже в том случае, если опция allow_url_fopen включена.

add a note User Contributed Notes
imagecreatefrompng
marcos at assl-site dot net
28-Feb-2007 12:23
`I had the same problem as jboyd1189 at yahoo dot com but I solve d it allocating more memory dynamically.
Usually the memory_limit var on php.ini is set to 8M. Unfortunately, the required amount of memory to manage a PNG image about 1000x1000 could be bigger !
The approach I used to solve the problem is:
1-Calculate the memory required by the image
2-Set the new memory_limit value
3-Create the PNG image and thumbnail
4-Restore the original value
1-The following value works for me:
$required_memory = Round($width * $height * $size['bits']);
Note that for JPEG the requirements are not the same:
http://es2.php.net/manual/en/function.imagecreatefromjpeg.php#60241
2-Use somthing like:
$new_limit=memory_get_usage() + $required_memory;
ini_set("memory_limit", $new_limit);
4-ini_restore ("memory_limit");`
dane.tschi _AT_ NOSPAM gmx [dot] at
11-Nov-2006 10:46
`I had a problem with PNG files.
My source files were PNG-8 files and i wanted to add some drawings to the Image with alpha blending, but it was not possible only by doing imagecolorallocatealpha() and imagefilledellipse() for example.
I noticed that it was only working for PNG-24 images, but i don't want to use them, because they are to big for my website, but PNG-8 files would be much greater.
My result is that the image has to be converted to PNG-24 after loading and converted back to PNG-8 before saving/output.
This is the script:
<?php
// Load Image and get it's size
$size = getimagesize("png8image.png");
$im = imagecreatefrompng("png8image.png");
// Convert the Image to PNG-24
$im_tc = imagecreatetruecolor($size[0],$size[1]);
imagecopy($im_tc,$im,0,0,0,0,$size[0],$size[1]);
imagedestroy($im);
//Now do what ever you want, all alpha-operation do work
$color = imagecolorallocatealpha ($im_tc,255,255,255,75);
imagefilledellipse ($im_tc,10,10,6,4,$color);
//And now convert it back to PNG-8
$im_result = imagecreate($size[0],$size[1]);
imagecopy($im_result,$im_tc,0,0,0,0,$size[0],$size[1]);
imagedestroy($im_tc);
//And save it
imagepng($im_result,"png8image.png");
?>`
jboyd1189 at yahoo dot com
05-Jul-2006 02:49
`I was having a terrible time with the imagecreatefrompng function as it was working perfectly for one image and not at all for another. After many hours of frustration, I discovered that the problem was the image size (number of pixels). It appears that the maximum number of pixels this function will process is 1,040,000. So, be sure that the pixel resolution of the image (eg. 1040 x 1000) does not exceed this value.`
alext82 at hotmail dot com
31-May-2006 05:54
`I was having trouble with
$black = imagecolorallocate($im, 0, 0, 0);
, as it would always display grey letters.
this solved it however:
$black = imagecolorresolve($im, 0, 0, 0);
this regarding this function.
imagettftext($im, 11, 7, 55, 60, $black, $font, $string);
I hope this helps.`
hendrikjan dot vanmeerveld at gmail dot com
01-May-2006 03:23
`Another usefull note for those using ImageCreateFromPng:
PHP and GD do not recognize grayscale/alpha images.
So if you use grayscale images with transparency between 0% and 100%, then save the image as RGB.
At least this is true for PHP Version 4.4.2-1 and in 5.1.2-1 with pictures made with GIMP 2.2.8.`
ketay [AT] comcast [DOT] net
05-Sep-2005 12:33
`A correction... If you are to set it to FALSE, then not only does it add the transparency to wherever you put it, but it takes the transparency out of the TTF files. Setting it to TRUE however, keeps your transparency both in your PNG file, and in any TTF text you make apply to the image.`
rf at i---i dot org
02-Nov-2004 03:47
`***CORRECTION*** to 07-Jun-2004 01:14
imageAlphaBlending must be false, NOT TRUE
$imgPng = imageCreateFromPng($strImagePath);
imageAlphaBlending($imgPng, false); <<<FALSE
imageSaveAlpha($imgPng, true);`
07-Jun-2004 04:14
`If you're trying to load a translucent png-24 image but are finding an absence of transparency (like it's black), you need to enable alpha channel AND save the setting. I'm new to GD and it took me almost two hours to figure this out.
<?php
$imgPng = imageCreateFromPng($strImagePath);
imageAlphaBlending($imgPng, true);
imageSaveAlpha($imgPng, true);
/* Output image to browser */
header("Content-type: image/png");
imagePng($imgPng);
?>`
csaba at alum dot mit dot edu
31-May-2004 10:57
`This is a another case of someone (IE) thinking they know better than you what you want. If you are of a mind to generate a complicated (read takes a long time) image incrementally, you might do it by having an IFRAME which calls to the image generating PHP script. That munches for a bit, saves the file, returns to the client (remembering we're in the iframe so the user doesn't see all this) (with appropriate state information in <input type=hidden ...> fields) which kicks off an <body onLoad='docInit()' ...> whose purpose is to set the src attribute of the png image to the saved file (so the user sees the changes), and then resubmit the iframe (the image isn't in the iframe so the iframe can be hidden) to repeat the process. Very nifty.
However, IE 6 has decided that it is far better to use a cached version of an image even on a local machine, where it can readily see that it changed, rather than to go to the source. And, since it's a file, you can't so easily set headers on it. This means that your incremental updates may not show any updates.
I solved this by (1) having Apache rewrite every .png request to a single .php file:
RewriteRule ^(.*).png$ pngPassThru.php?file=$1.png [QSA,L,NC]
(2) All pngPassThru.php does is to return the .png file with "don't cache me" headers. Avoid leading/trailing spaces in pngPassThru.php. The headers might be simplified - I've collected them from various sources and am not sure which ones could be eliminated. But this is working for me on IE 6:
<?php
header("Content-type: image/png");
header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");
header("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
header("Cache-Control: no-store, no-cache, must-revalidate");
header("Cache-Control: post-check=0, pre-check=0", false);
header("Pragma: no-cache");
$file=@$_GET['file'];
$size= filesize($file);
header("Content-Length: $size bytes");
readfile($file);
?>
Csaba Gabor`
aniakovas at yahoo dot co dot uk
27-Apr-2004 06:13
`Hey guys,
It has been my experience that the image type of a png file is best set to:-
image/x-png
This may be a peculiarity of the server I'm working on, which is running Apache/FreeBSD
Ania`
polak_sg at hotmail dot com
05-Nov-2002 07:02
`don't forget to write the header into your function file!!
header ("Content-type: image/png");`
wyvern at greywyvern.com
05-Oct-2002 08:45
`Make sure when coding image serving scripts that you avoid using the full "http://" URL of the image whenever possible. Use "../imagename" etc.
Loading URL's from your own site will double your used bandwidth, as the script grabbing the image will count against it as well as sending it to the browser.`
robross at comcast dot net
26-Feb-2002 04:47
`This color table issue is actually a bit more complicated.
From my testing, it would appear that whatever colors you have specified in the color table for your picture in the first nth number of spots, those colors will automatically be given to the first "n" colors you attempt to use in your CreateImagefromPNG.
So, for example, if you need to create dynamic black and red text in your image, the first three spots in the color table for your background image should be white, black and red (in this order).
This can be a pain, but it is the only way to ensure that your images look as intended in all browsers.`
netfiend at mediaone dot net
23-May-2001 04:04
`I've noticed a couple of things with the ImageCreateFromPng function that may be useful if your having problems.
1st thing I noticed is that the PNG file you are creating from needs to be indexed and less than 256 colors.
Secondly, you need to reduce the color depth by 1 for each color you plan on generating in php... I.E. if you plan on drawing 50 different colors on the screen with php you need to allocate space for them by reducing the origional image's color depth to 205 colors (I was pulling my hair out on this one for a while because the wrong colors were showing up in the output).
Also, if you are saving the image as a PNG you need to allocate the 1st color as white.. The reason for this is that Internet Explorer seems to interpret the first color in an indexed PNG as white no matter what color it is... (Figured this out when all my pretty black text was turning up as white in I.E. and was normal in Netscape; allocated the first color in the image as white and the problem went away.)
-- hope this helps.`
add a note
imagecreatefromstring imagecreatefromjpeg

Last updated: Sat, 27 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 09:32:46 2007 PST