PEAR Handbuch
ZurückNach vorne

imagick_read

imagick_read -- Reads an image

Description

boolean imagick_read (resource imagick_handle, mixed filename)

Warnung

Diese Funktion ist EXPERIMENTELL. Das bedeutet, dass sich das Verhalten der Funktion, ihr Name, und ALLES andere, das hier dokumentiert ist, in zukünftigen Versions des Pakets OHNE WARNUNG ändern kann. Seien Sie gewarnt und nutzen Sie das Paket auf eigenes Risiko.

Returns: TRUE on success, FALSE on error.

The filename parameter can be either a filename on your local filesystem or a URL (e.g. http://my.server.com/picture.gif) or an array containing more than one string with filenames for multiple image support. The imageformat should be recognized automatically by imagick. If imagick_read() does not recognize the imageformat, you can prefix the filename with the image format abbreviation plus a : (e.g. GIF:mygif.gif). Following imageformats are supported with ImageMagick 5.4.0.

Tabelle 1. Supported image formats by ImageMagick

Image TypeRead/Write SupportDescription
8BIM*rw-Photoshop resource format
AFM*r--TrueType font
APP1*rw-Photoshop resource format
ART*r--PF1: 1st Publisher
AVI*r--Audio/Visual Interleaved
AVS*rw+AVS X image
BIE*rw-Joint Bi-level Image experts Group interchange format
BMP*rw+Microsoft Windows bitmap image
CMYK*rw+Raw cyan, magenta, yellow, and black bytes
CMYKA*rw+Raw cyan, magenta, yellow, black, and matte bytes
CUT*r--DR Hallo
DCM*r--Digital Imaging and Communications in Medicine image
DCX*rw+ZSoft IBM PC multi-page Paintbrush
DIB*rw+Microsoft Windows bitmap image
DPX*rw+Digital Moving Picture Exchange
EPDF*rw-Encapsulated Portable Document Format
EPI*rw-Adobe Encapsulated PostScript Interchange format
EPS*rw-Adobe Encapsulated PostScript
EPS2*-w-Adobe Level II Encapsulated PostScript
EPS3*-w+Adobe Level III Encapsulated PostScript
EPSF*rw-Adobe Encapsulated PostScript
EPSI*rw-Adobe Encapsulated PostScript Interchange format
EPT*rw-Adobe Encapsulated PostScript with TIFF preview
FAX*rw+Group 3 FAX
FILE*r--Uniform Resource Locator
FITS*rw-Flexible Image Transport System
FPX*rw-FlashPix Format
FTP*r--Uniform Resource Locator
G3*rw-Group 3 FAX
GIF*rw+CompuServe graphics interchange format
GIF87*rw-CompuServe graphics interchange format (version 87a)
GRADIENT*r--Gradual passing from one shade to another
GRANITE*r--Granite texture
GRAY*rw+Raw gray bytes
H*rw-Internal format
HDFrw+Hierarchical Data Format
HISTOGRAM*-w-Histogram of the image
HTM*-w-Hypertext Markup Language and a client-side image map
HTML*-w-Hypertext Markup Language and a client-side image map
HTTP*r--Uniform Resource Locator
ICB*rw+Truevision Targa image
ICM*rw-ICC Color Profile
ICO*r--Microsoft icon
ICON*r--Microsoft icon
IPTC*rw-IPTC Newsphoto
JBG*rw+Joint Bi-level Image experts Group interchange format
JBIG*rw+Joint Bi-level Image experts Group interchange format
JP2*rw-JPEG-2000 JP2 File Format Syntax
JPC*rw-JPEG-2000 Code Stream Syntax
JPEG*rw-Joint Photographic Experts Group JFIF format
JPG*rw-Joint Photographic Experts Group JFIF format
LABEL*r--Text image format
LOGO*rw-ImageMagick Logo
M2V*rw+MPEG Video Stream
MAP*rw-Colormap intensities and indices
MAT*r--MATLAB image format
MATTE*-w+MATTE format
MIFF*rw+Magick image format
MNG*rw+Multiple-image Network Graphics
MONO*rw-Bi-level bitmap in least-significant-byte first order
MPCrw-Magick Persistent Cache image format
MPEG*rw+MPEG Video Stream
MPG*rw+MPEG Video Stream
MTV*rw+MTV Raytracing image format
MVG*rw-Magick Vector Graphics
NETSCAPE*r--Netscape 216 color cube
NULL*r--Constant image of uniform color
OTB*rw-On-the-air bitmap
P7*rw+Xv thumbnail format
PAL*rw-16bit/pixel interleaved YUV
PBM*rw+Portable bitmap format (black and white)
PCD*rw-Photo CD
PCDS*rw-Photo CD
PCL*-w-Page Control Language
PCT*rw-Apple Macintosh QuickDraw/PICT
PCX*rw-ZSoft IBM PC Paintbrush
PDB*r--Pilot Image Format
PDF*rw+Portable Document Format
PFB*r--TrueType font
PFM*r--TrueType font
PGM*rw+Portable graymap format (gray scale)
PICON*rw-Personal Icon
PICT*rw-Apple Macintosh QuickDraw/PICT
PIX*r--Alias/Wavefront RLE image format
PLASMA*r--Plasma fractal image
PM*rw-X Windows system pixmap (color)
PNG*rw-Portable Network Graphics
PNM*rw+Portable anymap
PPM*rw+Portable pixmap format (color)
PREVIEW*-w-Show a preview an image enhancement, effect, or f/x
PS*rw+Adobe PostScript
PS2*-w+Adobe Level II PostScript
PS3*-w+Adobe Level III PostScript
PSD*rw-Adobe Photoshop bitmap
PTIF*rw-Pyramid encoded TIFF
PWP*r--Seattle Film Works
RAS*rw+SUN Rasterfile
RGB*rw+Raw red, green, and blue bytes
RGBA*rw+Raw red, green, blue, and matte bytes
RLA*r--Alias/Wavefront image
RLE*r--Utah Run length encoded image
SCT*r--Scitex HandShake
SGI*rw+Irix RGB image
SHTML*-w-Hypertext Markup Language and a client-side image map
STEGANO*r--Steganographic image
SUN*rw+SUN Rasterfile
SVG*rw+Scalable Vector Gaphics
TEXT*rw+Raw text
TGA*rw+Truevision Targa image
TIF*rw+Tagged Image File Format
TIFF*rw+Tagged Image File Format
TILE*r--Tile image with a texture
TIM*r--PSX TIM
TTF*r--TrueType font
TXT*rw+Raw text
UIL*-w-X-Motif UIL table
UYVY*rw-16bit/pixel interleaved YUV
VDA*rw+Truevision Targa image
VICAR*rw-VICAR rasterfile format
VID*rw+Visual Image Directory
VIFF*rw+Khoros Visualization image
VST*rw+Truevision Targa image
WBMP*rw-Wireless Bitmap (level 0) image
WMFr--Windows Meta File
WPG*r--Word Perfect Graphics
X*rw-X Image
XBM*rw-X Windows system bitmap (black and white)
XC*r--Constant image uniform color
XML*r--Scalable Vector Gaphics
XPM*rw-X Windows system pixmap (color)
XV*rw+Khoros Visualization image
XWD*rw-X Windows system window dump (color)
YUV*rw-CCIR 601 4:1:1

Anmerkung: r = read, w = write, * = native blob support

On some platforms, ImageMagick automatically processes these extensions: .gz for Zip compression, .Z for Unix compression, .bz2 for block compression, and .pgp for PGP encryption. For example, a PNM image called image.pnm.gz is automatically uncompressed with the gzip program and the image is subsequently read.

Beispiel 1. imagick_read() example

<?php
$handle = imagick_create();
    or die ("Could not connect");
imagick_read($handle,"mypic.gif");
imagick_write($handle,"mypic.png");
imagick_free($handle);
?>

Beispiel 2. imagick_read() example with multiple images

<?php
$handle = imagick_create();
    or die ("Could not connect");
imagick_read($handle,array("mypic.gif","http://my.server.com/mypic.png"));
imagick_write($handle,"PNG:mypic.myext");
imagick_free($handle);
?>

See also: imagick_write(), imagick_convert().

ZurückZum AnfangNach vorne
imagick_createNach obenimagick_write