3.1.2.17 scale_bar要素

scale_bar要素は、マップに既知の空間参照システム(SRS)が含まれる場合に、マップ・リクエストに追加するスケール・バー(バー上にマークされた距離で何キロメートル/マイルを表すかを示す)を定義します。表示モードは単一(メートル法または米国式)または二重(メートル法と米国式の両方)を指定できます。<scale_bar>要素には、次の定義が含まれます。

<!ELEMENT scale_bar >
<!ATTLIST scale_bar
  mode (METRIC_MODE|US_MODE|DUAL_MODES) "METRIC_MODE"
  position (SOUTH_WEST|SOUTH_EAST|SOUTH|NORTH|
  NORTH_WEST|NORTH_EAST) "NORTH_EAST"
  offset_y CDATA #implied
  offset_y CDATA #implied
  color1 CDATA #implied
  color1_opacity CDATA #implied
  color2 CDATA #implied
  color2_opacity CDATA #implied
  length_hint CDATA #implied
  label_color CDATA #implied
  label_font_family CDATA #implied
  label_font_size CDATA #implied
  label_halo_size CDATA #implied
  label_position (TOP|BOTTOM) "TOP"
>

<scale_bar>属性はすべてオプションです。modeは、スケール・バーがメートル法または米国式、あるいは両方のモードのいずれであるかを指定します。デフォルトは、METRIC_MODEです。

positionは、スケール・バーを配置するマップ上の相対的な位置を定義します。デフォルトは、NORTH_EASTです。

offset_xおよびoffset_yは、マップのマージンからのスケール・バーの位置を示すXおよびYの値を定義します。デフォルト値は0(ゼロ)です。

color1、color1_opacity、color2およびcolor2_opacityは、スケール・バーのレンダリング時に使用する色を定義します。color1とcolor2には赤、緑、青のデフォルト値、color1_opacityには(0x44, 0x44, 0x44, 210)のデフォルト値、color2_opacityには(0xee, 0xee, 0xee, 210)のデフォルト値があります。

length_hintは、スケール・バーのレンダリングに使用するピクセル数を定義します。デフォルトは、マップ幅の約17%です。

label_color、label_font_family、label_font_sizeおよびlabel_halo_sizeは、スケール・バーのテキストに影響します。デフォルトは、黒色、Serifフォント・ファミリ、フォント・サイズ12pt、ハローなし(ハロー・サイズ0)です。

label_positionは、スケール・バーに対するテキストの位置(TOPまたはBOTTOM)を定義します。デフォルトはTOPです。

scale_bar要素は、スケール・バーを定義します。

例3-23 スケール・バー

<scale_bar position="SOUTH_WEST"
           mode="US_MODE"
           color1="#ff0000"
           color1_opacity="128"
           color2="#00ffff"
           label_font_family="Dialog"
           label_font_size="15"
           label_font_style="italic"
           label_font_weight="bold"
           label_halo_size="2.8"
           label_position="bottom"
           offset_y="5" />