imageindex - 云端在线

程序：

您的姓名

imageindex - 数码照片库工具

概要

Imageindex 是一个数字图片库程序。 它提供自动生成
图像和视频文件的缩略图和其他尺寸视图，以及符合 W3C 的 HTML 以
允许查看缩略图和图像或视频。 它还创建了所有的蒙太奇
给定目录中的图像用于 HTML 中的目录条目。

商品描述

Imageindex 已经从一个简单的缩略图生成程序发展成为一个成熟的
画廊应用程序。 有了它，您可以创建静态缩略图和“中等”视图（适用于
拨号网络查看器）以及按时间顺序显示图像的静态 HTML
顺序（基于 Exif 标题中的日期或文件本身的日期戳）。 支持
现在已为动画 GIF 和视频文件添加（我们支持任何文件格式
您安装的 mplayer 支持）。

出于多种原因，Imageindex 创建静态而不是动态内容。 首先也是最重要的
定期将图片存档到 CD-ROM 上更容易
只是“在那里”而不是“陷入”某种数据库中。 你创造你自己的
“数据库”与您自己的目录，并让 imageindex 处理
向世界展示图像。 Imageindex 将使用“蒙太奇”（或所有缩略图的缩略图
挤在一起）的子目录，如果它们与图像一起出现（请参阅示例
imageindex 网站上的页面 - http://www.edwinh.org/imageindex/sample.html).

imageindex 创建了四个基本的“视图”（默认启用）。 “指数”
视图以基本表格格式显示目录中所有图像的缩略图（默认为 3
列）。 在表格的每个单元格中的基本信息，例如日期/时间
给出图片以及图像中存在的任何评论（或标题）。 链接到
默认情况下还会显示各种尺寸的图像和其他图像视图。

呈现的第二个视图是“幻灯片”视图。 在这个视图中，“中等”大小的图像
与日期/时间、嵌入在图像中的任何标题等信息一起呈现，
等等 目前对于视频文件，“媒体”幻灯片仅指向实际的视频文件
处理。 未来的版本将允许在浏览器内直接播放（很像
YouTube）。 每个页面上都有“上一个”和“下一个”链接，让浏览者快速
循环浏览每个“中等”图像，而不必不断调用浏览器的“返回”
按钮。

视频文件的字幕可以通过创建一个与文件名相同的文件来创建。
原始视频文件，但以“.txt”为扩展名。 该文件的内容将是
在处理生成的 HTML 时，就像嵌入在 JPG 等格式中的标题一样使用。

与“幻灯片放映”视图结合使用的是“框架视图”。 启用后链接到
框架视图出现在索引视图页面的顶部。 当框架视图是
访问后，浏览器的窗格分为两部分。 在左侧，所有缩略图都是
排得很近。 在右侧部分，加载了相同的“幻灯片放映”页面。
当用户点击左侧的缩略图时，它是“幻灯片”视图（包括“媒体”
图像）显示在框架的右侧。 这创造了一个非常方便的
浏览许多图像的机制。

最后，存在“详细信息”视图。 此详细信息视图很像索引视图，因为
缩略图（尺寸进一步缩小）以表格形式呈现，但更多
信息显示在每个单元格中。 这对于来自的图像非常有用
数码相机，其中 Exif 标题填充了大量整洁的信息。

imageindex 的 HTML 输出可以通过在你的文件中创建一个“.imageindexrc”来定制。
$HOME 目录并在该文件中放置某些变量（请参阅变量部分）和
根据您的口味进行编辑。 其中一个变量控制级联样式表的输出
这最终会指导您的浏览器如何呈现 HTML。 所有颜色、字体、缩进、
可以在此样式表变量中完成您希望进行的更改等。

变数

当您在 $HOME 目录中创建“.imageindexrc”文件时，您可以将任何或所有
在那里添加以下变量并根据需要进行调整。 这是 Perl 代码本身，是
随后在运行时“包含”到 imageindex 中。

完全 必须 通过放置“1”来结束文件； 在它的最后。 这是 Perl 的事情！

您在这些示例中看到的值是程序默认值。 如果你喜欢默认
特定变量的值，您不需要将其包含在“.imageindexrc”文件中。

保存缩略图的目录名称

$thumbnail_dir = '缩略图';

“x”方向的缩略图大小（像素）。 请注意，imageindex 保留
图像从原始大小缩小以形成缩略图时的纵横比
图片。 因此，如果“x”维度小于“y”维度，则缩略图可能具有
小于 $default_thumbnail_x 的“x”大小。

$default_thumbnail_x = 200；

“y”方向的缩略图大小（像素）。 再次注意 imageindex
当图像从原始大小缩小以形成一个图像时，保留图像的纵横比
缩略图。 因此，如果“y”维度小于“x”维度，则缩略图
可能具有小于 $default_thumbnail_y 的“y”大小。

$default_thumbnail_y = 200；

如果原件的两个尺寸都在缩略图尺寸的这么多范围内，我们
将跳过缩略图并仅使用原始作为“缩略图”。

$thumbnail_threshold = 1.0;

“x”方向上“中等”图像的大小（像素）。 请注意，imageindex 保留
图像从原始尺寸缩小到“中等”尺寸时的纵横比
图片。 因此，如果“x”维度小于“y”维度，则“中等”图像可能
具有小于 $med_x 的“x”大小。

$med_x = 800;

“y”方向上“中等”图像的大小（像素）。 请注意，imageindex 保留
图像从原始尺寸缩小到“中等”尺寸时的纵横比
图片。 因此，如果“y”维度小于“x”维度，则“中等”图像可能
具有小于 $med_y 的“y”大小。

$med_y = 600;

保存“中等”图像的目录的名称

$med_dir = '中等';

如果原件的两个尺寸都在“中等”尺寸的这么多范围内，我们将
跳过创建中等大小的格式，只使用原始格式。 这节省了不必要的
如果它的大小已经接近原始图像，则创建一个“中等”图像。

$med_threshold = 1.6;

自动递归到子目录？ 设置为 1 以启用。

$do_recurse = 0;

生成“中等”图像？ 设置为 1 以启用。

$do_medium = 1;

生成“幻灯片放映”和框架视图？ 设置为 1 以启用。

$do_slide = 1;

生成“详细信息”视图？ 设置为 1 以启用。

$do_字幕 = 1;

使用/显示存储在图像中的标题信息？ 设置为 1 以启用。

$do_detail = 1;

处理子目录作为正常“索引”和“详细信息”视图中的条目？ 设置为 1 到
使能够。 如果在 $do_montage 设置为 1 的情况下处理了整个目录层次结构（请参阅
下面），给定目录的蒙太奇文件将用作“缩略图”
子目录。

$do_dirs = 1;

创建所有图像的蒙太奇？ 启用后，所有处理的图像都是
变成了平铺图案中非常小的缩略图的 NxM 蒙太奇。 所结果的
图像缩小到 $default_thumbnail_x x $default_thumbnail_y 尺寸并存储
在 $thumbnail_dir 目录中。 图块的大小随着图像数量的增加而增长
目录增加，但可以由下面概述的变量限制。 设置为 1 以启用。

$do_montage = 1;

将嵌入在图像注释中的 ASCII“笑脸”图案映射为真正的“表情符号”
图片？ 启用 ASCII 笑脸如 :) 和 :-) 时，眨眼 ;) 和 ;-)，以及
皱眉 :( 和 :-( 被映射到显示所传达情感的小 PNG 图像。
设置为 1 以启用。

$do_emoticons = 1;

以相反的顺序对时间戳进行排序。

$do_reverse = 1;

处理视频文件。 这依赖于安装了最新版本的 mplayer
你的系统。 我们已经测试了高达 0.99.8。 支持的视频文件类型
取决于在您的系统上安装 mplayer 时编译和使用的编解码器。

$do_video_files = 1;

将小图标覆盖到缩略图和中视图的一个角落
处理视频文件的第一帧。 这给出了一个“视觉提示”，该文件正在
在您的浏览器中显示的是视频文件而不是静止图像。

$do_video_thumbnail_icons = 1;

使用以下作为正则表达式，通过扩展名识别视频文件。 为了
某些技术原因，依靠这种快速有效的方法更可行
方法。 如果来自您的相机（或其他任何东西）的文件以不同的扩展名结尾，只需将
这里也有这个扩展。

$video_regexp = '(avi|mov|mpg|mpeg|mjpeg|m1v|m2v|wmv|fli|nuv|vob|ogm|vcd|svcd|mp4|qt)';

如果启用上述视频文件的“视觉提示”图标，则以下
变量决定了它被放置在哪个角落。 可接受的值为：SouthWest、
西北、东北、东南（区分大小写！）。

$video_icon_gravity = '西南';

如果启用上述视频文件的“视觉提示”图标，则有两个
从（当前）中挑选。 对于带有“播放”箭头的黄点，设置为 1（默认）。 设置为 2
用于摄像机的紫色图标。 更多内容将在后续版本中创建。

$video_icon = 1;

以下三个变量控制 HTML 输出中“指向”的超链接。 他们
可以设置如下：

index : 指向索引视图中图像的名称引用
fullsize : 指向实际图像本身
medium ：指向图像的“中等”版本
缩略图：指向图像的缩略图版本
slide ：指向为图像编写的“幻灯片放映”HTML 页面
details ：指向详细信息中图像的名称引用
查看

folling 变量控制索引视图中缩略图的超链接
指着：

$index_linkto = '幻灯片';

folling 变量控制详细信息中缩略图的超链接
观点指向：

$details_linkto = '索引';

folling 变量控制幻灯片视图中“中等”图像的超链接
指着：

$slide_linkto = '全尺寸';

要在索引和详细信息视图中使用的默认列数

$default_columns = 3;

设置幻灯片框架的方向 - “水平”或“垂直”。 当“垂直”
浏览器窗格将垂直拆分，所有缩略图都向左。 什么时候
'horizo​​ntal' 浏览器窗格水平拆分，缩略图排列在
上部

$frame_orient = '垂直';

以下两个变量可以设置为以下三个值中的任何一个：

top : 呈现时将有问题的项目放在页面顶部
底部：将有问题的项目放在页面底部时
呈现
none ：从 HTML 输出中省略该项目

控制是否检索嵌入在图像中的图像标题（或评论）并
写入 HTML 输出。 默认情况下，它写在显示的“中等”图像上方
在“幻灯片”视图中。

$slide_caption = '顶部';

控制是否将图像的日期/时间写入 HTML 输出。 默认情况下是
写在“幻灯片”视图中显示的“中等”图像下方。

$slide_date = '底部';

在“详细信息”视图中，缩略图被缩小到比正常小的尺寸
缩略图（以节省宝贵的空间）。 这设置了它们收缩的次数。
默认情况下，它会缩小 2 倍。

$detailshrink = 2;

缩略图和“中等”图像被写出为 JPEG 文件（即使原始
图像不是 JPEG 的）。 以下两个变量控制生成的“质量”
图片。 该值的范围可以从 0 到 100，其中 100 表示“不要失去任何质量”
文件大小。”

调整正在写出的缩略图的质量

$thumb_quality = 50；

调整写出的“中等”图像的质量

$med_quality = 80；

调整将在蒙太奇图像中找到的最小瓷砖数量。 如果数量
目录中的图像低于此值，图像将重复或空白
将被插入（见 $montage_fill）。

$蒙太奇分钟 = 4;

调整将在蒙太奇中找到的最大图块数。 如果数量
目录中的图像高于此数字，蒙太奇将通过“均匀
在目录中选择“$ montage_max 图像并仅使用这些图像。

$蒙太奇_max = 36;

调整蒙太奇图像之间的空间（像素）。

$蒙太奇空白= 2；

当目录中没有“偶数”数量的图像和完整的 NxM 拼贴蒙太奇时
无法形成，图像可以再次使用或可以使用空白空间。 设置为“重复”
重复使用图像和“空白”以使用空白空间。

$montage_fill = '空白';

以下变量控制 HTML 输出如何呈现的所有方面
符合标准的浏览器。 这个变量的内容将被写到一个
级联样式表及其中的属性将控制 HTML 的显示方式
呈现。 所有颜色、字体、大小、对齐方式等属性更改都可以发生。 这个
可能需要一些级联样式表的知识。 可以在这里找到一个很好的入门：

http://www.w3schools.com/css/css_reference.asp

$样式表 = '
身体{颜色：黑色； 背景：白色； }

/* 标题中的字体 */
h1.title { font-family: "Comic Sans MS",Helvetica,sans-serif;
字体大小：200%； 字体粗细：粗体； 文本对齐：居中； }
h2.daterange { 字体系列：Arial、Helvetica、sans-serif；
字体大小：125%； 文本对齐：居中； }
h3 { 字体系列：Arial、Helvetica、sans-serif； 字体大小：90%；
文本对齐：居中； }

/* 照片标题和目录标题 */
div.caption { 字体系列：Arial、Helvetica、sans-serif；
字体大小：100%； 字体粗细：粗体； 边距：1em； }

/* 索引页和详情页的整体字体 */
div.index { 字体系列：Arial、Helvetica、sans-serif；
字体大小：80%； }
div.detail { font-family: Arial, Helvetica, sans-serif;
字体大小：80%； }
div.credits { font-family: Arial, Helvetica, sans-serif;
字体大小：80%； 文本对齐：右； 边距：10px }

/* 表属性 */
table.index { 背景：#ffffff; 边界：无；
边框间距：8px； }
td.index { 边界：无； 填充：3px }
table.frame { 背景：#ffffff; 边框：无}
td.frame { 边框：无； 填充：0px }

/* 图像属性 */
img.index { 边框：无； }
img.slide { 边框：无； }
img.frame { 边框：无； }

/* 链接属性 */
一个：链接{颜色：蓝色； }
a：访问过{颜色：绿色； }
a：悬停{颜色：红色； }
a：活动{颜色：红色； }

';

当没有“偶数”数量时，调整“空”表格单元格中显示的内容
目录中的图像。

$emptycell = "空";

控制指向父目录的超链接的文本。 如果您不希望此链接
出现在索引和“详细信息”视图中“undef”变量（undef $updirtext;）

$updirtext = "上一级目录";

控制到框架视图的超链接的文本。 如果您不希望此链接成为
存在于索引和“详细信息”视图中的“undef”变量（undef $framelinktext;）

$framelinktext = "幻灯片视图（帧）";

控制指向详细视图的超链接的文本。 如果您不希望此链接成为
在索引视图中存在“undef”变量（undef $detaillinktext;）

$detaillinktext = "详情索引";

控制指向索引视图的超链接的文本。 如果您不希望此链接成为
在详细视图中显示“undef”变量（undef $indexlinktext;）

$indexlinktext = "主索引";

控制在给定目录的 HTML 中写出的默认 TITLE 字符串。 这是
通常通过命令行在每个目录的基础上给出并在其中“记住”
索引 HTML 文件本身内的 META 数据。

$default_titletext = "图片目录";

以下五个变量控制索引中锚结构的 TITLE 属性
和框架视图。 当给定 TITLE 属性时，它们通常呈现为“工具提示”
当光标悬停在活动链接上时显示文本的气泡。 我们使用它们
在这里给出有关图像的视觉提示。 这些变量的工作方式很像 的printf(1)
字符串。 可以为给定图像插值的值是：

%f => 替换为图片的文件名
%d => 替换为图像的日期/时间（或文件的 mtime）
%s => 替换为文件大小（以 Kb 为单位）
%r => 替换为原始图像的分辨率 (XxY)
%c => 替换为图像的标题（如果与一个一起存储）
%% => 替换为文字 '%' 字符

处理目录时插入以下代码并对其进行蒙太奇
directory 用作子目录的缩略图。

%n => 替换为目录中的图像数量
%b => 替换为图像目录中的“开始”日期
%e => 替换为图像目录中的“结束”日期
%t => 替换为图像目录中的“标题”

其他字符（包括空格）是文字。 在您的“.imageindexrc”中“取消定义”这些
如果您不希望将 TITLE 属性写入 HTML 文件，则可以使用该文件。 “日期/时间”
相关构造使用下面定义的日期/时间格式变量进行插值。

控制框架视图中缩略图图像超链接的 TITLE 属性。 这
默认为“ —— " 对于图像

$framethumbtitle = "%f - %d";

控制索引视图中缩略图图像超链接的 TITLE 属性。 这
默认为“ ( )" 用于图像

$indexthumbtitle = "%f (%s)";

控制幻灯片视图中缩略图图像超链接的 TITLE 属性。 这
默认为“ ( )" 用于图像

$slidethumbtitle = "%f (%s)";

控制详细视图中缩略图图像超链接的 TITLE 属性。
如果嵌入了图像，则默认为图像的标题（或评论）。

$detailthumbtitle = "%c";

控制索引视图中蒙太奇图像超链接的 TITLE 属性
正在显示子目录。 默认是显示子目录的图片数量
had 和跨越的日期范围。

$montagetitle = "%n 图像 %b 到 %e";

控制生成的 html 页面应具有的字符集。 这默认为 UTF-8，但
可以是 ISO-8859-1 或任何其他编码：

$file_charset = "ISO-8859-1";

以下八个变量控制写入时日期和时间的格式
HTML。 我们再次使用 的printf(1)-like 变量，其中代码被插值
根据用户的口味。

转义序列的定义来自 POSIX 时间(3) 定义。 不是
所有的 时间(3) 出于明显的原因得到支持。

%S 被秒替换为十进制数 (00-60)。
%M 替换为十进制数 (00-59) 的分钟。
%I 被小时（12 小时制）替换为十进制数 (01-12)。
%H 被小时（24 小时制）替换为十进制数 (00-23)。
%p 被“ante meridiem”或
适当的“post meridiem”（目前只有美国“am”或“pm”）
%R 等效于“%H:%M”（仅在 *timeformat 变量中）。
%r 等效于“%I:%M:%S %p”（仅在 *timeformat 变量中）。

%Y 替换为年份，世纪为十进制数。
%y 被没有世纪的年份替换为十进制数 (00-99)。
%m 替换为十进制数 (01-12) 的月份。
%d 替换为十进制数 (01-31) 的月份中的第几天。
%F 等效于“%Y-%m-%d”（仅在 *dateformat 变量中）。
%D 等效于“%m/%d/%y”（仅在 *dateformat 变量中）。
%% 替换为文字“%”。

控制框架视图中日期的形成方式

$framedateformat = "%m/%d/%Y";

在frame view中控制时间的形成方式

$frametimeformat = "%r";

控制索引视图中日期的形成方式

$indexdateformat = "%m/%d/%Y";

在索引视图中控制时间的形成方式

$indextimeformat = "%r";

在幻灯片视图中控制日期的形成方式

$slidedateformat = "%m/%d/%Y";

在幻灯片视图中控制时间的形成方式

$slidetimeformat = "%r";

控制详细视图中日期的形成方式

$detaildateformat = "%m/%d/%Y";

控制详细视图中日期的形成方式

$detailtimeformat = "%I:%M %p";

控制索引视图的 HTML 文件名

$indexfile = 'index.html';

控制详细视图的 HTML 文件名

$detailfile = 'details.html';

控制框架视图的 HTML 文件名

$framefile = 'frame.html';

控制幻灯片视图的 HTML 文件名

$slidefile = 'slides.html';

控制将存放所有“幻灯片视图”HTML 文件的目录的名称
（每张图片一个）

$slide_dir = '幻灯片';

控制写在每个目录中的级联样式表的名称

$stylefile = 'style.css';

如果启用，控制蒙太奇图像的名称

$montagefile = 'montage.jpg';

控制表情PNG图片文件名的前缀

$emoticonprefix = 'ii_';

示例

例如，假设您只想更改一些日期/时间格式字符串。 一套完整的
在这种情况下，“.imageindexrc”文件将是：

$framedateformat = "%F";
$frametimeformat = "%R";

$indexdateformat = "%F";
$indextimeformat = "%R";

$slidedateformat = "%F";
$slidetimeformat = "%R";

$detaildateformat = "%m/%y";

1; # 不要把它作为文件的最后一行！

致谢

我们要感谢 Perl 的创造者拉里·沃尔 (Larry Wall) 的“瑞士军用链锯”
脚本语言（以及所有这些年来对 Perl 进行黑客攻击的人）。 我们
还要感谢所有为 ImageMagick 及其配套模块做出贡献的人
PerlMagick。 如果没有 PerlMagick，这个软件的健壮性就会大大降低。
此外，我们还要感谢 mplayer 的创建者（以及所有贡献者）。
如果没有 mplayer，将永远不会出现对视频文件的支持。

作者

埃德温·赫夫斯图勒
约翰雷诺兹

使用 onworks.net 服务在线使用 imageindex