Imagick::morphology

(PECL imagick 3 >= 3.3.0)

Imagick::morphologyDescription

説明

public Imagick::morphology(
    int $morphologyMethod,
    int $iterations,
    ImagickKernel $ImagickKernel,
    int $channel = Imagick::CHANNEL_DEFAULT
): bool

Applies a user supplied kernel to the image according to the given morphology method.

パラメータ

morphologyMethod

Which morphology method to use one of the \Imagick::MORPHOLOGY_* constants.

iterations

The number of iteration to apply the morphology function. A value of -1 means loop until no change found. How this is applied may depend on the morphology method. Typically this is a value of 1.

ImagickKernel

channel

戻り値

成功した場合に true を返します。

例1 Convolve Imagick::morphology()

<?php
        $imagick 
$this->getCharacter();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_GAUSSIAN"5,1");
        
$imagick->morphology(\Imagick::MORPHOLOGY_CONVOLVE2$kernel);
        
header("Content-Type: image/png");
        echo 
$imagick->getImageBlob();

?>

例2 Correlate Imagick::morphology()

<?php

        
// Top-left pixel must be black
        // Bottom right pixel must be white
        // We don't care about the rest.
        

        
$imagick $this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromMatrix(self::$correlateMatrix, [22]);
        
$imagick->morphology(\Imagick::MORPHOLOGY_CORRELATE1$kernel);
        
header("Content-Type: image/png");
        echo 
$imagick->getImageBlob();

?>

例3 Erode Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_OCTAGON"3");
        
$canvas->morphology(\Imagick::MORPHOLOGY_ERODE2$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例4 Erode Intensity Imagick::morphology()

<?php
        $canvas 
$this->getCharacter();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_OCTAGON"1");
        
$canvas->morphology(\Imagick::MORPHOLOGY_ERODE_INTENSITY2$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例5 Dilate Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_OCTAGON"3");
        
$canvas->morphology(\Imagick::MORPHOLOGY_DILATE4$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例6 Dilate intensity Imagick::morphology()

<?php
        $canvas 
$this->getCharacter();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_OCTAGON"1");
        
$canvas->morphology(\Imagick::MORPHOLOGY_DILATE_INTENSITY4$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例7 Distance with Chebyshev kernel Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_CHEBYSHEV"3");
        
$canvas->morphology(\Imagick::MORPHOLOGY_DISTANCE3$kernel);
        
$canvas->autoLevelImage();
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例8 Distance with Manhattan kernel Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_MANHATTAN"5");
        
$canvas->morphology(\Imagick::MORPHOLOGY_DISTANCE3$kernel);
        
$canvas->autoLevelImage();
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例9 Distance with ocatagonal kernel Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_OCTAGONAL"5");
        
$canvas->morphology(\Imagick::MORPHOLOGY_DISTANCE3$kernel);
        
$canvas->autoLevelImage();
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例10 Distance with Euclidean kernel Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_EUCLIDEAN"4");
        
$canvas->morphology(\Imagick::MORPHOLOGY_DISTANCE3$kernel);
        
$canvas->autoLevelImage();
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例11 Edge Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_OCTAGON"3");
        
$canvas->morphology(\Imagick::MORPHOLOGY_EDGE1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例12 Open Imagick::morphology()

<?php
        
// As a result you will see that 'Open' smoothed the outline, by rounding off any sharp points, and remove any parts that is smaller than the shape used. It will also disconnect or 'open' any thin bridges.
        
$canvas $this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_DISK"6");
        
$canvas->morphology(\Imagick::MORPHOLOGY_OPEN1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例13 Open intensity Imagick::morphology()

<?php
        
// As a result you will see that 'Open' smoothed the outline, by rounding off any sharp points, and remove any parts that is smaller than the shape used. It will also disconnect or 'open' any thin bridges.

        
$canvas $this->getCharacter();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_DISK"6");
        
$canvas->morphology(\Imagick::MORPHOLOGY_OPEN_INTENSITY1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例14 Close Imagick::morphology()

<?php
        
//The basic use of the 'Close' method is to reduce or remove any 'holes' or 'gaps' about the size of the kernel 'Structure Element'. That is 'close' parts of the background that are about that size.
        
$canvas $this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_DISK"6");
        
$canvas->morphology(\Imagick::MORPHOLOGY_CLOSE1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例15 Close Intensity Imagick::morphology()

<?php
        
//The basic use of the 'Close' method is to reduce or remove any 'holes' or 'gaps' about the size of the kernel 'Structure Element'. That is 'close' parts of the background that are about that size.
        
$canvas $this->getCharacter();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_DISK"6");
        
$canvas->morphology(\Imagick::MORPHOLOGY_CLOSE_INTENSITY1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例16 Smooth Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_OCTAGON"3");
        
$canvas->morphology(\Imagick::MORPHOLOGY_SMOOTH1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例17 Edge in Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_OCTAGON"3");
        
$canvas->morphology(\Imagick::MORPHOLOGY_EDGE_IN1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例18 Edge out Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_OCTAGON"3");
        
$canvas->morphology(\Imagick::MORPHOLOGY_EDGE_OUT1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例19 The 'TopHat' method, or more specifically 'White Top Hat', returns the pixels that were removed by a Opening of the shape, that is the pixels that were removed to round off the points, and the connecting bridged between shapes. Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_DISK"5");
        
$canvas->morphology(\Imagick::MORPHOLOGY_TOP_HAT1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例20 The 'BottomHat' method, also known as 'Black TopHat' is the pixels that a Closing of the shape adds to the image. That is the pixels that were used to fill in the 'holes', 'gaps', and 'bridges'. Imagick::morphology()

<?php

        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_DISK"5");
        
$canvas->morphology(\Imagick::MORPHOLOGY_BOTTOM_HAT1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例21 Hit and Miss Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
//This finds all the pixels with 3 pixels of the right edge
        
$matrix = [[1falsefalse0]];
        
$kernel = \ImagickKernel::fromMatrix(
            
$matrix,
            [
00]
        );
        
$canvas->morphology(\Imagick::MORPHOLOGY_HIT_AND_MISS1$kernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例22 Thinning Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$leftEdgeKernel = \ImagickKernel::fromMatrix([[01]], [10]);
        
$rightEdgeKernel = \ImagickKernel::fromMatrix([[10]], [00]);
        
$leftEdgeKernel->addKernel($rightEdgeKernel);
        
        
$canvas->morphology(\Imagick::MORPHOLOGY_THINNING3$leftEdgeKernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例23 Thicken Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$leftEdgeKernel = \ImagickKernel::fromMatrix([[01]], [10]);
        
$rightEdgeKernel = \ImagickKernel::fromMatrix([[10]], [00]);
        
$leftEdgeKernel->addKernel($rightEdgeKernel);

        
$canvas->morphology(\Imagick::MORPHOLOGY_THICKEN3$leftEdgeKernel);
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例24 Thick to generate a convex hull Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$diamondKernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_DIAMOND"1");
        
$convexKernel =  \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_CONVEX_HULL"");

        
// The thicken morphology doesn't handle small gaps. We close them
        // with the close morphology.
        
$canvas->morphology(\Imagick::MORPHOLOGY_CLOSE1$diamondKernel);
        
$canvas->morphology(\Imagick::MORPHOLOGY_THICKEN, -1$convexKernel);
        
$canvas->morphology(\Imagick::MORPHOLOGY_CLOSE1$diamondKernel);

        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例25 Iterative morphology Imagick::morphology()

<?php
        $canvas 
$this->getCharacterOutline();
        
$kernel = \ImagickKernel::fromBuiltIn(\Imagick::KERNEL_DISK"2");        
        
$canvas->morphology(\Imagick::MORPHOLOGY_ITERATIVE3$kernel);
        
$canvas->autoLevelImage();
        
header("Content-Type: image/png");
        echo 
$canvas->getImageBlob();

?>

例26 Helper function to get an image silhouette Imagick::morphology()

<?php
function getCharacterOutline() {
    
$imagick = new \Imagick(realpath("./images/character.png"));
    
$character = new \Imagick();
    
$character->newPseudoImage(
        
$imagick->getImageWidth(),
        
$imagick->getImageHeight(),
        
"canvas:white"
    
);
    
$canvas = new \Imagick();
    
$canvas->newPseudoImage(
        
$imagick->getImageWidth(),
        
$imagick->getImageHeight(),
        
"canvas:black"
    
);

    
$character->compositeimage(
        
$imagick,
        \
Imagick::COMPOSITE_COPYOPACITY,
        
00
    
);
    
$canvas->compositeimage(
        
$character,
        \
Imagick::COMPOSITE_ATOP,
        
00
    
);
    
$canvas->setFormat('png');

    return 
$canvas;
}
?>

関連キーワード:  morphology, Imagick, Description, pixels, were, int, ImagickKernel, function, removed, TopHat