# Theme 設定ファイル

TODO

- BGSPIPath(画像を読み込むのに用いる、Susie Plugin が格納されているフォルダを指定します。)の設定GUIを作る
- 仕様をちゃんと決める
- 仕様に合わせてcolor picker(仮)を修正

## themeファイルの種類

テーマファイルにはいくつかの種類がある。

BG + カラー
  [BG]と[Color Theme]の2セクション入ったファイル
  [BG]セクションには背景画像の設定だけ入っている
BG のみ
  [BG]セクションのみのファイル
  [BG]セクションには背景画像の設定だけ入っている
カラーのみ
  [Color Theme]のみのファイル
BG + 旧カラー (廃止したい)
  [BG]セクションのみのファイル
  [BG]セクションには背景画像と文字の色情報が入っている
  [BG]セクションの色情報は廃止したい

### BG theme

iniファイルの[BG]セクション部分

BGPictureTone
  背景画像(Dest)にデスクトップ画像(Src1)どれぐらいブレンドするか
  BGSrc1Alpha = 255 - BGPictureTone
  0=デスクトップ画像(Src1)が100%
  255=背景画像(Dest)が100%
BGFadeColor
  Src2の色
  BGFadeColor = BGSrc2Color
BGFadeTone
  DestとSrc1の合成画像に単色(Src2)をどれぐらいブレンドするか
  BGSrc2Alpha = 255 - BGFadeTone
  0=単色(Src2)が100%
  255=DestとSrc1の合成画像が100%
BGReverseTextTone
  0 - 255
  反転テキストの透明度
BGPictureFile
  ファイル名
  壁紙と合成する画像ファイル名を指定します。
  ファイル名にワイルドカードが指定された場合、一致するファイルからランダムに一つ選びます。
  相対パスを利用する場合は、テーマファイルからの相対パスを指定してください。
  読み込めるファイルの種類は、BGSPIPath に格納されたプラグインによります。
  ビットマップはプラグインが無くても読み込めます。
BGPicturePattern
  Stretch
  Tile
  Center
  FitWidth
  FitHeight
  AutoFit
  画像ファイルの描画方法を指定します。
  FitWidth、FitHeight は画像のアスペクト比を維持したまま、画像を拡大縮小します。
  AutoFit は、ウィンドウと画像の間に隙間ができないように、FitWidth と FitHeight を切り替えます。
BGPictureBaseColor
  R, G, B
  画像とウィンドウの間に隙間ができた場合、この色で塗られます。
BGPictureTone
  0 - 255
  画像ファイルの透明度
BGFadeTone
  0 - 255
  背景全体をフェードします。
BGFadeColor
  R, G, B
  フェードしたときの色を指定します。

VTFore や Red など (廃止)
  R, G, B
  テキストの色を設定します。

## テーマファイルの拡張設定

theme\Advanced.sample ファイルを利用して、拡張設定をすることができます。
下記は、指定した画像ファイル(sample.jpg)を Tera Term の背景に描画する例で、 teraterm.ini の BGThemeFile エントリで指定してください。

    [BG]
    ; Advanced Setting
    ; Image source setting
    ; Type      : Color / Picture / Wallpaper
    : Pattern   : Stretch / Tile / Center / FitWidth / FitHeight / AutoFit
    ; AntiAlias : On / Off
    ; Color     : R,G,B (0-255)
    ; Alpha     : 0-255
    ; File      : wildcard => random select
    ; Dest = (Src1  * Src1Alpha + Dest * (255 - Src1Alpha)) / 255
    ; Dest = (Src2  * Src2Alpha + Dest * (255 - Src2Alpha)) / 255
    BGReverseTextAlpha = 192
    ;
    BGDestType      = Picture
    BGDestFile      = sample.jpg
    BGDestPattern   = AutoFit
    BGDestAntiAlias = On
    BGDestColor     = 0,0,0
    ;
    BGSrc1Type      = Color
    BGSrc1File      =
    BGSrc1Pattern   =
    BGSrc1AntiAlias =
    BGSrc1Color     = 32,32,32
    BGSrc1Alpha     = 64
    ;
    BGSrc2Type      = Color
    BGSrc2File      =
    BGSrc2Pattern   =
    BGSrc2AntiAlias =
    BGSrc2Color     = 32,32,32
    BGSrc2Alpha     = 64

## color theme

TBD
TODO

- 仕様書く
- release/theme/color/readme.md にリンク張る