============
**图片水印**
============


基本介绍
========

描述
-----

水印操作可以在图片上设置另外一张图片或者文字做为水印。水印类型分成图片水印和文字水印

接口
----

GET /${ObjectKey}?watermark HTTP/1.1

参数
----

.. list-table::
    :widths: 10 40 10
    :header-rows: 1

    * - 名称	
      - 描述
      - 是否必须
    * - watermark
      - 水印操作标志
      - 是
    * - type
      - 水印类型，1代表图片水印，2代表文字水印
      - 是
    * - gravity
      - 水印位置，详细见水印位置参数表，默认为：SouthEast
      - 否
    * - dissolve
      - 水印透明度,取值为1-100，默认为100（完全不透明）
      - 否
    * - dx
      - 横轴边距，单位:像素(px)，缺省值为10
      - 否
    * - dy
      - 竖轴边距，单位:像素(px)，缺省值为10
      - 否
    * - stripmeta
      - 是否去除元数据，1表示去除，0表示保留，默认为去除
      - 否

水印位置
--------

 .. image:: ../image/water_pos.png
 
* 其中靠边的Gravity其对应dx,dy起点为对应边，如NorthWest，NorthEast，SouthWest，SouthEast其对应的原点为四个顶点，向内延伸为正。
* 非靠边点，则以该模块和水印对象的中心点为原点，对应左右上下延伸分别为正负。

dx,dy原点对应九宫格里位置如下:

.. list-table::
    :widths: 10 40 40 40
    :header-rows: 1

    * - Gravity	
      - dx对应原点
      - dy对应原点
      - 备注
    * - northwest
      - 纵轴左侧0列，向右延伸为正
      - 横轴最顶部0行，向下延伸为正
      - dx,dy为0时，水印位于左上角
    * - north
      - 纵轴中心轴为水印部分纵轴中心中轴所在轴，向右延伸为正
      - 横轴最顶部行，向下延伸为正
      - dx,dy为0时水印位于顶部居中
    * - northeast
      - 纵轴最右侧列，向左延伸为正
      - 横轴最顶部行，向下延伸为正
      - dx,dy为0时，水印位于右上角
    * - west
      - 纵轴最左侧列，向右延伸为正
      - 横轴居中行为水印部分横轴中心轴所在轴，向下延伸为正
      - dx,dy为0时，水印位于左侧居中
    * - center
      - 纵轴中心轴为水印部分纵轴中心中轴所在列，向右延伸为正
      - 横轴居中行为水印部分横轴中心轴所在轴，向下延伸为正
      - dx,dy为0时，水印位于上下左右居中
    * - east
      - 纵轴最右侧列，向左延伸为正
      - 横轴居中行为水印部分横轴中心轴所在轴，向下延伸为正
      - dx,dy为0时，水印位于右侧居中
    * - southwest
      - 纵轴最右侧列，向左延伸为正
      - 横轴居中行为水印部分横轴中心轴所在轴，向下延伸为正
      - dx,dy为0时，水印位于右侧居中
    * - south
      - 纵轴中心轴为水印部分纵轴中心中轴所在轴，向右延伸为正
      - 横轴最底部0行，向上延伸为正
      - dx,dy为0时，水印位于底部居中
    * - southeast
      - 纵轴最右侧列，向左延伸为正
      - 横轴最底部0行，向上延伸为正
      - dx,dy为0时，水印位于底部居中
      
      

图片水印
============

请求query
---------

watermark&type=2&text=${text}&font=${font}&fontsize=${fontsize}&fontcolor=${color}&gravity=${gravity}&dissolve=${dissolve}&dx=${distanceX}&dy=${distanceY}


参数
-----

.. list-table::
    :widths: 10 40 10
    :header-rows: 1

    * - 名称	
      - 描述
      - 是否必须
    * - image
      - | 图片水印logo的object 名字（经过URL安全的Base64编码）。
        | Logo图片必须位于同一bucket下且存在，且边长不得超过4096
      - 是
      
示例
----

效果图：\ http://img-sample.nos-eastchina1.126.net/Koala2.jpg?watermark&type=1&dissolve=80&quality=100&gravity=north&image=Y2FydG9vbl9sb2dvLnBuZw==\

 .. image:: ../image/Koala_img.jpg


文字水印
============

请求query
---------

watermark&type=2&text=${text}&font=${font}&fontsize=${fontsize}&fontcolor=${color}&gravity=${gravity}&dissolve=${dissolve}&dx=${distanceX}&dy=${distanceY}


参数
-----

.. list-table::
    :widths: 10 40 10
    :header-rows: 1

    * - 名称	
      - 描述
      - 是否必须
    * - text
      - 水印文字内容（经过URL安全的Base64编码）
      - 是
    * - font
      - | 水印文字字体（经过URL安全的Base64编码），
        | 缺省为黑体.注意：中文水印必须指定中文字体。
      - 否
    * - fontsize
      - 水印文字大小，单位: 缇，等于1/20磅，默认大小为250，参考DPI为72,范围[20,+..]
      - 否
    * - fontcolor
      - | 水印文字颜色(经过URL安全的Base64编码)，RGB格式，可以是颜色名称（比如red）或十六进制（比如#FF0000），
        | 缺省为白色(white)
      - 否


水印字体
--------

中文字体

.. list-table::
    :widths: 10 20 10
    :header-rows: 1

    * - 参数	
      - 字体文件
      - 字体
    * - simfang
      - simfang.ttf
      - 仿宋
    * - simhei
      - simhei.ttf
      - 黑体
    * - simkai
      - simkai.ttf
      - 楷体
    * - simsum
      - simsun.ttc
      - 宋体
    * - msyh
      - msyh.ttf
      - 微软雅黑
    * - msyhbd
      - msyhdb.ttf
      - 微软雅黑(粗体)
      
其它字体

.. list-table::
    :widths: 10 20
    :header-rows: 1

    * - 参数	
      - 字体文件
    * - arial
      - arial.ttf
    * - comic
      - comic.ttf
    * - couri
      - couri.ttf
    * - georgia
      - georgia.ttf
    * - impact
      - impact.ttf
    * - times
      - times.ttf
    * - trebuc
      - trebuc.ttf
    * - verdana
      - verdana.ttf
      
      
示例
----

效果图：\ http://img-sample.nos-eastchina1.126.net/Koala2.jpg?watermark&type=2&text=Tk9TIOmdoOiwsQ==&fontsize=2500&fontcolor=cmVk&dissolve=30&gravity=north\

 .. image:: ../image/Koala_text.jpg