手册:$wgThumbnailBuckets
Appearance
| 缩略图设置: $wgThumbnailBuckets | |
|---|---|
| 用于加快缩略图渲染的中间缩略图尺寸列表。 |
|
| 引进版本: | 1.24.0(Gerrit change 135008; git #7036e7b6) |
| 移除版本: | 仍在使用 |
| 允许的值: | (正整数数组) |
| 默认值: | null |
| 其他设置: 按首字母排序 | 按功能排序 | |
细节
当定义了 $wgThumbnailBuckets 时,MediaWiki 会使用中间缩略图来加快渲染速度。
$wgThumbnailBuckets 必须设置为一组缩略图的宽度列表;当需要生成新的缩略图时,MediaWiki 会寻找一个满足条件的“桶”(bucket):它的尺寸大于目标宽度 + $wgThumbnailMinimumBucketDistance,且小于原始图像。然后系统会基于该中间缩略图缩放至目标尺寸,而不是直接从原始文件缩放。
这个过程是递归进行的:如果对应桶的中间缩略图不存在,就会先从下一个更大桶的中间缩略图生成。
这种机制会显著提升缩略图生成速度,尤其是在处理大图时。但它也会带来一定的质量损失,因为缩略图不再是一次性有损缩放的结果,而是多次链式有损缩放的结果。
文件处理器需要显式声明支持该功能,即通过 MediaHandler::supportsBucketing()。
目前只有 BitmapHandler 支持该功能。