跳转到主要内容

基于图像的sorl-thumbnail水印

项目描述

sorl-watermark

sorl-watermark为sorl-thumbnail添加了添加水印的支持。

测试与以下版本兼容

  • Django 1.8, 1.9, 1.10, 1.11, 2.0, 2.1, 2.2, 3.0, 3.1和3.2。
  • sorl-Thumbnail 12.4, 12.5, 12.6和12.7。
  • Pillow 5, 6, 7和8。
  • Python 2.7, 3.5, 3.6, 3.7, 3.8和3.9。

当然,从水印图像到位置和透明度,一切都可以配置。

sorl-watermark不提供基于文本的水印生成支持。

设置

通过pip安装

$ pip install sorl-watermark

将sorl的缩略图引擎更改为sorl-watermark中的一个。支持PIL和imagemagick。

PIL

# PIL is the most well tested backend.
THUMBNAIL_ENGINE = 'sorl_watermarker.engines.pil_engine.Engine'

Pgmagick

# PIL is the most well tested backend.
THUMBNAIL_ENGINE = 'sorl_watermarker.engines.pgmagick_engine.Engine'

接下来,您需要指定用作水印的图像。请注意,此文件必须位于STATIC_ROOT内部。

THUMBNAIL_WATERMARK = 'my_watermark.png'

这就是简单设置的全部内容。只有在缩略图大小足够大时,引擎才会应用水印。

请参阅高级使用部分,了解动态更改水印本身、其大小或选择性应用水印的方法。

高级使用

sorl-watermark 为 {% thumbnail %} 模板标签添加了额外的选项。

以下是可以使用的新选项:

  • watermark=imagefile 此选项接受一个 ImageFile 并使用该文件代替默认水印文件,该文件通过 THUMBNAIL_WATERMARK 设置。
  • watermark_size="x200" 修改水印的大小。与 THUMBNAIL_WATERMARK_SIZE 选项具有相同的选项。
  • watermark_pos="north east" 指定水印应放置的位置。接受与 THUMBNAIL_WATERMARK_POSITION 设置相同的选项。
  • watermark_alpha=0.9 设置水印的不透明度。必须是介于 0 和 1 之间的值。

设置参考

以下设置可用:

  • THUMBNAIL_WATERMARK 设置用作水印的图像。文件必须在 STATIC_ROOT 内。

  • THUMBNAIL_WATERMARK_ALWAYS 在每个图像上盖章水印。默认值为 True

  • THUMBNAIL_WATERMARK_SIZE 修改水印的大小。这可以是几何字符串,如 sorl-thumbnail 中的常规用法("x200","200x200"),或百分比。如果给出百分比,水印始终是缩略图大小的给定百分比。

  • THUMBNAIL_WATERMARK_OPACITY 一个介于 0 到 1 之间的整数,指定水印的不透明度。默认值为 0(不透明)。

  • THUMBNAIL_WATERMARK_POSITION 指定水印的位置。您可以使用一对填充值(以像素为单位)指定位置,例如 "20 20" 将水印放置在左上角附近,"-20 -20" - 在右下角附近。或者,您可以指定以下位置:

    • "north"
    • "south"
    • "west"
    • "east"
    • "north east"
    • "south east"
    • "north west"
    • "south west"
    • "center"

    默认值:"south east"(右下角)

    如果您想完全使用水印填充图像,应设置:

    THUMBNAIL_WATERMARK_POSITION = 'tile'
    

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装软件包 的信息。

源代码分发

sorl-watermark-1.2.0.tar.gz (9.7 kB 查看散列

上传时间 源代码

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面