ヘルプ
IIIF Kasane は、IIIF のマニフェストを読み込んで、資料を表示するビューアです。3D モデル・画像・音声・動画と、それに付いた注釈(アノテーション)を、一つの画面に重ねて表示します。このページでは、資料の開き方、画面の見方、操作のしかた、うまく表示できないときの確かめ方を説明します。
資料を開く
マニフェストの URL を入れる
トップページの入力欄に、IIIF マニフェストの URL を入れて「表示する」を押します。ビューアの画面が開き、資料が表示されます。
Presentation API 4.0(草案)と 3.0 のマニフェストを表示できます。2.0 のマニフェストも、読み込むときに新しい形に変換して表示します。
コレクション(Collection)の URL を入れると、収録された資料の一覧が出ます。一覧から資料を選ぶと、その資料が開きます。資料に日付(navDate)が付いていれば、年代順に並べ替えたり、年表で見たりできます。
サンプルとユースケースから開く
すぐに試したいときは、用意した例から開けます。
- ユースケース: 実際の資料で Kasane を使った例です。動画で使い方を見てから、「Kasane で開く」で同じ資料を開けます。
- サンプル一覧: IIIF Cookbook のレシピと、このサイトの検査用のマニフェストです。画像・音声・動画・3D に分けて並べています。「ビューアで開く」で、表示できるかを確かめられます。
URL で直接開く
ビューアの URL に、開く資料を書き込めます。リンクを作って人に渡すときや、論文・ウェブページから資料を指すときに使います。
/ja/viewer/?iiif-content=<マニフェストの URL>で、その資料を開きます。iiif-contentには、IIIF Content State(資料の中の場所を指すための IIIF の規格)も書けます。ページ・画像の領域・音声や動画の時刻を指していれば、その場所を開いて目立たせます。複数のページを指していれば、並べて表示します。&canvas=3のように足すと、3 ページ目から開きます。数は 1 から数えます。ページの URI(Canvas の id)でも指定できます。&tab=mapのように足すと、右の説明欄でそのタブを選んだ状態で開きます。- 以前の形の
?manifest=<URL>も使えます。IIIF Curation Viewer と同じ?curation=<URL>と&pos=<番号>も読みます。
比較の画面を URL で開く
比較の画面(/ja/compare/)では、別々の資料の画像を見比べられます。所蔵機関の違う資料どうしでも構いません。
?src=<URL>&src=<URL>のように、src=を比べたいものの数だけ繰り返します。URL には、マニフェストか、画像 1 枚の info.json(IIIF Image API の画像情報)を書きます。混ぜても構いません。- コレクションは
?iiif-content=<URL>で指定します。収録されたマニフェストがまとめて読み込まれます。そのあとにsrc=を足すこともできます。 - 指定したものに入っている画像は、頭から順に 1 列に並びます。
&a=0&b=1は、その列の何番目を A と B に出すかです。数は 0 から数えます。 &mode=で見せ方を選びます。side(左右に並べる)、swipe(スワイプ)、spyglass(スパイグラス)、overlay(重ねる)です。スワイプの境目を横にするときは&dir=vを足します。- URL は符号化して書きます(
/は%2F、:は%3A)。info.json の URL に元から%2Fが入っているときは、%252Fになります。 - 画面の「資料」から追加・削除すると、URL の
src=も書き換わります。比べたい組み合わせを画面で作ってから、URL をコピーして渡すのが簡単です。
例: 国立公文書館とスタンフォード大学図書館のマニフェストを、スワイプで見比べる
/ja/compare/?src=https%3A%2F%2Fwww.digital.archives.go.jp%2Fapi%2Fiiif%2F764297%2Fmanifest.json&src=https%3A%2F%2Fpurl.stanford.edu%2Fhs631zg4177%2Fiiif%2Fmanifest&a=0&b=1&mode=swipe
例: マニフェストと、画像 1 枚の info.json を見比べる
/ja/compare/?src=https%3A%2F%2Fwww.digital.archives.go.jp%2Fapi%2Fiiif%2F764297%2Fmanifest.json&src=https%3A%2F%2Fstacks.stanford.edu%2Fimage%2Fiiif%2Fhs631zg4177%252Fhs631zg4177_00_0001%2Finfo.json&a=0&b=1&mode=swipe
リンクを落として開く
資料を開いたあと、ビューアの画面に別のリンクをドラッグして落とすと、それを開きます。落とせるのは、マニフェストの URL と、iiif-content= の付いたリンクです。いま開いている資料の中の場所を指すリンクなら、そのページに移ります。
画面の見方
ビューアの画面は、左の表示欄と、右の説明欄に分かれています。
- 説明欄は、境目をドラッグすると幅を変えられます。ダブルクリックすると元の幅に戻ります。
- 説明欄は、ボタンで閉じたり開いたりできます。スマートフォンでは表示欄の下に出て、高さを変えられます。
- 画面の上の「ダウンロード」は、いま開いているマニフェストのファイルを開きます。
- 画面の上のボタンで、表示の言語(日本語・English)と、明るい表示・暗い表示を切り替えられます。
説明欄のタブ
説明欄には、資料の中身に応じてタブが出ます。使える内容が無いタブは出ません。
- 資料情報: タイトル・説明・メタデータ・提供者・関連リンクなど、マニフェストに書かれた情報です。
- ページ一覧: 2 ページ以上ある資料で出ます。サムネイルからページを選んで移れます。
- 目次: 目次(Range)がある資料で出ます。項目を押すと、そのページや場所に移ります。ページの並べ方が複数あるときは、ここで切り替えます。
- レイヤー: 1 つのページに複数の画像が重なっているときに出ます。画像ごとに表示・非表示、重ね順、不透明度を変えられます。画像を順に切り替えて再生することもできます。
- 地図: 場所の情報を持つ資料で出ます。今のページの場所は赤、ほかの場所は青で示します。地図か一覧の場所を押すと、そのページに移ります。
- 権利: ライセンスや出典表記が書かれているときに出ます。
- 文字起こし: 音声・動画に字幕や文字起こしが付いているときに出ます。
- 注釈の文字起こし: 注釈の形で文字起こしが付いているときに出ます。
- 注釈: 画像・音声・動画のページに付いた注釈の一覧です。
- アノテーション: 3D モデルに付いた注釈の一覧です。語句での検索と、タグでの絞り込みができます。
- 推論: 画像のページで出ます。画像の文字の読み取りや顔の検出などを、ブラウザの中で行います(後述)。
操作のしかた
画像
- マウスのホイールで拡大・縮小します。
- ドラッグで、表示する場所を動かします。
- ダブルクリックで、初めの表示に戻ります。
- 1 つのページで画像を選べる資料(Choice)では、切り替えの欄が出ます。「比較」を押すと、2 つを並べて見比べる画面が開きます。
ページの移動
- 表示欄の「前へ」「次へ」で、ページを移ります。
- キーボードでは、左右の矢印キーで移ります。右から左に読む資料では、向きも逆になります。
- 上下の矢印キーと PageUp・PageDown でも、前後に移ります。
- Home で最初のページ、End で最後のページに移ります。
- キーボードで操作するときは、先に表示欄を一度クリックしてください。
3D モデル
- 左ボタンでドラッグすると、モデルを回します。
- ホイールで拡大・縮小します。
- 右ボタンでドラッグすると、表示する場所を平行に動かします。
- スマートフォンでは、1 本の指で回し、2 本の指で拡大・縮小と移動をします。
- 右上の「+」「−」でも拡大・縮小できます。
- 「回す」を押すと、モデルが自動で回り続けます。「全体」でモデル全体が見える位置に戻り、「上」で真上から見ます。
- マニフェストに視点(カメラ)が書かれていれば、その名前のボタンが出ます。押すとその視点に移ります。
- 動きのあるモデルでは、「動かす」「止める」でアニメーションを再生・停止します。
- 同じ場所に複数のモデルが置かれた資料では、表示するモデルを切り替えられます。「比較」から、2 つを左右に並べたり、スワイプ・スパイグラス・重ね合わせで見比べたりする画面も開けます。
音声・動画
- 再生ボタンで再生します。
- 字幕や文字起こしがあれば、説明欄に並べて表示します。
- 複数のメディアを組み合わせたページは、まとめて再生します。
注釈(アノテーション)
注釈は、資料の上に重ねて表示します。
- 3D モデルの注釈は、モデルの上の印で示します。印を押すと、その場所に視点が移り、内容が出ます。
- 説明欄の「アノテーション」の一覧から選んでも、その場所に移ります。一覧の欄で、注釈の表示と非表示も切り替えられます。
- 画像の注釈は領域や点として、音声・動画の注釈は時刻として示します。
- 同じ場所に付いた複数の注釈は、まとめて表示します。
- Kasane は注釈を表示するためのビューアです。新しい注釈を書き込んで保存する機能はありません。
推論(文字の読み取り・顔の検出など)
「推論」タブでは、表示中の画像を、ブラウザの中で動く機械学習のモデルにかけられます。モデルは次の 4 種類です。
- 文字の読み取り(OCR): 文字を行ごとに読み取ります。
- 「NDL古典籍OCR-Lite」: 古典籍(くずし字を含む)向けです。
- 「NDLOCR-Lite」: 明治以降の活字の資料(縦書き・横書き)向けです。
- 「PP-OCRv6」(small・medium)「PP-OCRv5」: 活字の資料(主に横書き)向けです。中国語・英語・日本語に対応します。PP-OCRv6 のほうが新しく、日本語の読み落としが少なくなっています。
- PP-OCRv6 には small と medium の 2 つの大きさがあります。medium のほうが読み誤りが少なく、small のほうが軽くて速く読めます。
- 実測では、英語の活字(『不思議の国のアリス』1872 年の版、11 頁)で誤字の割合が small 1.43%・medium 1.35%、漢籍(嘉興蔵、15 面・5,714 字を 1 行ずつ読んだもの)で small 1.65%・medium 1.45% でした。
- その代わり、medium はファイルが約 139 MB(small は約 31 MB)で、読み取りには 4 倍ほどの時間がかかります(同じ英語の 1 頁で small 5 秒・medium 21 秒)。
- 「PP-OCRv5(ラテン文字)」: フランス語・ドイツ語・ラテン語などの活字向けです。
- 顔の検出(日本の絵画): 浮世絵・絵巻・近代の美人画などに描かれた顔を探して、枠で示します。「顔の輪郭(日本の絵画)」を選ぶと、枠の代わりに顔の形をなぞった輪郭で示します。
- クリックで切り出す: 画像の上の物をクリックすると、その形をなぞって輪郭の注釈にします。人物・建物・道具など、何にでも使えます。
- 絵の説明文・物の検出(Florence-2): 画像に描かれたものを英語の文章で説明したり、人・動物・建物などを英語の名前付きの枠で示したりします。写真や現代の図版が得意で、古い絵では外すこともあります。
使い方
- モデルを選び、「ダウンロード」を押します。最初の 1 回だけ、モデルをお使いのブラウザに保存します。大きさはモデルによって 10〜360 MB ほどで、ボタンに表示します。要らなくなったら「削除」で消せます。
- 「この画像で実行」を押すと、画像全体を読みます。「クリックで切り出す」では、代わりに「画像をクリックして切り出す」を押してから、画像の上の物をクリックします。
- 結果は注釈として、画像に重ねて表示します。注釈の形(JSON)で保存できます。文字の読み取りと絵の説明文の結果は、テキストでも保存できます。
拡大した範囲だけを読む
絵巻や大きな地図のような横長・大判の画像は、画像全体を読むと、モデルに渡す前に小さく縮めるため、文字や顔が潰れて見つからないことがあります。そのときは、読みたいところまで拡大してから「表示中の範囲で実行」を押します。見えている範囲だけを切り出して読みます。
- 範囲を移して、もう一度「表示中の範囲で実行」を押すと、結果を前の結果に足していきます。絵巻を場面ごとに読み進められます。
- 「この画像で実行」を押すと、それまでの結果を置き換えます。
- 広すぎる範囲では「表示中の範囲が広すぎます」と出ます。もう少し拡大してから押してください。
- 同じところを 2 回読むと、同じ結果が重なって出ます。
注意
画像はどこにも送りません。推論は、すべてブラウザの中で行います。結果は機械による推定で、誤りを含みます。マニフェストの中で切り抜きや回転を指定した画像には、まだ対応していません(ビューアの上で表示を回転させるのはかまいません)。
そのほかのページ
- コレクション・キュレーションの検索: コレクションかキュレーションの URL を入れると、中身をメタデータで絞り込める一覧にします。
- 地図と画像の連携(
/ja/georef/?iiif-content=<URL>): 位置の情報(ジオリファレンス)を持つ画像を、地図と並べて表示します。対応点があれば、画像を地図の上に重ねます。 地図の縮尺と中心(mapZoom・mapLat・mapLng)、画像の拡大率と中心(zoom・centerX・centerY)、画像の回転(rotation、度、反時計回りが正)、選んでいる地点(id)は、動かすたびに URL に書き込まれます。URL をそのまま渡せば、同じ表示で開けます。引数の名前は IIIF Georeference Viewer(geo.ldas.jp)と同じなので、向こうのリンクの?以降をそのまま使えます(マニフェストを指すu=も読みます)。&lat=<緯度>&lng=<経度>を足すと、その地点に印を立てて開きます。 画像は、地点が 2 つ以上あれば、開いたときに北が上になるよう自動で回ります(URL にrotationがあるときはその角度で開きます)。画像の上の「回転」ボタンから、角度を変える・北を上に戻す・0° に戻すことができます。 右の一覧は、名前・別名・ID・タグで探せます(カタカナとひらがな、全角と半角は区別しません)。タグがある資料では、検索欄の下のタグを押すと、そのタグの地点だけに絞り込めます。 地点の付いた画像が 2 枚以上あるマニフェストでは、画像の下の「‹ ›」で切り替えます。見ている画像は URL のcanvas(Canvas の id、またはマニフェストの何枚目か)に書き込まれます。 地図の右上では、背景地図(標準・地理院の淡色地図と写真・れきちず)を切り替えられます。地名を入れて検索すると、その場所へ移って印を立てます(OpenStreetMap の Nominatim で検索します)。照準のボタンを押すと、現在地へ移ります(ブラウザが位置情報の許可を求めます)。
リンクで共有する
ビューアの URL をそのまま人に渡せば、同じ資料を開けます。URL には、開いている資料と、選んでいるタブが入っています。
ページを移っても、URL は変わりません。特定のページを指したいときは、URL の最後に &canvas=<ページの番号> を足してください。ページの中の領域や時刻を指したいときは、IIIF Content State を使います(「URL で直接開く」を参照)。
うまく表示できないとき
「マニフェストを読み込めませんでした」と出る
まず、URL が正しいかを確かめてください。ブラウザで URL を直接開き、JSON が表示されるかを見ます。
JSON は表示されるのに Kasane で開けない場合は、CORS の設定が原因のことが多いです。CORS は、他のサイトのページからデータを読むことを許すかどうかの、サーバ側の設定です。Kasane はマニフェストを、お使いのブラウザから直接読みます。マニフェストのサーバが他のサイトからの読み取りを許していないと、ブラウザが読み込みを止めます。この場合は、Kasane の側では直せません。資料の提供元に、CORS の設定をお願いしてください。
画像が出ない
画像のサーバが止まっているか、画像の URL が誤っている可能性があります。「この画像はありません」と出るのは、画像を取得できなかったときです。
ログインを求められる
IIIF の認証(Authorization Flow API 2.0)で守られた画像では、画像の上に「ログイン」の案内が出ます。押すと、提供元のログイン画面が開きます。ログインできて閲覧の権限があれば、画像が表示されます。
- ブラウザが他のサイトの Cookie を制限していると、ログインしても画像が出ないことがあります。
- 認証に対応しているのは画像だけです。音声・動画・3D モデルの認証には対応していません。
「この形式の内容は表示できません」と出る
Kasane がまだ扱えない種類の内容です。3D モデルは、GLB 形式と点群に対応しています。
推論で「画像を読み込めませんでした」と出る
画像のサーバが、他のサイトからの読み取りを許していない可能性があります。上の CORS と同じ理由です。画像は表示できても、推論には使えないことがあります。
お問い合わせ
不具合の報告や要望は、GitHub Issues にお寄せください。問題が起きたマニフェストの URL を添えていただくと、原因を調べやすくなります。