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

<?php
declare(strict_types=1);
require __DIR__.'/legacy-noise-average-fixture.php';
naRestore();
$clean=naClean();$before=naHash($clean);
$frames=naFrames();$frameHashes=naFrameHashes($frames);
$image=clone $frames[0];
$call=naCall('median3',fn()=>$image->medianFilterImage(3));
$result=naImage($image,$clean,'legacy-noise-average-median.png');
$input=naImage($frames[0],$clean,'median-noisy8.png');naSave($clean,'source-preview8.png');
naDiagnostic('legacy-noise-median-minimal',['executed_api'=>'medianFilterImage','radius'=>3,'call'=>naRecord($call),'images'=>['noisy'=>$input,'median'=>$result],
    'source_unchanged'=>naHash($clean)===$before,'input_frames_unchanged'=>naFrameHashes($frames)===$frameHashes,
    'checks'=>['true_two_warnings'=>$call['value']===true&&$call['deprecations']===2,
        'actual_change'=>naHash($image)!==naHash($frames[0]),'impulse_removed'=>$result['samples']['impulse1']['r']==1.0,
        'fixture_MAE_lower'=>$result['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE']<$input['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE'],
        'source_preserved'=>naHash($clean)===$before&&naFrameHashes($frames)===$frameHashes]]);
echo "legacy-noise-average-median.png\nsource-preview8.png\nmedian-noisy8.png\nmetrics.json\nmedian-radius=3 deprecations=2 impulse-removed=1 input-preserved=1\n";

В точке (27,45) чёрный дефект стал белым. MAE к известному учебному оригиналу уменьшилась с 1.9914 до 0.6366, но надпись MUG01 и тонкое подчёркивание повреждены. Очищенный результат не объявляется точным восстановлением. Каждый ZIP самостоятельный: example.php, пять PNG в base64 и legacy-noise-average-fixture.php. Распакуйте рядом и выполните php example.php. naRestore проверяет SHA и восстанавливает точные входы; шум не генерируется заново. naFrames открывает три кадра, naFreshSequence добавляет их копии в новый Imagick и ставит первый итератор; изучаемый averageImages остаётся виден в основном коде. naCall временно сохраняет только E_DEPRECATED и восстанавливает handler через finally. naImage измеряет объект до отдельной записи PNG8; naCompare составляет нативную полосу без масштабирования. Полный helper открыт в последнем разделе. Проверенная среда: PHP 8.3.6 / Imagick 3.7.0 / IM6.9.12-98 Q16, Ubuntu WSL; исполнение устаревших median/reduce в Windows IM7 не заявлено.

<?php
declare(strict_types=1);
require __DIR__.'/legacy-noise-average-fixture.php';
naRestore();
$clean=naClean();$before=naHash($clean);
$frames=naFrames();$frameHashes=naFrameHashes($frames);
$median=clone $frames[0];$reduce=clone $frames[0];
$calls['median']=naCall('median',fn()=>$median->medianFilterImage(3));
$calls['reduce']=naCall('reduce',fn()=>$reduce->reduceNoiseImage(3));
$sequence=naFreshSequence($frames);$sequence->setFirstIterator();
$calls['average']=naCall('average',fn()=>$sequence->averageImages());$mean=$calls['average']['value'];
$images=['clean'=>naImage($clean,$clean,'workflow-clean8.png'),'noisy'=>naImage($frames[0],$clean,'workflow-noisy8.png'),
    'median'=>naImage($median,$clean,'workflow-median8.png'),'reduce'=>naImage($reduce,$clean,'workflow-reduce8.png'),'mean'=>naImage($mean,$clean,'workflow-mean8.png')];
$rects=naCompare([$clean,$frames[0],$median,$reduce,$mean],'legacy-noise-average-workflow.png');
naDiagnostic('legacy-noise-average-workflow',['executed_apis'=>['medianFilterImage','reduceNoiseImage','averageImages'],'radius'=>3,'frame_count'=>3,
    'calls'=>array_map('naRecord',$calls),'images'=>$images,'panel_keys'=>['clean','noisy','median','reduce','mean'],'panel_geometry'=>$rects,
    'source_unchanged'=>naHash($clean)===$before,'input_frames_unchanged'=>naFrameHashes($frames)===$frameHashes,
    'checks'=>['median_success'=>$calls['median']['value']===true&&$calls['median']['deprecations']===2,
        'reduce_success_not_quality'=>$calls['reduce']['value']===true&&$calls['reduce']['deprecations']===2,
        'mean_new_object'=>$mean instanceof Imagick&&$mean!==$sequence&&$calls['average']['deprecations']===0,
        'median_fixture_MAE_lower'=>$images['median']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE']<$images['noisy']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE'],
        'reduce_fixture_MAE_higher'=>$images['reduce']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE']>$images['noisy']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE'],
        'mean_impulse_attenuated'=>naClose($images['mean']['samples']['impulse1']['r'],2/3),
        'source_preserved'=>naHash($clean)===$before&&naFrameHashes($frames)===$frameHashes]]);
echo "legacy-noise-average-workflow.png\nworkflow-clean8.png\nworkflow-noisy8.png\nworkflow-median8.png\nworkflow-reduce8.png\nworkflow-mean8.png\nmetrics.json\nmedian-MAE-lower=1 reduce-MAE-higher=1 mean-impulse-attenuated=1 input-preserved=1\n";

Сравнены известный чистый рисунок, повреждённый кадр, медиана, Nonpeak и среднее трёх выровненных кадров. Ни один bool не выбирает лучший вариант: учитываем точки, читаемость MUG01, тонкую линию и допустимые изменения. Каждый ZIP самостоятельный: example.php, пять PNG в base64 и legacy-noise-average-fixture.php. Распакуйте рядом и выполните php example.php. naRestore проверяет SHA и восстанавливает точные входы; шум не генерируется заново. naFrames открывает три кадра, naFreshSequence добавляет их копии в новый Imagick и ставит первый итератор; изучаемый averageImages остаётся виден в основном коде. naCall временно сохраняет только E_DEPRECATED и восстанавливает handler через finally. naImage измеряет объект до отдельной записи PNG8; naCompare составляет нативную полосу без масштабирования. Полный helper открыт в последнем разделе. Проверенная среда: PHP 8.3.6 / Imagick 3.7.0 / IM6.9.12-98 Q16, Ubuntu WSL; исполнение устаревших median/reduce в Windows IM7 не заявлено.

<?php
declare(strict_types=1);
require __DIR__.'/legacy-noise-average-fixture.php';
naRestore();
$clean=naClean();$before=naHash($clean);
$frames=naFrames();$frameHashes=naFrameHashes($frames);
$image=clone $frames[0];
$call=naCall('reduce3',fn()=>$image->reduceNoiseImage(3));
$result=naImage($image,$clean,'legacy-noise-average-reduce.png');
$input=naImage($frames[0],$clean,'reduce-noisy8.png');
naDiagnostic('legacy-noise-reduce-minimal',['executed_api'=>'reduceNoiseImage','radius'=>3,'call'=>naRecord($call),'images'=>['noisy'=>$input,'reduce'=>$result],
    'source_unchanged'=>naHash($clean)===$before,'input_frames_unchanged'=>naFrameHashes($frames)===$frameHashes,
    'checks'=>['true_two_warnings'=>$call['value']===true&&$call['deprecations']===2,
        'actual_change'=>naHash($image)!==naHash($frames[0]),'not_claimed_improvement'=>$result['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE']>$input['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE'],
        'impulse_can_remain'=>$result['samples']['impulse1']['r']==0.0,
        'source_preserved'=>naHash($clean)===$before&&naFrameHashes($frames)===$frameHashes]]);
echo "legacy-noise-average-reduce.png\nreduce-noisy8.png\nmetrics.json\nreduce-radius=3 returned=1 deprecations=2 fixture-error-increased=1 input-preserved=1\n";

Вызов вернул true и изменил картинку, однако точка (27,45) осталась чёрной, а MAE выросла примерно до 15.9989. Здесь reduceNoiseImage не улучшил исходник. Это полезный отрицательный результат, а не успешная очистка по одному имени метода. Каждый ZIP самостоятельный: example.php, пять PNG в base64 и legacy-noise-average-fixture.php. Распакуйте рядом и выполните php example.php. naRestore проверяет SHA и восстанавливает точные входы; шум не генерируется заново. naFrames открывает три кадра, naFreshSequence добавляет их копии в новый Imagick и ставит первый итератор; изучаемый averageImages остаётся виден в основном коде. naCall временно сохраняет только E_DEPRECATED и восстанавливает handler через finally. naImage измеряет объект до отдельной записи PNG8; naCompare составляет нативную полосу без масштабирования. Полный helper открыт в последнем разделе. Проверенная среда: PHP 8.3.6 / Imagick 3.7.0 / IM6.9.12-98 Q16, Ubuntu WSL; исполнение устаревших median/reduce в Windows IM7 не заявлено.

<?php
declare(strict_types=1);
require __DIR__.'/legacy-noise-average-fixture.php';
naRestore();
$clean=naClean();$before=naHash($clean);
$frames=naFrames();$frameHashes=naFrameHashes($frames);
$median=clone $frames[0];$reduce=clone $frames[0];
$calls['median']=naCall('median',fn()=>$median->medianFilterImage(3));
$calls['reduce']=naCall('reduce',fn()=>$reduce->reduceNoiseImage(3));
$sequence=naFreshSequence($frames);$sequence->setFirstIterator();
$calls['average']=naCall('average',fn()=>$sequence->averageImages());$mean=$calls['average']['value'];
$images=['clean'=>naImage($clean,$clean,'workflow-clean8.png'),'noisy'=>naImage($frames[0],$clean,'workflow-noisy8.png'),
    'median'=>naImage($median,$clean,'workflow-median8.png'),'reduce'=>naImage($reduce,$clean,'workflow-reduce8.png'),'mean'=>naImage($mean,$clean,'workflow-mean8.png')];
$rects=naCompare([$clean,$frames[0],$median,$reduce,$mean],'legacy-noise-average-workflow.png');
naDiagnostic('legacy-noise-average-workflow',['executed_apis'=>['medianFilterImage','reduceNoiseImage','averageImages'],'radius'=>3,'frame_count'=>3,
    'calls'=>array_map('naRecord',$calls),'images'=>$images,'panel_keys'=>['clean','noisy','median','reduce','mean'],'panel_geometry'=>$rects,
    'source_unchanged'=>naHash($clean)===$before,'input_frames_unchanged'=>naFrameHashes($frames)===$frameHashes,
    'checks'=>['median_success'=>$calls['median']['value']===true&&$calls['median']['deprecations']===2,
        'reduce_success_not_quality'=>$calls['reduce']['value']===true&&$calls['reduce']['deprecations']===2,
        'mean_new_object'=>$mean instanceof Imagick&&$mean!==$sequence&&$calls['average']['deprecations']===0,
        'median_fixture_MAE_lower'=>$images['median']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE']<$images['noisy']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE'],
        'reduce_fixture_MAE_higher'=>$images['reduce']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE']>$images['noisy']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE'],
        'mean_impulse_attenuated'=>naClose($images['mean']['samples']['impulse1']['r'],2/3),
        'source_preserved'=>naHash($clean)===$before&&naFrameHashes($frames)===$frameHashes]]);
echo "legacy-noise-average-workflow.png\nworkflow-clean8.png\nworkflow-noisy8.png\nworkflow-median8.png\nworkflow-reduce8.png\nworkflow-mean8.png\nmetrics.json\nmedian-MAE-lower=1 reduce-MAE-higher=1 mean-impulse-attenuated=1 input-preserved=1\n";

Сравнены известный чистый рисунок, повреждённый кадр, медиана, Nonpeak и среднее трёх выровненных кадров. Ни один bool не выбирает лучший вариант: учитываем точки, читаемость MUG01, тонкую линию и допустимые изменения. Каждый ZIP самостоятельный: example.php, пять PNG в base64 и legacy-noise-average-fixture.php. Распакуйте рядом и выполните php example.php. naRestore проверяет SHA и восстанавливает точные входы; шум не генерируется заново. naFrames открывает три кадра, naFreshSequence добавляет их копии в новый Imagick и ставит первый итератор; изучаемый averageImages остаётся виден в основном коде. naCall временно сохраняет только E_DEPRECATED и восстанавливает handler через finally. naImage измеряет объект до отдельной записи PNG8; naCompare составляет нативную полосу без масштабирования. Полный helper открыт в последнем разделе. Проверенная среда: PHP 8.3.6 / Imagick 3.7.0 / IM6.9.12-98 Q16, Ubuntu WSL; исполнение устаревших median/reduce в Windows IM7 не заявлено.

<?php
declare(strict_types=1);
require __DIR__.'/legacy-noise-average-fixture.php';
naRestore();
$clean=naClean();$before=naHash($clean);
$frames=naFrames();$frameHashes=naFrameHashes($frames);
$sequence=new Imagick();
$sequence->addImage(clone $frames[0]);$sequence->addImage(clone $frames[1]);$sequence->addImage(clone $frames[2]);
$sequence->setFirstIterator();$iteratorBefore=$sequence->getIteratorIndex();
$call=naCall('average',fn()=>$sequence->averageImages());
$mean=$call['value'];
$result=naImage($mean,$clean,'legacy-noise-average-average.png');
foreach($frames as $index=>$frame){naSave($frame,'average-frame'.($index+1).'-8.png');}
naDiagnostic('legacy-noise-average-minimal',['executed_api'=>'averageImages','call'=>naRecord($call),'images'=>['mean'=>$result],
    'sequence'=>['count'=>$sequence->getNumberImages(),'iterator_before'=>$iteratorBefore,'iterator_after'=>$sequence->getIteratorIndex()],
    'returned_new_object'=>$mean!==$sequence,'input_frames_unchanged'=>naFrameHashes($frames)===$frameHashes,'source_unchanged'=>naHash($clean)===$before,
    'checks'=>['new_single_image'=>$mean instanceof Imagick&&$mean!==$sequence&&$mean->getNumberImages()===1,
        'three_frames_first_iterator'=>$sequence->getNumberImages()===3&&$iteratorBefore===0&&$sequence->getIteratorIndex()===0,
        'no_runtime_deprecation'=>$call['deprecations']===0,'same_coordinate_mean'=>naClose($result['samples']['impulse1']['r'],2/3),
        'fixture_max_error_85'=>$result['error_to_clean_PIXEl_CHAR_before_PNG8']['max']===85,
        'source_preserved'=>naHash($clean)===$before&&naFrameHashes($frames)===$frameHashes]]);
echo "legacy-noise-average-average.png\naverage-frame1-8.png\naverage-frame2-8.png\naverage-frame3-8.png\nmetrics.json\nframes=3 result-images=1 returned-new=1 iterator=0 input-preserved=1\n";

Один Imagick содержит три кадра; averageImages без параметров вернул отдельный объект с одним кадром 400 × 320. В точке (27,45) среднее black/white/white равно 2/3. Точки стали менее контрастными, но не исчезли; подпись и подчёркивание сохраняются лучше, чем после медианы. Каждый ZIP самостоятельный: example.php, пять PNG в base64 и legacy-noise-average-fixture.php. Распакуйте рядом и выполните php example.php. naRestore проверяет SHA и восстанавливает точные входы; шум не генерируется заново. naFrames открывает три кадра, naFreshSequence добавляет их копии в новый Imagick и ставит первый итератор; изучаемый averageImages остаётся виден в основном коде. naCall временно сохраняет только E_DEPRECATED и восстанавливает handler через finally. naImage измеряет объект до отдельной записи PNG8; naCompare составляет нативную полосу без масштабирования. Полный helper открыт в последнем разделе. Проверенная среда: PHP 8.3.6 / Imagick 3.7.0 / IM6.9.12-98 Q16, Ubuntu WSL; исполнение устаревших median/reduce в Windows IM7 не заявлено.

<?php
declare(strict_types=1);
require __DIR__.'/legacy-noise-average-fixture.php';
naRestore();
$clean=naClean();$before=naHash($clean);
$frames=naFrames();$frameHashes=naFrameHashes($frames);
$median=clone $frames[0];$reduce=clone $frames[0];
$calls['median']=naCall('median',fn()=>$median->medianFilterImage(3));
$calls['reduce']=naCall('reduce',fn()=>$reduce->reduceNoiseImage(3));
$sequence=naFreshSequence($frames);$sequence->setFirstIterator();
$calls['average']=naCall('average',fn()=>$sequence->averageImages());$mean=$calls['average']['value'];
$images=['clean'=>naImage($clean,$clean,'workflow-clean8.png'),'noisy'=>naImage($frames[0],$clean,'workflow-noisy8.png'),
    'median'=>naImage($median,$clean,'workflow-median8.png'),'reduce'=>naImage($reduce,$clean,'workflow-reduce8.png'),'mean'=>naImage($mean,$clean,'workflow-mean8.png')];
$rects=naCompare([$clean,$frames[0],$median,$reduce,$mean],'legacy-noise-average-workflow.png');
naDiagnostic('legacy-noise-average-workflow',['executed_apis'=>['medianFilterImage','reduceNoiseImage','averageImages'],'radius'=>3,'frame_count'=>3,
    'calls'=>array_map('naRecord',$calls),'images'=>$images,'panel_keys'=>['clean','noisy','median','reduce','mean'],'panel_geometry'=>$rects,
    'source_unchanged'=>naHash($clean)===$before,'input_frames_unchanged'=>naFrameHashes($frames)===$frameHashes,
    'checks'=>['median_success'=>$calls['median']['value']===true&&$calls['median']['deprecations']===2,
        'reduce_success_not_quality'=>$calls['reduce']['value']===true&&$calls['reduce']['deprecations']===2,
        'mean_new_object'=>$mean instanceof Imagick&&$mean!==$sequence&&$calls['average']['deprecations']===0,
        'median_fixture_MAE_lower'=>$images['median']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE']<$images['noisy']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE'],
        'reduce_fixture_MAE_higher'=>$images['reduce']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE']>$images['noisy']['error_to_clean_PIXEl_CHAR_before_PNG8']['MAE'],
        'mean_impulse_attenuated'=>naClose($images['mean']['samples']['impulse1']['r'],2/3),
        'source_preserved'=>naHash($clean)===$before&&naFrameHashes($frames)===$frameHashes]]);
echo "legacy-noise-average-workflow.png\nworkflow-clean8.png\nworkflow-noisy8.png\nworkflow-median8.png\nworkflow-reduce8.png\nworkflow-mean8.png\nmetrics.json\nmedian-MAE-lower=1 reduce-MAE-higher=1 mean-impulse-attenuated=1 input-preserved=1\n";

Сравнены известный чистый рисунок, повреждённый кадр, медиана, Nonpeak и среднее трёх выровненных кадров. Ни один bool не выбирает лучший вариант: учитываем точки, читаемость MUG01, тонкую линию и допустимые изменения. Каждый ZIP самостоятельный: example.php, пять PNG в base64 и legacy-noise-average-fixture.php. Распакуйте рядом и выполните php example.php. naRestore проверяет SHA и восстанавливает точные входы; шум не генерируется заново. naFrames открывает три кадра, naFreshSequence добавляет их копии в новый Imagick и ставит первый итератор; изучаемый averageImages остаётся виден в основном коде. naCall временно сохраняет только E_DEPRECATED и восстанавливает handler через finally. naImage измеряет объект до отдельной записи PNG8; naCompare составляет нативную полосу без масштабирования. Полный helper открыт в последнем разделе. Проверенная среда: PHP 8.3.6 / Imagick 3.7.0 / IM6.9.12-98 Q16, Ubuntu WSL; исполнение устаревших median/reduce в Windows IM7 не заявлено.