Manual:$wgThumbnailBuckets

From MediaWiki.org
Jump to: navigation, search

Other languages:
English • ‎español • ‎日本語 • ‎polski
Thumbnail settings: $wgThumbnailBuckets
List of intermediary thumbnail sizes to use to speed up thumbnail rendering.
Introduced in version: 1.24.0 (Gerrit change 135008; git #7036e7b6)
Removed in version: still in use
Allowed values: an array of positive integers
Default value: null
Other settings: Alphabetical | By function

Details[edit]

When $wgThumbnailBuckets is defined, MediaWiki will use intermediary thumbnails to speed up thumbnail rendering. $wgThumbnailBuckets must be set to a list of thumbnail widths; whenever a new thumbnail needs to be rendered, MediaWiki will find the smallest bucket which is larger than the target width + $wgThumbnailMinimumBucketDistanceManual:$wgThumbnailMinimumBucketDistance but smaller than the original, and it will scale that thumbnail down to the target size instead of scaling down the original file. This is down recursively, i.e. if the intermediary thumbnail for that bucket does not exist, it will be created from the intermediary thumbnail for the next bucket.

This will increase thumbnail generation speed considerably, especially for large images, but it will cause some loss of quality as thumbnails are now the result of several chained lossy transformations instead of just one.

File handlers have to opt into using this feature via MediaHandler::supportsBucketing(). For now only BitmapHandler supports it.

See also[edit]