wiki.techinc.nl/tests/phpunit/includes/media/JpegPixelFormatTest.php
Brion Vibber a30bc4f7e0 Enable 4:2:0 chroma subsampling for JPEG thumbnails
* Add $wgJpegPixelFormat, default to 'yuv420'
* Implemented for ImageMagick via CLI and extension
* Currently ignored for other scaler backends
* Added test case to run when using ImageMagick

4:2:0 subsampling can save an average of 17% bandwidth
over 4:4:4 subsampling, at the cost of some artifacting
at sharp red or blue edges. This is usually not noticeable
in photographic images.

To restore the previous behavior, set to false:

  $wgJpegPixelFormat = false;

which will maintain the original file's pixel subsampling
settings in the thumbnail.

Can set explicitly to one of:

  'yuv444' - never subsample
  'yuv422' - subsample 2x horizontally, not vert
  'yuv420' - subsample 2x in both dimensions

Bug: T129128
Change-Id: Ib9cb36c3a7e6a69d66c11150ef4a1d02dbac2df5
2016-04-27 15:36:18 -07:00

115 lines
2.3 KiB
PHP

<?php
/**
* Tests related to JPEG chroma subsampling via $wgJpegPixelFormat setting.
*
* @group Media
* @group medium
*
* @todo covers tags
*/
class JpegPixelFormatTest extends MediaWikiMediaTestCase {
protected function setUp() {
parent::setUp();
}
/**
* Mark this test as creating thumbnail files.
*/
protected function createsThumbnails() {
return true;
}
/**
*
* @dataProvider providePixelFormats
*/
public function testPixelFormatRendering( $sourceFile, $pixelFormat, $samplingFactor ) {
global $wgUseImageMagick, $wgUseImageResize;
if ( !$wgUseImageMagick ) {
$this->markTestSkipped( "This test is only applicable when using ImageMagick thumbnailing" );
}
if ( !$wgUseImageResize ) {
$this->markTestSkipped( "This test is only applicable when using thumbnailing" );
}
$fmtStr = var_export( $pixelFormat, true );
$this->setMwGlobals( 'wgJpegPixelFormat', $pixelFormat );
$file = $this->dataFile( $sourceFile, 'image/jpeg' );
$params = [
'width' => 320,
];
$thumb = $file->transform( $params, File::RENDER_NOW | File::RENDER_FORCE );
$this->assertTrue( !$thumb->isError(), "created JPEG thumbnail for pixel format $fmtStr" );
$path = $thumb->getLocalCopyPath();
$this->assertTrue( is_string( $path ), "path returned for JPEG thumbnail for $fmtStr" );
$cmd = [
'identify',
'-format',
'%[jpeg:sampling-factor]',
$path
];
$retval = null;
$output = wfShellExec( $cmd, $retval );
$this->assertTrue( $retval === 0, "ImageMagick's identify command should return success" );
$expected = $samplingFactor;
$actual = trim( $output );
$this->assertEquals(
$expected,
trim( $output ),
"IM identify expects JPEG chroma subsampling \"$expected\" for $fmtStr"
);
}
public static function providePixelFormats() {
return [
// From 4:4:4 source file
[
'yuv444.jpg',
false,
'1x1,1x1,1x1'
],
[
'yuv444.jpg',
'yuv444',
'1x1,1x1,1x1'
],
[
'yuv444.jpg',
'yuv422',
'2x1,1x1,1x1'
],
[
'yuv444.jpg',
'yuv420',
'2x2,1x1,1x1'
],
// From 4:2:0 source file
[
'yuv420.jpg',
false,
'2x2,1x1,1x1'
],
[
'yuv420.jpg',
'yuv444',
'1x1,1x1,1x1'
],
[
'yuv420.jpg',
'yuv422',
'2x1,1x1,1x1'
],
[
'yuv420.jpg',
'yuv420',
'2x2,1x1,1x1'
]
];
}
}