Products.WatermarkImage 1.0

数据存储

WatermarkImage实例接收原始图像数据，将其存储在实例中，并生成一个水印图像以及一个缩略图，这些图像也存储在实例中。水印图像作为主图像存储，因此所有正常的图像访问都将返回水印图像。缩略图是水印图像的缩放副本。

缩略图支持

每当创建或更新WatermarkImage时，都会生成一个缩略图。可以使用ZMI（Zope管理界面）在《缩略图》标签下查看缩略图数据。可以通过在WatermarkImage URL中添加《/thumbnail.jpg》来访问其数据。可以使用新的方法《tag_thumbnail》生成缩略图像的HTML《img》标签，其参数与标准Zope Image的《tag》方法相同。

以下WatermarkImage属性会影响缩略图生成

• 最大缩略图高度（像素）：生成缩略图的最大高度。缩略图将保持原始图像的高度/宽度比例，因此实际缩略图高度可能小于此处指定的最大高度。

• 最大缩略图宽度（像素）：生成缩略图的最大宽度。缩略图将保持原始图像的高度/宽度比例，因此实际缩略图宽度可能小于此处指定的最大宽度。

如果您通过ZMI的《属性》标签更改了这些属性中的任何一个，缩略图将自动重新生成以反映新值。

水印支持

如果用户指定要创建带水印的图像，则将任何图像上传到WatermarkImage实例以及《属性》标签上的属性更新都将生成原始图像的水印副本。可以使用ZMI在《编辑原始》标签上查看原始图像数据。通过在WatermarkImage URL中添加《/original》可以访问其数据。可以使用新的方法《tag_original》生成原始图像的HTML《img》标签，其参数与OFS.Image的《tag》方法相同。

原始图像的访问受名为《WatermarkImage: View original》的新Zope权限保护。默认情况下，此权限仅授予Zope的《Manager》角色。您可以使用ZMI的《安全》标签更改此默认设置。

以下WatermarkImage属性影响水印支持

• 水印ID：包含要放置在图像上的实际水印的Zope图像实例的Zope ID。

• 水印不透明度：不透明度值决定了水印在带水印图像上显示的透明度。其值必须在0到1之间。不透明度0将创建透明的水印，而不透明度1将应用水印图像，不进行任何透明度处理。

• 水印使用：选择是否完全不创建水印（《none》），在图像的特定位置放置单个水印（《position》），尽可能多地平铺水印图像（《tile》）或将单个水印放置在图像上，并按原始图像大小缩放（《scale》）。

• 水印在X轴上的位置：仅在《水印使用》下选择《position》时适用。水印的左上角将根据此处设置的数量像素进一步向右放置。如果您指定负值，则放置将由从原始图像宽度中减去提供的值来确定，以便允许右对齐放置。

• 水印在Y轴上的位置：仅在《水印使用》下选择《position》时适用。水印的左上角将根据此处设置的数量像素进一步向下放置。如果您指定负值，则放置将由从原始图像高度中减去提供的值来确定，以便允许底对齐放置。

如果您通过ZMI的《properties》标签更改了这些属性中的任何一个，带水印的图像和缩略图将自动重新生成以反映新值。

更改配置默认值

用户可以针对每个实例配置一些设置，这些设置会影响缩略图和带水印图像的生成。但是，为每个WatermarkImage实例这样做是繁琐的。相反，可以在Zope实例的《zope.conf》配置文件中定义一组配置默认值。只需添加一个名为《product-config watermarkimage》的段落并定义新的默认值。

<product-config watermarkimage>
  watermark_use position
  watermark_position_x 100
  watermark_position_y -100
  thumbmail_max_height 100
  thumbnail_max_width 100
</product-config>

以下键及其在ZMI《Properties》标签上的对应设置被识别

• watermark_use：对应于《水印使用》

• watermark_position_x：对应于《水印在X轴上的位置》

• watermark_position_y：对应于《水印在Y轴上的位置》

• watermark_opacity：对应于《水印不透明度》

• 水印ID: 对应于 水印ID

• 缩略图最大高度: 对应于 最大缩略图高度（像素）

• 缩略图最大宽度: 对应于 最大缩略图宽度（像素）

请注意：当您在 zope.conf 中设置默认值时，它将在创建水印图像实例时应用。后续对 zope.conf 默认值的更改不会影响现有实例。

错误跟踪

如果您有建议、错误报告或请求，请使用问题跟踪器 http://www.dataflake.org/tracker/

SVN版本

您可以通过此URL使用setuptools或zc.buildout从Subversion检索最新代码

http://svn.dataflake.org/svn/Products.WatermarkImage/trunk#egg=Products.WatermarkImage

变更日志

1.0 (2009-05-09)

初始发布。

下载