|
imagedestroy
Destroy an image
(PHP 4, PHP 5)
Related Examples ( Source code ) » imagedestroy Examples ( Source code ) » Draw Filled Arc Examples ( Source code ) » Drawing a Circle Examples ( Source code ) » Paint string value with different colors and position Examples ( Source code ) » Draw char with color Examples ( Source code ) » Draw string and fill rectangle Examples ( Source code ) » Using a Bounding Box to Center Text Examples ( Source code ) » Drawing a Square and a string Examples ( Source code ) » Draw Filled Ellipse Examples ( Source code ) » Draw ellipse Examples ( Source code ) » Filled ellipse Examples ( Source code ) » Set font Examples ( Source code ) » Create Color for paint Examples ( Source code ) » Color Examples ( Source code ) » Set Font size Examples ( Source code ) » Image copy Code Examples / Notes » imagedestroyandrew hoffmann - ahoffmann
When working with a lot of high-resolution images, it's IMPERATIVE that you use the imagedestroy() function. In my scenario, I was taking two high resolution desktop wallpapers and shrinking them down into successively smaller ones (preventing the user from having to upload a dozen files). At first, my script would run, then just stop. I realized later that I had not destroyed the source image and the newly resized image in memory after I had finished writing the file out to disk. Thus, I quickly reached the memory limit that my hosting provider placed in their php.ini file. Reusing an image variable does NOT clear the old data out of memory! You must use imagedestroy() to clear the data out. (I don't know if unset() works as well). Also note that the image data in memory is raw, so don't base how much memory you are using based on the original filesize of the compressed image (such as jpeg or png). docey
When the script stop PHP will automatic destory ANY resources, this goes for aswell for images, thus in the case the use clicks the stop button, php will automatic clear the resource. thus imagedestroy is used to clear the memory BEFORE the script ends. this is usefull to keep memory usage DURING the script to an acceptable level. hope this clear somethings up. dan
I have noticed that gd drawing functions can behave oddly if there is a previous image which has not been imagedestroy()'ed. You should always imagedestroy when you are done with an image object.
roland
As Andrew states below, it's IMPERATIVE that you use the imagedestroy() function. But your script may abort before it reaches the call to imagedestroy() (for example the user may click the browsers 'stop' button). In this case the default PHP behaviour is to abort the script, never reaching your call to imagedestroy(). One way of doing it (the one which works very well for me) is with register_shutdown_function(): <? function shutdown_func() { global $img; if($img) imagedestroy($img); } register_shutdown_function("shutdown_func"); $img = imagecreate...(...); ... // manipulate image // normally I'd need the following line, but now it's handled by shutdown_func() // imagedestroy($img); ?> webmaster
And to continue what Docey said, if php did not destroy all resources when the script stopped it would be a huge memory leak and everyone would be crying out for it to be fixed right away. I have been using this function during a script that was breaking an image made of many little icons into the little parts, which could mean 400+ images in the one script, which was using a lot of memory so I needed to destroy them. |
Change Languagegd_info getimagesize image_type_to_extension image_type_to_mime_type image2wbmp imagealphablending imageantialias imagearc imagechar imagecharup imagecolorallocate imagecolorallocatealpha imagecolorat imagecolorclosest imagecolorclosestalpha imagecolorclosesthwb imagecolordeallocate imagecolorexact imagecolorexactalpha imagecolormatch imagecolorresolve imagecolorresolvealpha imagecolorset imagecolorsforindex imagecolorstotal imagecolortransparent imageconvolution imagecopy imagecopymerge imagecopymergegray imagecopyresampled imagecopyresized imagecreate imagecreatefromgd2 imagecreatefromgd2part imagecreatefromgd imagecreatefromgif imagecreatefromjpeg imagecreatefrompng imagecreatefromstring imagecreatefromwbmp imagecreatefromxbm imagecreatefromxpm imagecreatetruecolor imagedashedline imagedestroy imageellipse imagefill imagefilledarc imagefilledellipse imagefilledpolygon imagefilledrectangle imagefilltoborder imagefilter imagefontheight imagefontwidth imageftbbox imagefttext imagegammacorrect imagegd2 imagegd imagegif imagegrabscreen imagegrabwindow imageinterlace imageistruecolor imagejpeg imagelayereffect imageline imageloadfont imagepalettecopy imagepng imagepolygon imagepsbbox imagepsencodefont imagepsextendfont imagepsfreefont imagepsloadfont imagepsslantfont imagepstext imagerectangle imagerotate imagesavealpha imagesetbrush imagesetpixel imagesetstyle imagesetthickness imagesettile imagestring imagestringup imagesx imagesy imagetruecolortopalette imagettfbbox imagettftext imagetypes imagewbmp imagexbm iptcembed iptcparse jpeg2wbmp png2wbmp |