IIIF Curation Viewer for Timeline

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

この文書は、時系列画像の扱いに関する拡張部分を中心に記述する。ベースとした“IIIF Curation Viewer”と共通する内容については、IIIF Curation Viewerを参照のこと。

基本利用者向け機能

ビューワ画面

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

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

高度利用者向け機能

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

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

パラメータ名 内容 値の形式 補足
timeline Timeline APIに準拠するJSONファイルの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ファイルの読み込み

制限事項

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

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

ライセンス

IIIF Curation Viewer for Timeline v1.2

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.2 (2017-06-02)