
#
# 天の川テクスチャーの調整ツール(Windows用)について
# Copyright (C) 2025- Misato Observatory, Wakayama, Japan
#

・テクスチャーの問題点とツールの機能

　Stellariumでは、天の川の描画に textures/milkyway.png が使われます。

　milkyway.png はデスクトップアプリ上での見栄えは良いのですが、プラネタリウム投
影では 1.明暗が強すぎる 2.広がりが少なく幅が狭い 3.冬の天の川が明るすぎる など
の問題があり、リアルさに欠けます。さらに投影像を撮影すると、プロジェクターの寒
色な色温度によってテクスチャーの青色部分が沈み、天の川の明暗が極端に写ってしま
います。

　これらの問題を解決するため、update_milkyway.tcl を作成しました。テクスチャー
の色温度を下げ、輝度差を控え、裾野を広げ、裾の部分のみ脱色し、冬の天の川の輝度
を下げます。


・ツール使い方

　このツールでは内部で ImageMagick を呼び出します。
  https://usage.imagemagick.org/ よりダウンロードし、インストールしてください。
  (みさと天文台で使用したバージョンは ImageMagick 7.1.1-44 Q16-HDRI x64)

  Tcl/Tk は Magicsplat 版をインストールしてください。
  https://www.magicsplat.com/tcl-installer/index.html#downloads
  ※必ず、BAWT 版をアンインストールします。Interstellar Console は Magicsplat 版
    で問題なく動作します。

　update_milkyway.bat を実行すると、フィルターのプレビューが表示されますから、
そこで Enter キーを押すと milkyway.orig-vXX.X.png が読み込まれ、数段階の調整が行
われ milkyway.png が出力されます。Stellariumで使われるようにするには、textures/ 
ディレクトリにそれをコピーしてください。

　プロジェクターの特性は機種によってかなり異なると考えられます。そのため、リア
ルさを追求するには update_milkyway.tcl をテキストエディタで開き、先頭部分にある
パラメータを変更し、現場に最適な milkyway.png を生成してください。

　パラメータ群は (1) から (5) まであります：

  (1) 明るい部分の色温度(カラーバランス)
  (2) 暗い部分(裾野)の明度
  (3) 全体の輝度バランス
  (4) 冬の天の川の明るさ
  (5) 夏・秋の天の川の明るさ

　ツール実行時に表示されるプレビュー画面が(4)(5)のためのフィルター(実際の半分の
大きさ)です。(1)から(3)の結果とそのフィルターとが乗算されたものが、最終結果とし
て出力されます。フィルター生成のために設定するパラメータのうち座標値は、1/2の値
(プレビュー時の値)です。

　それぞれのパラメータ群から中間ファイルが生成されます。それらのファイルとコー
ドのコメントが理解の助けになるでしょう。

