概要

Mirador 4で、初期読み込み時に、画像の回転や範囲指定を行う方法を紹介します。

背景

2025年3月現在、Mirador 4の開発が進められています。alpha版を以下で確認することができます。

おそらくMirador 4からの機能かと思いますが、以下のFAQで初期設定の方法が記述されています。

具体的には、以下のように、initialViewerConfigを用いることで、初期設定ができました。

上記を応用して、以下のような初期設定を行ってみました。

これにより、わかりにくいですが、以下のように、180度回転しつつ、xywhにフォーカスした形で初期読み込みできました。

なお、「東京帝國大學本部構内及農學部建物鳥瞰圖（東京大学農学生命科学研究科・農学部）」をサンプルデータとして利用しています。

この設定を用いることで、IIIF Content State APIなどにも対応可能かと思います。

初期設定については、Universal ViewerやCuration Viewerではすでに実装されているものです。一方、私の知る限りにおいて、Mirador 3では初期設定が行いにくかったと思います。（例えば、回転させた状態での初期設定はできなかった？）

上記で紹介した方法を用いることで、Miradorの利便性が向上するかと思います。

しかし、初期設定でrotationを指定すると、アニメーションが発生することがわかりました。この原因は、以下で示すように、viewport.setRotation(viewerConfig.rotation);となっていることでした。

そのため、immediately: trueを加えたものをフォークしたリポジトリで公開しています。

上記を使用することで、初期ロード時でも、アニメーションが発生せず、指定した角度で回転および領域にフォーカスした形で、画像を表示することができるようになりました。

Mirador 4の利用にあたり、参考になりましたら幸いです。これまで開発したプラグインについても、Mirador 4への対応を進める予定です。