使用(Usage)

1. 图像处理参数

• 斜线 / 隔开，区分不同的操作；
• 逗号 , 隔开，区分操作中不同的参数；
• 下划线 _ 隔开，key_value 的形式，区分参数的Key和Value；
• value是复杂参数时，需要进行base64url_encode，是否需要encode查看文档参数详细说明；

1.1 图像保存时需要的参数

注意：多个操作key放在一起说明，使用都需要/隔开；从1.2开始都是单个操作说明；

示例：

• format,webp webp能节省图像大小；
• format,png 需要透明度使用png格式；
• interlace,1/quality,70/format,jpeg 设置为质量75渐近显示的jpeg图像

1.2 缩放 resize

注意：settings.PROCESSOR_MAX_W_H 默认值为 30000。

示例：

• resize,m_fixed,w_1000,h_1000,l_700 其中l优先级低不会生效，原图1980x1080会强制缩放成1000x1000的图像

1.3 裁剪 crop

示例：

• crop,ratio_4:3,g_center 原图是500x300会居中裁剪成400x300
• crop,x_25,y_25,w_50,h_50,pf_xywh 原图是500x400根据百分比计算，会居中裁剪成250x200
• crop,x_10,y_10,padr_10,padb_10 原图四周裁剪10像素

1.4 圆角 circle

注意：一般结合format,png使用，否则无透明度；

示例：

• circle/format,png 不设置r值，原图800x800，会裁剪成圆形，尺寸还是800x800；
• circle,r_10/format,png 原图800x800，原图四角有半径为10的圆角；
• circle,r_1000/format,png 原图800x800，r值超过边界，结果输出圆形图像；

1.5 模糊效果 blur

示例：

• blur,r_2

1.6 旋转 rotate

注意：该操作参数无key，直接逗号后跟数值即可

示例：

• rotate 相当于 rotate,0，不旋转
• rotate,90 图像顺时针旋转90度
• rotate,45 图像顺时针旋转45度，会改变原有图像宽高比

1.7 透明度 alpha

注意：该操作参数无key，直接逗号后跟数值即可；若原图非png图像，需结合format,png使用

示例：

• alpha 相当于 alpha,100，完全不透明
• alpha,0 图像完全透明
• alpha,50/format,png 图像透明度50%

1.8 灰度图 gray

无任何参数

示例：

• gray 图像会置灰
• gray/format,jpeg/quality,75 一般会结合转换成jpeg并设置质量减少原图大小（非强制）

1.9 水印 watermark

示例：

• watermark,text_SGVsbG8g5LiW55WM,color_FFFFFF,size_80 文字水印其中SGVsbG8g5LiW55WM是Hello 世界编码后的

1.10 合并图像 merge

注： 参数 bg 取值 1 时，order之后的参数则是：图像在image上的坐标/数值。

示例：

• merge,image_dGVzdHMvaW1ncy9sZW5uYS00MDB4MjI1LmpwZw,g_ne,color_FFFF/format,png 其中image是tests/imgs/lenna-400x225.jpg编码后的，FFFF 表示填充全透明

2. 图像处理函数

31
32
33
34
35
36
37
38
39
40
41
42
43
44

class OpAction(ChoiceEnum):
    """支持的操作类型"""

    # 其他
    RESIZE = ("resize", "缩放")
    CROP = ("crop", "裁剪")
    CIRCLE = ("circle", "圆角")
    BLUR = ("blur", "模糊效果")
    ROTATE = ("rotate", "旋转")
    ALPHA = ("alpha", "透明度")
    GRAY = ("gray", "灰度图")
    WATERMARK = ("watermark", "水印")
    # 特殊操作
    MERGE = ("merge", "合并图像")

47
48
49
50
51
52
53
54

class ResizeMode(ChoiceEnum):
    """图像缩放的模式"""

    LFIT = ("lfit", "等比缩放，缩放图限制为指定w与h的矩形内的最大图片")  # 类似 ImageOps.contain
    MFIT = ("mfit", "等比缩放，缩放图为延伸出指定w与h的矩形框外的最小图片")  # 类似 ImageOps.cover
    FIT = ("fit", "将原图等比缩放为延伸出指定w与h的矩形框外的最小图片，然后将超出的部分进行居中裁剪")  # ImageOps.fit
    PAD = ("pad", "将原图缩放为指定w与h的矩形内的最大图片，然后使用指定颜色居中填充空白部分")  # ImageOps.pad
    FIXED = ("fixed", "固定宽高，强制缩放")

65
66
67
68
69
70
71
72
73
74
75
76

class Geography(ChoiceEnum):
    """图像中的九宫格位置"""

    NW = ("nw", "左上")
    NORTH = ("north", "中上")
    NE = ("ne", "右上")
    WEST = ("west", "左中")
    CENTER = ("center", "中部")
    EAST = ("east", "右中")
    SW = ("sw", "左下")
    SOUTH = ("south", "中下")
    SE = ("se", "右下")

79
80
81
82
83

class PositionOrder(ChoiceEnum):
    """两个元素的前后顺序"""

    BEFORE = (0, "第一输入元素在前/在上")  # 图片在前
    AFTER = (1, "第一个输入元素在后/在下")  # 文字在前

86
87
88
89
90
91
92
93
94

class PositionAlign(ChoiceEnum):
    """两个元素的对齐方式"""

    TOP = (0, "水平上对齐")
    HORIZONTAL_CENTER = (1, "水平居中对齐")
    BOTTOM = (2, "水平下对齐")
    LEFT = (3, "垂直左对齐")
    VERTIAL_CENTER = (4, "垂直居中对齐")
    RIGHT = (5, "垂直右对齐")

 6
 7
 8
 9
10
11

class ImageFormat(ChoiceEnum):
    """图像转换的格式"""

    JPEG = ("JPEG", "JPEG")
    PNG = ("PNG", "PNG")
    WEBP = ("WEBP", "WebP")