Skip to content

Commit

Permalink
Update to English exif-read-data.xml
Browse files Browse the repository at this point in the history
  • Loading branch information
@mmalferov
mmalferov committed Apr 27, 2024
1 parent e03778c commit b8506e7
Showing 1 changed file with 65 additions and 101 deletions.
166 changes: 65 additions & 101 deletions reference/exif/functions/exif-read-data.xml
View file
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a7421437b658dc4e0455ba8ea7e37a39a530845e Maintainer: tmn Status: ready -->
<!-- EN-Revision: f57352dd7a678230f929e1bac0d4a9189631cf16 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.exif-read-data" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -18,47 +18,46 @@
<methodparam choice="opt"><type>bool</type><parameter>read_thumbnail</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<function>exif_read_data</function> читает заголовки <acronym>EXIF</acronym>
из файлов изображений. Таким образом можно
читать метаданные, генерируемые цифровыми фотоаппаратами.
Функция <function>exif_read_data</function> читает заголовки <acronym>EXIF</acronym>
из файлов изображений. Так читают метаданные, которые генерируют цифровые фотоаппараты.
</para>
<para>
По идее, <acronym>EXIF</acronym>-заголовки должны идти первыми в JPEG/TIFF
файлах, генерируемых фотоаппаратами. Но, к сожалению, каждый производитель имеет
своё представление того, каким образом компоновать метаданные изображения.
По идее, <acronym>EXIF</acronym>-заголовки должны идти первыми в JPEG- или TIFF-файлах,
которые генерируют фотоаппараты. Но, к сожалению, каждый производитель по-своему
представляет, как компоновать метаданные изображения.
Поэтому будьте готовы к ситуации, когда перед Exif-заголовком есть ещё что-то.
</para>
<para>
<literal>Height</literal> и <literal>Width</literal> вычисляются аналогично
вычислениям <function>getimagesize</function>, так что эти параметры не обязаны
присутствовать в заголовке. <literal>html</literal> - текстовая строка, задающая
высоту/ширину, которую можно использовать в обычном <acronym>HTML</acronym>.
Значения <literal>Height</literal> и <literal>Width</literal> функция вычисляет аналогично
вычислениям функции <function>getimagesize</function>, так что эти параметры не обязаны
присутствовать в заголовке. <literal>html</literal> — текстовая строка, которая задаёт
высоту и ширину, которую можно использовать в обычном <acronym>HTML</acronym>.
</para>
<para>
Если Exif-заголовок содержит сообщение об авторских правах (Copyright), само
сообщение может содержать 2 значения. Эта ситуация не описана в стандарте
Exif 2.10, поэтому раздел <literal>COMPUTED</literal> будет содержать оба
Если Exif-заголовок содержит сообщение об авторских правах, само
сообщение может содержать 2 значения. Стандарт Exif 2.10 не описывает эту ситуацию,
поэтому раздел <literal>COMPUTED</literal> будет содержать оба
этих значения в полях <literal>Copyright.Photographer</literal> и
<literal>Copyright.Editor</literal>. В то же время разделы
<literal>IFD0</literal> будут содержать массив байт с NULL-символом в качестве
<literal>IFD0</literal> будут содержать массив байтов с NULL-символом в качестве
разделителя этих двух значений либо только первое значение, если тип файла
определён неверно (нормальная ситуация для Exif). Раздел
определился неверно (нормальная ситуация для Exif). Раздел
<literal>COMPUTED</literal> будет также содержать <literal>Copyright</literal>,
это может быть либо исходная строка, либо список из владельца
который бывает либо исходной строкой, либо списком из владельца
фотографии и редактора через запятую.
</para>
<para>
Тег <literal>UserComment</literal> имеет те же проблемы, что и Copyright.
Он может хранить 2 значения. Первое - использованную кодировку, второе -
Тег <literal>UserComment</literal> содержит те же проблемы, что и Copyright.
Он может хранить 2 значения. Первое — кодировку, второе —
само значение. В этом случае раздел <literal>IFD</literal> содержит либо
кодировку, либо массив байт. Раздел <literal>COMPUTED</literal> будет хранить
кодировку, либо массив байтов. Раздел <literal>COMPUTED</literal> будет хранить
оба этих значения в полях <literal>UserCommentEncoding</literal> и
<literal>UserComment</literal>. Содержимое <literal>UserComment</literal>
будет доступно в любом случае, поэтому предпочтительней использовать его вместо
<literal>UserComment</literal>. Содержимое тега <literal>UserComment</literal>
будет доступно в любом случае, поэтому лучше использовать этот тег вместо
раздела <literal>IFD0</literal>.
</para>
<para>
Также <function>exif_read_data</function> проверяет EXIF теги на соответствие
Также <function>exif_read_data</function> проверяет EXIF-теги на соответствие
спецификации EXIF (<link
xlink:href="&url.exifspec;">&url.exifspec;</link>, стр. 20).
</para>
Expand Down Expand Up @@ -96,7 +95,7 @@
html, Width, Height, IsColor, и другие. Height и
Width вычисляются аналогично <function>getimagesize</function>,
поэтому их не обязательно включать в заголовок.
<literal>html</literal> - текстовая строка, задающая
<literal>html</literal> — текстовая строка, задающая
высоту/ширину, которую можно использовать в обычном
<acronym>HTML</acronym>.
</entry>
Expand Down Expand Up @@ -167,7 +166,7 @@
&reftitle.returnvalues;
<para>
Возвращает ассоциативный массив (<type>array</type>), в котором ключами будут
имена заголовков, а значениями - значения соответствующие этим заголовкам.
имена заголовков, а значениями — значения соответствующие этим заголовкам.
Если никаких данных вернуть нельзя, <function>exif_read_data</function>
вернёт &false;.
</para>
Expand Down Expand Up @@ -203,72 +202,30 @@
<row>
<entry>7.2.0</entry>
<entry>
Параметр <parameter>file</parameter> переименован в
<parameter>stream</parameter> и может принимать как локальный путь
Параметр <parameter>file</parameter> переименовали в
<parameter>stream</parameter> и принимает как локальный путь
к файлу, так и потоковый ресурс.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
Добавлена поддержка следующих форматов EXIF:
<itemizedlist>
<listitem>
<simpara>
Samsung
</simpara>
</listitem>
<listitem>
<simpara>
DJI
</simpara>
</listitem>
<listitem>
<simpara>
Panasonic
</simpara>
</listitem>
<listitem>
<simpara>
Sony
</simpara>
</listitem>
<listitem>
<simpara>
Pentax
</simpara>
</listitem>
<listitem>
<simpara>
Minolta
</simpara>
</listitem>
<listitem>
<simpara>
Sigma/Foveon
</simpara>
</listitem>
<listitem>
<simpara>
AGFA
</simpara>
</listitem>
<listitem>
<simpara>
Kyocera
</simpara>
</listitem>
<listitem>
<simpara>
Ricoh
</simpara>
</listitem>
<listitem>
<simpara>
Epson
</simpara>
</listitem>
</itemizedlist>
<para>
Добавили поддержку следующих форматов EXIF:
<simplelist>
<member>Samsung</member>
<member>DJI</member>
<member>Panasonic</member>
<member>Sony</member>
<member>Pentax</member>
<member>Minolta</member>
<member>Sigma/Foveon</member>
<member>AGFA</member>
<member>Kyocera</member>
<member>Ricoh</member>
<member>Epson</member>
</simplelist>
</para>
</entry>
</row>
</tbody>
Expand All @@ -280,33 +237,36 @@
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>exif_read_data</function></title>
<title>Пример использования функции <function>exif_read_data</function></title>
<programlisting role="php">
<![CDATA[
<?php
echo "test1.jpg:<br />\n";
$exif = exif_read_data('tests/test1.jpg', 'IFD0');
echo $exif===false ? "Не найдено данных заголовка.<br />\n" : "Изображение содержит заголовки<br />\n";
echo $exif===false ? "Функция не нашла данные заголовка.<br />\n" : "Изображение содержит заголовки<br />\n";
$exif = exif_read_data('tests/test2.jpg', 0, true);
echo "test2.jpg:<br />\n";
foreach ($exif as $key => $section) {
foreach ($section as $name => $val) {
echo "$key.$name: $val<br />\n";
}
}
?>
]]>
</programlisting>
<para>
Первый вызов завершается неудачей, так как в заголовках
изображения нет информации.
Первый вызов завершается неудачей, поскольку заголовки
изображения не содержат информации.
</para>
&example.outputs.similar;
<screen role="php">
<![CDATA[
test1.jpg:
No header data found.
Функция не нашла данные заголовка.
test2.jpg:
FILE.FileName: test2.jpg
FILE.FileDateTime: 1017666176
Expand Down Expand Up @@ -339,10 +299,13 @@ THUMBNAIL.Thumbnail.Height: 1
</para>
<para>
<example>
<title>Использование <function>exif_read_data</function> с потоковым ресурсом (доступно с PHP 7.2.0)</title>
<title>
Использование функции <function>exif_read_data</function> с потоковым ресурсом (доступно с PHP 7.2.0)
</title>
<programlisting role="php">
<![CDATA[
<?php
// Открываем файл в бинарном режиме
$fp = fopen('/path/to/image.jpg', 'rb');
Expand All @@ -365,6 +328,7 @@ echo 'Заголовки EXIF:' . PHP_EOL;
foreach ($headers['COMPUTED'] as $header => $value) {
printf(' %s => %s%s', $header, $value, PHP_EOL);
}
?>
]]>
</programlisting>
Expand All @@ -391,20 +355,20 @@ EXIF Headers:
&reftitle.notes;
<note>
<para>
Если разрешён <link linkend="ref.mbstring">mbstring</link>, то exif будет пытаться
обрабатывать юникод и брать кодировку как указано в
<link linkend="ini.exif.decode-unicode-motorola">exif.decode_unicode_motorola</link> и
<link linkend="ini.exif.decode-unicode-intel">exif.decode_unicode_intel</link>.
Модуль exif не будет пытаться самостоятельно определить кодировку и указание
правильной кодировки остаётся на совести пользователя путём установки одной из
двух INI-директив перед вызовом <function>exif_read_data</function>.
Если модуль <link linkend="ref.mbstring">mbstring</link> включили, то exif будет пытаться
обрабатывать Юникод и брать кодировку как указано в
параметрах конфигурации <link linkend="ini.exif.decode-unicode-motorola">exif.decode_unicode_motorola</link>
и <link linkend="ini.exif.decode-unicode-intel">exif.decode_unicode_intel</link>.
Модуль exif не будет пытаться определить кодировку сам, правильную кодировку
для декодирования указывает пользователь путём установки одной из
двух INI-директив перед вызовом функции <function>exif_read_data</function>.
</para>
</note>
<note>
<para>
Если параметр <parameter>file</parameter> использован для передачи в функцию
потока, то этот поток должен быть перематываемым. Обратите внимание, что файловый
позиционный указатель не будет изменён после завершения работы этой функции.
Если параметр <parameter>file</parameter> указали для передачи в функцию
потока, поток должен быть перематываемым. Обратите внимание, что файловый
позиционный указатель не изменится после завершения работы функции.
</para>
</note>
</refsect1>
Expand Down

0 comments on commit b8506e7

Please sign in to comment.