django-image-loupe 0.5

关于

Django Loupe提供了一个简单的方法来显示可缩放的、大图像。这些图像可以是本地托管，通过上传原始大图像，也可以是外部托管。外部托管的图像通过其URL引用。

通过制作一个分块的 图像金字塔 来显示可缩放的图像。制作这个金字塔有几种方法和格式。Django Loupe使用开源的 VIPS 库创建本地托管的Deep Zoom格式的分块。

OpenSeadragon JavaScript库显示本地或外部托管的图像。

安装

1. 使用 pip 安装Django Loupe

   pip install django-loupe

2. 将 "loupe", 添加到您的Django项目的 INSTALLED_APPS 中。

3. 在您的平台上安装 VIPS。Windows有相应的包，大多数Linux发行版都包含该包。Mac OS X有一个homebrew配方。

上传图像

1. 添加新的loupe图像

2. 输入标题和描述

3. 点击上传文件按钮并选择一个高分辨率文件

4. 保存。

输入外部托管图像

1. 添加新的loupe图像

2. 输入标题和描述

3. 输入瓦片的URL。这不是查看图像的页面的URL。您需要查看页面源代码以发现瓦片集URL。不同格式有标准的描述文件，Django Loupe将根据这些文件确定正确的URL。

   • Deep Zoom： http://example.com/path/to/image/imagename.dzi

   • 国际图像互操作框架： http://example.com/path/to/image/info.xml

   • Zoomify： http://example.com/path/to/image/ImageProperties.xml

4. 从选择中选取外部瓦片集类型。

5. 保存。

提供服务图像

1. 在模板中包含JavaScript

   {% load loupe_tags %}{% openseadragon_js %}

2. {{ object.render }} 将包含大图像的HTML片段。

   • 如果是外部瓦片集，它将查找 <modulename>/<classname>_<tileset_type>.html，其中 <tileset_type> 是瓦片集类型选择的简称。

   • 最后，它将在 <modulename>/<classname>_default.html 中查找。

使用远程存储

1. 使用 django-queued-storage

2. 将 'IMAGE_STORAGE' 设置为适当的存储类型。

3. 指定设置 'QUEUED_STORAGE_TASK' 为 'loupe.task.TileAndTransfer' 或 'loupe.task.TileTransferAndDelete'。