全部文档
当前文档
最近更新时间：2025-06-30 19:32:01
图片处理是金山云在数据存储的基础服务上提供的缩略图生成和水印添加的功能，每个Bucket支持创建100个图片样式。为了便于开发者使用，通过预先定义的图片处理样式可以极大缩短请求URL的长度，具有更好的可读性。
进入KS3控制台，点击XX桶（要创建缩略图的空间),点击图片处理页签，点击创建样式按钮。
点击新建图片样式后您将进入到缩略图样式创建阶段，在这个阶段您需要设置样式名称、缩略尺寸、自动旋转、居中裁剪、图片格式和图片质量。在图片样式生成窗口的右侧会显示原图的宽和高，在调整的样式的过程中效果图框内会实时显示缩略效果，通过标尺显示缩减以后的宽和高。
其中：
1）样式名称：该名称后期用于作为整个样式的别称被使用。
2）后缀匹配：图片后缀匹配到您设置的内容后，将应用该图片样式，如：您前缀中填写example，后缀中填写/png,则将所有png后缀的图片以example样式进行处理。
您样式名称中填写example，后缀中填写/w100，则将所有以/w100结尾的URL以example样式进行处理。
例如：图片URL为https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg，需要在URL后面加上/w100变为https://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg/w100 ，就会以example样式对您的图片进行处理。
注：开启后缀匹配后，预计5分钟内生效。
3）缩略尺寸规则：
只设置缩略宽，按照宽进行等比例缩放；
只设置缩略高，按照高进行等比例缩放；
设置宽和高，在没有设置短边优先的情况下按照长边进行等比例缩放；
设置宽和高，在设置短边优先的情况下按照短边进行等比例缩放；
居中裁剪，在进行缩放以后对超出设定范围外的进行居中裁剪，该裁剪只会发生在设定了缩略宽和高的情况下；
在设定了固定宽和高的情况下，选择裁剪会按照固定的宽和高居中裁剪。
4）旋转模式：可以选择不设置旋转、根据exif自动旋转、根据自定义角度旋转。
5）图片输出格式：图片可以保持原有格式，也可以选择您需要保存的格式，支持JPG、JPEG、PNG、GIF、WBMP、BMP等格式。
6）缩略图保存：用于兼容其他厂家的缩略图，如选择该项，假设上传文件名为picture.jpg,输入的图片后缀名为_200 * 150.jpg,则会根据设定的样式格式，在上传的bucket下自动生成一个picture.jpg__200 * 150.jpg的文件。
注意：如选择了原图保护功能，则缩略图保护功能不起作用，需要先关闭原图保护功能。
7）调整图片质量:可以降低生成图片的大小，调整图片质量会影响到图片的现实效果，需要根据需要合理调整。
8）选择不添加水印,如下图所示：
您可以给图片增加文字水印或者增加图片水印。可自定义项如下：
设置水印文字内容。注意：如果输入的文字超出图片能够显示的范围，则水印添加失败，请在输入时注意效果图的变化；
设置水印的透明度；
设置文字的字体、大小和颜色，字体的大小单位是缇（Twip），1 Twip = 96 DPI / 1440 TPI = 0.0666667 Pixels（像素）；
设置水印的位置。您可以通过设置X轴边距和Y轴边距来进行一步细调，x轴y轴边距分别指的是水印与图片边缘的水平和垂直距离。如下图：
缩略图+水印：
您可以对图片进行缩略的基础上再增加水印。缩略和水印的处理顺序是先进行缩略再增加水印。
纯净模式
