IIIF Curation Viewer for Timeline

“IIIF Curation Viewer for Timeline”は、国文学研究資料館が公開する古典籍データを人文学オープンデータ共同利用センターのウェブサイト上で閲覧するために開発された、IIIF (International Image Interoperability Framework)準拠の画像ビューワIIIF Curation Viewerをベースとして、時系列画像の扱いに関する拡張を行ったビューワである。

この文書は、時系列画像の扱いに関する拡張部分を中心に記述する。ベースとした“IIIF Curation Viewer”と共通する内容については、IIIF Curation Viewerを参照のこと。またビューワの設置に関する情報はインストールを参照のこと。

IIIF Curation Viewerの機能をとりあえず試してみたい方は、以下のデモサイトをお試しいただきたい。

IIIF Curation Viewerのデモンストレーション

おすすめIIIFサイト

基本利用者向け機能

ビューワ画面

Timelineを表示した場合の画面例を挙げる。“IIIF Curation Viewer”と共通する内容については、別資料を参照のこと。

ビューワ画面の操作項目
番号 項目名 説明
14 コマ移動幅の増減(ボタン) ページナビでの前後移動コマ数を変更する。
15 日付指定(ボタン) カレンダーが表示され、日付押下により、指定日について問い合わせを行った返戻コマへ移動する。
16 最新画像に移動(ボタン) Timelineの再読み込みを行い、最新のコマへ移動する。
このボタンは、更新される可能性があるTimelineにおいてのみ表示される。

高度利用者向け機能

URL(GET引数)による動作指定

本ビューワは、URLの引数を活用して動作を細かく制御できる点に特徴がある。例えば、Timeline APITimeline APIとCuration APIの組み合わせに準拠して閲覧対象を記述したJSONファイルを用いて、閲覧対象を指定することができる。以下は指定できるパラメータのリストである。

パラメータ名 内容 値の形式 補足
timeline Timeline APIに準拠するJSONファイルのURLによる表示対象指定 URL ビューワ設置者の設定により表示が認められたURL。Timeline APIを参照。
curation Curation APIに準拠するJSONファイルのURLによる表示対象指定 URL Curation APIを参照。
pos 表示ページ指定 [0-9]+ timelineまたはcurationで指定された表示すべき時系列画像のうち、何番目を画面に表示するかの数値(1から始まる通し番号)
cursorIndex Cursor時刻指定 -?[0-9]+ timelineまたはcurationで指定された表示すべき時系列画像のうち、どの時刻から読み込むかを指定する数値(Unix time)
full フルページ表示(オプション) 1 1:フルページ状態でページを開く
tnパラメータとの同時指定不可
tn サムネイル一覧表示(オプション) 1 1:サムネイル一覧を表示した状態でページを開く
fullパラメータとの同時指定不可
lang 表示言語指定(オプション) "ja"など "ja"または未指定:日本語表示
上記以外("en"など):英語表示
label キュレーション名指定(オプション) URLエンコード(UTF-8)文字列 キュレーション名として表示する文字列
curationパラメータとの同時指定は無効

記述例

  1. Timeline API準拠JSONファイルの読み込み
  2. 1.の表示対象に対し、2017-05-01T00:00:00Z(=Unix time 1493596800)から表示するケース
  3. 2.の表示範囲のうち、2017-05-01T03:00:00Z(=2017-05-01T12:00:00+09:00)を最初に表示するケース
  4. Curation API準拠JSONファイルの読み込み

制限事項

本ビューワのtl:Manifestに関する実装では、Timelineのうち表示対象がcursorsで指定されているものに対応し、Timelineのうち表示対象がsequencesで指定されているものや、tl:ManifestのうちviewingHint値がtime以外であるものなどには対応していない。

本ビューワの実装は、Timelineと非Timelineの混在指定には対応していないが、Curationの仕様としてこれらを禁じるものではない。

ライセンス

IIIF Curation Viewer for Timeline v1.3

Copyright 2017 Center for Open Data in the Humanities,
Research Organization of Information and Systems

Released under the MIT license

Core contributor: Jun HOMMA (@2SC1815J)

Licenses of open source JS libraries, see acknowledgements.txt

活用情報

バージョン

  1. バージョン1.3 (2017-10-11)
  2. バージョン1.2 (2017-06-02)