Wikimore

VipsScaler; Category:Stable extensions/zh
	Category:Media handling extensions/zh
描述	Allows to scale PNG and JPEG images using VIPS
作者	Bryan Tong Minh (Bryan留言)
MediaWiki	1.19+Category:Extensions with manual MediaWiki version/zh
	否
	GNU通用公眾授權條款2.0或更新版本
下載	下載 ; Git [?]: 浏览存储库 (GitHub); Gerrit代码; Git提交日誌; 下載原始碼(tarball壓縮); Category:Extensions in Wikimedia version control/zh; README
	$wgVipsCommand; $wgVipsOptions; $wgVipsTestExpiry; $wgVipsExposeTestPage; $wgVipsThumbnailerHost;
	添加权限 vipsscaler-test;
	BitmapHandlerCheckImageAreaCategory:BitmapHandlerCheckImageArea extensions/zh; BitmapHandlerTransformCategory:BitmapHandlerTransform extensions/zh;
	前往translatewiki.net翻譯VipsScaler
問題	开启的任务 ·

Category:GPL licensed extensions/zhCategory:All extensions/zh

The VipsScaler extension creates JPG and PNG thumbnails faster and at low memory usage. The extension replaces MediaWiki core's Media handlers for bitmaps, which default to ImageMagick. It is powered by the free image processing software VIPS, which speeds up resizing of large PNGs, and it improves the appearance of shrunken JPEGs.

The extension shells out to the VIPS binary. By configuring $wgVipsOptions, it can be configured to scale only certain files (for example, big PNG files).

Installation

VIPS

Install VIPS. It can be downloaded from https://libvips.github.io/libvips or your OS repository (see below).

Debian / Ubuntu

$ apt-get install libvips-tools

Mac OS X

$ brew install homebrew/science/vips
$ binary symlink is /usr/local/bin/vips

VipsScaler extension

Install VIPS
下载，并将解压后的VipsScaler移动到extensions/目录中。
开发者和代码贡献人员应从Git安装扩展，输入：
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/VipsScaler
```
将下列放置在您的LocalSettings.php 的底部：
```
wfLoadExtension( 'VipsScaler' );
```
Configure as required.
完成 – 在您的wiki上至Special:Version，以验证已成功安装。

$wgVipsCommand: Path to the "vips" command (default: /usr/bin/vips).

$wgVipsOptions: Options and conditions to scale images with this scaler (default: empty). Set to an array of arrays. The inner array contains a condition array, which contains a list of conditions the image should pass for it to be scaled with VIPS. Conditions are mimeType, minArea, maxArea, minShrinkFactor, maxShrinkFactor. The other items in the array are options. Options available are:

sharpen - Set to an array with keys 'radius' and 'sigma', parameters to the Gaussian sharpen matrix.
preconvert - Convert the file to a .v file first, which costs some space but saves memory on the actual downsize
bilinear - Use im_resize_linear instead of im_shrink
convolution - Apply specified convolution matrix
setcomment - Add an EXIF comment specifying the source of the file. Requires $wgExiv2Command to be set properly.

Example

$wgVipsOptions = [
  // Sharpen jpeg files which are shrunk more than 1.2
  [
    'conditions' => [
      'mimeType' => 'image/jpeg',
      'minShrinkFactor' => 1.2,
    ],
    'sharpen' => [
      'radius' => 0,
      'sigma' => 0.8
    ],
  ],
  // Other jpeg files
  [
    'conditions' =>[
      'mimeType' => 'image/jpeg',
    ],
    'sharpen' => false,
    'bilinear' => true,
  ],
  // Do a simple shrink for PNGs
  [
    'conditions' => [
      'mimeType' => 'image/png',
    ],
  ],
];

$wgVipsExposeTestPage

Allow testing via "Special:VipsTest", which lets you verify it is working and see the difference in output quality. (default: false).