Jump to content

手册:$wgThumbnailBuckets

From mediawiki.org
This page is a translated version of the page Manual:$wgThumbnailBuckets and the translation is 100% complete.
缩略图设置: $wgThumbnailBuckets
用于加快缩略图渲染的中间缩略图尺寸列表。
引进版本:1.24.0​(Gerrit change 135008; git #7036e7b6
移除版本:仍在使用
允许的值:(正整数数组)
默认值:null

细节

当定义了 $wgThumbnailBuckets 时,MediaWiki 会使用中间缩略图来加快渲染速度。 $wgThumbnailBuckets 必须设置为一组缩略图的宽度列表;当需要生成新的缩略图时,MediaWiki 会寻找一个满足条件的“桶”(bucket):它的尺寸大于目标宽度 + $wgThumbnailMinimumBucketDistance ,且小于原始图像。然后系统会基于该中间缩略图缩放至目标尺寸,而不是直接从原始文件缩放。 这个过程是递归进行的:如果对应桶的中间缩略图不存在,就会先从下一个更大桶的中间缩略图生成。

这种机制会显著提升缩略图生成速度,尤其是在处理大图时。但它也会带来一定的质量损失,因为缩略图不再是一次性有损缩放的结果,而是多次链式有损缩放的结果。

文件处理器需要显式声明支持该功能,即通过 MediaHandler::supportsBucketing()。 目前只有 BitmapHandler 支持该功能。

参阅