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

<?php
declare(strict_types=1);
require __DIR__ . '/fx-hald-fixture.php';
restoreFxHaldInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = fxHaldPreview($source);
$rgb = Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE;
$expression = 'u^0.8';
$before = fxHaldPixelHash($source);
$direct = $source->fxImage($expression, $rgb);
saveFxHaldPNG($direct, 'direct.png', true);
$identity = new Imagick(); $identity->newPseudoImage(216, 216, 'hald:6');
$look = $identity->fxImage($expression, $rgb);
saveFxHaldPNG($look, 'look16.png', false, 16);
$storedLook = new Imagick(__DIR__ . '/look16.png');
if ($storedLook->getImageColorspace() !== $source->getImageColorspace()) { throw new RuntimeException('LUT color space must match'); }
$result = clone $source; $result->haldClutImage($storedLook, $rgb);
saveFxHaldPNG($result, 'reapplied.png', true);
saveFxHaldPNG($storedLook, 'look-preview8.png');
$readDirect = new Imagick(__DIR__ . '/direct.png'); $readResult = new Imagick(__DIR__ . '/reapplied.png');
[$left, $right] = fxHaldMetricViews($direct, $result);
$rmse = $left->getImageDistortion($right, Imagick::METRIC_ROOTMEANSQUAREDERROR);
saveFxHaldPNG($sourceWhite, 'source-preview8.png');
saveFxHaldPNG(fxHaldPreview($readResult, '#243c4d'), 'reapplied-dark.png');
saveFxHaldComparison([$sourceWhite, fxHaldPreview($readDirect), fxHaldPreview($readResult)], 'fx-hald-first.png');
saveFxHaldDiagnostic('fx-hald-first', ['kind'=>'first','expression'=>$expression,'source'=>fxHaldState($source),'direct'=>fxHaldState($direct),'result'=>fxHaldState($result),'tables'=>['look16.png'=>fxHaldTableInfo($storedLook,6,'look-preview8.png',$look)],'metrics'=>['native_Q16_RMSE'=>$rmse],'metric_views'=>[fxHaldState($left),fxHaldState($right)],'LUT16_generated_native_hash'=>fxHaldPixelHash($look)]);
echo "fx-hald-first.png\ndirect.png\nlook16.png\nlook-preview8.png\nreapplied.png\nsource-preview8.png\nreapplied-dark.png\nmetrics.json\n";
printf("new-object=%d source-unchanged=%d LUT16-exact=%d alpha-preserved=%d\n", (int)($direct !== $source), (int)($before === fxHaldPixelHash($source)), (int)(fxHaldPixelHash($look) === fxHaldPixelHash($storedLook)), (int)(fxHaldPixelHash($source,'A',Imagick::PIXEL_CHAR) === fxHaldPixelHash($readResult,'A',Imagick::PIXEL_CHAR)));

Программа создаёт настоящие direct.png, look16.png и reapplied.png. Первый результат вычислен формулой, второй — прочитанной с диска Hald-таблицей. Таблица сохраняет Q16 значения в PNG16; её экранное preview — отдельный PNG8. При явной RGB-маске исходная прозрачность сохранена. Численное отличие приближения записано в metrics.json. Сохраните example.php, source.png.b64 и fx-hald-fixture.php из архива в одной папке. Запустите php example.php с расширением Imagick, PNG и HALD coder. Требуется запись в эту папку; все входы и рецепты локальные. Helper опубликован целиком: он восстанавливает собственный PNG, сохраняет результаты и готовит виды для просмотра, но не вызывает fxImage, haldClutImage или getImageDistortion. Эти три действия видны в самой программе.

<?php
declare(strict_types=1);
require __DIR__ . '/fx-hald-fixture.php';
restoreFxHaldInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = fxHaldPreview($source);
$rgb = Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE;
$expression = 'u^0.8';
$direct = $source->fxImage($expression, $rgb); $errors = []; $tables = []; $results = [];
foreach (['coarse16'=>[3,16], 'fine16'=>[6,16], 'fine8'=>[6,8]] as $name=>[$level,$depth]) {
    $edge = $level ** 3; $identity = new Imagick(); $identity->newPseudoImage($edge, $edge, 'hald:'.$level);
    $look = $identity->fxImage($expression, $rgb);
    saveFxHaldPNG($look, $name.'-lut.png', false, $depth);
    $lut = new Imagick(__DIR__ . '/'.$name.'-lut.png');
    $result = clone $source; $result->haldClutImage($lut, $rgb);
    saveFxHaldPNG($result, $name.'-result.png', true); saveFxHaldPNG($lut, $name.'-preview8.png');
    [$left,$right] = fxHaldMetricViews($direct,$result);
    $errors[$name] = $left->getImageDistortion($right, Imagick::METRIC_ROOTMEANSQUAREDERROR);
    $tables[$name.'-lut.png'] = fxHaldTableInfo($lut,$level,$name.'-preview8.png',$look);
    $results[$name] = $result;
    if ($name === 'fine16') { $fineLut = $lut; }
}
$default = clone $source; $default->haldClutImage($fineLut);
saveFxHaldPNG($default, 'default-mask.png', true);
saveFxHaldPNG(fxHaldPreview($results['fine16'],'#243c4d'), 'rgb-mask-dark.png');
saveFxHaldPNG(fxHaldPreview($default,'#243c4d'), 'default-mask-dark.png');
saveFxHaldComparison([$sourceWhite, fxHaldPreview($direct), fxHaldPreview(new Imagick(__DIR__.'/coarse16-result.png')), fxHaldPreview(new Imagick(__DIR__.'/fine16-result.png'))], 'fx-hald-controls.png');
$alphaSource=fxHaldPixelHash($source,'A',Imagick::PIXEL_CHAR);
saveFxHaldDiagnostic('fx-hald-controls', ['kind'=>'controls','expression'=>$expression,'tables'=>$tables,'metrics'=>['native_Q16_RMSE'=>$errors],'source'=>fxHaldState($source),'explicit_RGB'=>fxHaldState($results['fine16']),'default_mask'=>fxHaldState($default),'alpha_RGB_same'=>$alphaSource===fxHaldPixelHash($results['fine16'],'A',Imagick::PIXEL_CHAR),'alpha_default_same'=>$alphaSource===fxHaldPixelHash($default,'A',Imagick::PIXEL_CHAR)]);
echo "fx-hald-controls.png\ncoarse16-lut.png\ncoarse16-result.png\ncoarse16-preview8.png\nfine16-lut.png\nfine16-result.png\nfine16-preview8.png\nfine8-lut.png\nfine8-result.png\nfine8-preview8.png\ndefault-mask.png\nrgb-mask-dark.png\ndefault-mask-dark.png\nmetrics.json\n";
printf("fine16-better-grid=%d fine16-better-storage=%d RGB-alpha=%d default-alpha=%d\n", (int)($errors['fine16']<$errors['coarse16']), (int)($errors['fine16']<$errors['fine8']), (int)($alphaSource===fxHaldPixelHash($results['fine16'],'A',Imagick::PIXEL_CHAR)), (int)($alphaSource===fxHaldPixelHash($default,'A',Imagick::PIXEL_CHAR)));

Три настоящих результата разделяют два изменения: level3→level6 и PNG16→PNG8 при том же level6. Для выбранной формулы/исходника dense16 даёт меньшую измеренную ошибку. Это частный результат, не универсальная гарантия для любой таблицы. Дополнительный контроль показывает, что default Hald меняет alpha; RGB-маска в этой задаче её сохраняет. Сохраните example.php, source.png.b64 и fx-hald-fixture.php из архива в одной папке. Запустите php example.php с расширением Imagick, PNG и HALD coder. Требуется запись в эту папку; все входы и рецепты локальные. Helper опубликован целиком: он восстанавливает собственный PNG, сохраняет результаты и готовит виды для просмотра, но не вызывает fxImage, haldClutImage или getImageDistortion. Эти три действия видны в самой программе.

<?php
declare(strict_types=1);
require __DIR__ . '/fx-hald-fixture.php';
restoreFxHaldInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = fxHaldPreview($source);
$rgb = Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE;
$expression = 'u^0.8';
$before = fxHaldPixelHash($source);
$result = $source->fxImage('u^0.8', $rgb);
saveFxHaldPNG($result, 'fx-minimal.png', true);
$read = new Imagick(__DIR__ . '/fx-minimal.png');
saveFxHaldComparison([$sourceWhite, fxHaldPreview($read)], 'fx-minimal-comparison.png');
saveFxHaldDiagnostic('fx-hald-fximage-minimal', ['kind'=>'fx-minimal','expression'=>'u^0.8','source'=>fxHaldState($source),'native_result'=>fxHaldState($result),'saved_result'=>fxHaldState($read),'returns_new_object'=>$result!==$source]);
echo "fx-minimal-comparison.png\nfx-minimal.png\nmetrics.json\n";
printf("new-object=%d source-unchanged=%d alpha-preserved=%d\n", (int)($result!==$source), (int)($before===fxHaldPixelHash($source)), (int)(fxHaldPixelHash($source,'A',Imagick::PIXEL_CHAR)===fxHaldPixelHash($read,'A',Imagick::PIXEL_CHAR)));

fxImage вернул новый объект Imagick. В формуле u — нормированная компонента выбранного канала; степень 0.8 поднимает промежуточные значения 0<u<1 в текущем представлении. Источник не изменён, alpha исключена явной RGB-маской; самостоятельный PNG можно открыть после запуска. Сохраните example.php, source.png.b64 и fx-hald-fixture.php из архива в одной папке. Запустите php example.php с расширением Imagick, PNG и HALD coder. Требуется запись в эту папку; все входы и рецепты локальные. Helper опубликован целиком: он восстанавливает собственный PNG, сохраняет результаты и готовит виды для просмотра, но не вызывает fxImage, haldClutImage или getImageDistortion. Эти три действия видны в самой программе.

<?php
declare(strict_types=1);
require __DIR__ . '/fx-hald-fixture.php';
restoreFxHaldInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = fxHaldPreview($source);
$rgb = Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE;
$expression = 'u^0.8';
$recipes = ['lift'=>'u^0.8','soft-edges'=>'u*(0.45+0.55*max(0,1-hypot(i-w/2,j-h/2)/200))'];
$pointwise = $source->fxImage($recipes['lift'], $rgb);
$spatial = $source->fxImage($recipes['soft-edges'], $rgb);
$canvas = new Imagick(); $canvas->newPseudoImage(400, 320, 'xc:white');
$radialExpression = 'xx=i-w/2; yy=j-h/2; rr=hypot(xx,yy); (.5-rr/140)*1.2+.5';
$radial = $canvas->fxImage($radialExpression, $rgb);
saveFxHaldPNG($pointwise, 'recipe-lift.png', true); saveFxHaldPNG($spatial, 'recipe-spatial.png', true); saveFxHaldPNG($radial, 'radial.png');
saveFxHaldComparison([$sourceWhite, fxHaldPreview(new Imagick(__DIR__.'/recipe-lift.png')), fxHaldPreview(new Imagick(__DIR__.'/recipe-spatial.png')), new Imagick(__DIR__.'/radial.png')], 'fx-spatial-comparison.png');
saveFxHaldDiagnostic('fx-hald-fximage-workflow', ['kind'=>'fx-workflow','recipes'=>$recipes,'radial_expression'=>$radialExpression,'source'=>fxHaldState($source),'pointwise'=>fxHaldState($pointwise),'spatial'=>fxHaldState($spatial),'radial'=>fxHaldState($radial),'pointwise_transferable_to_Hald'=>true,'coordinate_recipe_transferable_to_Hald'=>false]);
echo "fx-spatial-comparison.png\nrecipe-lift.png\nrecipe-spatial.png\nradial.png\nmetrics.json\n";
printf("recipes=2 alpha-preserved=%d radial-size=%dx%d\n", (int)(fxHaldPixelHash($source,'A',Imagick::PIXEL_CHAR)===fxHaldPixelHash($spatial,'A',Imagick::PIXEL_CHAR)), $radial->getImageWidth(), $radial->getImageHeight());

Два доверенных рецепта решают разные задачи: первый зависит только от цвета, второй — ещё и от координат. Отдельный radial.png действительно сгенерирован на пустом холсте по пространственной формуле из официального примера. Пространственные эффекты нельзя переносить на произвольные картинки одной цветовой Hald-таблицей. Сохраните example.php, source.png.b64 и fx-hald-fixture.php из архива в одной папке. Запустите php example.php с расширением Imagick, PNG и HALD coder. Требуется запись в эту папку; все входы и рецепты локальные. Helper опубликован целиком: он восстанавливает собственный PNG, сохраняет результаты и готовит виды для просмотра, но не вызывает fxImage, haldClutImage или getImageDistortion. Эти три действия видны в самой программе.

<?php
declare(strict_types=1);
require __DIR__ . '/fx-hald-fixture.php';
restoreFxHaldInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = fxHaldPreview($source);
$rgb = Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE;
$expression = 'u^0.8';
$identity = new Imagick(); $identity->newPseudoImage(27, 27, 'hald:3');
saveFxHaldPNG($identity, 'identity16.png', false, 16);
$table = new Imagick(__DIR__ . '/identity16.png');
$result = clone $source;
$ok = $result->haldClutImage($table, $rgb);
saveFxHaldPNG($result, 'identity-result.png', true); saveFxHaldPNG($table, 'identity-preview8.png');
saveFxHaldComparison([$sourceWhite, fxHaldPreview(new Imagick(__DIR__.'/identity-result.png'))], 'hald-identity-comparison.png');
saveFxHaldDiagnostic('fx-hald-haldclutimage-minimal', ['kind'=>'hald-minimal','tables'=>['identity16.png'=>fxHaldTableInfo($table,3,'identity-preview8.png',$identity)],'source'=>fxHaldState($source),'native_result'=>fxHaldState($result),'saved_result'=>fxHaldState(new Imagick(__DIR__.'/identity-result.png')),'return_type'=>get_debug_type($ok),'return_value'=>$ok]);
echo "hald-identity-comparison.png\nidentity16.png\nidentity-result.png\nidentity-preview8.png\nmetrics.json\n";
printf("ok=%d table-size=%dx%d native-identity-exact=%d\n", (int)$ok, $table->getImageWidth(), $table->getImageHeight(), (int)(fxHaldPixelHash($source)===fxHaldPixelHash($result)));

Identity Hald отображает цвет в тот же цвет. В проверенной цепочке level3/PNG16 исходные Q16 компоненты и alpha сохранились точно. Таблица 27×27 — развёрнутый куб 9×9×9, не уменьшенная фотография. Метод меняет текущую рабочую копию и возвращает bool, а не новый объект. Сохраните example.php, source.png.b64 и fx-hald-fixture.php из архива в одной папке. Запустите php example.php с расширением Imagick, PNG и HALD coder. Требуется запись в эту папку; все входы и рецепты локальные. Helper опубликован целиком: он восстанавливает собственный PNG, сохраняет результаты и готовит виды для просмотра, но не вызывает fxImage, haldClutImage или getImageDistortion. Эти три действия видны в самой программе.

<?php
declare(strict_types=1);
require __DIR__ . '/fx-hald-fixture.php';
restoreFxHaldInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = fxHaldPreview($source);
$rgb = Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE;
$expression = 'u^0.8';
$identity = new Imagick(); $identity->newPseudoImage(216,216,'hald:6');
$recipe = $identity->fxImage($expression,$rgb);
saveFxHaldPNG($recipe,'recipe16.png',false,16);
$stored = new Imagick(__DIR__.'/recipe16.png');
saveFxHaldPNG($stored,'recipe-preview8.png');
$mirror = clone $source; $mirror->flopImage(); saveFxHaldPNG($mirror,'mirror-input.png',true);
$inputs=['original'=>$source,'mirror'=>$mirror]; $outputs=[];
foreach ($inputs as $name=>$input) {
    if ($input->getImageColorspace()!==$stored->getImageColorspace()) { throw new RuntimeException('LUT color space must match'); }
    $output=clone $input; $output->haldClutImage($stored,$rgb);
    saveFxHaldPNG($output,$name.'-graded.png',true); $outputs[$name]=$output;
}
$mirrorOfGraded=clone $outputs['original']; $mirrorOfGraded->flopImage();
saveFxHaldComparison([$sourceWhite,fxHaldPreview(new Imagick(__DIR__.'/original-graded.png')),fxHaldPreview($mirror),fxHaldPreview(new Imagick(__DIR__.'/mirror-graded.png'))],'hald-reuse-comparison.png');
saveFxHaldDiagnostic('fx-hald-haldclutimage-workflow',['kind'=>'hald-workflow','expression'=>$expression,'tables'=>['recipe16.png'=>fxHaldTableInfo($stored,6,'recipe-preview8.png',$recipe)],'source'=>fxHaldState($source),'mirror_input'=>fxHaldState($mirror),'original_result'=>fxHaldState($outputs['original']),'mirror_result'=>fxHaldState($outputs['mirror']),'mirror_commutes'=>fxHaldPixelHash($mirrorOfGraded)===fxHaldPixelHash($outputs['mirror'])]);
echo "hald-reuse-comparison.png\nrecipe16.png\nrecipe-preview8.png\nmirror-input.png\noriginal-graded.png\nmirror-graded.png\nmetrics.json\n";
printf("reused=2 mirror-consistent=%d alpha-preserved=%d\n",(int)(fxHaldPixelHash($mirrorOfGraded)===fxHaldPixelHash($outputs['mirror'])),(int)(fxHaldPixelHash($source,'A',Imagick::PIXEL_CHAR)===fxHaldPixelHash($outputs['original'],'A',Imagick::PIXEL_CHAR)));

Один файл recipe16.png прочитан и применён к двум локальным входам. Второй вход — намеренное зеркальное преобразование собственного исходника, а не заявка на тестирование чужих фотографий. Поскольку рецепт зависит только от цвета, перестановка пикселей и применение look дают согласованный результат. Alpha проверена отдельно. Сохраните example.php, source.png.b64 и fx-hald-fixture.php из архива в одной папке. Запустите php example.php с расширением Imagick, PNG и HALD coder. Требуется запись в эту папку; все входы и рецепты локальные. Helper опубликован целиком: он восстанавливает собственный PNG, сохраняет результаты и готовит виды для просмотра, но не вызывает fxImage, haldClutImage или getImageDistortion. Эти три действия видны в самой программе.

<?php
declare(strict_types=1);
require __DIR__ . '/fx-hald-fixture.php';
restoreFxHaldInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = fxHaldPreview($source);
$rgb = Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE;
$expression = 'u^0.8';
$changed = $source->fxImage($expression,$rgb);
[$left,$right] = fxHaldMetricViews($source,$changed);
$exactCopy=clone $left; $before=fxHaldPixelHash($left);
$zero=$left->getImageDistortion($exactCopy,Imagick::METRIC_ROOTMEANSQUAREDERROR);
$error=$left->getImageDistortion($right,Imagick::METRIC_ROOTMEANSQUAREDERROR);
$property=$left->getImageProperty('distortion');
saveFxHaldPNG($left,'metric-reference.png'); saveFxHaldPNG($exactCopy,'metric-copy.png'); saveFxHaldPNG($right,'metric-changed.png');
saveFxHaldComparison([$sourceWhite,new Imagick(__DIR__.'/metric-copy.png'),new Imagick(__DIR__.'/metric-changed.png')],'metric-minimal-comparison.png');
saveFxHaldDiagnostic('fx-hald-getimagedistortion-minimal',['kind'=>'metric-minimal','metrics'=>['copy_Q16_RMSE'=>$zero,'changed_Q16_RMSE'=>$error],'metric_views'=>[fxHaldState($left),fxHaldState($right)],'return_type'=>get_debug_type($error),'distortion_property'=>$property,'metric_source_pixels_unchanged'=>$before===fxHaldPixelHash($left)]);
echo "metric-minimal-comparison.png\nmetric-reference.png\nmetric-copy.png\nmetric-changed.png\nmetrics.json\n";
printf("copy=%.6f changed-positive=%d alpha-free=%d pixels-unchanged=%d\n",$zero,(int)($error>0),(int)(!$left->getImageAlphaChannel()&&!$right->getImageAlphaChannel()),(int)($before===fxHaldPixelHash($left)));

Точная копия даёт RMSE 0; изменённая картинка — положительное float-значение, записанное полностью в metrics.json. Перед сравнением получены одинаковые непрозрачные RGB-виды OVER-white с TRUECOLOR. Метод сохраняет служебное свойство distortion у сравниваемого объекта, но не меняет его пиксели. Сохраните example.php, source.png.b64 и fx-hald-fixture.php из архива в одной папке. Запустите php example.php с расширением Imagick, PNG и HALD coder. Требуется запись в эту папку; все входы и рецепты локальные. Helper опубликован целиком: он восстанавливает собственный PNG, сохраняет результаты и готовит виды для просмотра, но не вызывает fxImage, haldClutImage или getImageDistortion. Эти три действия видны в самой программе.

<?php
declare(strict_types=1);
require __DIR__ . '/fx-hald-fixture.php';
restoreFxHaldInput();
$source = new Imagick(__DIR__ . '/source.png');
$sourceWhite = fxHaldPreview($source);
$rgb = Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE;
$expression = 'u^0.8';
$direct=$source->fxImage($expression,$rgb); saveFxHaldPNG($direct,'metric-direct.png',true);
$errors=[]; $savedErrors=[]; $tables=[]; $results=[]; $best=null; $bestError=INF;
foreach (['coarse16'=>[3,16],'fine16'=>[6,16],'fine8'=>[6,8]] as $name=>[$level,$depth]) {
    $edge=$level ** 3; $identity=new Imagick(); $identity->newPseudoImage($edge,$edge,'hald:'.$level);
    $recipe=$identity->fxImage($expression,$rgb); saveFxHaldPNG($recipe,$name.'-lut.png',false,$depth);
    $table=new Imagick(__DIR__.'/'.$name.'-lut.png');
    $output=clone $source; $output->haldClutImage($table,$rgb);
    saveFxHaldPNG($output,$name.'-result.png',true); saveFxHaldPNG($table,$name.'-preview8.png');
    [$a,$b]=fxHaldMetricViews($direct,$output); $errors[$name]=$a->getImageDistortion($b,Imagick::METRIC_ROOTMEANSQUAREDERROR);
    [$savedA,$savedB]=fxHaldMetricViews(new Imagick(__DIR__.'/metric-direct.png'),new Imagick(__DIR__.'/'.$name.'-result.png'));
    $savedErrors[$name]=$savedA->getImageDistortion($savedB,Imagick::METRIC_ROOTMEANSQUAREDERROR);
    $results[$name]=$output; $tables[$name.'-lut.png']=fxHaldTableInfo($table,$level,$name.'-preview8.png',$recipe);
    if ($errors[$name]<$bestError) {$best=$name; $bestError=$errors[$name];}
}
$threshold=0.001;
[$reference,$coarse]=fxHaldMetricViews($direct,$results['coarse16']);
$difference=clone $reference; $difference->compositeImage($coarse,Imagick::COMPOSITE_DIFFERENCE,0,0);
$difference->evaluateImage(Imagick::EVALUATE_MULTIPLY,32,$rgb); saveFxHaldPNG($difference,'difference32.png');
saveFxHaldComparison([$sourceWhite,fxHaldPreview(new Imagick(__DIR__.'/metric-direct.png')),fxHaldPreview(new Imagick(__DIR__.'/coarse16-result.png')),new Imagick(__DIR__.'/difference32.png')],'metric-choice-comparison.png');
saveFxHaldDiagnostic('fx-hald-getimagedistortion-workflow',['kind'=>'metric-workflow','expression'=>$expression,'tables'=>$tables,'metrics'=>['native_Q16_RMSE'=>$errors,'saved_PNG8_RMSE'=>$savedErrors],'threshold'=>$threshold,'chosen'=>$best,'chosen_pass'=>$bestError<$threshold,'metric_views'=>[fxHaldState($reference),fxHaldState($coarse)],'difference'=>['filename'=>'difference32.png','factor'=>32,'operator'=>'native COMPOSITE_DIFFERENCE then EVALUATE_MULTIPLY; Q16 clamp before PNG8','domain'=>'native coarse16 and direct opaque TRUECOLOR white views']]);
echo "metric-choice-comparison.png\nmetric-direct.png\ncoarse16-lut.png\ncoarse16-result.png\ncoarse16-preview8.png\nfine16-lut.png\nfine16-result.png\nfine16-preview8.png\nfine8-lut.png\nfine8-result.png\nfine8-preview8.png\ndifference32.png\nmetrics.json\n";
printf("chosen=%s pass=%d coarse-pass=%d fine-pass=%d\n",$best,(int)($bestError<$threshold),(int)($errors['coarse16']<$threshold),(int)($errors['fine16']<$threshold));

Для собственной формулы выбирается вариант с меньшей RMSE по фиксированной политике. Порог 0.001 — правило этого проекта, не универсальная граница качества. В metrics.json раздельно сохранены Q16 измерения до PNG8-доставки и измерения повторно прочитанных PNG8. Последняя панель — реальная native разница coarse/direct, умноженная на 32 с отсечением: это не исходная ошибка в натуральном цвете. Сохраните example.php, source.png.b64 и fx-hald-fixture.php из архива в одной папке. Запустите php example.php с расширением Imagick, PNG и HALD coder. Требуется запись в эту папку; все входы и рецепты локальные. Helper опубликован целиком: он восстанавливает собственный PNG, сохраняет результаты и готовит виды для просмотра, но не вызывает fxImage, haldClutImage или getImageDistortion. Эти три действия видны в самой программе.