php · lacatoire · Feb 27, 2026
diff --git a/reference/imagick/imagickkernel.xml b/reference/imagick/imagickkernel.xml
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: lacatoire Status: ready -->
+
+<reference xml:id="class.imagickkernel" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+
+ <title>ImagickKernel クラス</title>
+ <titleabbrev>ImagickKernel</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ ImagickKernel intro -->
+  <section xml:id="imagickkernel.intro">
+   &reftitle.intro;
+   <para>
+
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="imagickkernel.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>ImagickKernel</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>ImagickKernel</classname>
+     </ooclass>
+    </classsynopsisinfo>
+<!-- }}} -->
+
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.imagickkernel')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.imagick.entities.imagickkernel;
+
+</reference>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/imagick/imagickkernel/frombuiltin.xml b/reference/imagick/imagickkernel/frombuiltin.xml
@@ -0,0 +1,215 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 1ef9c7a76700b3e72844050d75e6ed1b870f9ca7 Maintainer: lacatoire Status: ready -->
+
+<refentry xml:id="imagickkernel.frombuiltin" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>ImagickKernel::fromBuiltIn</refname>
+  <refpurpose>組み込みカーネルからカーネルを作成する</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <modifier>static</modifier> <type>ImagickKernel</type><methodname>ImagickKernel::fromBuiltin</methodname>
+   <methodparam><type>int</type><parameter>kernelType</parameter></methodparam>
+   <methodparam><type>string</type><parameter>kernelString</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   組み込みカーネルからカーネルを作成します。例については
+   http://www.imagemagick.org/Usage/morphology/#kernel を参照してください。
+   現時点では 'rotation' シンボルはサポートされていません。例:
+   $diamondKernel = ImagickKernel::fromBuiltIn(\Imagick::KERNEL_DIAMOND, "2");
+  </para>
+
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>kerneltype</parameter></term>
+    <listitem>
+     <para>
+      作成するカーネルの種類。例: \Imagick::KERNEL_DIAMOND
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>kernelString</parameter></term>
+    <listitem>
+     <para>
+      パラメータを記述する文字列。例: "4,2.5"
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+
+  </para>
+ </refsect1>
+
+
+
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+    <example>
+      <title> <function>ImagickKernel::fromBuiltin</function></title>
+      <programlisting role="php">
+      <![CDATA[
+<?php
+
+
+function renderKernel(ImagickKernel $imagickKernel) {
+    $matrix = $imagickKernel->getMatrix();
+
+    $imageMargin = 20;
+
+    $tileSize = 20;
+    $tileSpace = 4;
+    $shadowSigma = 4;
+    $shadowDropX = 20;
+    $shadowDropY = 0;
+
+    $radius = ($tileSize / 2) * 0.9;
+
+    $rows = count($matrix);
+    $columns = count($matrix[0]);
+
+    $imagickDraw = new \ImagickDraw();
+
+    $imagickDraw->setFillColor('#afafaf');
+    $imagickDraw->setStrokeColor('none');
+
+    $imagickDraw->translate($imageMargin, $imageMargin);
+    $imagickDraw->push();
+
+    ksort($matrix);
+
+    foreach ($matrix as $row) {
+        ksort($row);
+        $imagickDraw->push();
+        foreach ($row as $cell) {
+            if ($cell !== false) {
+                $color = intval(255 * $cell);
+                $colorString = sprintf("rgb(%f, %f, %f)", $color, $color, $color);
+                $imagickDraw->setFillColor($colorString);
+                $imagickDraw->rectangle(0, 0, $tileSize, $tileSize);
+            }
+            $imagickDraw->translate(($tileSize + $tileSpace), 0);
+        }
+        $imagickDraw->pop();
+        $imagickDraw->translate(0, ($tileSize + $tileSpace));
+    }
+
+    $imagickDraw->pop();
+
+    $width = ($columns * $tileSize) + (($columns - 1) * $tileSpace);
+    $height = ($rows * $tileSize) + (($rows - 1) * $tileSpace);
+
+    $imagickDraw->push();
+    $imagickDraw->translate($width/2 , $height/2);
+    $imagickDraw->setFillColor('rgba(0, 0, 0, 0)');
+    $imagickDraw->setStrokeColor('white');
+    $imagickDraw->circle(0, 0, $radius - 1, 0);
+    $imagickDraw->setStrokeColor('black');
+    $imagickDraw->circle(0, 0, $radius, 0);
+    $imagickDraw->pop();
+
+    $canvasWidth = $width + (2 * $imageMargin);
+    $canvasHeight = $height + (2 * $imageMargin);
+
+    $kernel = new \Imagick();
+    $kernel->newPseudoImage(
+        $canvasWidth,
+        $canvasHeight,
+        'canvas:none'
+    );
+
+    $kernel->setImageFormat('png');
+    $kernel->drawImage($imagickDraw);
+
+    /* 別レイヤーにドロップシャドウを作成 */
+    $canvas = $kernel->clone();
+    $canvas->setImageBackgroundColor(new \ImagickPixel('rgb(0, 0, 0)'));
+    $canvas->shadowImage(100, $shadowSigma, $shadowDropX, $shadowDropY);
+
+    $canvas->setImagePage($canvasWidth, $canvasHeight, -5, -5);
+    $canvas->cropImage($canvasWidth, $canvasHeight, 0, 0);
+
+    /* 元のテキストレイヤーをシャドウレイヤーに合成 */
+    $canvas->compositeImage($kernel, \Imagick::COMPOSITE_OVER, 0, 0);
+    $canvas->setImageFormat('png');
+
+    return $canvas;
+}
+
+
+function createFromBuiltin($kernelType, $kernelFirstTerm, $kernelSecondTerm, $kernelThirdTerm) {
+    $string = '';
+
+    if ($kernelFirstTerm != false && strlen(trim($kernelFirstTerm)) != 0) {
+        $string .= $kernelFirstTerm;
+
+        if ($kernelSecondTerm != false && strlen(trim($kernelSecondTerm)) != 0) {
+            $string .= ','.$kernelSecondTerm;
+            if ($kernelThirdTerm != false && strlen(trim($kernelThirdTerm)) != 0) {
+                $string .= ','.$kernelThirdTerm;
+            }
+        }
+    }
+
+    $kernel = ImagickKernel::fromBuiltIn(
+        $kernelType,
+        $string
+    );
+
+    return $kernel;
+}
+
+function fromBuiltin($kernelType, $kernelFirstTerm, $kernelSecondTerm, $kernelThirdTerm) {
+    $diamondKernel = createFromBuiltin($kernelType, $kernelFirstTerm, $kernelSecondTerm, $kernelThirdTerm);
+    $imagick = renderKernel($diamondKernel);
+
+    header("Content-Type: image/png");
+    echo $imagick->getImageBlob();
+}
+
+fromBuiltin(\Imagick::KERNEL_DIAMOND, 2, false, false);
+
+
+?>
+]]>
+      </programlisting>
+    </example>
+  </para>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->