From 8d4550d1818e3d010407a3da391bb3f03d0a8922 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@php.net>
Date: Sat, 18 Jan 2025 07:56:33 +0300
Subject: [PATCH] Update examples.xml to En + Infostyle

---
 reference/image/examples.xml | 64 ++++++++++++++++++------------------
 1 file changed, 32 insertions(+), 32 deletions(-)

diff --git a/reference/image/examples.xml b/reference/image/examples.xml
index b40a6420e2..7821f4552d 100644
--- a/reference/image/examples.xml
+++ b/reference/image/examples.xml
@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 10c69571e7dd8a7cc0fbc9f20a55d24b1b1032be Maintainer: mch Status: ready -->
+<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <chapter xml:id="image.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
  <section xml:id="image.examples-png">
-  <title>Создание PNG средствами PHP</title>
+  <title>Создаёт PNG-изображение средствами PHP</title>
   <para>
    <example>
-    <title>Создание PNG средствами PHP</title>
+    <title>Пример создания изображения в формате PNG средствами PHP</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -19,30 +19,30 @@ $orange = imagecolorallocate($im, 220, 210, 60);
 $px     = (imagesx($im) - 7.5 * strlen($string)) / 2;
 imagestring($im, 3, $px, 9, $string, $orange);
 imagepng($im);
-imagedestroy($im);
 
 ?>
 ]]>
     </programlisting>
    </example>
    Этот пример можно было бы вызвать на странице с тегом: <literal>&lt;img
-   src=&quot;button.php?text=text&quot;&gt;</literal>. Приведённый выше скрипт <filename>button.php</filename>
-   возьмёт строку <literal>&quot;text&quot;</literal> и наложит её поверх базового изображения,
-   которое является, в данном случае <literal>&quot;images/button1.png&quot;</literal>
-   и выведет конечное изображение. Это очень удобный способ,
-   чтобы избежать необходимости создания новой кнопки всякий раз,
-   когда вы хотите изменить текст кнопки. С помощью этого метода она
-   генерируются динамически.
+   src=&quot;button.php?text=text&quot;&gt;</literal>. Приведённый скрипт <filename>button.php</filename>
+   возьмёт строку <literal>&quot;text&quot;</literal>, наложит её поверх базового изображения
+   <literal>&quot;images/button1.png&quot;</literal>
+   и выведет конечное изображение. Это удобный способ
+   не создавать новую кнопку каждый раз,
+   когда требуется изменить текст кнопки. Этот метод
+   генерирует кнопку динамически.
   </para>
  </section>
  <section xml:id="image.examples-watermark">
-  <title>Добавление водяных знаков на изображения с помощью альфа-каналов</title>
+  <title>Добавление водяных знаков на изображения через альфа-каналы</title>
   <para>
    <example>
-    <title>Добавление водяных знаков на изображения с помощью альфа-каналов</title>
+    <title>Добавление водяных знаков на изображения через альфа-каналы</title>
     <programlisting role="php">
 <![CDATA[
 <?php
+
 // Загрузка штампа и фото, для которого применяется водяной знак (называется штамп или печать)
 $stamp = imagecreatefrompng('stamp.png');
 $im = imagecreatefromjpeg('photo.jpeg');
@@ -53,41 +53,42 @@ $marge_bottom = 10;
 $sx = imagesx($stamp);
 $sy = imagesy($stamp);
 
-// Копирование изображения штампа на фотографию с помощью смещения края
+// Копирование изображения штампа на фотографию путём смещения края
 // и ширины фотографии для расчёта позиционирования штампа.
 imagecopy($im, $stamp, imagesx($im) - $sx - $marge_right, imagesy($im) - $sy - $marge_bottom, 0, 0, imagesx($stamp), imagesy($stamp));
 
-// Вывод и освобождение памяти
+// Вывод изображения
 header('Content-type: image/png');
 imagepng($im);
-imagedestroy($im);
+
 ?>
 ]]>
     </programlisting>
     <mediaobject>
-     <alt>Добавление водяных знаков на изображения с помощью альфа-каналов</alt>
+     <alt>Добавление водяных знаков на изображения через альфа-каналы</alt>
      <imageobject>
       <imagedata fileref="en/reference/image/figures/watermarks.png"/>
      </imageobject>
     </mediaobject>
    </example>
-   Этот пример является простым способом добавить водяные знаки и штампы на фотографии и изображения,
-   защищённые авторским правом. Обратите внимание, что наличие альфа-канала в изображении
-   штампа, как текст сглаживается. Это сохранилось во время копирования.
+   Этот пример — распространенный способ добавления водяных знаков и штампов к фотографиям и изображениям,
+   защищённым авторским правом. Обратите внимание, что альфа-канал на изображении
+   штампа в виде текста сглаживается. Это сохранилось при копировании.
   </para>
  </section>
  <section xml:id="image.examples.merged-watermark">
-  <title>Использование <function>imagecopymerge</function> создать полупрозрачный водяной знак</title>
+  <title>Создание полупрозрачного водяного знака функцией <function>imagecopymerge</function></title>
   <para>
    <example>
-    <title>Использование <function>imagecopymerge</function> создать полупрозрачный водяной знак</title>
+    <title>Пример создания полупрозрачного водяного знака функцией <function>imagecopymerge</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
+
 // Загрузка штампа и фото, для которого применяется водяной знак (называется штамп или печать)
 $im = imagecreatefromjpeg('photo.jpeg');
 
-// Сначала создаём наше изображение штампа вручную с помощью GD
+// Сначала создаём изображение штампа вручную через модуль GD
 $stamp = imagecreatetruecolor(100, 70);
 imagefilledrectangle($stamp, 0, 0, 99, 69, 0x0000FF);
 imagefilledrectangle($stamp, 9, 9, 90, 60, 0xFFFFFF);
@@ -100,28 +101,27 @@ $marge_bottom = 10;
 $sx = imagesx($stamp);
 $sy = imagesy($stamp);
 
-// Слияние штампа с фотографией. Прозрачность 50%
+// Слияние штампа с фотографией. Прозрачность 50 %
 imagecopymerge($im, $stamp, imagesx($im) - $sx - $marge_right, imagesy($im) - $sy - $marge_bottom, 0, 0, imagesx($stamp), imagesy($stamp), 50);
 
-// Сохранение фотографии в файл и освобождение памяти
+// Сохранение изображения в файл
 imagepng($im, 'photo_stamp.png');
-imagedestroy($im);
 
 ?>
 ]]>
     </programlisting>
     <mediaobject>
-     <alt>Использование imagecopymerge()  для создания полупрозрачного водяного знака</alt>
+     <alt>Пример создания полупрозрачного водяного знака функцией imagecopymerge()</alt>
      <imageobject>
       <imagedata fileref="en/reference/image/figures/watermark-merged.png"/>
      </imageobject>
     </mediaobject>
    </example>
-   В этом примере используется <function>imagecopymerge</function> для объединения штампа
-   с нашим исходным изображением. С помощью этого мы можем установить прозрачность нашего штампа -
-   в нашем примере мы установили его на 50% непрозрачности (opacity).
-   На практике это было бы полезным для защиты авторских прав, полупрозрачные водяные знаки трудно удалить и
-   позволяют зрителям увидеть изображение.
+   В примере функция <function>imagecopymerge</function> объединяет штамп
+   с исходным изображением. Так устанавливают прозрачность штампа —
+   в примере установили прозрачность на уровне 50 % непрозрачности (opacity).
+   На практике это принесло бы пользу для защиты авторских прав, поскольку полупрозрачные водяные знаки трудно удалить,
+   но при этом изображения видны зрителям.
   </para>
  </section>
 </chapter>