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

<?php
declare(strict_types=1);
require __DIR__.'/palette-sequence-fixture.php';
restorePaletteInput();
$source=new Imagick(__DIR__.'/source.png');
$before=paletteState($source);$sourceWhite=palettePreview($source);
$rgb=Imagick::CHANNEL_RED|Imagick::CHANNEL_GREEN|Imagick::CHANNEL_BLUE;
$assets=[];$checks=[];
$segmented=clone $sourceWhite;$segmentOK=$segmented->segmentImage(Imagick::COLORSPACE_RGB,5,5,false);
savePaletteView(palettePreview($segmented),'segment-preview.png');savePaletteView($sourceWhite,'source-preview8.png');
$negative=$sourceWhite->fxImage('1-u',$rgb);
$sequence=new Imagick();$sequence->addImage($sourceWhite);$sequence->addImage($negative);$sequence->setFirstIterator();
$quantizeOK=$sequence->quantizeImages(16,Imagick::COLORSPACE_SRGB,0,true,false);$states=paletteSequenceStates($sequence);
$sequence->setFirstIterator();foreach($sequence as $index=>$frame){$current=$sequence->getImage();$assets['first-frame'.$index]=paletteAsset($current,'first-frame'.$index);$checks['detached_frame'.$index]=$assets['first-frame'.$index]['native']['state']===$states[$index]['state'];}
$sequence->setFirstIterator();$cycled=$sequence->getImage();$paletteBefore=paletteEntries($cycled);$cycleOK=$cycled->cycleColormapImage(1);$assets['first-cycle']=paletteAsset($cycled,'first-cycle');
$checks['operations_return_true']=$segmentOK&&$quantizeOK&&$cycleOK;$checks['pair_has_distinct_rasters']=$states[0]['state']['RGBA8_hash']!==$states[1]['state']['RGBA8_hash'];$checks['saved_pair_distinct']=$assets['first-frame0']['reread']['state']['RGBA8_hash']!==$assets['first-frame1']['reread']['state']['RGBA8_hash'];$checks['cycle_keeps_native_palette']=$paletteBefore===paletteEntries($cycled);

$checks['source_unchanged']=$before===paletteState($source);
foreach($checks as $name=>$ok){if(!$ok){throw new RuntimeException('Check failed: '.$name);}}
$rects=savePaletteComparison([$sourceWhite,new Imagick(__DIR__.'/segment-preview.png'),paletteAssetView($assets['first-frame0']),paletteAssetView($assets['first-cycle'])], 'first-palette-sequence.png');
savePaletteDiagnostic('palette-sequence-first', ['source_before'=>$before,'source_after'=>paletteState($source),'panel_geometry'=>$rects,'assets'=>$assets,'checks'=>$checks]+['segment_return'=>$segmentOK,'quantize_return'=>$quantizeOK,'cycle_return'=>$cycleOK,'sequence_states'=>$states,'segmented_state'=>paletteState($segmented)]);
echo "first-palette-sequence.png\nsource-preview8.png\nsegment-preview.png\nfirst-frame0-indexed.png\nfirst-frame0-preview.png\nfirst-frame0-strip.png\nfirst-frame1-indexed.png\nfirst-frame1-preview.png\nfirst-frame1-strip.png\nfirst-cycle-indexed.png\nfirst-cycle-preview.png\nfirst-cycle-strip.png\nmetrics.json\n";
echo "segment=1 sequence=2 cycle=1 source-unchanged=1\n";

Исходный предмет остаётся узнаваемым. Отдельная копия группирует близкие цвета; последовательность двух иллюстраций получает совместно рассчитанную палитру; cycle создаёт намеренно необычный цветовой вариант. Вы получаете настоящие PNG, превью и полоски фактических палитр. Сохраните example.php и два дополнительных текстовых файла из архива в одной папке. Запустите php example.php с Imagick и PNG. Helper проверяет и восстанавливает собственный source.png; нужна запись в эту папку. Основные изображения и превью — настоящие PNG8/RGB либо явно названные PNG8/RGBA. Отдельные *-indexed.png — настоящие индексированные PNG3; они читаются снова самим Imagick, после чего сохраняется RGB8-превью. Helper не вызывает segmentImage, quantizeImages, quantizeImage или cycleColormapImage; все эти вызовы видны в программе.

<?php
declare(strict_types=1);
require __DIR__.'/palette-sequence-fixture.php';
restorePaletteInput();
$source=new Imagick(__DIR__.'/source.png');
$before=paletteState($source);$sourceWhite=palettePreview($source);
$rgb=Imagick::CHANNEL_RED|Imagick::CHANNEL_GREEN|Imagick::CHANNEL_BLUE;
$assets=[];$checks=[];
$rgbaSequence=new Imagick();$rgbaSequence->addImage($source);$rgbaSequence->setFirstIterator();$quantizeOK=$rgbaSequence->quantizeImages(16,Imagick::COLORSPACE_SRGB,0,true,false);$nativeRGBA=$rgbaSequence->getImage();
savePaletteView($nativeRGBA,'native-RGBA.png',true);$nativeRead=new Imagick(__DIR__.'/native-RGBA.png');savePaletteView(palettePreview($nativeRead),'native-white.png');savePaletteView(palettePreview($nativeRead,'#18333c'),'native-dark.png');
// Deliberately allow this labelled lossy policy control; normal deliveries reject translucent input.
$assets['forced-indexed']=paletteAsset($nativeRGBA,'forced-indexed',true);
$pattern=makePaletteAlphaPattern();$patternSequence=new Imagick();$patternSequence->addImage($pattern);$patternSequence->setFirstIterator();$patternSequence->quantizeImages(4,Imagick::COLORSPACE_SRGB,0,true,false);$patternBase=$patternSequence->getImage();$patternCycle=clone $patternBase;$cycleOK=$patternCycle->cycleColormapImage(1);
savePaletteView($patternBase,'pattern-base-RGBA.png',true);savePaletteView($patternCycle,'pattern-cycle-RGBA.png',true);savePaletteView(palettePreview(new Imagick(__DIR__.'/pattern-base-RGBA.png')),'pattern-base-white.png');savePaletteView(palettePreview(new Imagick(__DIR__.'/pattern-cycle-RGBA.png')),'pattern-cycle-white.png');
$errors=[];foreach(['segment'=>fn()=>(new Imagick())->segmentImage(Imagick::COLORSPACE_RGB,5,5,false),'quantize'=>fn()=>(new Imagick())->quantizeImages(16,Imagick::COLORSPACE_SRGB,0,true,false),'cycle'=>fn()=>(new Imagick())->cycleColormapImage(1)] as $name=>$call){try{$call();$errors[$name]=['thrown'=>false];}catch(ImagickException $e){$errors[$name]=['thrown'=>true,'class'=>get_class($e),'message'=>$e->getMessage()];}}
$checks['operations_return_true']=$quantizeOK&&$cycleOK;$checks['all_empty_errors_caught']=count(array_filter($errors,fn($e)=>$e['thrown']))===3;

$checks['source_unchanged']=$before===paletteState($source);
foreach($checks as $name=>$ok){if(!$ok){throw new RuntimeException('Check failed: '.$name);}}
$rects=savePaletteComparison([$sourceWhite,new Imagick(__DIR__.'/native-white.png'),paletteAssetView($assets['forced-indexed']),new Imagick(__DIR__.'/pattern-base-white.png'),new Imagick(__DIR__.'/pattern-cycle-white.png')], 'palette-boundaries.png');
savePaletteDiagnostic('palette-sequence-controls', ['source_before'=>$before,'source_after'=>paletteState($source),'panel_geometry'=>$rects,'assets'=>$assets,'checks'=>$checks]+['native_RGBA_state'=>paletteState($nativeRGBA),'native_RGBA_read_state'=>paletteState($nativeRead),'native_quantize_preserved_source_alpha'=>$before['alpha8_hash']===paletteHash($nativeRGBA,'A'),'pattern_source'=>paletteState($pattern),'pattern_base'=>paletteState($patternBase),'pattern_cycle'=>paletteState($patternCycle),'cycle_preserved_alpha'=>paletteHash($patternBase,'A')===paletteHash($patternCycle,'A'),'errors'=>$errors]);
echo "palette-boundaries.png\nnative-RGBA.png\nnative-white.png\nnative-dark.png\nforced-indexed-indexed.png\nforced-indexed-preview.png\nforced-indexed-strip.png\npattern-base-RGBA.png\npattern-cycle-RGBA.png\npattern-base-white.png\npattern-cycle-white.png\nmetrics.json\n";
echo "empty-errors=3 native-and-encoded-domains=separate source-unchanged=1\n";

Этот контроль показывает причину ограничений: quantize может изменить исходную alpha; cycle выбирает другую RGBA-ячейку, поэтому меняется и прозрачность. Принудительная PNG3-политика этой сборки даёт непрозрачное повторное чтение. PNG3 поддерживает tRNS; это не доказательство запрета прозрачности форматом. Сохраните example.php и два дополнительных текстовых файла из архива в одной папке. Запустите php example.php с Imagick и PNG. Helper проверяет и восстанавливает собственный source.png; нужна запись в эту папку. Основные изображения и превью — настоящие PNG8/RGB либо явно названные PNG8/RGBA. Отдельные *-indexed.png — настоящие индексированные PNG3; они читаются снова самим Imagick, после чего сохраняется RGB8-превью. Helper не вызывает segmentImage, quantizeImages, quantizeImage или cycleColormapImage; все эти вызовы видны в программе.

<?php
declare(strict_types=1);
require __DIR__.'/palette-sequence-fixture.php';
restorePaletteInput();
$source=new Imagick(__DIR__.'/source.png');
$before=paletteState($source);$sourceWhite=palettePreview($source);
$rgb=Imagick::CHANNEL_RED|Imagick::CHANNEL_GREEN|Imagick::CHANNEL_BLUE;
$assets=[];$checks=[];
$poster=clone $sourceWhite;
$ok=$poster->segmentImage(Imagick::COLORSPACE_RGB,5,5,false);
savePaletteView(palettePreview($poster),'poster-preview.png');
$checks['return_true']=$ok===true;$checks['same_geometry']=$poster->getImageWidth()===400&&$poster->getImageHeight()===320;

$checks['source_unchanged']=$before===paletteState($source);
foreach($checks as $name=>$ok){if(!$ok){throw new RuntimeException('Check failed: '.$name);}}
$rects=savePaletteComparison([$sourceWhite,new Imagick(__DIR__.'/poster-preview.png')], 'segment-minimal.png');
savePaletteDiagnostic('palette-sequence-segmentimage-minimal', ['source_before'=>$before,'source_after'=>paletteState($source),'panel_geometry'=>$rects,'assets'=>$assets,'checks'=>$checks]+['return_type'=>get_debug_type($ok),'return_value'=>$ok,'parameters'=>['colorspace'=>Imagick::COLORSPACE_RGB,'cluster_threshold'=>5.0,'smooth_threshold'=>5.0,'verbose'=>false],'before_state'=>paletteState($sourceWhite),'after_state'=>paletteState($poster)]);
echo "segment-minimal.png\nposter-preview.png\nmetrics.json\n";
echo "segment=1 geometry-kept=1 source-unchanged=1\n";

Один явный вызов создаёт плакатный вид без изменения ширины и высоты. Он ищет цветовые группы гистограммы, а не распознаёт предметы и не выдаёт маску кружки. Сохраните example.php и два дополнительных текстовых файла из архива в одной папке. Запустите php example.php с Imagick и PNG. Helper проверяет и восстанавливает собственный source.png; нужна запись в эту папку. Основные изображения и превью — настоящие PNG8/RGB либо явно названные PNG8/RGBA. Отдельные *-indexed.png — настоящие индексированные PNG3; они читаются снова самим Imagick, после чего сохраняется RGB8-превью. Helper не вызывает segmentImage, quantizeImages, quantizeImage или cycleColormapImage; все эти вызовы видны в программе.

<?php
declare(strict_types=1);
require __DIR__.'/palette-sequence-fixture.php';
restorePaletteInput();
$source=new Imagick(__DIR__.'/source.png');
$before=paletteState($source);$sourceWhite=palettePreview($source);
$rgb=Imagick::CHANNEL_RED|Imagick::CHANNEL_GREEN|Imagick::CHANNEL_BLUE;
$assets=[];$checks=[];
$presets=['gentle'=>[0.5,0.5],'bold'=>[5.0,5.0]];$views=[];$states=[];$sequence=new Imagick();
foreach($presets as $name=>[$cluster,$smooth]){$poster=clone $sourceWhite;$ok=$poster->segmentImage(Imagick::COLORSPACE_RGB,$cluster,$smooth,false);$checks[$name.'_return']=$ok===true;$states[$name]=paletteState($poster);savePaletteView(palettePreview($poster),$name.'-segmented.png');$views[$name]=new Imagick(__DIR__.'/'.$name.'-segmented.png');$sequence->addImage($poster);}
$sequence->setFirstIterator();$ok=$sequence->quantizeImages(16,Imagick::COLORSPACE_SRGB,0,true,false);$quantizedStates=paletteSequenceStates($sequence);$checks['quantize_return']=$ok===true;
$sequence->setFirstIterator();foreach($sequence as $index=>$frame){$current=$sequence->getImage();$assets['poster-frame'.$index]=paletteAsset($current,'poster-frame'.$index);$checks['detached_frame'.$index]=$assets['poster-frame'.$index]['native']['state']===$quantizedStates[$index]['state'];}

$checks['source_unchanged']=$before===paletteState($source);
foreach($checks as $name=>$ok){if(!$ok){throw new RuntimeException('Check failed: '.$name);}}
$rects=savePaletteComparison([$sourceWhite,$views['gentle'],$views['bold'],paletteAssetView($assets['poster-frame0']),paletteAssetView($assets['poster-frame1'])], 'segment-workflow.png');
savePaletteDiagnostic('palette-sequence-segmentimage-workflow', ['source_before'=>$before,'source_after'=>paletteState($source),'panel_geometry'=>$rects,'assets'=>$assets,'checks'=>$checks]+['presets'=>$presets,'segmented_states'=>$states,'sequence_states'=>$quantizedStates]);
echo "segment-workflow.png\ngentle-segmented.png\nbold-segmented.png\nposter-frame0-indexed.png\nposter-frame0-preview.png\nposter-frame0-strip.png\nposter-frame1-indexed.png\nposter-frame1-preview.png\nposter-frame1-strip.png\nmetrics.json\n";
echo "presets=2 indexed-deliveries=2 source-unchanged=1\n";

Два настоящих результата позволяют выбрать мягкую или крупную цветовую группировку. Затем отдельная quantizeImages готовит пару индексированных доставок; segmentation и palette quantization остаются разными операциями. Сохраните example.php и два дополнительных текстовых файла из архива в одной папке. Запустите php example.php с Imagick и PNG. Helper проверяет и восстанавливает собственный source.png; нужна запись в эту папку. Основные изображения и превью — настоящие PNG8/RGB либо явно названные PNG8/RGBA. Отдельные *-indexed.png — настоящие индексированные PNG3; они читаются снова самим Imagick, после чего сохраняется RGB8-превью. Helper не вызывает segmentImage, quantizeImages, quantizeImage или cycleColormapImage; все эти вызовы видны в программе.

<?php
declare(strict_types=1);
require __DIR__.'/palette-sequence-fixture.php';
restorePaletteInput();
$source=new Imagick(__DIR__.'/source.png');
$before=paletteState($source);$sourceWhite=palettePreview($source);
$rgb=Imagick::CHANNEL_RED|Imagick::CHANNEL_GREEN|Imagick::CHANNEL_BLUE;
$assets=[];$checks=[];
$negative=$sourceWhite->fxImage('1-u',$rgb);savePaletteView(palettePreview($negative),'negative-input.png');
$sequence=new Imagick();$sequence->addImage($sourceWhite);$sequence->addImage($negative);
$sequence->setFirstIterator();
$ok=$sequence->quantizeImages(16,Imagick::COLORSPACE_SRGB,0,true,false);
$states=paletteSequenceStates($sequence);$sequence->setFirstIterator();
foreach($sequence as $index=>$frame){$current=$sequence->getImage();$assets['joint-frame'.$index]=paletteAsset($current,'joint-frame'.$index);$checks['detached_frame'.$index]=$assets['joint-frame'.$index]['native']['state']===$states[$index]['state'];}
$checks['return_true']=$ok===true;$checks['two_frames']=$sequence->getNumberImages()===2;$checks['native_pair_distinct']=$states[0]['state']['RGBA8_hash']!==$states[1]['state']['RGBA8_hash'];$checks['saved_pair_distinct']=$assets['joint-frame0']['reread']['state']['RGBA8_hash']!==$assets['joint-frame1']['reread']['state']['RGBA8_hash'];

$checks['source_unchanged']=$before===paletteState($source);
foreach($checks as $name=>$ok){if(!$ok){throw new RuntimeException('Check failed: '.$name);}}
$rects=savePaletteComparison([$sourceWhite,new Imagick(__DIR__.'/negative-input.png'),paletteAssetView($assets['joint-frame0']),paletteAssetView($assets['joint-frame1'])], 'quantize-minimal.png');
savePaletteDiagnostic('palette-sequence-quantizeimages-minimal', ['source_before'=>$before,'source_after'=>paletteState($source),'panel_geometry'=>$rects,'assets'=>$assets,'checks'=>$checks]+['return_type'=>get_debug_type($ok),'return_value'=>$ok,'sequence_states'=>$states,'parameters'=>['number_colors'=>16,'colorspace'=>Imagick::COLORSPACE_SRGB,'tree_depth'=>0,'dither'=>true,'measure_error'=>false]]);
echo "quantize-minimal.png\nnegative-input.png\njoint-frame0-indexed.png\njoint-frame0-preview.png\njoint-frame0-strip.png\njoint-frame1-indexed.png\njoint-frame1-preview.png\njoint-frame1-strip.png\nmetrics.json\n";
echo "sequence=2 detached-files=2 source-unchanged=1\n";

В объект добавлены два действительно разных изображения. setFirstIterator выбирает начало перед совместным анализом, getImage извлекает именно текущий кадр для записи. Оба сохранённых результата должны различаться и соответствовать своим native состояниям. Сохраните example.php и два дополнительных текстовых файла из архива в одной папке. Запустите php example.php с Imagick и PNG. Helper проверяет и восстанавливает собственный source.png; нужна запись в эту папку. Основные изображения и превью — настоящие PNG8/RGB либо явно названные PNG8/RGBA. Отдельные *-indexed.png — настоящие индексированные PNG3; они читаются снова самим Imagick, после чего сохраняется RGB8-превью. Helper не вызывает segmentImage, quantizeImages, quantizeImage или cycleColormapImage; все эти вызовы видны в программе.

<?php
declare(strict_types=1);
require __DIR__.'/palette-sequence-fixture.php';
restorePaletteInput();
$source=new Imagick(__DIR__.'/source.png');
$before=paletteState($source);$sourceWhite=palettePreview($source);
$rgb=Imagick::CHANNEL_RED|Imagick::CHANNEL_GREEN|Imagick::CHANNEL_BLUE;
$assets=[];$checks=[];
$negative=$sourceWhite->fxImage('1-u',$rgb);$inputs=[$sourceWhite,$negative];
$whole=new Imagick();foreach($inputs as $input){$whole->addImage($input);}$whole->setFirstIterator();$ok=$whole->quantizeImages(16,Imagick::COLORSPACE_SRGB,0,true,true);$wholeStates=paletteSequenceStates($whole);$checks['whole_return']=$ok===true;
$whole->setFirstIterator();foreach($whole as $index=>$frame){$current=$whole->getImage();$assets['whole-frame'.$index]=paletteAsset($current,'whole-frame'.$index);$checks['detached_whole'.$index]=$assets['whole-frame'.$index]['native']['state']===$wholeStates[$index]['state'];}
$independentStates=[];foreach($inputs as $index=>$input){$single=clone $input;$ok=$single->quantizeImage(16,Imagick::COLORSPACE_SRGB,0,true,true);$checks['single_return'.$index]=$ok===true;$independentStates[]=paletteState($single);$assets['single-frame'.$index]=paletteAsset($single,'single-frame'.$index);}
$suffix=new Imagick();foreach($inputs as $input){$suffix->addImage($input);}$suffix->setIteratorIndex(1);$suffixBefore=paletteSequenceStates($suffix,false);$ok=$suffix->quantizeImages(16,Imagick::COLORSPACE_SRGB,0,true,false);$suffixAfter=paletteSequenceStates($suffix);$checks['suffix_return']=$ok===true;$checks['previous_frame_unchanged']=$suffixBefore[0]['state']===$suffixAfter[0]['state'];
$suffix->setFirstIterator();$untouched=$suffix->getImage();savePaletteView(palettePreview($untouched),'suffix-frame0.png');$suffix->setIteratorIndex(1);$current=$suffix->getImage();$assets['suffix-frame1']=paletteAsset($current,'suffix-frame1');$checks['detached_suffix1']=$assets['suffix-frame1']['native']['state']===$suffixAfter[1]['state'];
$checks['saved_whole_pair_distinct']=$assets['whole-frame0']['reread']['state']['RGBA8_hash']!==$assets['whole-frame1']['reread']['state']['RGBA8_hash'];

$checks['source_unchanged']=$before===paletteState($source);
foreach($checks as $name=>$ok){if(!$ok){throw new RuntimeException('Check failed: '.$name);}}
$rects=savePaletteComparison([$sourceWhite,paletteAssetView($assets['whole-frame0']),paletteAssetView($assets['whole-frame1']),paletteAssetView($assets['single-frame0']),paletteAssetView($assets['single-frame1'])], 'quantize-workflow.png');
savePaletteDiagnostic('palette-sequence-quantizeimages-workflow', ['source_before'=>$before,'source_after'=>paletteState($source),'panel_geometry'=>$rects,'assets'=>$assets,'checks'=>$checks]+['whole_states'=>$wholeStates,'independent_states'=>$independentStates,'suffix_before'=>$suffixBefore,'suffix_after'=>$suffixAfter,'measure_error_return_is_bool'=>get_debug_type($ok),'whole_native_palettes_equal'=>$wholeStates[0]['palette']===$wholeStates[1]['palette']]);
echo "quantize-workflow.png\nwhole-frame0-indexed.png\nwhole-frame0-preview.png\nwhole-frame0-strip.png\nwhole-frame1-indexed.png\nwhole-frame1-preview.png\nwhole-frame1-strip.png\nsingle-frame0-indexed.png\nsingle-frame0-preview.png\nsingle-frame0-strip.png\nsingle-frame1-indexed.png\nsingle-frame1-preview.png\nsingle-frame1-strip.png\nsuffix-frame0.png\nsuffix-frame1-indexed.png\nsuffix-frame1-preview.png\nsuffix-frame1-strip.png\nmetrics.json\n";
echo "whole=2 independent=2 suffix-start=1 earlier-frame-unchanged=1 source-unchanged=1\n";

Набор баннеров можно анализировать совместно либо отдельно. Сравниваются настоящие результаты обеих политик. Отдельный контроль начинает с индекса 1: кадр 0 остаётся прежним. measureError не превращает возвращаемый bool в число ошибки. Сохраните example.php и два дополнительных текстовых файла из архива в одной папке. Запустите php example.php с Imagick и PNG. Helper проверяет и восстанавливает собственный source.png; нужна запись в эту папку. Основные изображения и превью — настоящие PNG8/RGB либо явно названные PNG8/RGBA. Отдельные *-indexed.png — настоящие индексированные PNG3; они читаются снова самим Imagick, после чего сохраняется RGB8-превью. Helper не вызывает segmentImage, quantizeImages, quantizeImage или cycleColormapImage; все эти вызовы видны в программе.

<?php
declare(strict_types=1);
require __DIR__.'/palette-sequence-fixture.php';
restorePaletteInput();
$source=new Imagick(__DIR__.'/source.png');
$before=paletteState($source);$sourceWhite=palettePreview($source);
$rgb=Imagick::CHANNEL_RED|Imagick::CHANNEL_GREEN|Imagick::CHANNEL_BLUE;
$assets=[];$checks=[];
$sequence=new Imagick();$sequence->addImage($sourceWhite);$sequence->setFirstIterator();$ok=$sequence->quantizeImages(16,Imagick::COLORSPACE_SRGB,0,true,false);$base=$sequence->getImage();$assets['base']=paletteAsset($base,'base');
$variant=clone $base;$beforePalette=paletteEntries($variant);$cycleOK=$variant->cycleColormapImage(1);$assets['shift-one']=paletteAsset($variant,'shift-one');
$checks['operations_return_true']=$ok&&$cycleOK;$checks['native_palette_unchanged']=$beforePalette===paletteEntries($variant);$checks['visible_raster_changed']=paletteHash($base)!==paletteHash($variant);

$checks['source_unchanged']=$before===paletteState($source);
foreach($checks as $name=>$ok){if(!$ok){throw new RuntimeException('Check failed: '.$name);}}
$rects=savePaletteComparison([$sourceWhite,paletteAssetView($assets['base']),paletteAssetView($assets['shift-one'])], 'cycle-minimal.png');
savePaletteDiagnostic('palette-sequence-cyclecolormapimage-minimal', ['source_before'=>$before,'source_after'=>paletteState($source),'panel_geometry'=>$rects,'assets'=>$assets,'checks'=>$checks]+['cycle_return_type'=>get_debug_type($cycleOK),'cycle_return_value'=>$cycleOK,'displace'=>1,'native_before'=>paletteState($base),'native_after'=>paletteState($variant),'palette_before'=>$beforePalette,'palette_after'=>paletteEntries($variant)]);
echo "cycle-minimal.png\nbase-indexed.png\nbase-preview.png\nbase-strip.png\nshift-one-indexed.png\nshift-one-preview.png\nshift-one-strip.png\nmetrics.json\n";
echo "displace=1 native-colormap-unchanged=1 source-unchanged=1\n";

Новый вариант использует следующий цвет таблицы для каждого пикселя. Native таблица цветов остаётся прежней; меняется выбор ячейки. Это художественная перестановка, а не осмысленная замена заданного красного на заданный синий. Сохраните example.php и два дополнительных текстовых файла из архива в одной папке. Запустите php example.php с Imagick и PNG. Helper проверяет и восстанавливает собственный source.png; нужна запись в эту папку. Основные изображения и превью — настоящие PNG8/RGB либо явно названные PNG8/RGBA. Отдельные *-indexed.png — настоящие индексированные PNG3; они читаются снова самим Imagick, после чего сохраняется RGB8-превью. Helper не вызывает segmentImage, quantizeImages, quantizeImage или cycleColormapImage; все эти вызовы видны в программе.

<?php
declare(strict_types=1);
require __DIR__.'/palette-sequence-fixture.php';
restorePaletteInput();
$source=new Imagick(__DIR__.'/source.png');
$before=paletteState($source);$sourceWhite=palettePreview($source);
$rgb=Imagick::CHANNEL_RED|Imagick::CHANNEL_GREEN|Imagick::CHANNEL_BLUE;
$assets=[];$checks=[];
$sequence=new Imagick();$sequence->addImage($sourceWhite);$sequence->setFirstIterator();$sequence->quantizeImages(16,Imagick::COLORSPACE_SRGB,0,true,false);$base=$sequence->getImage();$palette=paletteEntries($base);$period=count($palette);$assets['variant-base']=paletteAsset($base,'variant-base');$states=[];
foreach(['minus-one'=>-1,'plus-one'=>1,'period'=>$period] as $name=>$displace){$variant=clone $base;$ok=$variant->cycleColormapImage($displace);$checks[$name.'_return']=$ok===true;$checks[$name.'_palette']=$palette===paletteEntries($variant);$states[$name]=['displace'=>$displace,'state'=>paletteState($variant)];$assets[$name]=paletteAsset($variant,$name);}
$inverse=clone $base;$inverse->cycleColormapImage(1);$inverse->cycleColormapImage(-1);$checks['inverse_native_RGBA_exact']=paletteHash($inverse)===paletteHash($base);$checks['period_native_RGBA_exact']=$states['period']['state']['RGBA8_hash']===paletteHash($base);

$checks['source_unchanged']=$before===paletteState($source);
foreach($checks as $name=>$ok){if(!$ok){throw new RuntimeException('Check failed: '.$name);}}
$rects=savePaletteComparison([$sourceWhite,paletteAssetView($assets['variant-base']),paletteAssetView($assets['minus-one']),paletteAssetView($assets['plus-one'])], 'cycle-variants.png');
savePaletteDiagnostic('palette-sequence-cyclecolormapimage-workflow', ['source_before'=>$before,'source_after'=>paletteState($source),'panel_geometry'=>$rects,'assets'=>$assets,'checks'=>$checks]+['native_base'=>paletteState($base),'native_palette'=>$palette,'native_palette_slots'=>$period,'variants'=>$states,'inverse_state'=>paletteState($inverse)]);
echo "cycle-variants.png\nvariant-base-indexed.png\nvariant-base-preview.png\nvariant-base-strip.png\nminus-one-indexed.png\nminus-one-preview.png\nminus-one-strip.png\nplus-one-indexed.png\nplus-one-preview.png\nplus-one-strip.png\nperiod-indexed.png\nperiod-preview.png\nperiod-strip.png\nmetrics.json\n";
echo "variants=3 inverse-exact=1 period-exact=1 source-unchanged=1\n";

Коллекция вариантов строится из одной detached-копии. Отрицательный сдвиг идёт назад; полный период считается по числу native ячеек, а не числу различных видимых цветов. +1 и−1 возвращают native RGBA этого подготовленного растра. Порядок saved PLTE проверяется отдельно. Сохраните example.php и два дополнительных текстовых файла из архива в одной папке. Запустите php example.php с Imagick и PNG. Helper проверяет и восстанавливает собственный source.png; нужна запись в эту папку. Основные изображения и превью — настоящие PNG8/RGB либо явно названные PNG8/RGBA. Отдельные *-indexed.png — настоящие индексированные PNG3; они читаются снова самим Imagick, после чего сохраняется RGB8-превью. Helper не вызывает segmentImage, quantizeImages, quantizeImage или cycleColormapImage; все эти вызовы видны в программе.