PHP: полный мануал с примерами, функциями и ООП

PECL imagick 2, PECL imagick 3 · imagick

Imagick::setImageDepth(int $depth): bool

Самая маленькая запись

$image — загруженное изображение. $ обозначает переменную; = присваивает; -> вызывает метод; () содержит аргументы; запятая их разделяет; ; завершает инструкцию. Imagick:: обращается к именованной константе. RGB — красная, зелёная и синяя компоненты; RGBA добавляет alpha, где 0 прозрачен,1 непрозрачен. clone создаёт рабочую копию. Q16 здесь означает внутренние 16 битные целые значения компоненты от 0 до 65535; это отдельно от глубины хранения PNG.

$copy = clone $image;
$ok = $copy->setImageDepth(4);

В проверенной Q16-сборке это огрубляет разрешённые к изменению каналы. Возвращённое true — статус, а не новое изображение.4 означает максимум 16 уровней на компоненту, не 16 цветов RGB: комбинаций может быть больше. Для градиента это намеренный контрпример со ступеньками.

if проверяет условие, ! отрицает статус; throw new RuntimeException прекращает цепочку при отказе. echo выводит текст, "\n" переводит строку, printf подставляет %d как целое. new Imagick(путь) заново читает файл. Основы: объекты и методы, массивы, файлы, исключения.

Официальный контракт и границы реализации

Imagick::setImageDepth(int $depth): bool

Sets the image depth. Доступность: PECL imagick 2, PECL imagick 3. Возврат: Returns true on success. Официальных примеров и таблиц изменений у этих трёх XML-записей нет; полный XML сохранён ниже.

Проверенная версия: Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16 без HDRI. В ней getImageDepth читает поле текущего изображения, хотя внутренняя библиотека имеет и отдельную функцию анализа значений. Это разные пути. Все три PHP-метода требуют непустое изображение и в проверке дали ImagickException на пустом объекте; раздел ошибок getter в исходном XML не заполнен, уточнение относится к этой реализации.

При d=4 либо 8 и обычных неотрицательных Q16-значениях здесь n=floor(c×(2^d−1)/65535), затем c′=n×65535/(2^d−1). d — переданное число depth, n — целый номер уровня, c — исходная компонента; c′ — результат; floor означает округление вниз, например floor(2.9)=2. ^ в математической записи означает степень, не PHP-оператор XOR. Эта формула ограничена проверенной сборкой без HDRI и веткой без отдельно включённого дизеринга FloydSteinberg (распределения ошибки по соседним пикселям); другую глубину сборки или дизеринг нельзя молча считать тем же механизмом.

При depth≥16 в этой Q16-сборке метод только меняет поле depth. В пробе 32 было принято без новых значений; это не гарантия 32 битной внутренней точности или 32 битного truecolorPNG. Снижение точности теряет промежуточные значения; увеличение обратно их не вычисляет. RGB/RGBA PNG поддерживает 8- и 16 битные компоненты, поэтому 4 битная сетка здесь сохраняется в 8- или 16 битном контейнере.

Setters возвращают true при успехе, а внутренний отказ преобразуется PHP-обёрткой в ImagickException; неверный PHP-тип может дать TypeError. Реализация не обещает за приложение ограничить depth только 4/8/16 или проверить белый список каналов. Наши примеры используют известные положительные значения; внешние параметры надо отдельно ограничить разумным диапазоном и доступными константами. Отрицательные значения и бесконтрольные глубины не являются способом исследования возможного диапазона.

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="imagick.setimagedepth">
 <refnamediv>
  <refname>Imagick::setImageDepth</refname>
  <refpurpose>Sets the image depth</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <modifier>public</modifier> <type>bool</type><methodname>Imagick::setImageDepth</methodname>
   <methodparam><type>int</type><parameter>depth</parameter></methodparam>
  </methodsynopsis>
  <para>
   Sets the image depth.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>depth</parameter></term>
     <listitem>
      <para>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &imagick.return.success;
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   &imagick.imagick.throws;
  </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
-->

Огрубить все цветовые компоненты до четырёхбитной сетки

У текущего изображения depth=4, цвета выбраны из сетки максимум 16 уровней каждой компоненты. Для точного исследования сохранён PNG16; после чтения его getter возвращает 16. Это различие между сеткой значений, общим полем depth и числом бит хранения.

<?php
declare(strict_types=1);
require __DIR__ . '/depth-fixture.php';
[$source, $product] = loadDepthInputs();
$sourceView = saveDepthPNG($source, 'source-preview8.png', 8);
$coarse = clone $source;
if (!$coarse->setImageDepth(4)) { throw new RuntimeException('Depth4 failed'); }
$storage = clone $coarse; $storage->setImageDepth(16);
$loaded = saveDepthPNG($storage, 'all-four-storage16.png', 16);
$view = saveDepthPNG($loaded, 'all-four-preview8.png', 8);
saveDepthComparison([$sourceView, $view], 'depth-all.png');
echo "depth-all.png\nall-four-storage16.png\n";
printf("live=%d stored-read=%d\n", $coarse->getImageDepth(), $loaded->getImageDepth());

depth-all.png
all-four-storage16.png
live=4 stored-read=16

Применить грубую сетку только к рисунку, сохранив SKU

Меняем только рисунок 352×132 от(24,88), затем вставляем обратно. Вне прямоугольника исходные 16 битные значения, градиенты и SKU сохранены точно. Это намеренная стилизация; уменьшение точности не является повышением качества или автоматическим способом улучшить текст.

<?php
declare(strict_types=1);
require __DIR__ . '/depth-fixture.php';
[$source, $product] = loadDepthInputs();
$sourceView = saveDepthPNG($source, 'source-preview8.png', 8);
$region = $source->getImageRegion(352, 132, 24, 88);
$region->setImagePage(0, 0, 0, 0);
if (!$region->setImageDepth(4)) { throw new RuntimeException('Region depth failed'); }
$protected = clone $source;
$protected->compositeImage($region, Imagick::COMPOSITE_OVER, 24, 88);
$loaded = saveDepthPNG($protected, 'protected16.png', 16);
$view = saveDepthPNG($loaded, 'protected-preview8.png', 8);
saveDepthComparison([$sourceView, $view], 'depth-protected.png');
echo "depth-protected.png\nprotected16.png\n";

depth-protected.png
protected16.png

• Imagick::setImageDepth

PECL imagick 2, PECL imagick 3 · imagick

Imagick::getImageDepth(): int

Самая маленькая запись

$image — загруженное изображение. $ обозначает переменную; = присваивает; -> вызывает метод; () содержит аргументы; запятая их разделяет; ; завершает инструкцию. Imagick:: обращается к именованной константе. RGB — красная, зелёная и синяя компоненты; RGBA добавляет alpha, где 0 прозрачен,1 непрозрачен. clone создаёт рабочую копию. Q16 здесь означает внутренние 16 битные целые значения компоненты от 0 до 65535; это отдельно от глубины хранения PNG.

$depth = $image->getImageDepth();
echo $depth;

Getter — метод чтения. Он возвращает целое поле depth: например 16 у исходного PNG16,4 после уменьшения. Это не подсчёт разных цветов и не обещание, что произвольный PNG16 содержит все 65536 уровней. После сохранения и чтения 16 битного контейнера значение может стать 16 даже при грубой сетке.

if проверяет условие, ! отрицает статус; throw new RuntimeException прекращает цепочку при отказе. echo выводит текст, "\n" переводит строку, printf подставляет %d как целое. new Imagick(путь) заново читает файл. Основы: объекты и методы, массивы, файлы, исключения.

Официальный контракт и границы реализации

Imagick::getImageDepth(): int

Gets the image depth. Доступность: PECL imagick 2, PECL imagick 3. Возврат: The image depth. Официальных примеров и таблиц изменений у этих трёх XML-записей нет; полный XML сохранён ниже.

Проверенная версия: Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16 без HDRI. В ней getImageDepth читает поле текущего изображения, хотя внутренняя библиотека имеет и отдельную функцию анализа значений. Это разные пути. Все три PHP-метода требуют непустое изображение и в проверке дали ImagickException на пустом объекте; раздел ошибок getter в исходном XML не заполнен, уточнение относится к этой реализации.

При d=4 либо 8 и обычных неотрицательных Q16-значениях здесь n=floor(c×(2^d−1)/65535), затем c′=n×65535/(2^d−1). d — переданное число depth, n — целый номер уровня, c — исходная компонента; c′ — результат; floor означает округление вниз, например floor(2.9)=2. ^ в математической записи означает степень, не PHP-оператор XOR. Эта формула ограничена проверенной сборкой без HDRI и веткой без отдельно включённого дизеринга FloydSteinberg (распределения ошибки по соседним пикселям); другую глубину сборки или дизеринг нельзя молча считать тем же механизмом.

После RED4 getter также сообщает 4, хотя G/B не снижались. После сохранения грубых значений в PNG16 и чтения он сообщает 16. Чтобы доказать точность, нужны известный источник и сравнение самих отсчётов; одного getter недостаточно. Число используемых уровней и глубина файла также не равны размеру файла в байтах.

Setters возвращают true при успехе, а внутренний отказ преобразуется PHP-обёрткой в ImagickException; неверный PHP-тип может дать TypeError. Реализация не обещает за приложение ограничить depth только 4/8/16 или проверить белый список каналов. Наши примеры используют известные положительные значения; внешние параметры надо отдельно ограничить разумным диапазоном и доступными константами. Отрицательные значения и бесконтрольные глубины не являются способом исследования возможного диапазона.

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="imagick.getimagedepth">
 <refnamediv>
  <refname>Imagick::getImageDepth</refname>
  <refpurpose>Gets the image depth</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <modifier>public</modifier> <type>int</type><methodname>Imagick::getImageDepth</methodname>
   <void/>
  </methodsynopsis>
  <para>
   Gets the image depth.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  &no.function.parameters;
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   The image depth.
  </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
-->

Прочитать depth объекта и заново открытого PNG16

Вживую getter вернул 4, после хранения PNG16 и чтения вернул 16, хотя числовые значения остались на четырёхбитной сетке. Метод читает общее поле текущего изображения, не подсчитывает использованные уровни и не доказывает происхождение точных оттенков.

<?php
declare(strict_types=1);
require __DIR__ . '/depth-fixture.php';
[$source, $product] = loadDepthInputs();
$sourceView = saveDepthPNG($source, 'source-preview8.png', 8);
$coarse = clone $source; $coarse->setImageDepth(4);
$live = $coarse->getImageDepth();
$storage = clone $coarse; $storage->setImageDepth(16);
$loaded = saveDepthPNG($storage, 'read-container16.png', 16);
$read = $loaded->getImageDepth();
$view = saveDepthPNG($loaded, 'read-container-preview8.png', 8);
saveDepthComparison([$sourceView, $view], 'depth-read.png');
echo "depth-read.png\nread-container16.png\n";
printf("live=%d read=%d\n", $live, $read);

depth-read.png
read-container16.png
live=4 read=16

Обнаружить ложное восстановление точности в маршруте 16→8→16

Три просмотра: исходник, сохранённая 8 битная копия и 16 битный контейнер после увеличения поля. Отчёт снова показывает 16, но сохранённые значения последнего файла равны восьмибитной копии, а не исходнику. Поэтому при работе с градиентами важно сохранять точный мастер, а не полагаться на одно число getter.

<?php
declare(strict_types=1);
require __DIR__ . '/depth-fixture.php';
[$source, $product] = loadDepthInputs();
$sourceView = saveDepthPNG($source, 'source-preview8.png', 8);
$eight = clone $source; $eight->setImageDepth(8);
$expanded = clone $eight; $expanded->setImageDepth(16);
$readEight = saveDepthPNG($eight, 'route-eight.png', 8);
$readExpanded = saveDepthPNG($expanded, 'route-expanded16.png', 16);
$eightView = saveDepthPNG($readEight, 'route-eight-preview8.png', 8);
$expandedView = saveDepthPNG($readExpanded, 'route-expanded-preview8.png', 8);
saveDepthComparison([$sourceView, $eightView, $expandedView], 'depth-no-restore.png');
echo "depth-no-restore.png\nroute-eight.png\nroute-expanded16.png\n";
printf("source=%d eight=%d expanded=%d\n", $source->getImageDepth(), $eight->getImageDepth(), $expanded->getImageDepth());

depth-no-restore.png
route-eight.png
route-expanded16.png
source=16 eight=8 expanded=16

• Imagick::getImageDepth

PECL imagick 2, PECL imagick 3 · imagick

Imagick::setImageChannelDepth(int $channel, int $depth): bool

Самая маленькая запись

$image — загруженное изображение. $ обозначает переменную; = присваивает; -> вызывает метод; () содержит аргументы; запятая их разделяет; ; завершает инструкцию. Imagick:: обращается к именованной константе. RGB — красная, зелёная и синяя компоненты; RGBA добавляет alpha, где 0 прозрачен,1 непрозрачен. clone создаёт рабочую копию. Q16 здесь означает внутренние 16 битные целые значения компоненты от 0 до 65535; это отдельно от глубины хранения PNG.

$copy = clone $image;
$ok = $copy->setImageChannelDepth(Imagick::CHANNEL_RED, 4);

Первый аргумент выбирает красный канал, второй задаёт 4 битную сетку. Для alpha замените константу на CHANNEL_ALPHA. Остальные каналы в наших контролях сохранены. Общее поле depth при этом всё равно стало 4; для сохранения остальных 16 битных отсчётов перед PNG16 нужно явно подготовить отдельную копию:

$storage = clone $copy;
$storage->setImageDepth(16);

На Q16 этот второй вызов меняет поле хранения, не возвращает потерянные красные значения и не меняет оставшиеся 16 битные G/B. Оригинальный $copy продолжает сообщать 4. Следующая запись helper выбирает контейнер PNG16 отдельно.

if проверяет условие, ! отрицает статус; throw new RuntimeException прекращает цепочку при отказе. echo выводит текст, "\n" переводит строку, printf подставляет %d как целое. new Imagick(путь) заново читает файл. Основы: объекты и методы, массивы, файлы, исключения.

Официальный контракт и границы реализации

Imagick::setImageChannelDepth(int $channel, int $depth): bool

Sets the depth of a particular image channel. Доступность: PECL imagick 2, PECL imagick 3. Возврат: Returns true on success. Официальных примеров и таблиц изменений у этих трёх XML-записей нет; полный XML сохранён ниже.

Проверенная версия: Imagick 3.8.1 / ImageMagick 7.1.1-46 Q16 без HDRI. В ней getImageDepth читает поле текущего изображения, хотя внутренняя библиотека имеет и отдельную функцию анализа значений. Это разные пути. Все три PHP-метода требуют непустое изображение и в проверке дали ImagickException на пустом объекте; раздел ошибок getter в исходном XML не заполнен, уточнение относится к этой реализации.

При d=4 либо 8 и обычных неотрицательных Q16-значениях здесь n=floor(c×(2^d−1)/65535), затем c′=n×65535/(2^d−1). d — переданное число depth, n — целый номер уровня, c — исходная компонента; c′ — результат; floor означает округление вниз, например floor(2.9)=2. ^ в математической записи означает степень, не PHP-оператор XOR. Эта формула ограничена проверенной сборкой без HDRI и веткой без отдельно включённого дизеринга FloydSteinberg (распределения ошибки по соседним пикселям); другую глубину сборки или дизеринг нельзя молча считать тем же механизмом.

В IM7 PHP-совместимость временно выбирает маску каналов и возвращает её после вызова. При успехе общее поле image depth всё равно меняется. Для RED4 оставшиеся G/B могут иметь 16 битные значения, поэтому перед PNG16 в программе явно вызывается setImageDepth(16) у отдельной storage-копии. Одного позднего настройки записи PNG недостаточно считать доказательством сохранения этих значений.

Setters возвращают true при успехе, а внутренний отказ преобразуется PHP-обёрткой в ImagickException; неверный PHP-тип может дать TypeError. Реализация не обещает за приложение ограничить depth только 4/8/16 или проверить белый список каналов. Наши примеры используют известные положительные значения; внешние параметры надо отдельно ограничить разумным диапазоном и доступными константами. Отрицательные значения и бесконтрольные глубины не являются способом исследования возможного диапазона.

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="imagick.setimagechanneldepth">
 <refnamediv>
  <refname>Imagick::setImageChannelDepth</refname>
  <refpurpose>Sets the depth of a particular image channel</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <modifier>public</modifier> <type>bool</type><methodname>Imagick::setImageChannelDepth</methodname>
   <methodparam><type>int</type><parameter>channel</parameter></methodparam>
   <methodparam><type>int</type><parameter>depth</parameter></methodparam>
  </methodsynopsis>
  <para>
   Sets the depth of a particular image channel.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>channel</parameter></term>
     <listitem>
      <para>
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>depth</parameter></term>
     <listitem>
      <para>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &imagick.return.success;
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   &imagick.imagick.throws;
  </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
-->

Огрубить только красный канал и сохранить остальные значения

CHANNEL_RED выбирает только красную компоненту. G/B остаются исходными 16 битными значениями; результат сохраняется с явной подготовкой копии к PNG16. Установка канала всё равно меняет общее поле depth на 4, поэтому это поле не является отчётом о глубине каждого канала.

<?php
declare(strict_types=1);
require __DIR__ . '/depth-fixture.php';
[$source, $product] = loadDepthInputs();
$sourceView = saveDepthPNG($source, 'source-preview8.png', 8);
$red = clone $source;
if (!$red->setImageChannelDepth(Imagick::CHANNEL_RED, 4)) { throw new RuntimeException('Red depth failed'); }
$live = $red->getImageDepth();
$storage = clone $red;
$storage->setImageDepth(16);
$loaded = saveDepthPNG($storage, 'red-only16.png', 16);
$view = saveDepthPNG($loaded, 'red-only-preview8.png', 8);
saveDepthComparison([$sourceView, $view], 'depth-red.png');
echo "depth-red.png\nred-only16.png\n";
printf("red-live=%d storage-read=%d\n", $live, $loaded->getImageDepth());

depth-red.png
red-only16.png
red-live=4 storage-read=16

Изменить сетку alpha наклейки, сохранив RGB и отверстие

После каталога показана исходная наклейка на тёмном, alpha4 на тёмном и тот же результат на светлом. Промежуточная прозрачность стала ступенчатой, RGB сохранены, alpha0 и 65535 остаются концами диапазона. alpha-only16.png хранит RGBA16; alpha-raw-preview8.png — отдельный RGBA8 просмотр, не непрозрачный фон.

<?php
declare(strict_types=1);
require __DIR__ . '/depth-fixture.php';
[$source, $product] = loadDepthInputs();
$sourceView = saveDepthPNG($source, 'source-preview8.png', 8);
$alpha = clone $product;
if (!$alpha->setImageChannelDepth(Imagick::CHANNEL_ALPHA, 4)) { throw new RuntimeException('Alpha depth failed'); }
$storage = clone $alpha;
$storage->setImageDepth(16);
$loaded = saveDepthPNG($storage, 'alpha-only16.png', 16, true);
saveDepthPNG($loaded, 'alpha-raw-preview8.png', 8, true);
$originalDark = depthPreview($product, '#243c4d');
$alphaDark = depthPreview($loaded, '#243c4d');
$alphaLight = depthPreview($loaded, '#e6edf1');
$a = saveDepthPNG($originalDark, 'product-dark-preview8.png', 8);
$b = saveDepthPNG($alphaDark, 'alpha-dark-preview8.png', 8);
$c = saveDepthPNG($alphaLight, 'alpha-light-preview8.png', 8);
saveDepthComparison([$sourceView, $a, $b, $c], 'depth-alpha.png');
echo "depth-alpha.png\nalpha-only16.png\n";
printf("alpha-live=%d storage-read=%d\n", $alpha->getImageDepth(), $loaded->getImageDepth());

depth-alpha.png
alpha-only16.png
alpha-live=4 storage-read=16

• Imagick::setImageChannelDepth