私、結構頻繁にエゴサーチをするんです。自分の名前（リアル・ハンドル）や、作ったソフトウェア名なんかをググってみるんです。
で、ついさっき『Glaeja』での検索結果からリンク辿っていくと、
『サークルの設定難しすぎ』みたいなツイートが見つかりました
（リンクは貼りませんが…）。
というわけで、［サークル ］レイヤーのチュートリアル、というかお勉強です。
『Glaeja』［サークル ］レイヤーの持つ設定パラメータは結構多いんですが、
それらは機能別に以下の４つに分類できます。
- サークルをどこにどんな大きさで表示するか
- サークルが表現する比率は何か
- 比率の０％と１００％の角度は何度か
- 円弧のどの範囲を何色に塗るか
これは、［線の幅 ］［サークルの半径 ］［中心座標(水平) ］［中心座標(垂直) ］が該当します。
各々の意味は以下の図の通りです。
注意する点は、［サークルの半径 ］は、サークル中心から、描かれる［線の幅 ］の真ん中までである、というところです。
つまり、実際に描かれるサークルの外寸は、［サークルの半径 ］×２より大きく、［線の幅 ］＋［サークルの半径 ］×２ となります。
例えば、［サークルの半径 ］＝２０dp.、［線の幅 ］＝１０dp. のサークルは以下のようになります。
また、［線の幅 ］を［サークルの半径 ］の２倍にすることで、円グラフのようにすることができます。
２．サークルが表現する比率は何か
『Glaeja』のサークル（とバー）は、比率を表現するためのものです。
要するに、「あるものが、比較対象に対して何％であるか」を表示するものです。
この「あるもの」が［現在値となる項目 ］で、「比較対象」が［最大値となる項目 ］です。
サークルとは、［現在値となる項目 ］÷［最大値となる項目 ］×100（％）となる円グラフを描く、
というようなものだ、と考えておけばイイでしょう。
※この ［現在値となる項目 ］÷［最大値となる項目 ］×100（％）となる比率のことを、Glaejaでは「レベル」と呼び、後の４.で扱います。
では、［現在値となる項目 ］［最大値となる項目 ］に何を記述すればイイか、具体的に見て行きましょう。
まず、「バッテリー残量を表現したい」とします。
この場合、［現在値となる項目 ］はエスケープキャラクタを使って「#P#」と書けばイイでしょう。
そして「#P#」は充電率を％単位で返すキャラクタなので、 ［最大値となる項目 ］は「100」と書けばよろしいです。
他にもこのような比率を％と単位で返すキャラクタとして、ストレージ容量に関するものがありますが（&h&, &H&, &l&, &L&）、
それらの ［最大値となる項目 ］は全て「100」と書けばよろしいです。
つぎに、「現在時刻の分をサークルで表現したい」とします。
この場合、［現在値となる項目 ］はエスケープキャラクタを使って「$m$」と書けばイイでしょう。
そして ［最大値となる項目 ］は当然「60」となります。
これにより、このサークルの表現する比率は、現在時刻が
- ５分なら、５÷６０×１００＝８.３３％
- １０分なら、１０÷６０×１００＝１６.６７％
- ３０分なら、３０÷６０×１００＝５０.００％
- ４５分なら、４５÷６０×１００＝７５.００％
最後に、「現在曜日をサークルで表現したい」とします。
この場合、［現在値となる項目 ］はエスケープキャラクタを使って「$f$」と書けばイイでしょう。
この「$f$」は「日曜＝０、月曜＝１、、、金曜＝５、土曜＝６」を返すので、 ［最大値となる項目 ］は「6」となります。
これにより、このサークルの表現する比率は、現在曜日が
- 日曜なら、０÷６×１００＝０.００％
- 月曜なら、１÷６×１００＝１６.６７％
- 金曜なら、５÷６×１００＝８３.３３％
- 土曜なら、６÷６×１００＝１００.００％
３．０％と１００％の角度は何度か
これらは、［０％の絶対角度 ］［１００％の絶対角度 ］の２つに該当します。
これは、上記２．で決めた比率をサークル上のどの部分にどのようにマッピングするか、に相当します。
つまり、 上記１．で定めたサークルのうち、［０％の絶対角度 ］から［１００％の絶対角度 ］までの円弧部分をゲージとして、上記２．で決めた比率を表示する、ということを意味します。
例えば、［０％の絶対角度 ］＝０°、［１００％の絶対角度 ］＝９０°とした場合、ゲージとなる円弧は以下のようになります。
上図の灰色の円弧部分が０～１００％を表現するゲージとなるわけです。
この円弧で比率３０％となるものを表示した場合、以下のように表示されます。
さて、上図でもわかるように、［０％の絶対角度 ］［１００％の絶対角度 ］を記述する絶対角度は、時計で言う１２時が０°で、時計回り方向にプラス、反時計回り方向がマイナスとなるものです。
ここで、［０％の絶対角度 ］［１００％の絶対角度 ］の大小が、ゲージのすすむ方向（０→１００％）を決定します。
例えば、［０％の絶対角度 ］＝９０°、［１００％の絶対角度 ］＝０°とした場合には、ゲージとなる円弧は上図と同じになるのですが、ゲージのすすむ方向が下図のように反対向きになります。
では、ここからはちょっと難しくしてみましょうｗ
下図のようなゲージとなる円弧にしたい場合、［０％の絶対角度 ］［１００％の絶対角度 ］にはどんな値を入れればイイでしょう？
［１００％の絶対角度 ］＝９０°なのは確実だとして、［０％の絶対角度 ］は「－９０°」なのか「２７０°」なのかどちらでしょうか？
ここで［０％の絶対角度 ］［１００％の絶対角度 ］の大小が重要になってきます。
- ［０％の絶対角度 ］ ＜ ［１００％の絶対角度 ］の場合、ゲージは時計回りにすすむ
- ［０％の絶対角度 ］ ＞ ［１００％の絶対角度 ］の場合、ゲージは反時計回りにすすむ
- 比率５０％となる絶対角度は、［０％の絶対角度 ］［１００％の絶対角度 ］の平均値である
よって、上図のようにしたい場合だと、比率５０％の絶対角度が０°にならないといけないので、 ［１００％の絶対角度 ］＝９０°なのであれば、［０％の絶対角度 ］＝－９０°としなければなりません。
これを、［０％の絶対角度 ］＝２７０°としてしまった場合、［０％の絶対角度 ］［１００％の絶対角度 ］の平均値は「１８０°」となるため、以下のようなゲージになってしまいます。
実際にパラメータを設定する場合には、「比率５０％」の絶対角度を先に決めた上で、「０％がそこから何度」「１００％がそこから何度」か、というふうに考えたほうが楽チンかも知れません。
４．円弧のどの範囲を何色に塗るか
よくある円グラフのように０％からある比率までにのみ色を塗る、ってんなら簡単なんですが、それでは芸がないので、Glaejaでは色の塗りに関する概念を拡張してあります。それが「レベル領域」というものです。
先の２.で「レベル（［現在値となる項目 ］÷［最大値となる項目 ］×100（％）となる比率のこと）」 について触れましたが、「レベル領域」とは、このレベルをサークル上に色として表現するための「塗り範囲」となります。
グラフの色に関するパラメータは、［サークルの線色 ］［サークルの背景色 ］の２つです。
Glaejaではまず、［０％の絶対角度 ］［１００％の絶対角度 ］で指定された円弧全体を［サークルの背景色 ］で塗りつぶし、その後に「レベル領域」を［サークルの線色 ］で塗ります。
この［サークルの線色 ］で塗られる「レベル領域」の開始・終了位置をレベルに対してどう設定するのか、というパラメータが［開始位置のタイプ ］［開始位置 ］［終了位置のタイプ ］［終了位置 ］の４つになります。
［開始位置のタイプ ］［終了位置のタイプ ］は、
- 「ある％で固定」 ： レベルとは関係なく、［開始位置 ］［終了位置 ］で指定した％値とする
- 「現在の％から相対指定」 ： 現在のレベルから［開始位置 ］［終了位置 ］で指定した量だけズラした％値とする
例えば、先の「よくある円グラフのように０％からある比率までにのみ色を塗る」場合なら、
塗り範囲である「レベル領域」の開始位置は常に０％なので、
- ［開始位置のタイプ ］： 「ある％で固定」
- ［開始位置 ］： 「０.０」
また、「レベル領域」の終了位置は「ある比率（＝現在のレベル）まで」なので、
- ［終了位置のタイプ ］： 「現在の％から相対指定」
- ［終了位置 ］： 「０.０」
では、［開始位置のタイプ ］［終了位置のタイプ ］をともに「現在の％から相対指定」とするとどうなるのでしょう。
こうすると、「レベル領域」の開始位置・終了位置ともに現在のレベルに依存して変化することになります。
例えば、
- ［開始位置のタイプ ］： 「現在の％から相対指定」
- ［開始位置 ］： 「-5.０」
- ［終了位置のタイプ ］： 「現在の％から相対指定」
- ［終了位置 ］： 「1０.０」
つまりレベル領域の幅は、［終了位置 ］-［開始位置 ］＝10.0-（-5.0）＝１５％分に相当します。
このとき、サークルの０～１００％の円弧は元のものより膨らんで表示されます。
この膨らみの量は、０％側が［開始位置 ］分だけ、１００％側が［終了位置 ］分だけ、となっています。
例えば、 ［０％の絶対角度 ］＝０°、［１００％の絶対角度 ］＝９０°であった場合には、以下のようになります。
これは、現在のレベルが０％および１００％になった時に、レベル領域がはみ出る分を見込むようにしてあるためです。
0 件のコメント:
コメントを投稿