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

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

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

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

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

  Ver.1.4a で全体の色調を再調整した上で、描写が不自然な箇所について手作業で修正
を施しました。修正内容は milkyway.orig-v25.4_multiply-filter.tiff で、これがオ
リジナルに対して乗算されます。Domeモードはもちろん、Naviモードでも自然な発色で
天の川が描かれます。


・ツール使い方

　このツールでは内部で 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.x.xx.png が出力されます。これらはすべて 16-bit/ch で処理され、
結果のみが 8-bit/ch で出力されます。Stellarium で使われるようにするには、
textures/ ディレクトリにそれを milkyway.png という名称でコピーしてください。

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

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

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

  重要なのが (3) で、最も重要なのは update_milkyway.tcl の save_my_image プロ
シーシャで、以下のコードが見つかります：

  save_an_image 0.80
  save_an_image 0.85
  save_an_image 0.95
  save_an_image 1.00
  save_an_image 0.90

上記数値を調整する事で、ほとんどのプロジェクターに最適なテクスチャーが生成でき
るはずです。数値はカーブ値で、小さいほど中間輝度が大きくなります。中間輝度を大
きくすると天の川が太く広がりを伴って描かれます。コード内では上記の5つの場合で
生成したものが以下のファイルで、これら5つだけでもかなりの場合をカバーできるは
ずです：

milkyway.0.80.png
milkyway.0.85.png
milkyway.0.95.png
milkyway.1.00.png
milkyway.0.90.png

なお、インストーラで使われるのは milkyway.0.90.png です。

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

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


・出力結果

  milkyway.20260427.png           ... Ver.1.4 まで
  milkyway.x.xx.png, milkyway.png ... Ver.1.4a


