Erweiterung:VipsScaler

From mediawiki.org
This page is a translated version of the page Extension:VipsScaler and the translation is 43% complete.
MediaWiki-Erweiterungen
VipsScaler
Freigabestatus: stabil
Einbindung Medien
Beschreibung Erlaubt es, PNG- und JPEG-Bilder mit VIPS zu skalieren
Autor(en) Bryan Tong Minh (BryanDiskussion)
MediaWiki 1.19+
Datenbankänderungen Nein
Lizenz GNU General Public License 2.0 oder neuer
Herunterladen
README
  • $wgVipsCommand
  • $wgVipsOptions
  • $wgVipsTestExpiry
  • $wgVipsExposeTestPage
  • $wgVipsThumbnailerHost
  • vipsscaler-test
Quarterly downloads 16 (Ranked 134th)
Public wikis using 1,811 (Ranked 203rd)
Übersetze die VipsScaler-Erweiterung, wenn sie auf translatewiki.net verfügbar ist
Probleme Offene Aufgaben · Einen Fehler melden

The VipsScaler extension is a wrapper around VIPS, a free image processing software. VIPS is a set of image manipulation tools specially designed for speed and low memory usage. This is useful for resizing large PNGs, and it improves the appearance of shrunken JPEGs.

The extension shells out to the vips binary. It can be configured to scale only certain files (for example: big PNGs) by configuring $wgVipsOptions.

VIPS-Installation

VIPS installieren

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

If you want to build from source have a look at upstream documentation: https://libvips.github.io/libvips/install.html

(Wikimedia has packaged and uses a more recent version for Ubuntu 12.04 at apt.wikimedia.org)

macOS

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

VipsScaler-Erweiterung installieren

  • Install VIPS (see above)
  • Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens VipsScaler im Ordner extensions/ ablegen.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/VipsScaler
  • Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
    wfLoadExtension( 'VipsScaler' );
    
  • Navigate to Special:VipsTest to verify it is working and see the difference in output quality.
  • Yes Erledigt – Zu Special:Version in dem Wiki (bei Einstellung auf deutsch nach Spezial:Version) navigieren, um die erfolgreiche Installierung der Erweiterung zu überprüfen.

Konfiguration

$wgVipsCommand
path to the vips command (default: vips).
$wgVipsOptions
Options and conditions for images to be scaled with this scaler. Set to an array of arrays. The inner array contains a condition array, which contains a list of conditions that 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', which are parameters to gaussian sharpen matrix.
  • preconvert - Convert the file to a .v file first, which costs some space, but saves memory on the actual downsize
  • bilinear - Verwende im_resize_linear statt im_shrink
  • convolution - Apply specified convolution matrix
  • setcomment - Add an exif comment specifying the source of the file. Requires $wgExiv2Command to be set properly.
$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',
    ],
  ],
];