CoveredCalc カバーの作り方

「Adams」のファイル構成

ここでは、例として CoveredCalc デフォルトカバー「Adams」のファイル構成を紹介します。 必ずしもこのような配置、ファイル名を使う必要はありませんが、ひとつの指針にはなるでしょう。

AdamsActive.bmp ～ AdamsCheckInactive.bmp が外見のデザインです。 外見のデザインについては、アクティブ時のデザインが最低でも必要です。他のデザインは省略することもできます。

「Adams」では同じイメージファイルを使い回している部分があります。 「Admas」で使っている画像の他にも次のイメージファイルを用意して利用できます。

• チェック済み状態のボタンが押されたときのデザイン（「Adams」では AdamsPressed.bmp を使い回しています）
• アクティブ時、チェック済み かつ "Hot" 状態のボタンの上に乗ったときのデザイン（「Adams」では AdamsHotActive.bmp を使い回しています）
• 非アクティブ時、チェック済み かつ "Hot" 状態のボタンの上に乗ったときのデザイン（「Adams」では AdamsHotInactive.bmp を使い回しています）

カラーマップイメージ

カラーマップイメージはデザイン上に存在するボタン等のパーツの位置を色分けにより指定したものです。 CoveredCalc ではパーツの位置の指定に座標の表記を使いません。 パーツの位置はカラーマップイメージ上の色によって決まります。 これは、複雑な形状のパーツにも簡単に対応できるというメリットがあります。 ただし、デメリットもあります。 CoveredCalc では複数のパーツを重ねて配置することはできません。

「Adams」のカラーマップイメージを使って具体的な例を見てみましょう。 「Adams」のカラーマップイメージファイルは AdamsMap.bmp です。 これを見ると、各ボタンの部分に色づけがされているのがわかると思います。 通常状態の画像である AdamsActive.bmp と比べながら見てください。 例えば、[1] ボタン（左端、下から 2 番目のボタン）は、カラーマップイメージでは赤色で塗られています。 CoverDef.xml を見ると、

という記述があります。 AdamsMap.bmp がカラーマップイメージファイルであることを記述し、 その中の赤色（#ff0000）に対して "Main_Button1" という名前（id）を付けています。 そして、その id を参照しているところが次の部分です。

これにより、[1] ボタン（class="1"）はカラーマップイメージ中の Main_Button1 の名前（id）が付けられた部分、 つまり、#ff0000 の色を塗られた部分ということになります。

このように、パーツの位置は色で指定し、その色に id を付けて参照します。 id はファイル全体でユニークです。つまり、重複するものがあってはいけません。

透明・半透明領域

カラーマップイメージを使って、カバーの透明領域を定義することができます。 透明領域はその部分のカバーの見た目が透明になるだけでなく、その部分が完全にくりぬかれます。 カバーの周囲を透明領域にすることで、カバーの形状を矩形以外の自由な形に定義できます。 ただし、BeOS 版では、OS にその機能がないため、透明領域を利用できません。

「Adams」の CoverDef.xml には、

という記述があります。この mapId で参照している Main_Transparent は次のように定義されています。

これを見てわかるように、カラーマップイメージ中の紫色（#ff00ff）で塗られた部分が透明領域です。

バージョン：1.5～外見のデザインのイメージファイルにアルファプレーンを含めておくと、 アルファプレーンが利用できる環境では一部のピクセルを半透明にすることができます。 アルファプレーンが利用できる環境は今のところ Windows 2000/XP/Vista です。 アルファプレーンの値（アルファ値）を 0 にすると、そのピクセルは透明領域と同じようにくりぬかれます。 カバーの周囲で外側から順にアルファ値を上げていくことで CoveredCalc の後ろにあるウィンドウとの境界をなめらかに見せたり、 アルファ値を使ってきれいなドロップシャドウをつけたりできます。 32 ビットまたは 16 ビットのビットマップ形式がアルファプレーンをサポートしています。

アルファプレーンと transparentRegion タグによる透明領域の定義は併用できます。 transparentRegion タグで定義された透明領域はアルファプレーンの値に関わらずくりぬかれます。 transparentRegion タグの usedAgainstAlpha 属性に "false" に設定しておくと、 アルファプレーンが利用できる環境では transparentRegion タグの定義は無効になります。 「Adams」ではこの属性を使ってアルファプレーンが利用できる環境ではアルファプレーンを、 そうでない環境では transparentRegion タグで定義された透明領域を使うようにしています。

フォントイメージ

演算結果を表示するための文字の画像がフォントイメージです。

フォントイメージは、電卓上のディスプレイに表示する文字を「0123456789ABCDEF.-」の順に、 左から右へ横 1 列に並べたものです。 フォントイメージファイル中のすべての文字は、 同じ幅・高さである必要があります。

「Adams」のフォントイメージで具体的な例を示します。 まず、CoverDef.xml を見てください。

という記述があります。AdamsNumFont.bmp がフォントイメージファイルです。 type というのはフォントイメージファイルのタイプです。現在は number しかありません。 次の width と height の指定は、フォントイメージファイルの中に入っている 1 つの文字の幅と高さを表します。この場合、幅は 13 ピクセル、高さは 21 ピクセルです。 charSpace は文字と文字の間のピクセル数を記述します。これは実際に表示されるときの間隔です。 フォントイメージファイル中の間隔ではありません。 フォントイメージファイルでは必ず間隔を空けずに文字を並べる必要があります。 最後の transparentColor はフォントイメージファイル中の透明色です。 ここで指定した色は電卓上には描画されません。

カバーの配置先

カバーを構成するファイル群はアプリケーションの実行ファイル（Windows なら CoveredCalc.exe、 BeOS/ZETA なら CoveredCalc）と同じ階層にある Covers フォルダの中に そのカバー専用のフォルダを作って格納します。このフォルダの名称は他のものと ぶつからない限り何でも構いません。 しかし、他とぶつかるかどうかは実行するユーザの環境によって異なります。それを完全に避けることはできません。 フォルダ名の一部にカバーの作者名を入れるのも 1 つのアイデアでしょう。 あるいは、他の人が思いつきもしないようなユニークで素敵な名前を思いついたなら、 それをそのまま使ってもいいでしょう。 ただし、ぶつかったときにユーザがフォルダをリネームするだけでうまくいくように、 このフォルダ名には依存しないようにするべきです。

カバー専用のフォルダの下はどんなフォルダ構成にしようが構いません。 しかし、カバー定義ファイル（CoverDef.xml）は、 カバー専用フォルダの直下に配置する必要があります。 つまり、

に配置する必要があるわけです。 CoveredCalc はこのパスに存在する CoverDef.xml だけをカバーブラウザに表示します。 （より正確には CoverDef.xml が存在しても、その中に書かれた情報が読み込めなければ、 カバーブラウザには表示されません）

カバー定義ファイル以外のファイルのファイルパスやファイル名は、 全てカバー定義ファイルに記述されます。 その記述はカバー定義ファイルのあるフォルダ（つまり、カバー専用フォルダです）からの相対パスで指定します。 このときのパス区切り文字は（Windowsであっても）"/" です。 相対パスに ".." を使えば、カバー専用フォルダから飛び出して、 別のカバーのフォルダを参照することもできるはずですが、 それは推奨されません。

カバーの多言語化

バージョン：1.2～CoveredCalc 1.4.0 以降では、日本語以外の言語用にユーザーインタフェースを切り替える仕組みが用意されています。 これに伴いカバー定義でも特定の言語向けに翻訳したテキストを定義できるようになっています。

「Adams」のカバー定義で例を挙げます。例えば、Adams カバーの説明は次のように CoverDef.xml 定義されています。

このように、テキストを含むタグに id 属性で ID を付けて（この例では「Description」）、 それを language タグで囲んだ altText タグで参照します。

language タグはいくつでも定義できます。 CoveredCalc は設定で選択されている言語に対応する language タグを見つけると、 その中の altText タグの内容を優先します。上記の例では、設定で日本語が選ばれている場合、 カバーの説明として「シンプルでくせのない電卓」が定義されているものとして扱います。 逆に、設定で選択された言語に対応する language タグが存在しなかったり、 存在しても altText タグで上書きされていないテキストについては元の定義を使います。 例えば上記の例では、設定で英語など日本語以外の言語が選ばれていれば「Simple and Basic Look Cover」を使います。

特定の言語に対する翻訳が見つからなければ元の定義が利用されるという点から、 元の定義には世界の事実上の公用語である英語を用いることを推奨します。

概要

カバー定義ファイルは CoverDef.xml という名前のファイルです。 XML 1.0 形式で記述します。 文字のエンコーディングは UTF-8 固定です。 それ以外は受け付けません。（Shift_JIS などは使えません）

XML についての説明はここでは行いませんが、 よくわからない場合はファイルの 1 行目を

のようにしておくといいでしょう。 あとは HTML を記述するような感覚で記述できると思います。 （HTML もわからない？ その場合はサンプルカバーをコピーしてそれを修正すればいいでしょう）

文字エンコーディングが UTF-8 ということに注意してください。 エディタが UTF-8 に対応していないと記述できません。 （日本語版 Windows XP に付属するメモ帳は UTF-8 が扱えます）。 もし、どうしても UTF-8 を使えるエディタが見つからないなら、 コメントを含むすべての記述を半角英数字（といくつかの半角記号文字）だけで記述すれば OK かもしれません。

要素の説明