概要

mirador-rotation-pluginに以下の機能を追加しました:

  1. 90度単位の回転ボタン
  2. URLパラメータによるマニフェスト・回転角度の指定
  3. UIの改善(リセットボタンのアイコン変更)
  4. ヘルプ機能(使い方を説明するダイアログ)

新機能の詳細

1. 90度単位の回転ボタン

従来は1度単位のスライダーのみでしたが、90度単位で素早く回転できるボタンを追加しました。

実装内容

src/plugins/MiradorRotation.js に以下の変更を加えました:

iic}mmo;ppncuoo9soprr0tndttsahttRRaeoonnVttdeiaalwetteRweeRopLRotoeitarfgattthti(IteowcI9nioc0nno=dn=ofrwrf(oIordtdmoia,mrt'ei{@'com@tnrumioiuo+t/inai/)(tcidioc=iono>rnsne:-s{cm-tnamietaowetnRreoirtaiala9t/l0iR)oR;ntoat}ta)et;LeeRfitg'h;t';

UIには2つのボタンを追加:

  • 左回転ボタン : 反時計回りに90度回転
  • 右回転ボタン : 時計回りに90度回転

翻訳対応

src/translations.js に英語・日本語の翻訳を追加:

{}e}j}n,a,:rr:rroooo{tt{ttaaaatttteeeeLRLReieifgfgthth:t:t::''R''oRto9at09ta0ete9'09,'°0,°lerfitg'h,t',

2. URLパラメータ対応

デモページでURLパラメータからマニフェストと回転角度を指定できるようになりました。

対応パラメータ

パラメータ説明区切り文字
manifestIIIFマニフェストURL;(セミコロン)
rotation初期回転角度(度);(セミコロン)

デモページURL

https://nakamura196.github.io/mirador-rotation-plugin/

使用例

#h#h#httttttpppsss::://////nnnaaakkkaaammmuuurrraaa111999666...gggiiittthhhuuubbb...iiiooo///mmmiiirrraaadddooorrr---rrroootttaaatttiiiooonnn---pppllluuugggiiinnn///???mmmaaannniiifffeeesssttt===huutrrtllp11s;;:uu/rr/lle22x&&arrmoopttlaaett.iicooonnm==/99m00a;n1i8f0est.json&rotation=180

実装内容

demo/src/index.js の主な変更:

ccccc}ooooo;nnnnni}sssssftttttcr}(oe)pmrrcmntmrri})aaoorasuaoon,;rnttentrnttiraiaaainiaatomftttfmfttitseiieeameiiaasooWsnasoolt=tnnitintnnVi.PPsnPfiIEOio.naadaefdnpen.err=orse:aew:waawatsbnemmrsmUtul:rrUo)rUreCoR==t=lrldtotLa{sl,:rnaSpptsufteaai=.teiiarromr,goraan=mau:ncmmP>apeshssan(,{[P..r{i(iaggafunreemerdattslem((?t,xs''P](mrraiwaoorn?inttad?niaamedftt.xroeiis)owsoopt.tnnl=al''Pi>to))at0ic;;r((oaa'{ntm;si.'[os)0np;].lsi?et?a(r'0c;,h'));.map(Number):[];

3. リセットボタンのアイコン変更

回転ボタンとの区別をつけるため、リセットボタンのアイコンを変更しました。

変更前変更後
ReplaySharpIconRestartAltIcon

ReplaySharpIconは回転を連想させるデザインだったため、より「リセット」を明確に示すRestartAltIconに変更しました。

4. ヘルプ機能

プラグイン内に「?」ボタンを追加し、クリックすると使い方を説明するダイアログが表示されます。

実装内容

MUIのDialogコンポーネントを使用して、各コントロールの説明を表形式で表示します。

iiiic<mmmmoM/ppppniao<MoooosrrnHirrrrtaiCerttttdalla[o-ipdHDDDhrlcOoeiiieMakurlaaaleb=tMplllpne{leOoooOul(inugggpB=)nutTCeu{eBlfiontt=Iuirtn,t(>ctnolto'otemeesnhsnoIneeenc'fttlt>o@rHpHnmofe'eumrl)lfiop}pr'mOOm@ppmam'eetu@nn'eim](@r/utmimi=ruaa/uiltmue//eas)iDrte}ciieSoaartnlliaso/at-gDlem'i/(a;aDftliaeoalrglsiToeaig)ltC;/loHene'tl;epnOtu't;line';

ダイアログの内容

アイコン説明
RotateLeftIcon反時計回りに90度回転
RotateRightIcon時計回りに90度回転
LinearScaleIcon回転角度を微調整(-180°〜180°)
RestartAltIcon回転を0°にリセット

翻訳対応

{}e}j}n,a,:hhhhhh:hhhhhheeeeeeeeeeee{llllll{llllllpppppppppppp:TRRSR:TRRSRiooleioole'tttis'tttisHlaadelaadeeettetettetl:eer::eer:pLR:'LR:''ei','ei',Rfg'Rfg'othFetht:tis:ta:ne:0t'et'°iR'-'ooRtrntouo調atnt'Ctaea,oett-'neri991,t9oo008r09tn0o°0a°l°ttscio''1'oco,,8,uln00no°°tca'ekn,'rwg,-ilcseleo'c,-k1w8i0s°e't,o180°)',

コントロール一覧

現在のプラグインは以下のコントロールを提供します:

コントロールアイコン機能
左に90度回転RotateLeftIcon反時計回りに90度回転
右に90度回転RotateRightIcon時計回りに90度回転
角度スライダーLinearScaleIcon-180度〜180度の範囲で1度単位の調整
リセットRestartAltIcon回転を0度に戻す
ヘルプHelpOutlineIcon使い方ダイアログを表示

設定オプション

オプションデフォルト説明
rotationEnabledbooleanfalseプラグインの表示を有効化
rotationOpenbooleanfalse回転コントロールをデフォルトで開く
initialViewerConfig.rotationnumber0初期回転角度

まとめ

今回の機能拡張により、mirador-rotation-pluginの使い勝手が向上しました:

  • 90度回転ボタン : 書籍や文書の向きを素早く修正可能に
  • URLパラメータ : 外部からの呼び出しや共有が容易に
  • UIの改善 : 直感的に操作しやすいアイコンに変更
  • ヘルプ機能 : 初めてのユーザーでも使い方がすぐに分かる

これらの機能により、IIIF画像の回転操作がより効率的に行えるようになりました。