🐷

Mirador2のPhysical Document Rulerを試す

2023/08/29に公開

iiif

Mirador

mirador2

tech

概要

IIIFのLinking to External ServicesにPhysical Dimensionsがあります。

以下のように説明されています。

For digitized objects, it is often useful to know the physical dimensions of the object. When available, they allow a client to present a ruler, or other rendition of physical scale, to the user.

（機械翻訳）デジタル化された物体の場合、その物体の物理的な寸法を知ることはしばしば有用である。利用可能な場合、クライアントが定規やその他の物理的な縮尺をユーザーに提示することができます。

Mirador ver.2とver.3では、それぞれ以下のプラグインが存在します。

ver.2

ver.3

残念ながらver.3のプラグインをうまく導入することができませんでした。そこで、Mirador2を対象に、Physical Document Rulerを使用する方法を説明します。

結果、例えば東京大学史料編纂所所蔵の大型絵図である正保琉球国絵図写（請求記号：Ｓ島津 76-2-4、法量：354.1×731.0cm）を対象にした場合、以下のように定規を表示させることができます。

ソースコードの準備

以下のリポジトリからソースコードを取得できます。

https://github.com/nakamura196/mirador2

Mirador2のプラグインを格納する以下のフォルダmirador/pluginsに対して、以下で公開されているPhysicalRulerのソースコードをコピーしています。

そして、index.htmlで以下のように参照しています。

index.html

...
<body>
  <div id="viewer"></div>
  
  <script src="mirador/mirador.min.js"></script></script>
  <script src="mirador/plugins/PhysicalRuler/physicalRuler.js"></script>
  <script type="text/javascript">
	  ...
  </script>
</body>

データ

マニフェストファイルの各Canvasに対して、serviceを追記します。physicalScaleは実寸（cm）をピクセル数で割った値を用いています。

{
...
"canvases": [
        {
          "@id": "https://www.hi.u-tokyo.ac.jp/collection/digitalgallery/ryukyu/data/iiif/0001/canvas/p1",
          "@type": "sc:Canvas",
          "height": 24221,
          "service": {
            "@context": "http://iiif.io/api/annex/services/physdim/1/context.json",
            "physicalScale": 0.0146,
            "physicalUnits": "cm",
            "profile": "http://iiif.io/api/annex/services/physdim"
          },
          "images": ...,
          "label": "[1]",
          "thumbnail": ...,
          "width": 49894
        }
      ],
}
...

結果

以下で結果を確認できます。画面左上部の定規のアイコンをクリックすることで、ビューア上に定規が表示されます。

https://nakamura196.github.io/mirador2/?manifest=https://nakamura196.github.io/mirador2/data/examples/hi.json

まとめ

本プラグインは以下のように記載されています。

Due to technical limitations in the scanning process, the dimensions shown here are approximate. They are not suitable for purposes that demand scientific accuracy

（機械翻訳）スキャニングの技術的限界のため、ここに示された寸法はおおよそのものです。科学的な正確さを求める目的には適していません。

そのため、おおよその寸法である点に注意が必要ですが、実寸とともに画像を閲覧する際の参考になりましたら幸いです。

概要

ソースコードの準備

データ

結果

まとめ

Discussion