# 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
  The transparency value of the reverse text.
BGPictureFile
  file name
  You can specify the image file name merging with the wall paper.
  Tera Term will randomly select one of files when the wild card is specified.
  Please specify the relative path from the theme file when you want to use the relative path.
  The kind of file that Tera Term can load is depend the plugin stored in BGSPIPath.
  Tera Term can load the bitmap file when there is not plugin.
BGPicturePattern
  Stretch
  Tile
  Center
  FitWidth
  FitHeight
  AutoFit
  You can specify the painting method of the image file.
  Both FitWidth and FitHeight can expand or reduce the image while the aspect ratio of the image preserves.
  AutoFit can exchange FitWidth for FitHeight not to generate the space between the window and the image.
BGPictureBaseColor
  R, G, B
  This color can paint between the image file and the window.
BGPictureTone
  0 - 255
  The transparency value of the image file.
BGFadeTone
  0 - 255
  This option can enable the whole background to fade.
BGFadeColor
  R, G, B
  This option can configure the fade color.

VTFore, Red ...
  R, G, B
  This option can configure the text color.

## Extension of theme file

A user can configure the extension of the theme file based on the theme\Advanced.sample file.
For example, an image file(sample.jpg) can be drawn in the Tera Term background. Please specify the .ini file at the BGThemeFile entry of the teraterm.ini file.

    [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 にリンク張る