ImageJ設定ファイル: IJ_Props.txtとIJ_Prefs.txt

ImageJの設定ファイル，IJ_Props.txtとIJ_Prefs.txtについて．

IJ_Props.txt

ImageJの起動時に読込まれる設定ファイルで，普通はij.jar内にアーカイブされているものが利用される．ImageJはこのファイルを読込むだけであり，書換えは行なわない．ij.jar内からIJ_Props.txtを外したり，ソース(Prefs.java)を改変すると，メニューについてカスタマイズがIJ_Props.txtを編集するだけで可能．とくにFile/Open Samples，右クリックメニューはカスタマイズしがいがある．また，メニューのPlugins/Shortcuts/*では割り振ることのできないショートカットキーも，IJ_Props.txtを編集することで利用可能．

IJ_Prefs.txt

ImageJの起動時に読込まれ，終了時に書き出される設定ファイル．主に各ユーザによる設定内容を保存する．無い場合には終了時に作られる．起動時には imageJ.main() → imageJ.ImageJ() → Prefs.load()でIJ_Props.txt読込 → Pres.loadPreferences()でIJ_Prefs.txt読込，という流れで設定ファイルが読込まれる．

ImageJの実行中は各プラグイン等によってPrefs.get*()やPrefs.set*()で各設定項目の参照ないし更新が行なわれる．組込みのプラグインでなくとも，これらのメソッドを使うことでIJ_Prefs.txtに独自のフィールドを設け，参照することができる．なお設定ファイル中ではこのような非組込みプラグインの設けたフィールド名の先頭に"."が自動的につけられている(おそらく組込みプラグインの利用するフィールドの衝突回避のため)．

終了時には imageJ.quit() → Prefs.savePreferences() ImageJ組込プラグイン(例えばplugin/filter/ParticleAnalyzer)等のsavePreferencesメソッド呼出によるstaticフィールド書出準備 → Prefs.savePrefs() によってIJ_Prefs.txt が更新される．IJ_Props.txt はImageJによって改変されることはない．

初期状態は以下の項目が記録されている．

fps=7.0
Image/Stacks/Animation Options.../Speed で設定するstack画像のアニメーション表示におけるコマ送り速度．単位はframe/second．

new.type=0
new.width=400
fcolor=#000000
gel.options=2
div-by-zero=Infinity
pp.options=1
raw.type=0

ij.y=32
ImageJ終了時におけるメインウインドウの画面上の場所(Y座標．単位はピクセル)．Xではxwininfoの-geometryでの値と同じ．(少なくともXでは)次回の起動時の場所とは限らない．

roicolor=#FFFF00

ij.x=441
ImageJ終了時におけるメインウインドウの画面上の場所(X座標．単位はピクセル)．

ap.bins=20
noise.sd=25.0
prefs.options=2
new.slices=1
raw.width=512
new.height=400
new.fill=0
bcolor=#FFFFFF
ap.options=64
measurements=19
precision=3
mark.width=0
raw.gap=0
raw.height=512
raw.options=0
new.name=Untitled
raw.n=1
jpeg=75
raw.offset=0

以下はImageJ上で設定したり作業すると必要に応じて作られる項目．

dir.image=/foo/bar
最後に開いた画像ファイルのディレクトリ．

plugin00=h,"*foo[B]",ij.plugin.Hotkeys("foo")

Plugins/Shortcuts/Create Shortcut で登録したショートカット(ホットキー)．
[B]がショートカットを示す．IJ_Props.txtで既に設定されているものは使えない．

plugin01=p,"bar[H]",bar

Plugins/Shortcuts/Install Plugin で登録したプラグイン．"="の次の文字(上記例ではp)はメニューにおける配置を決めている．定数ij/Menus.*_MENUとして定義されており，以下の通り．

p: Plugins/
i: File/Import/
s: File/Save as/
h: Plugins/Shortcuts/
a: Help/About Plugins/
f: Process/Filters/
t: Analze/Tools/
u: Plugins/Utilities/

recent00=/home/maro/wc/ijp/ss-col-mf-vm-03.gif
最近 File/Openで開いた画像ファイル．File/Open Recentにあらわれる．