django-image-loupe 0.5

关于

django loupe提供了一种简单的方式来显示可缩放的大图像。图像可以通过上载原始大图像在本地托管，也可以在外部托管。外部托管的图像由其url引用。

可缩放图像通过平铺image pyramid来显示。制作这个金字塔有几种方法和格式。Django Loupe使用Microsoft使用开源VIPS库开发的深度缩放格式创建本地托管的磁贴。

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

安装

1. 使用pip：

   安装django loupe

   pip install django-loupe
   

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

3. 在您的平台上安装VIPS。有针对windows的软件包，大多数linux发行版都包含一个软件包。Mac OS X有一个自制配方。

上载图像

1. 添加新的loupe图像
2. 输入标题和说明
3. 单击“上载文件”按钮并选择高分辨率文件
4. 保存。

输入外部托管的图像

1. 添加新的loupe图像
2. 输入标题和说明
3. 输入平铺的url。这不是您查看图像的页面的url。您必须查看页面源才能发现tileset url。不同的格式有标准的描述文件，Django Loupe将从中确定正确的URL。
   • 深度缩放：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:

   {%loadloupe_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'。