目次前へ次へ

2.3.1 風配図の目盛りを指定する

目盛りは各プロットのプロパティでインスタンス変数「WindrosePlot::scale」によって操作できます。目盛りは同心円として風配図プロット上で放射状に広がっています。円と円の間の幅は手動で自動でもデータの値によりライブラリから操作できます。

（説明文を継続するため、このセクションでは例を全部表示せずに「サンプル集」に回します。）

円の目盛りを手動で設定するには次の方法を使います。

WindrosePlotScale::SetStepSize($aMax,$aStepSize=null)

$aMax, The maximum scale value

$aStepSize, The step between each scale circle

ライブラリの初期設定により５と２の倍数が綺麗な目盛間隔になるよう表示されます。

目盛りを調整するための他の手法は次の通りです。

WindrosePlotScale::SetFont($aFontFamily,$aFontStyle=FS_NORMAL,$aFontSize=10)

中心の0値ラベル以外の全ての目盛りのフォントを指定します。

WindrosePlotScale::SetZFont($aFontFamily,$aFontStyle=FS_NORMAL,$aFontSize=10)

中心の0値ラベルのフォントを指定します。

WindrosePlotScale::SetFontColor($aColor)

中心の0値ラベル以外の全ての目盛りのフォントカラーを指定します。

WindrosePlotScale::SetZFontColor($aColor)

中心の0値ラベルのフォントカラーを指定します。

WindrosePlotScale::SetLabelFillColor($aBkgColor,$aBorderColor=false)

全てのラベルの背景色を指定します。

WindrosePlotScale::SetLabelAlign($aAlign)

ラベルの文字の配置を指定します。

WindrosePlotScale::SetLabelFormat($aFmt)

ラベルのフォーマットを指定します。フォーマットString変数「printf()」を使います。

WindrosePlotScale::Hide($aFlg)

目盛りラベルを非表示にします。

これらの方法を使用した例は次のセクションに記載しています。

フォントとフォントカラーを指定する

フォントは目盛り上のラベル全てに対して指定することも、プロットの中心のラベルを別に指定することもできます。それをどのように行うかは次のコードの抜粋でご覧いただけます。（ここでは「windplot」という名前の風配図プロットが既に作成してあると仮定します。）

 // 目盛りラベルのフォントとフォントカラー
 $windplot->scale->SetFont(FF_VERDANA,FS_NORMAL,10);
 $windplot->scale->SetFontColor('navy');
                         
 // 中心の0値ラベルの目盛りラベルのフォントとフォントカラー
 $windplot->scale->SetZFont(FF_VERDANA,FS_NORMAL,10);
 $windplot->scale->SetZFontColor('navy');

目盛りを任意で指定する

ライブラリの初期設定により、目盛りの範囲と間隔はデータの最大値、プロットの大きさ、目盛りラベルのフォントの大きさを考慮して自動的に決まります。

しかし、Set($aMaxValue,$aStepSize)を呼び出すことで強制的に手動で行うことができます。ここでは目盛りの最大値と間隔を指定します。目盛り間隔は任意です。目盛り間隔が指定されていない場合は自動で指定されます。

 // 目盛り最大値と間隔を指定。
 $windplot->scale->Set(40,8);
   ...
 // 目盛りの最大値のみを指定。
 $windplot->scale->Set(40);

この特徴については、この章の「サンプル集」の図2.4_7にも紹介しています。

注意:自動的に生成される目盛りは目盛りのラインに適した５か２の倍数の刻み幅を使っています。

注意:目盛りラベルのフォントが変更されるときに目盛りの間隔が変化する場合は驚かれるかもしれません。しかしそういう設計になっています。各刻み幅に適用するラベルには限られたスペースしかありません。大きいフォントがマス目のスペース内に収まるように、それぞれの目盛りに当たる円の大きさが調整されます。

目盛りラベルの角度の指定

目盛りラベルは風配図プロットの中心から放射状に伸びる方位軸線に沿って置かれます。ラベルの角度は任意でも自動でも設定できます。

ラベルの自動位置設定を選択した場合、目盛りラベルは16本のコンパス方位のどれかに沿って置かれます。ライブラリの初期設定ではデータが一番少ない方位を選ぶようになっています。

角度の手動設定の場合は、SetAngle($aAngle)を呼び出し、度数を引数に入れます。

次のように記述します。

 // ラベルを45度の角度で表示する
 $windplot->scale->SetAngle(45);

初期設定によりライブラリが角度の自動設定を行いますが、これを明示するには次のように「'auto'」という文字列を使います。

 // ライブラリの適切な角度を設定させる 
 $windplot->scale->SetAngle('auto');

目盛りラベルの数字フォーマットを指定する

他のライブラリの目盛り同様、「printf()」フォーマット文字列を指定してラベルの表示を調整することができます。初期設定では次のようになっています。

$windplot->scale->SetLabelFormat('%d%%');

目次前へ次へ