Класс Imagick
(PECL imagick 2.0.0)
Обзор классов
$radius
, float $sigma
[, int $channel
= Imagick::CHANNEL_DEFAULT
] )$radius
, float $sigma
[, int $channel
= Imagick::CHANNEL_DEFAULT
] )$draw_settings
, float $x
, float $y
, float $angle
, string $text
)$composite_object
, int $composite
, int $x
, int $y
[, int $channel
= Imagick::CHANNEL_ALL
] )$files
)$black_point
, float $white_point
[, int $channel
= Imagick::CHANNEL_ALL
] )$x
, int $y
, int $width
, int $height
, string $map
, int $STORAGE
)$fill
, float $fuzz
, mixed $target
, int $x
, int $y
, bool $invert
[, int $channel
= Imagick::CHANNEL_DEFAULT
] )$matte_color
, int $width
, int $height
, int $inner_bevel
, int $outer_bevel
)$function
, array $arguments
[, int $channel
= Imagick::CHANNEL_DEFAULT
] )$reference
, int $metric
[, int $channel
= Imagick::CHANNEL_DEFAULT
] )$x
, int $y
, int $width
, int $height
, string $map
, int $storage
, array $pixels
)$blackPoint
, float $gamma
, float $whitePoint
[, int $channel
= Imagick::CHANNEL_ALL
] )$draw
, string $tile_geometry
, string $thumbnail_geometry
, int $mode
, string $frame
)$radius
, float $sigma
, float $angle
[, int $channel
= Imagick::CHANNEL_DEFAULT
] )$target
, mixed $fill
, float $fuzz
, bool $invert
[, int $channel
= Imagick::CHANNEL_DEFAULT
] )$fill
, float $fuzz
, mixed $bordercolor
, int $x
, int $y
[, int $channel
= Imagick::CHANNEL_ALL
] )$target
, mixed $fill
, float $fuzz
[, int $channel
= Imagick::CHANNEL_ALL
] )$numberColors
, int $colorspace
, int $treedepth
, bool $dither
, bool $measureError
)$numberColors
, int $colorspace
, int $treedepth
, bool $dither
, bool $measureError
)$columns
, int $rows
, int $filter
, float $blur
[, bool $bestfit
= false
] )$x_rounding
, float $y_rounding
[, float $stroke_width
= 10
[, float $displace
= 5
[, float $size_correction
= -6
]]] )$COLORSPACE
, float $cluster_threshold
, float $smooth_threshold
[, bool $verbose
= false
] )$sharpen
, float $alpha
, float $beta
[, int $channel
= Imagick::CHANNEL_ALL
] )$SPARSE_METHOD
, array $arguments
[, int $channel
= Imagick::CHANNEL_DEFAULT
] )$radius
, float $sigma
, float $amount
, float $threshold
[, int $channel
= Imagick::CHANNEL_ALL
] )Методы изображения и глобальные методы
Класс Imagick имеет возможность удерживать и обрабатывать несколько изображений одновременно. Это достигается за счет внутреннего стека, в котором существует указатель, указывающий на текущее изображение. Некоторые функции работают со всеми изображениями в классе Imagick, но всё-таки, большинство работает только с текущим изображением во внутреннем стеке. По соглашению, имена методов могут содержать слово Image для обозначения того, что они влияют только на текущее изображение в стеке.
Методы класса
Здесь приведён список наиболее используемых методов, объединённых в группы по назначению:
Содержание
- Imagick::adaptiveBlurImage — Добавляет адаптивный фильтр размытия к изображению
- Imagick::adaptiveResizeImage — Адаптивное изменение размера изображения с данными триангуляции
- Imagick::adaptiveSharpenImage — Адаптивное изменение резкости изображения
- Imagick::adaptiveThresholdImage — Выбор порога для каждого пикселя в зависимости от диапазона интенсивности
- Imagick::addImage — Добавляет новое изображение к списку изображений объекта Imagick
- Imagick::addNoiseImage — Накладывает случайный шум на изображение
- Imagick::affineTransformImage — Преобразование изображения
- Imagick::animateImages — Анимация одного или нескольких изображений
- Imagick::annotateImage — Добавляет текстовый комментарий на изображение
- Imagick::appendImages — Объединяет набор изображений
- Imagick::averageImages — Усредняет набор изображений
- Imagick::blackThresholdImage — Перевести все пиксели ниже порогового значения в черный цвет
- Imagick::blurImage — Добавляет фильтр размытия к изображению
- Imagick::borderImage — Окружает изображение рамкой
- Imagick::charcoalImage — Рисование углем
- Imagick::chopImage — Удаляет область изображения и обрезает его
- Imagick::clear — Очищает все ресурсы, связанные с объектом Imagick
- Imagick::clipImage — Обрезка вдоль ближайшего контура с профилем 8BIM
- Imagick::clipPathImage — Отсечь вдоль обозначенного контура с профилем 8BIM
- Imagick::clone — Создает точную копию объекта Imagick
- Imagick::clutImage — Заменяет цвета в изображении
- Imagick::coalesceImages — Composites a set of images
- Imagick::colorFloodfillImage — Changes the color value of any pixel that matches target
- Imagick::colorizeImage — Смешивание цвета заливки с изображением
- Imagick::combineImages — Combines one or more images into a single image
- Imagick::commentImage — Adds a comment to your image
- Imagick::compareImageChannels — Returns the difference in one or more images
- Imagick::compareImageLayers — Returns the maximum bounding region between images
- Imagick::compareImages — Compares an image to a reconstructed image
- Imagick::compositeImage — Composite one image onto another
- Imagick::__construct — Конструктор объекта Imagick
- Imagick::contrastImage — Change the contrast of the image
- Imagick::contrastStretchImage — Enhances the contrast of a color image
- Imagick::convolveImage — Applies a custom convolution kernel to the image
- Imagick::cropImage — Извлекает область изображения
- Imagick::cropThumbnailImage — Creates a crop thumbnail
- Imagick::current — Возвращает ссылку на текущий объект Imagick
- Imagick::cycleColormapImage — Displaces an image's colormap
- Imagick::decipherImage — Deciphers an image
- Imagick::deconstructImages — Returns certain pixel differences between images
- Imagick::deleteImageArtifact — Delete image artifact
- Imagick::deskewImage — Removes skew from the image
- Imagick::despeckleImage — Reduces the speckle noise in an image
- Imagick::destroy — Удаляет объект Imagick
- Imagick::displayImage — Выводит изображение
- Imagick::displayImages — Выводит изображение или последовательность изображений
- Imagick::distortImage — Distorts an image using various distortion methods
- Imagick::drawImage — Выполняет рендеринг объекта ImagickDraw на текущем изображении
- Imagick::edgeImage — Enhance edges within the image
- Imagick::embossImage — Returns a grayscale image with a three-dimensional effect
- Imagick::encipherImage — Enciphers an image
- Imagick::enhanceImage — Improves the quality of a noisy image
- Imagick::equalizeImage — Equalizes the image histogram
- Imagick::evaluateImage — Applies an expression to an image
- Imagick::exportImagePixels — Exports raw image pixels
- Imagick::extentImage — Set image size
- Imagick::flattenImages — Merges a sequence of images
- Imagick::flipImage — Создает вертикальное зеркало изображения
- Imagick::floodFillPaintImage — Changes the color value of any pixel that matches target
- Imagick::flopImage — Создает горизонтальное зеркало изображения
- Imagick::frameImage — Adds a simulated three-dimensional border
- Imagick::functionImage — Applies a function on the image
- Imagick::fxImage — Evaluate expression for each pixel in the image
- Imagick::gammaImage — Gamma-corrects an image
- Imagick::gaussianBlurImage — Blurs an image
- Imagick::getColorspace — Возвращает цветовую палитру
- Imagick::getCompression — Возвращает тип сжатия объекта
- Imagick::getCompressionQuality — Возвращает качество сжатия объекта
- Imagick::getCopyright — Возвращает копирайт API ImageMagick в виде строки
- Imagick::getFilename — Имя файла результирующего изображения
- Imagick::getFont — Возвращает название шрифта
- Imagick::getFormat — Возвращает формат Imagick объекта
- Imagick::getGravity — Возвращает значение гравитации (притяжения)
- Imagick::getHomeURL — Возвращает домашний URL библиотеки ImageMagick
- Imagick::getImage — Возвращает новый объект Imagick
- Imagick::getImageAlphaChannel — Возвращает альфа-канал изображения
- Imagick::getImageArtifact — Get image artifact
- Imagick::getImageBackgroundColor — Возвращает цвет фона изображения
- Imagick::getImageBlob — Returns the image sequence as a blob
- Imagick::getImageBluePrimary — Returns the chromaticy blue primary point
- Imagick::getImageBorderColor — Возвращает цвет рамки изображения
- Imagick::getImageChannelDepth — Gets the depth for a particular image channel
- Imagick::getImageChannelDistortion — Compares image channels of an image to a reconstructed image
- Imagick::getImageChannelDistortions — Gets channel distortions
- Imagick::getImageChannelExtrema — Gets the extrema for one or more image channels
- Imagick::getImageChannelKurtosis — The getImageChannelKurtosis purpose
- Imagick::getImageChannelMean — Gets the mean and standard deviation
- Imagick::getImageChannelRange — Gets channel range
- Imagick::getImageChannelStatistics — Returns statistics for each channel in the image
- Imagick::getImageClipMask — Gets image clip mask
- Imagick::getImageColormapColor — Returns the color of the specified colormap index
- Imagick::getImageColors — Возвращает число уникальных цветов в изображении
- Imagick::getImageColorspace — Возвращает цветовую палитру изображения
- Imagick::getImageCompose — Возвращает составной оператор, связанный с изображением
- Imagick::getImageCompression — Возвращает текущий тип компрессии изображения
- Imagick::getImageCompressionQuality — Возвращает текущее качество сжатия изображения
- Imagick::getImageDelay — Gets the image delay
- Imagick::getImageDepth — Gets the image depth
- Imagick::getImageDispose — Gets the image disposal method
- Imagick::getImageDistortion — Compares an image to a reconstructed image
- Imagick::getImageExtrema — Gets the extrema for the image
- Imagick::getImageFilename — Возвращает имя файла конкретного изображения в последовательности
- Imagick::getImageFormat — Возвращает формат конкретного изображения в последовательности
- Imagick::getImageGamma — Возвращает гамму изображения
- Imagick::getImageGeometry — Возвращает ширину и высоту в виде ассоциативного массива
- Imagick::getImageGravity — Возвращает значение гравитации (притяжения)
- Imagick::getImageGreenPrimary — Returns the chromaticy green primary point
- Imagick::getImageHeight — Возвращает высоту изображения
- Imagick::getImageHistogram — Gets the image histogram
- Imagick::getImageIndex — Gets the index of the current active image
- Imagick::getImageInterlaceScheme — Gets the image interlace scheme
- Imagick::getImageInterpolateMethod — Returns the interpolation method
- Imagick::getImageIterations — Gets the image iterations
- Imagick::getImageLength — Returns the image length in bytes
- Imagick::getImageMagickLicense — Returns a string containing the ImageMagick license
- Imagick::getImageMatte — Return if the image has a matte channel
- Imagick::getImageMatteColor — Returns the image matte color
- Imagick::getImageOrientation — Gets the image orientation
- Imagick::getImagePage — Returns the page geometry
- Imagick::getImagePixelColor — Returns the color of the specified pixel
- Imagick::getImageProfile — Returns the named image profile
- Imagick::getImageProfiles — Returns the image profiles
- Imagick::getImageProperties — Returns the image properties
- Imagick::getImageProperty — Returns the named image property
- Imagick::getImageRedPrimary — Returns the chromaticity red primary point
- Imagick::getImageRegion — Extracts a region of the image
- Imagick::getImageRenderingIntent — Gets the image rendering intent
- Imagick::getImageResolution — Gets the image X and Y resolution
- Imagick::getImagesBlob — Returns all image sequences as a blob
- Imagick::getImageScene — Gets the image scene
- Imagick::getImageSignature — Generates an SHA-256 message digest
- Imagick::getImageSize — Возвращает размер (длину) изображения в байтах
- Imagick::getImageTicksPerSecond — Gets the image ticks-per-second
- Imagick::getImageTotalInkDensity — Gets the image total ink density
- Imagick::getImageType — Возвращает возможный тип изображения
- Imagick::getImageUnits — Gets the image units of resolution
- Imagick::getImageVirtualPixelMethod — Returns the virtual pixel method
- Imagick::getImageWhitePoint — Returns the chromaticity white point
- Imagick::getImageWidth — Возвращает ширину изображения
- Imagick::getInterlaceScheme — Gets the object interlace scheme
- Imagick::getIteratorIndex — Gets the index of the current active image
- Imagick::getNumberImages — Returns the number of images in the object
- Imagick::getOption — Returns a value associated with the specified key
- Imagick::getPackageName — Returns the ImageMagick package name
- Imagick::getPage — Returns the page geometry
- Imagick::getPixelIterator — Returns a MagickPixelIterator
- Imagick::getPixelRegionIterator — Возвращает объект ImagickPixelIterator для секции изображения
- Imagick::getPointSize — Возвращает размер точки
- Imagick::getQuantumDepth — Возвращает величину глубины
- Imagick::getQuantumRange — Возвращает величину диапазона объекта Imagick
- Imagick::getReleaseDate — Возвращает дату релиза ImageMagick
- Imagick::getResource — Возвращает размер используемой памяти указанного ресурса
- Imagick::getResourceLimit — Возвращает заданный лимит ресурсов
- Imagick::getSamplingFactors — Возвращает горизонтальный и вертикальный фактор выборки
- Imagick::getSize — Возвращает размер, связанный с объектом Imagick
- Imagick::getSizeOffset — Возвращает размер смещения
- Imagick::getVersion — Возвращает версию API ImageMagick
- Imagick::haldClutImage — Replaces colors in the image
- Imagick::hasNextImage — Checks if the object has more images
- Imagick::hasPreviousImage — Checks if the object has a previous image
- Imagick::identifyImage — Identifies an image and fetches attributes
- Imagick::implodeImage — Creates a new image as a copy
- Imagick::importImagePixels — Imports image pixels
- Imagick::labelImage — Adds a label to an image
- Imagick::levelImage — Adjusts the levels of an image
- Imagick::linearStretchImage — Stretches with saturation the image intensity
- Imagick::liquidRescaleImage — Animates an image or images
- Imagick::magnifyImage — Scales an image proportionally 2x
- Imagick::mapImage — Replaces the colors of an image with the closest color from a reference image.
- Imagick::matteFloodfillImage — Changes the transparency value of a color
- Imagick::medianFilterImage — Applies a digital filter
- Imagick::mergeImageLayers — Merges image layers
- Imagick::minifyImage — Scales an image proportionally to half its size
- Imagick::modulateImage — Control the brightness, saturation, and hue
- Imagick::montageImage — Creates a composite image
- Imagick::morphImages — Method morphs a set of images
- Imagick::mosaicImages — Forms a mosaic from images
- Imagick::motionBlurImage — Simulates motion blur
- Imagick::negateImage — Negates the colors in the reference image
- Imagick::newImage — Creates a new image
- Imagick::newPseudoImage — Creates a new image
- Imagick::nextImage — Moves to the next image
- Imagick::normalizeImage — Enhances the contrast of a color image
- Imagick::oilPaintImage — Simulates an oil painting
- Imagick::opaquePaintImage — Changes the color value of any pixel that matches target
- Imagick::optimizeImageLayers — Removes repeated portions of images to optimize
- Imagick::orderedPosterizeImage — Performs an ordered dither
- Imagick::paintFloodfillImage — Changes the color value of any pixel that matches target
- Imagick::paintOpaqueImage — Change any pixel that matches color
- Imagick::paintTransparentImage — Changes any pixel that matches color with the color defined by fill
- Imagick::pingImage — Fetch basic attributes about the image
- Imagick::pingImageBlob — Quickly fetch attributes
- Imagick::pingImageFile — Get basic image attributes in a lightweight manner
- Imagick::polaroidImage — Simulates a Polaroid picture
- Imagick::posterizeImage — Reduces the image to a limited number of color level
- Imagick::previewImages — Quickly pin-point appropriate parameters for image processing
- Imagick::previousImage — Move to the previous image in the object
- Imagick::profileImage — Adds or removes a profile from an image
- Imagick::quantizeImage — Analyzes the colors within a reference image
- Imagick::quantizeImages — Analyzes the colors within a sequence of images
- Imagick::queryFontMetrics — Returns an array representing the font metrics
- Imagick::queryFonts — Returns the configured fonts
- Imagick::queryFormats — Returns formats supported by Imagick
- Imagick::radialBlurImage — Radial blurs an image
- Imagick::raiseImage — Creates a simulated 3d button-like effect
- Imagick::randomThresholdImage — Creates a high-contrast, two-color image
- Imagick::readImage — Reads image from filename
- Imagick::readImageBlob — Reads image from a binary string
- Imagick::readImageFile — Reads image from open filehandle
- Imagick::recolorImage — Recolors image
- Imagick::reduceNoiseImage — Smooths the contours of an image
- Imagick::remapImage — Remaps image colors
- Imagick::removeImage — Removes an image from the image list
- Imagick::removeImageProfile — Removes the named image profile and returns it
- Imagick::render — Renders all preceding drawing commands
- Imagick::resampleImage — Resample image to desired resolution
- Imagick::resetImagePage — Reset image page
- Imagick::resizeImage — Scales an image
- Imagick::rollImage — Offsets an image
- Imagick::rotateImage — Rotates an image
- Imagick::roundCorners — Rounds image corners
- Imagick::sampleImage — Scales an image with pixel sampling
- Imagick::scaleImage — Scales the size of an image
- Imagick::segmentImage — Segments an image
- Imagick::separateImageChannel — Separates a channel from the image
- Imagick::sepiaToneImage — Sepia tones an image
- Imagick::setBackgroundColor — Sets the object's default background color
- Imagick::setColorspace — Set colorspace
- Imagick::setCompression — Sets the object's default compression type
- Imagick::setCompressionQuality — Sets the object's default compression quality
- Imagick::setFilename — Sets the filename before you read or write the image
- Imagick::setFirstIterator — Sets the Imagick iterator to the first image
- Imagick::setFont — Sets font
- Imagick::setFormat — Sets the format of the Imagick object
- Imagick::setGravity — Sets the gravity
- Imagick::setImage — Replaces image in the object
- Imagick::setImageAlphaChannel — Sets image alpha channel
- Imagick::setImageArtifact — Set image artifact
- Imagick::setImageBackgroundColor — Sets the image background color
- Imagick::setImageBias — Sets the image bias for any method that convolves an image
- Imagick::setImageBluePrimary — Sets the image chromaticity blue primary point
- Imagick::setImageBorderColor — Sets the image border color
- Imagick::setImageChannelDepth — Sets the depth of a particular image channel
- Imagick::setImageClipMask — Sets image clip mask
- Imagick::setImageColormapColor — Sets the color of the specified colormap index
- Imagick::setImageColorspace — Sets the image colorspace
- Imagick::setImageCompose — Sets the image composite operator
- Imagick::setImageCompression — Sets the image compression
- Imagick::setImageCompressionQuality — Sets the image compression quality
- Imagick::setImageDelay — Sets the image delay
- Imagick::setImageDepth — Sets the image depth
- Imagick::setImageDispose — Sets the image disposal method
- Imagick::setImageExtent — Sets the image size
- Imagick::setImageFilename — Sets the filename of a particular image
- Imagick::setImageFormat — Sets the format of a particular image
- Imagick::setImageGamma — Sets the image gamma
- Imagick::setImageGravity — Sets the image gravity
- Imagick::setImageGreenPrimary — Sets the image chromaticity green primary point
- Imagick::setImageIndex — Set the iterator position
- Imagick::setImageInterlaceScheme — Sets the image compression
- Imagick::setImageInterpolateMethod — Sets the image interpolate pixel method
- Imagick::setImageIterations — Sets the image iterations
- Imagick::setImageMatte — Sets the image matte channel
- Imagick::setImageMatteColor — Sets the image matte color
- Imagick::setImageOpacity — Sets the image opacity level
- Imagick::setImageOrientation — Sets the image orientation
- Imagick::setImagePage — Sets the page geometry of the image
- Imagick::setImageProfile — Adds a named profile to the Imagick object
- Imagick::setImageProperty — Sets an image property
- Imagick::setImageRedPrimary — Sets the image chromaticity red primary point
- Imagick::setImageRenderingIntent — Sets the image rendering intent
- Imagick::setImageResolution — Sets the image resolution
- Imagick::setImageScene — Sets the image scene
- Imagick::setImageTicksPerSecond — Sets the image ticks-per-second
- Imagick::setImageType — Sets the image type
- Imagick::setImageUnits — Sets the image units of resolution
- Imagick::setImageVirtualPixelMethod — Sets the image virtual pixel method
- Imagick::setImageWhitePoint — Sets the image chromaticity white point
- Imagick::setInterlaceScheme — Sets the image compression
- Imagick::setIteratorIndex — Set the iterator position
- Imagick::setLastIterator — Sets the Imagick iterator to the last image
- Imagick::setOption — Set an option
- Imagick::setPage — Sets the page geometry of the Imagick object
- Imagick::setPointSize — Sets point size
- Imagick::setResolution — Sets the image resolution
- Imagick::setResourceLimit — Sets the limit for a particular resource in megabytes
- Imagick::setSamplingFactors — Sets the image sampling factors
- Imagick::setSize — Sets the size of the Imagick object
- Imagick::setSizeOffset — Sets the size and offset of the Imagick object
- Imagick::setType — Sets the image type attribute
- Imagick::shadeImage — Creates a 3D effect
- Imagick::shadowImage — Simulates an image shadow
- Imagick::sharpenImage — Sharpens an image
- Imagick::shaveImage — Shaves pixels from the image edges
- Imagick::shearImage — Creating a parallelogram
- Imagick::sigmoidalContrastImage — Adjusts the contrast of an image
- Imagick::sketchImage — Simulates a pencil sketch
- Imagick::solarizeImage — Applies a solarizing effect to the image
- Imagick::sparseColorImage — Interpolates colors
- Imagick::spliceImage — Splices a solid color into the image
- Imagick::spreadImage — Randomly displaces each pixel in a block
- Imagick::steganoImage — Hides a digital watermark within the image
- Imagick::stereoImage — Composites two images
- Imagick::stripImage — Strips an image of all profiles and comments
- Imagick::swirlImage — Swirls the pixels about the center of the image
- Imagick::textureImage — Repeatedly tiles the texture image
- Imagick::thresholdImage — Изменяет отдельные пиксели на основе порогового значения
- Imagick::thumbnailImage — Changes the size of an image
- Imagick::tintImage — Applies a color vector to each pixel in the image
- Imagick::transformImage — Convenience method for setting crop size and the image geometry
- Imagick::transparentPaintImage — Paints pixels transparent
- Imagick::transposeImage — Creates a vertical mirror image
- Imagick::transverseImage — Creates a horizontal mirror image
- Imagick::trimImage — Remove edges from the image
- Imagick::uniqueImageColors — Discards all but one of any pixel color
- Imagick::unsharpMaskImage — Sharpens an image
- Imagick::valid — Checks if the current item is valid
- Imagick::vignetteImage — Adds vignette filter to the image
- Imagick::waveImage — Applies wave filter to the image
- Imagick::whiteThresholdImage — Force all pixels above the threshold into white
- Imagick::writeImage — Writes an image to the specified filename
- Imagick::writeImageFile — Writes an image to a filehandle
- Imagick::writeImages — Writes an image or image sequence
- Imagick::writeImagesFile — Writes frames to a filehandle
Коментарии
Users looking to save with these functions should know it can be done easily, for example
<?php
header ("Content-Type: image/{$Imagick->getImageFormat()}");
$data = $Imagick->getImageBlob ();
echo $data;
file_put_contents ('test.png', $data);
?>
That would display the image, and then save it to test.png. Such things are helpful especially when you need to reload images after creating them or save for later. :)
When using this library with PDFs, the term "image" applies to a page where the pointer begins at the last page of the document.
<?php
$document = new Imagick('myPdf.pdf'); //2 page PDF
$document->getNumberImages(); //returns 2
var_dump($document->hasNextImage()); //returns false - remember, we're on the last page
var_dump($document->hasPreviousImage()); //returns true
?>
If you need to do more than generate thumbnails from a PDF, use XPDF: http://www.foolabs.com/xpdf/home.html