[reference/image] sync with en

mumumu · mumumu · commit 659c0685df7f · 2025-09-07T17:55:11.000+09:00
diff --git a/reference/image/functions/imageaffinematrixget.xml b/reference/image/functions/imageaffinematrixget.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 593ea510e853ff034e03f78a4be0daa41661c9d4 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <refentry xml:id="function.imageaffinematrixget" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -28,7 +28,7 @@
     <term><parameter>type</parameter></term>
     <listitem>
      <para>
-      定数 <constant>IMG_AFFINE_*</constant> のいずれか。
+      定数 <constant>IMG_AFFINE_<replaceable>*</replaceable></constant> のいずれか。
      </para>
     </listitem>
    </varlistentry>
diff --git a/reference/image/functions/imageavif.xml b/reference/image/functions/imageavif.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: ccd3e68e1e8a89a099a32207dd31ed26b70f43cd Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 24641aea6dd6d48db8a15a6cbe6ca6d89f70ba98 Maintainer: mumumu Status: ready -->
 <refentry xml:id="function.imageavif" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>imageavif</refname>
@@ -43,7 +43,7 @@
        0 (画質は最悪、小さなファイル) から
        100 (最高画質、大きなファイル) までの値を取ります。
        <literal>-1</literal> を指定した場合、
-       デフォルト値 <literal>30</literal> を使います。
+       デフォルト値 <literal>52</literal> を使います。
       </para>
      </listitem>
     </varlistentry>
diff --git a/reference/image/functions/imagecolorset.xml b/reference/image/functions/imagecolorset.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: c21abf2132646aa69e05685690d8fbf8fe7c31f4 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.imagecolorset" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
diff --git a/reference/image/functions/imagedestroy.xml b/reference/image/functions/imagedestroy.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 52dc204a77076e1404257cf39f179882b90b5780 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: de13997491811ade18c2d23e9959ef2825154add Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xml:id="function.imagedestroy" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -18,6 +18,9 @@
    PHP 8.0.0 より前のバージョンでは、
    <function>imagedestroy</function> は画像 <parameter>image</parameter>
    を保持するメモリを解放していました。
+   PHP 8.0.0 以降のバージョンでは、
+   GD 拡張モジュールはリソースの代わりにオブジェクトを使うようになったので、
+   オブジェクトは明示的にクローズできなくなっています。
   </para>
  </refsect1>
  <refsect1 role="parameters">
diff --git a/reference/image/functions/imagegd.xml b/reference/image/functions/imagegd.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 55f2d0cda1972031881f6e3464946144dfb900a2 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.imagegd" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -15,8 +15,9 @@
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>file</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   GD イメージを、指定した <parameter>file</parameter>
-   に出力します。
+   指定された <parameter>image</parameter>
+   を GDフォーマットで出力するか、保存します。
+
   </para>
  </refsect1>
  <refsect1 role="parameters">
diff --git a/reference/image/functions/imagegd2.xml b/reference/image/functions/imagegd2.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 2a3e48b0edb8daeebb6479ade819c397759c74be Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.imagegd2" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -17,8 +17,8 @@
    <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer><constant>IMG_GD2_RAW</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
-   GD2 イメージを、指定した <parameter>file</parameter>
-   に出力します。
+   指定された <parameter>image</parameter>
+   を GD2フォーマットで出力するか、保存します。
   </para>
  </refsect1>
  <refsect1 role="parameters">
diff --git a/reference/image/functions/imageloadfont.xml b/reference/image/functions/imageloadfont.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: a242967282148c0dc1c7594ed406ee4b01d41d3d Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.imageloadfont" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -149,6 +149,7 @@ imagepng($im);
   <simplelist>
    <member><function>imagefontwidth</function></member>
    <member><function>imagefontheight</function></member>
+   <member><function>imagestring</function></member>
   </simplelist>
  </refsect1>
 </refentry>
diff --git a/reference/image/functions/imagettfbbox.xml b/reference/image/functions/imagettfbbox.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 48220b9fcde41afb13e0b7f3e806f51cd179df90 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.imagettfbbox" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -60,6 +60,14 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>options</parameter></term>
+     <listitem>
+      <para>
+       <function>imagettftext</function> と同じです。
+      </para>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
diff --git a/reference/image/functions/imagettftext.xml b/reference/image/functions/imagettftext.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 48220b9fcde41afb13e0b7f3e806f51cd179df90 Maintainer: hirokawa Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.imagettftext" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -100,12 +100,12 @@
       </para>
       <para>
        フォント内で 127 文字目以降の文字にアクセスするために、
-       (&amp;#8364; のような) 十進数文字参照を含めることができます。
-       (&amp;#xA9; のような) 十六進形式もサポートしています。
+       (<literal>&amp;#8364;</literal> のような) 十進数文字参照を含めることができます。
+       (<literal>&amp;#xA9;</literal> のような) 十六進形式もサポートしています。
        UTF-8 エンコーディングされた文字列を直接渡すことができます。
       </para>
       <para>
-       &amp;copy; のような文字エンティティはサポートされません。
+       <literal>&amp;copy;</literal> のような文字エンティティはサポートされません。
        <function>html_entity_decode</function> を使用して、
        文字エンティティを UTF-8 文字列にすることを検討してください。
       </para>
@@ -115,6 +115,14 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>options</parameter></term>
+     <listitem>
+      <para>
+       <literal>linespacing</literal> キーに <type>float</type> 値を指定した配列。
+      </para>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
@@ -165,7 +173,8 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-// コンテントタイプを設定します
+
+// content-type を設定します
 header('Content-Type: image/png');
 
 // 画像を生成します
@@ -179,6 +188,7 @@ imagefilledrectangle($im, 0, 0, 399, 29, $white);
 
 // 描画する文字列
 $text = 'Testing...';
+
 // フォント自身のパスでパスを置き換えます
 $font = 'arial.ttf';
 
@@ -190,6 +200,7 @@ imagettftext($im, 20, 0, 10, 20, $black, $font, $text);
 
 // imagepng() を使用して imagejpeg() よりもクリアなテキストにします
 imagepng($im);
+
 ?>
 ]]>
     </programlisting>
@@ -212,6 +223,7 @@ imagepng($im);
   <simplelist>
    <member><function>imagettfbbox</function></member>
    <member><function>imagefttext</function></member>
+   <member><function>imagestring</function></member>
   </simplelist>
  </refsect1>
 </refentry>
diff --git a/reference/image/functions/imagewebp.xml b/reference/image/functions/imagewebp.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 8f76f001f7ab39f2ecf0766b9158f05111d6c99d Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.imagewebp" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -39,6 +39,8 @@
        <parameter>quality</parameter> には、0 (品質は最低で、
        ファイルサイズが小さくなる) から 100 (品質が最高で、ファイルサイズは大きくなる)
        までの値を指定します。
+       <literal>-1</literal> を指定すると、
+       デフォルト値 <literal>80</literal> を使います。
       </para>
      </listitem>
     </varlistentry>
