001/* 002 * Copyright (c) 2009 The openGion Project. 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, 013 * either express or implied. See the License for the specific language 014 * governing permissions and limitations under the License. 015 */ 016package org.opengion.hayabusa.io; 017 018import org.opengion.fukurou.util.StringUtil; 019import org.opengion.hayabusa.common.HybsSystem; 020import org.opengion.hayabusa.common.HybsSystemException; 021import org.opengion.hayabusa.db.DBTableModel; 022 023import java.util.List; 024import java.util.ArrayList; 025import java.util.Arrays; 026import java.awt.Color; 027import java.sql.Connection; 028import java.sql.SQLException; 029import java.text.NumberFormat; 030import java.text.DecimalFormat; // 5.5.2.1 (2012/05/07) 031import java.text.DecimalFormatSymbols; // 5.5.2.1 (2012/05/07) 032import java.text.FieldPosition; // 5.5.2.1 (2012/05/07) 033 034import org.jfree.data.general.Dataset; 035import org.jfree.data.general.DefaultValueDataset; 036import org.jfree.data.general.ValueDataset; 037import org.jfree.chart.plot.ValueMarker; 038import org.jfree.chart.axis.NumberAxis; 039import org.jfree.chart.axis.NumberTickUnit; 040import org.jfree.chart.renderer.category.CategoryItemRenderer; 041import org.jfree.chart.renderer.category.BarRenderer; 042import org.jfree.chart.renderer.category.LineAndShapeRenderer; 043import org.jfree.chart.labels.CategoryItemLabelGenerator; 044import org.jfree.chart.labels.StandardCategoryItemLabelGenerator; 045import org.jfree.chart.urls.CategoryURLGenerator; 046import org.jfree.ui.RectangleInsets; 047import org.jfree.ui.TextAnchor; 048 049import org.jfree.chart.plot.MeterPlot; // 5.7.8.0 (2014/07/04) 050import org.jfree.chart.plot.ThermometerPlot; // 5.7.8.0 (2014/07/04) 051import org.jfree.chart.plot.CompassPlot; // 5.7.8.0 (2014/07/04) 052import org.jfree.chart.plot.Plot; // 5.7.8.0 (2014/07/04) 053import java.awt.BasicStroke; // 5.7.8.0 (2014/07/04) 054import org.jfree.data.Range; // 5.7.8.0 (2014/07/04) 055import org.jfree.chart.plot.MeterInterval; // 5.7.8.0 (2014/07/04) 056import org.jfree.chart.plot.DialShape; // 5.7.8.0 (2014/07/04) 057 058/** 059 * ChartDataset は、Dataset および、JFreeChart の個別属性を管理しているデータ管理クラスです。 060 * JFreeChart のグラフ合成機能のための、個別のグラフ描画属性を管理しています。 061 * 内部的に、引数の文字列を JFreeChart の各オブジェクトへの変換なども行っています。 062 * 063 * @version 0.9.0 2007/06/21 064 * @author Kazuhiko Hasegawa 065 * @since JDK1.1, 066 */ 067public class ChartDataset { 068 069 private Dataset dataset = null; // Dataset オブジェクト 070 private String query = null; // 実行クエリー 071 private String chartType = null; // チャートの種類 072 private String needleType = null; // Needleの種類 073 private boolean baseLegend = true; // シリーズ単位の凡例 の表示可否 074 private String valueLabel = null; 075 private double[] markValues = null; // doubleの配列 076 private Color[] markColors = new Color[] { Color.RED }; // Colorの配列 077 private Color[] markOverColors = null; // 4.0.3.0 (2008/01/07) マーカーラインの超過色 078 private boolean useMarkAnchor = true; // 4.1.1.0 (2008/02/04) 設定値をラベル表示するかどうか 079 private int dynamicOCNo = -1; // 4.1.1.0 (2008/02/04) 動的なマーカーラインの基準シリーズ番号 080 private int dynamicOCadrs = -1; // 4.1.1.0 (2008/02/21) 動的なマーカーラインの基準番号 081 private String lowerBound = null; // double 082 private String upperBound = null; // double 083 private String tickSize = null; // double 4.0.3.0 (2008/01/07) 084 private boolean useGradient = false; 085 private boolean shapesVisible = true; 086 private Color[] shapeColors = null; // 4.0.3.0 (2008/01/07) データ毎にShapeを切り替える時の色指定 087 private String shapeScale = null; // 4.1.1.0 (2008/02/04) 基本形 Shape の表示倍率(double) 088 private boolean useDottedLine = false; 089 private Color[] seriesColors = null; // シリーズに対応した色指定 090 private boolean isLabelsVisible = true; // 4.0.2.0 (2007/12/20) (縦軸)のラベルを表示するかどうか 091 private boolean isMarksVisible = true; // 4.0.2.0 (2007/12/20) (縦軸)のマーカーを表示するかどうか 092 private boolean isItemValVisible= false; // 4.1.1.0 (2008/02/04) データの値(itemText)を表示するかどうか 093 private boolean isItemLastVisible= false; // 4.1.2.0 (2008/03/12) データの値(itemText)で最後のみ表示するかどうか 094 private boolean useItemLabelSep = true; // 4.1.2.0 (2008/03/12) データの値(itemText)の表示に桁区切り文字を使用するかどうか 095 private String barWidth = null; // 4.0.3.0 (2008/01/07) バー幅(double) 096 private String maxBarWidth = null; // 4.0.2.0 (2007/12/20) バー幅の最大値(0.0~1.0) 097 private String itemMargin = null; // 4.0.2.0 (2007/12/20) バーアイテムのマージン(0.0~1.0) 098 private String visibleLimit = null; // 4.0.3.0 (2008/01/07) 表示下限値(これ以下のデータは未表示) 099 private String valueInset = null; // 4.0.3.0 (2008/01/07) 縦軸表示領域INSET値 100 private double domainMargin = 0.0; // 4.1.1.0 (2008/02/14) グラフの書き出し位置の調整比率 101 102 private String timeFormatType = null; // 5.5.2.1 (2012/05/07) 時刻の表示方法(E1/E2/E3/H1/H2/H3) 103 private boolean useVerticalLabels = false; // 5.5.2.1 (2012/05/07) ラベルの表示向き(横書き:false/縦書き:true) 104 105 /** 106 * Connection と query 文字列から、Dataset オブジェクトを作成します。 107 * 108 * setChartType( String ) で指定されたチャートタイプに応じて、Datasetオブジェクト 109 * を構築します。 110 * Dataset クラスは、"org.jfree.data.jdbc.JDBCXXXXDataset" の XXXX の箇所を 111 * ChartFactory クラスのチャートタイプ変換表に基づいて求めます。 112 * 現状は、Category , Pie , XY の3種類と、Value が指定可能です。 113 * ※ Value は、conn や sql を使用していません。値は、markValues を使用しています。 114 * これは、現状の暫定方法であり、今後は変わる可能性があります。 115 * 116 * @og.rev 4.0.0.0 (2007/11/28) new Double(double) ⇒ Double.valueOf(double) 変更 117 * 118 * @param conn Datasetの取得先のコネクション 119 * @param sql 取得するクエリー文字列 120 * @throws SQLException データベース実行エラーが発生した場合 121 */ 122 public void makeDataset( final Connection conn,final String sql ) throws SQLException { 123 dataset = ChartFactory.newDataset( conn,sql,chartType ); 124 query = sql ; 125 126 // 暫定的対応。本当は、SQL を実行してその値をセットすべき 127 if( dataset instanceof DefaultValueDataset ) { 128 if( markValues != null && markValues.length > 0 ) { 129 ((DefaultValueDataset)dataset).setValue( Double.valueOf( markValues[0] ) ); 130 } 131 else { 132 String errMsg = "markValues が指定されていません。"; 133 throw new HybsSystemException( errMsg ); 134 } 135 } 136 } 137 138 /** 139 * DBTableModelオブジェクトから、Dataset オブジェクトを作成します。 140 * 141 * setChartType( String ) で指定されたチャートタイプに応じて、Datasetオブジェクト 142 * を構築します。 143 * 144 * 現状は、Category , Pie , XY の3種類と、Value が指定可能です。 145 * ※ Value は、DBTableModel を使用していません。値は、markValues を使用しています。 146 * これは、現状の暫定方法であり、今後は変わる可能性があります。 147 * 148 * @og.rev 5.3.0.0 (2010/12/01) 新規追加 149 * 150 * @param table Datasetの取得先のテーブルモデル 151 */ 152 public void makeDataset( final DBTableModel table ) { 153 dataset = ChartFactory.newDataset( table,chartType ); 154 155 // 暫定的対応。本当は、SQL を実行してその値をセットすべき 156 if( dataset instanceof DefaultValueDataset ) { 157 if( markValues != null && markValues.length > 0 ) { 158 ((DefaultValueDataset)dataset).setValue( Double.valueOf( markValues[0] ) ); 159 } 160 else { 161 String errMsg = "markValues が指定されていません。"; 162 throw new HybsSystemException( errMsg ); 163 } 164 } 165 } 166 167 /** 168 * NumberAxis オブジェクトを作成します。 169 * 170 * NumberAxis オブジェクトは、Value(縦軸)の属性を設定する為に使用される 171 * オブジェクトです。 172 * これに、各種属性を設定して、値を返します。 173 * 属性としては、isLineVisible、isLabelsVisible、isMarksVisible、 174 * range(lowerBound、upperBound) です。 175 * 176 * @og.rev 4.0.2.0 (2007/12/20) 新規追加 177 * @og.rev 4.0.3.0 (2008/01/07) 縦軸レンジを個別設定、チック幅指定 178 * @og.rev 4.1.1.0 (2008/02/04) HybsNumberAxis 採用 179 * @og.rev 4.1.1.0 (2008/02/04) setAxisLineVisible を、isMarksVisible 値で設定する。 180 * @og.rev 5.5.2.1 (2012/05/07) timeFormatType 、useVerticalLabels 属性を追加する。 181 * 182 * @return 縦軸の属性(NumberAxisオブジェクト) 183 */ 184 protected NumberAxis makeNumberAxis() { 185 NumberAxis axis = new HybsNumberAxis( valueLabel ); 186 187 // 縦軸レンジ幅の軸設定 188 if( lowerBound != null ) { 189 axis.setLowerBound( Double.parseDouble( lowerBound ) ); 190 } 191 192 if( upperBound != null ) { 193 axis.setUpperBound( Double.parseDouble( upperBound ) ); 194 } 195 196 if( tickSize != null ) { 197NumberFormat nf = NumberFormat.getInstance(); 198 axis.setTickUnit( new NumberTickUnit( Double.parseDouble( tickSize ) , nf , 2 ) ); 199 } 200 201 axis.setTickLabelsVisible( isLabelsVisible ); 202 axis.setTickMarksVisible ( isMarksVisible ); 203 axis.setAxisLineVisible ( isMarksVisible ); // 4.1.1.0 (2008/02/04) 204 205 if( valueInset != null ) { 206 double rightInset = Double.parseDouble( valueInset ); 207 RectangleInsets base = axis.getTickLabelInsets(); 208 RectangleInsets inset = new RectangleInsets( 209 base.getUnitType(), // UnitType unitType 210 base.getTop(), // double top 211 base.getLeft(), // double left 212 base.getBottom(), // double bottom 213 base.getRight() + rightInset // double right 214 ); 215 axis.setTickLabelInsets( inset ) ; 216 } 217 218 // 5.5.2.1 (2012/05/07) 時刻の表示方法(E1/E2/E3/H1/H2/H3) 219 if( timeFormatType != null ) { 220 axis.setNumberFormatOverride( new HybsTimeFormat( timeFormatType ) ); 221 } 222 223 // 5.5.2.1 (2012/05/07) ラベルの表示向き(横書き:false/縦書き:true) 224 if( useVerticalLabels ) { 225 axis.setVerticalTickLabels( true ); // 処理的には冗長。 226 } 227 228 return axis; 229 } 230 231 /** 232 * 検索を行う クエリー文字列を返します。 233 * 234 * これは、makeDataset( Connection ,String ) メソッドで指定した、 235 * sql 属性の設定値そのものです。 236 * 237 * @return 取得するクエリー文字列 238 */ 239 public String getQuery() { return query; } 240 241 /** 242 * Dataset オブジェクトを取得します。 243 * 244 * makeDataset( Connection,String ) で、予めオブジェクトを構築しておく 245 * 必要があります。 246 * Dataset クラスは、"org.jfree.data.jdbc.JDBCXXXXDataset" の XXXX の箇所を 247 * ChartFactory クラスのチャートタイプ変換表に基づいて求めます。 248 * 現状は、Category , Pie , XY の3種類と、Value が指定可能です。 249 * 250 * @return Datasetオブジェクト 251 * @see #makeDataset( Connection ,String ) 252 */ 253 protected Dataset getDataset() { return dataset; } 254 255 /** 256 * Dataset オブジェクトを作成する時のチャートタイプを指定します。 257 * 258 * チャートタイプ は、外部からチャートを指定するのに便利なように、キー化 259 * されています。このキーに基づいて、ChartFactory クラスの 260 * チャートタイプ変換表に基づいて、レンデラーや、データセットを作成します。 261 * 262 * @param type チャートタイプ 263 */ 264 public void setChartType( final String type ) { 265 if( type != null && type.length() > 0 ) { 266 chartType = type; 267 } 268 } 269 270 /** 271 * Dataset オブジェクトを作成する時のNeedleタイプを指定します。 272 * 273 * Needleタイプ は、MeterPlot,Compassチャートを使用する場合に指定します。 274 * 275 * MeterPlot 276 * org.jfree.chart.plot.DialShape の指定キーワードとして、CHORD,CIRCLE,PIE が指定可能です。 277 * 初期値は、CIRCLE です。 278 * 279 * Compass 280 * org.jfree.chart.needle.MeterNeedle の指定キーワードとして、下記の9種類が指定可能です。 281 * 指定は、Arrow,Line,Long,Pin,Plum,Pointer,Ship,Wind,Arrow,MiddlePin という文字列です。 282 * 初期値は、Pointer です。 283 * 284 * 0 = ArrowNeedle; 285 * 1 = LineNeedle; 286 * 2 = LongNeedle; 287 * 3 = PinNeedle; 288 * 4 = PlumNeedle; 289 * 5 = PointerNeedle; 290 * 6 = ShipNeedle; 291 * 7 = WindNeedle; 292 * 8 = ArrowNeedle; 293 * 9 = MiddlePinNeedle; 294 * 295 * @og.rev 5.7.8.0 (2014/07/04) 新規追加 296 * 297 * @param type Needleタイプ 298 */ 299 public void setNeedleType( final String type ) { 300 if( type != null && type.length() > 0 ) { 301 needleType = type; 302 } 303 } 304 305 /** 306 * Dataset オブジェクトを作成する時のチャートタイプを取得します。 307 * 308 * チャートタイプ は、外部からチャートを指定するのに便利なように、キー化 309 * されています。このキーに基づいて、ChartFactory クラスの 310 * チャートタイプ変換表に基づいて、レンデラーや、データセットを作成します。 311 * 312 * @return チャートタイプ 313 */ 314 protected String getChartType() { return chartType; } 315 316 /** 317 * シリーズ単位の凡例 の表示可否を設定します。 318 * 319 * @param baseLeg シリーズ単位の凡例 の表示可否 320 */ 321 public void setBaseLegend( final boolean baseLeg ) { 322 baseLegend = baseLeg; 323 } 324 325 /** 326 * Renderer 関連の共通インターフェースを返します。 327 * 328 * setChartType( String )で設定された、チャートタイプに応じた、レンデラーを 329 * 返します。 330 * 対応表は、ChartFactory クラスに持っています。 331 * 基本的には、チャートタイプ は、この、レンデラー名称から決定しています。 332 * 333 * @og.rev 4.1.1.0 (2008/02/04) useDynamicOC , isItemValVisible , shapeScale 属性追加 334 * @og.rev 4.1.1.0 (2008/02/04) クリッカブル・マップの設定を移動、serNo 引数追加 335 * @og.rev 4.1.1.0 (2008/02/04) 返す型を CategoryItemRenderer に変更 336 * @og.rev 4.1.1.0 (2008/02/16) HybsStackedBarRenderer に domainMargin を設定 337 * @og.rev 4.1.1.0 (2008/02/19) Shapes の設定をこちらに移動。 338 * @og.rev 4.1.2.0 (2008/03/12) isItemLastVisible の設定 339 * 340 * @param serNo シリアルNo 341 * @param urlGen CategoryURLGeneratorオブジェクト 342 * 343 * @return レンデラーの共通インターフェース 344 * @see org.jfree.chart.renderer.category.CategoryItemRenderer 345 * @see org.jfree.chart.renderer.xy.XYItemRenderer 346 */ 347 protected CategoryItemRenderer getRenderer( final int serNo , final CategoryURLGenerator urlGen ) { 348 TypeRenderer typeRen = ChartFactory.getTypeRenderer( chartType ); 349 CategoryItemRenderer rend = (CategoryItemRenderer)typeRen.getRenderer(); 350 351 // 4.1.1.0 (2008/02/19) LineAndShapeRenderer オブジェクトの場合の設定 352 if( rend instanceof LineAndShapeRenderer ) { 353 LineAndShapeRenderer lsRend = (LineAndShapeRenderer)rend; 354 355 // シェープ(四角)表示。serNo 内の表示は、個別に行います。 356 lsRend.setBaseShapesVisible( shapesVisible ); 357 if( serNo >= 0 ) { 358 lsRend.setSeriesShapesVisible( serNo,true ); 359 } 360 361 // 4.1.1.0 (2008/02/04) 繰返しshapeの開始番号(初期値:0) 362 ShapeList shapeList = new ShapeList(); 363 for( int i=0; i<shapeList.size(); i++ ) { 364 lsRend.setSeriesShape( i,shapeList.getShape(i) ); 365 } 366 } 367 368 // 4.0.3.0 (2008/01/07) HybsLineRenderer 特別処理 369 if( rend instanceof HybsLineRenderer ) { 370 HybsLineRenderer hyRend = (HybsLineRenderer)rend ; 371 if( shapeColors != null ) { 372 hyRend.setShapeColors( shapeColors ); 373 } 374 375 // 4.1.1.0 (2008/02/04) shapeの大きさの倍率(初期値:null) 376 hyRend.setShapeScale( shapeScale ); 377 378 // 縦軸マーカーの超過時Shape色指定(未使用時は null) 379 if( markOverColors != null ) { 380 hyRend.setValueMarkOverColors( getValueMarkOverColors(),dynamicOCNo ); 381 } 382 383 // 表示下限値(これ以下のデータは未表示)の値(double)を指定 384 if( visibleLimit != null ) { 385 hyRend.setVisibleLimit( Double.valueOf( visibleLimit ) ); 386 } 387 } 388 389 // 4.0.2.0 (2007/12/20) BarRenderer オブジェクトの場合にマージン等を設定します。 390 if( rend instanceof BarRenderer ) { 391 BarRenderer barRend = (BarRenderer)rend ; 392 393 // 棒の間を表示領域を1として小数点以下の数値で幅を設定する(0.0~1.0) 394 if( itemMargin != null ) { 395 double margin = Double.parseDouble( itemMargin ); 396 barRend.setItemMargin( margin ) ; 397 } 398 399 // 棒の幅を設定す 表示領域を1として小数点以下の数値で幅を設定する(0.0~1.0) 400 if( maxBarWidth != null ) { 401 barRend.setMaximumBarWidth( Double.parseDouble( maxBarWidth ) ) ; 402 } 403 } 404 405 // 4.1.1.0 (2008/02/16) HybsStackedBarRenderer オブジェクトの場合に domainMargin を設定します。 406 if( rend instanceof HybsStackedBarRenderer ) { 407 HybsStackedBarRenderer stBarRend = (HybsStackedBarRenderer)rend ; 408 409 stBarRend.setDomainMargin( domainMargin ) ; 410 } 411 412 // シリーズ単位の凡例 の表示可否 413 rend.setBaseSeriesVisibleInLegend( baseLegend ); 414 415 // 4.1.1.0 (2008/02/04) データの値(itemText)を表示するかどうか 416 if( isItemValVisible ) { 417 // 4.1.2.0 (2008/03/12) 桁区切り文字を使用するかどうか 418 NumberFormat numForm = NumberFormat.getInstance(); 419 numForm.setGroupingUsed( useItemLabelSep ); 420 421 CategoryItemLabelGenerator labelGen 422 = new StandardCategoryItemLabelGenerator( 423 StandardCategoryItemLabelGenerator.DEFAULT_LABEL_FORMAT_STRING, 424 numForm 425 ); 426 rend.setBaseItemLabelGenerator( labelGen ); 427 428 if( serNo >= 0 ) { 429 rend.setSeriesItemLabelsVisible( serNo,true ); 430 } 431 else { 432 rend.setBaseItemLabelsVisible( true ); 433 } 434 // 4.1.1.0 (2008/02/04) 動的なマーカーラインを使用する場合、 435 // 指定の番号は閾値なので、表示しません。 436 if( dynamicOCNo >= 0 ) { 437 rend.setSeriesItemLabelsVisible( dynamicOCNo,false ); // 閾値 438 } 439 440 // 4.1.2.0 (2008/03/12) isItemLastVisible の設定 441 if( isItemLastVisible && rend instanceof HybsDrawItem ) { 442 ((HybsDrawItem)rend).setItemLabelLastVisible( true ) ; 443 } 444 } 445 446 // クリッカブル・マップ 447 if( urlGen != null ) { 448 if( serNo >= 0 ) { 449 rend.setSeriesItemURLGenerator( serNo,urlGen ); 450 } 451 else { 452 rend.setBaseItemURLGenerator( urlGen ); 453 } 454 } 455 456 return rend; 457 } 458 459 /** 460 * 縦軸の表示名称を指定します。 461 * 462 * @param valLbl 縦軸の表示名称 463 */ 464 public void setValueLabel( final String valLbl ) { 465 if( valLbl != null && valLbl.length() > 0 ) { 466 valueLabel = valLbl; 467 } 468 } 469 470 /** 471 * 縦軸の表示名称を取得します。 472 * 473 * @return 縦軸の表示名称 474 */ 475 protected String getValueLabel() { return valueLabel; } 476 477 /** 478 * マーカーラインの設定値配列を指定します。 479 * 480 * 指定の値にマーカーラインを引きます。 481 * 色は、setMarkColor( String ) で指定します。 482 * markColors と、あわせて設定する必要があります。 483 * markColorsが、指定されていない場合は、Color.RED で マーカーされます。 484 * dynamicOCNo を使用する場合は、そのValues の並びの箇所に、 485 * "G" という文字列を設定して下さい。 486 * 例:2000,G 基準1は、2000の直線、基準2は、グラフ という意味。 487 * 488 * @og.rev 4.1.1.0 (2008/02/21) 基準ラインにグラフを使用する場合の位置指定 489 * 490 * @param mkVal マーカーラインの設定値配列 491 * @see #setMarkColors( String[] ) 492 */ 493 public void setMarkValues( final String[] mkVal ) { 494 if( mkVal != null && mkVal.length > 0 ) { 495 int size = mkVal.length; 496 markValues = new double[size]; 497 for( int i=0; i<size; i++ ) { 498 if( "G".equals( mkVal[i] ) ) { 499 dynamicOCadrs = i; 500 markValues[i] = 0.0; 501 } 502 else { 503 markValues[i] = Double.parseDouble( mkVal[i] ); 504 } 505 } 506 } 507 } 508 509 /** 510 * マーカーラインの色を配列指定します。 511 * 512 * マーカーラインとは、縦軸設定のラインの事で、縦軸の設定値(markValues)に 513 * 横方向にラインを付与します。このラインの色を、カンマ区切り形式で 514 * 指定します。 515 * markValues と、あわせて設定する必要があります。 516 * 個数が異なる場合は、markValues が優先され、無指定の場合は、Color.REDで 517 * 表示されます。 518 * 519 * <pre> 520 * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY , 521 * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) 522 * #XXXXXX形式の16bitRGB表記 でも指定可能です。 523 * </pre> 524 * 525 * @param mkCol マーカーラインの色配列 526 * @see java.awt.Color#BLACK 527 * @see #setMarkValues( String[] ) 528 */ 529 public void setMarkColors( final String[] mkCol ) { 530 if( mkCol != null && mkCol.length > 0 ) { 531 int size = mkCol.length; 532 markColors = new Color[size]; 533 for( int i=0; i<size; i++ ) { 534 markColors[i] = StringUtil.getColorInstance( mkCol[i] ); 535 } 536 } 537 } 538 539 /** 540 * マーカーライン描画時に、その設定値を表示します。 541 * 542 * マーカーラインの縦軸の設定値(markValues)に、設定値をラベル表示します。 543 * 位置は、TextAnchor.BASELINE_LEFT 固定です。 544 * 初期値は、表示する(true)です。 545 * 546 * @og.rev 4.1.1.0 (2008/02/04) 新規追加 547 * 548 * @param useAnchor true:設定値を表示する。 549 */ 550 public void setUseMarkAnchor( final boolean useAnchor ) { 551 useMarkAnchor = useAnchor ; 552 } 553 554 /** 555 * マーカーラインの超過時のShape色をカンマ区切り形式で複数指定します。 556 * 557 * HybsLine でのみ使用可能です。 558 * マーカーラインを使用する場合に、そのラインを超えない色、超える色を指定します。 559 * この色の指定は、マーカーラインの色やマーカーラインの設定値の個数+1に 560 * なります。つまり、色1:設定値1:色2:設定値2:色3 となります。 561 * 色1は、設定値1より小さい場合に使用され、色2は、設定値1より大きく、 562 * 設定値2より小さい場合、色3は、設定値2より大きい場合になります。 563 * 564 * 指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。 565 * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY , 566 * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。 567 * また、#XXXXXX形式の16bitRGB表記 でも指定可能です。 568 * markValues と、あわせて設定する必要があります。 569 * どちらかが、指定されていない場合は、マーカー表示されません。 570 * <pre> 571 * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY , 572 * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) 573 * #XXXXXX形式の16bitRGB表記 でも指定可能です。 574 * </pre> 575 * 576 * @og.rev 4.0.3.0 (2008/01/07) 新規追加 577 * 578 * @param ovCol マーカーラインの超過時のShape色 579 * @see java.awt.Color#BLACK 580 */ 581 public void setMarkOverColors( final String[] ovCol ) { 582 if( ovCol != null && ovCol.length > 0 ) { 583 int size = ovCol.length; 584 markOverColors = new Color[size]; 585 for( int i=0; i<size; i++ ) { 586 markOverColors[i] = StringUtil.getColorInstance( ovCol[i] ); 587 } 588 } 589 } 590 591 /** 592 * マーカーラインの超過時のShape色を規定するオブジェクトを返します。 593 * 594 * HybsLine でのみ使用可能です。 595 * 設定情報が存在しない場合は、null を返します。 596 * 597 * @og.rev 4.0.3.0 (2008/01/07) 新規追加 598 * @og.rev 4.1.1.0 (2008/02/04) markColors 属性追加 599 * @og.rev 4.1.1.1 (2008/02/25) markValues での "G" 指定を考慮 600 * 601 * @return マーカーラインの超過時のShape色管理オブジェクト 602 */ 603 private ValueMarkOverColors getValueMarkOverColors() { 604 ValueMarkOverColors vmoc = null; 605 606 if( markValues != null && markOverColors != null && 607 markValues.length + 1 == markOverColors.length && 608 markValues.length >= 1 ) { 609 int dynAdrs = (dynamicOCadrs >= 0) ? dynamicOCadrs : 0 ; 610 611 vmoc = new ValueMarkOverColors( 612 markValues, 613 markOverColors, 614 markColors[dynAdrs], 615 dynamicOCadrs 616 ); 617 } 618 619 return vmoc ; 620 } 621 622 /** 623 * 動的なマーカーラインの基準シリーズ番号を設定します(初期値:-1)。 624 * 625 * 動的なマーカーラインを使用する場合は、基準値となるシリーズ番号を指定します。 626 * 627 * マーカーラインの最下位閾値に相当します。これは、グラフ化されますが、 628 * Shape は自動的に削除されます。 629 * この設定を使用する場合、最初のデータには、必ずShapeが付きます。それ以外の 630 * データに、Shape を付けるかどうかは、shapesVisible 属性で指定します。 631 * この線の色は、markColors で指定した、最下位の色になります。また、 632 * markValues で指定した、最下位の値は、使用されません。ただし、色指定の 633 * 関係上、設定しておく必要があります。 634 * また、isValueVisible == true で、設定値の値表示を行う場合も、最下位の 635 * 値は表示しないようにします。 636 * 初期値は、使用しない(-1)です。 637 * 638 * @og.rev 4.1.1.0 (2008/02/04) 新規追加 639 * @og.rev 4.1.1.0 (2008/02/19) setUseDynamicOC ⇒ setDynamicOCNo 640 * 641 * @param ocNo 動的なマーカーラインの基準シリーズ番号 642 */ 643 public void setDynamicOCNo( final int ocNo ) { 644 dynamicOCNo = ocNo; 645 } 646 647 /** 648 * マーカーラインの ValueMarker オブジェクト配列を返します。 649 * 650 * マーカーライン は、markValues(double配列) と markColors(Color配列) 651 * より、ValueMarker オブジェクトを、順次配列化していきます。 652 * useMarkAnchor == true の場合は、設定値(markValues) の Anchor を 653 * 表示します。位置は、TextAnchor.BASELINE_LEFT 固定です。 654 * dynamicOCNo が指定された場合は、最下位の閾値は使用しません。 655 * 656 * @og.rev 4.1.1.0 (2008/02/04) useMarkAnchor 属性追加 657 * @og.rev 4.1.1.0 (2008/02/04) 動的なオーバーカラー useDynamicOC 属性追加 658 * 659 * @return マーカーラインのオブジェクト配列(not null) 660 * @see java.awt.Color#BLACK 661 * @see #setMarkValues( String[] ) 662 * @see #setMarkColors( String[] ) 663 * @see #setUseMarkAnchor( boolean ) 664 */ 665 protected ValueMarker[] getValueMarkers() { 666 List<ValueMarker> markerList = new ArrayList<ValueMarker>(); 667 int size = (markValues == null) ? 0 : markValues.length; 668 for( int i=0; i<size; i++ ) { 669 if( i != dynamicOCadrs ) { 670 ValueMarker marker = new ValueMarker( markValues[i] ); 671 marker.setPaint( markColors[i] ); 672 if( useMarkAnchor ) { 673 marker.setLabel( String.valueOf( markValues[i] ) ); 674 marker.setLabelTextAnchor( TextAnchor.BASELINE_LEFT ); 675 } 676 markerList.add( marker ); 677 } 678 } 679 680 return markerList.toArray( new ValueMarker[markerList.size()] ); 681 } 682 683 /** 684 * チャートの縦軸の最小値をセットします(初期値:自動計算)。 685 * 686 * 何も指定しない場合は、データの最小値から、自動的に計算します。 687 * 688 * @param lowBnd 縦軸の最小値 689 * @see #setUpperBound( String ) 690 */ 691 public void setLowerBound( final String lowBnd ) { 692 if( lowBnd != null && lowBnd.length() > 0 ) { 693 lowerBound = lowBnd; 694 } 695 } 696 697 /** 698 * チャートの縦軸の最大値をセットします(初期値:自動計算)。 699 * 700 * 何も指定しない場合は、データの最大値から、自動的に計算します。 701 * 702 * @param upBnd 縦軸の最大値 703 * @see #setLowerBound( String ) 704 */ 705 public void setUpperBound( final String upBnd ) { 706 if( upBnd != null && upBnd.length() > 0 ) { 707 upperBound = upBnd; 708 } 709 } 710 711 /** 712 * チャートの縦軸の目盛の幅をセットします(初期値:自動計算)。 713 * 714 * 何も指定しない場合は、データの範囲から、自動的に計算します。 715 * 716 * @og.rev 4.0.3.0 (2008/01/07) 新規追加 717 * 718 * @param size 縦軸のチック(目盛)の幅 719 */ 720 public void setTickSize( final String size ) { 721 if( size != null && size.length() > 0 ) { 722 tickSize = size; 723 } 724 } 725 726 /** 727 * バーチャートのグラデーション処理を行うかどうか[true/false]をセットします(初期値:true)。 728 * 729 * 通常のバーチャートは、単一色表示で表されますが、これにグラデーション効果を 730 * 付加するかどうかを指定します。 731 * 通常のバーチャートが、少しきれいに見えます。 732 * 初期値は、true(グラデーション効果を付与する)です。 733 * 734 * @param useGrad グラデーション処理 [true:する/false:しない] 735 */ 736 public void setUseGradient( final boolean useGrad ) { 737 useGradient = useGrad; 738 } 739 740 /** 741 * バーチャートのグラデーション処理を行うかどうかを取得します。 742 * 743 * 通常のバーチャートは、単一色表示で表されますが、これにグラデーション効果を 744 * 付加するかどうかを指定します。 745 * 通常のバーチャートが、少しきれいに見えます。 746 * 初期値は、false(使用しない)です。 747 * 748 * @return グラデーション処理(する:true/しない:false) 749 * @see #setUseGradient( boolean ) 750 */ 751 protected boolean isUseGradient() { return useGradient; } 752 753 /** 754 * ラインチャートのポイントを四角表示するかどうかを指定します(初期値:false)。 755 * 756 * ラインチャートは、通常、線分で表され、各ポイントについても、線分で接続されます。 757 * shapesVisible を true に設定すると、各ポイントが、線上に四角く表示され、 758 * そのポイントの位置を、容易に判断出来るようになります。 759 * 初期値は、マーカーを入れません。 760 * 761 * @param shVisible ポイントを四角表示するかどうか 762 */ 763 public void setShapesVisible( final boolean shVisible ) { 764 shapesVisible = shVisible; 765 } 766 767 /** 768 * ラインチャートのポイントを四角表示するかどうかを取得します。 769 * 770 * ラインチャートは、通常、線分で表され、各ポイントについても、線分で接続されます。 771 * shapesVisible を true に設定すると、各ポイントが、線上に四角く表示され、 772 * そのポイントの位置を、容易に判断出来るようになります。 773 * 初期値は、マーカーを入れません。 774 * 775 * @return ポイントを四角表示するかどうか 776 * @see #setShapesVisible( boolean ) 777 */ 778 protected boolean isShapesVisible() { return shapesVisible; } 779 780 /** 781 * データ毎にShapeを切り替える時の色の繰返しパターンを文字列配列で指定します。 782 * 783 * HybsLine でのみ使用可能です。 784 * これは、データそのものが、繰返し性のある場合に、その繰返し性に対応した 785 * 形状のShape を表示させる場合に使用します。 786 * 繰返しShapeの形状は、JFreeChart のシリーズ毎の繰返し標準形状を使用します。 787 * 現在のバージョンでは、10個までの繰返しに対応可能です。 788 * 繰返し色を、指定した分だけ、順に使用されていきます。 789 * 790 * 指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。 791 * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY , 792 * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。 793 * また、#XXXXXX形式の16bitRGB表記 でも指定可能です。 794 * 795 * @og.rev 4.0.3.0 (2008/01/07) 新規追加 796 * 797 * @param colors データ毎の色の繰返しパターン(文字列配列) 798 * @see java.awt.Color#BLACK 799 */ 800 public void setShapeColors( final String[] colors ) { 801 if( colors != null && colors.length > 0 ) { 802 int size = colors.length; 803 shapeColors = new Color[size]; 804 for( int i=0; i<size; i++ ) { 805 shapeColors[i] = StringUtil.getColorInstance( colors[i] ); 806 } 807 } 808 } 809 810 /** 811 * shapeの大きさを倍率指定で変更します(初期値:null)。 812 * 813 * ラインチャートのShape(各グラフのポイントのマーカー)の大きさは、通常は、 814 * 自動設定されます。 815 * この大きさを、倍率指定で、変更可能です。 816 * 指定は、double 型です。 817 * 初期値は、null は、スケール変更しません(自動設定のままの大きさ) 818 * 819 * @og.rev 4.1.1.0 (2008/02/04) 新規追加 820 * 821 * @param scale shapeの大きさの倍率 822 */ 823 public void setShapeScale( final String scale ) { 824 shapeScale = scale; 825 } 826 827 /** 828 * ラインチャートの線をドットラインにするかどうかを指定します(初期値:false)。 829 * 830 * ラインチャートは、通常、線分で表されます。 831 * これに、点線で表すことで、グラフの違いを、色だけでなく形状でも識別 832 * しやすくすることが可能です。 833 * 初期値は、線分です。 834 * 835 * @param useDotLine ドットラインにするかどうか 836 */ 837 public void setUseDottedLine( final boolean useDotLine ) { 838 useDottedLine = useDotLine; 839 } 840 841 /** 842 * ラインチャートの線をドットラインにするかどうかを取得します。 843 * 844 * ラインチャートは、通常、線分で表されます。 845 * これに、点線で表すことで、グラフの違いを、色だけでなく形状でも識別 846 * しやすくすることが可能です。 847 * 初期値は、線分です。 848 * 849 * @return ドットラインにするかどうか 850 * @see #setUseDottedLine( boolean ) 851 */ 852 protected boolean isUseDottedLine() { return useDottedLine; } 853 854 /** 855 * 複数チャート描画時のチャート色の繰返しパターンを文字列配列で指定します。 856 * 857 * 通常、複数のチャートを同時に表示させる場合は、縦軸が共通であれば、 858 * 1回のSelect分で複数データを取得します。 859 * この、データをシリーズと呼んでおり、これを区別する為に、色を分けます。 860 * 初期値は、JFreeChart が自動で割り振ります。 861 * これを、外部からCVS形式で、カンマ区切りで色コードを指定します。 862 * 指定データが多い場合は、多い分の色は使用されません。少ない場合は、 863 * 順番に繰り返して使用されます。 864 * 例えば、1色だけ指定した場合は、すべてのシリーズが同じ色で表されます。 865 * 866 * 指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。 867 * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY , 868 * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。 869 * また、#XXXXXX形式の16bitRGB表記 でも指定可能です。 870 * 871 * @param colors チャート色の繰返しパターン(文字列配列) 872 * @see java.awt.Color#BLACK 873 */ 874 public void setSeriesColors( final String[] colors ) { 875 if( colors != null && colors.length > 0 ) { 876 int size = colors.length; 877 seriesColors = new Color[size]; 878 for( int i=0; i<size; i++ ) { 879 seriesColors[i] = StringUtil.getColorInstance( colors[i] ); 880 } 881 } 882 } 883 884 /** 885 * 複数チャート描画時のチャート色の繰返しパターンをColor配列で指定します。 886 * 887 * @return チャート色の繰返しパターン(Color配列) 888 * @see #setSeriesColors( String[] ) 889 */ 890 protected Color[] getSeriesColors() { 891 return seriesColors ; 892 } 893 894 /** 895 * Value(縦軸)のラベルを表示するかどうかを指定します(初期値:true[表示する])。 896 * 897 * ValueAxis にて設定される、縦軸情報の、ラベルを表示するかどうか指定します。 898 * 初期値は、true(表示する)です。 899 * 900 * @og.rev 4.0.2.0 (2007/12/20) 新規追加 901 * 902 * @param labelsVisible Value(縦軸)のラベルを表示するかどうか 903 */ 904 public void setValueLabelsVisible( final boolean labelsVisible ) { 905 isLabelsVisible = labelsVisible; 906 } 907 908 /** 909 * Value(縦軸)のマーカーを表示するかどうかを指定します(初期値:true[表示する])。 910 * 911 * ValueAxis にて設定される、縦軸情報の、マーカーを表示するかどうか指定します。 912 * 初期値は、true(表示する)です。 913 * 914 * @og.rev 4.0.2.0 (2007/12/20) 新規追加 915 * 916 * @param marksVisible Value(縦軸)のマーカーを表示するかどうか 917 */ 918 public void setValueMarksVisible( final boolean marksVisible ) { 919 isMarksVisible = marksVisible; 920 } 921 922 /** 923 * データの値(itemText)を表示するかどうか[true/false/last]を指定します(初期値:false[表示しない])。 924 * 925 * CategoryItemRenderer 関連のグラフの設定値をグラフ上に表示するかどうかを 926 * 指定します。 927 * true に設定した場合、通常の場合は、すべてのシリーズにラベル表示されます。 928 * false に設定すると、表示されません。 929 * last を設定すると、各シリーズの最後の値のみ表示されます。 930 * ChartCreate クラスに、seriesPikup が設定されている場合は、指定のシリーズ 931 * のみの設定値を表示し、他の値は、表示しません。 932 * 同様に、dynamicOCNo が指定されている場合(動的なマーカーライン) 933 * 指定のシリーズは、閾値として使用されるため、設定値は表示されません。 934 * ラベルの表示位置は、表示する線グラフの傾きに応じてラベルの表示場所を 935 * 変えます。山形、右坂、谷形、左坂 に応じて、上中、下右、下中、上右 に 936 * 位置を設定します。右にずらすのは、10 ピクセル固定です。 937 * 初期値は、false(表示しない)です。 938 * 939 * @og.rev 4.1.1.0 (2008/02/04) 新規追加 940 * @og.rev 4.1.2.0 (2008/03/12) 文字列のまま、受け取りるように変更 941 * 942 * @param visible データの値の表示のさせ方 [true/false/last] 943 * @see ChartCreate#setSeriesPikup( int ) 944 */ 945 public void setItemLabelVisible( final String visible ) { 946 if( "true".equalsIgnoreCase( visible ) ) { 947 isItemValVisible = true; 948 } 949 else if( "last".equalsIgnoreCase( visible ) ) { 950 isItemValVisible = true; 951 isItemLastVisible = true; 952 } 953 else if( visible != null && !"false".equalsIgnoreCase( visible ) ) { 954 String errMsg = "itemLabelVisible は、「true,false,last」から指定してください。[" 955 + visible + "]"; 956 throw new HybsSystemException( errMsg ); 957 } 958 } 959 960 /** 961 * データの値(itemText)の表示に桁区切り文字を使用するかどうかを指定します。 962 * 963 * itemLabelVisible=true 時に、表示されるデータ値ラベルで、 964 * NumberFormat していますが、3桁区切り文字(123,456,789.0) の 965 * 区切り記号を表示するかどうかを指定します。 966 * true を指定すると、表示します。false では、表示しません。 967 * 初期値は、true(使用する)です。 968 * 969 * @og.rev 4.1.2.0 (2008/03/12) 新規追加 970 * 971 * @param used 桁区切り文字を使用するかどうか 972 */ 973 public void setUseItemLabelSep( final boolean used ) { 974 useItemLabelSep = used; 975 } 976 977 /** 978 * 縦軸の表示領域INSET値(double)を指定します。 979 * 980 * 縦軸文字表示領域(NumberAxis)の幅の追加値を設定します。 981 * これは、通常の表示領域の左側にスペースを挿入します。 982 * あくまで、追加する値なので、文字の長さは含まれません。 983 * 何も指定しない場合は、設定しません。 984 * 985 * @og.rev 4.0.3.0 (2008/01/07) 新規追加 986 * 987 * @param inset Value(縦軸)の表示領域INSET値 988 */ 989 public void setValueInset( final String inset ) { 990 valueInset = inset; 991 } 992 993 /** 994 * BOXチャートのバー幅(double)を指定します。 995 * 996 * BOXチャートのバー幅(double)を指定します。 997 * 設定されるのは、org.jfree.chart.renderer.category.BarRenderer を 998 * 使用した描画のみです。 999 * 棒グラフのバー幅指定は、直接、CategoryItemRendererState に設定しています。 1000 * 通常は、barMaxWidth(0.0~1.0)とbarItemMargin(0.0~1.0)を用いて比率で指定します。 1001 * 何も指定しない場合は、設定しません。 1002 * 1003 * @og.rev 4.0.3.0 (2008/01/07) 新規追加 1004 * 1005 * @param width BOXチャートのバー幅(double) 1006 */ 1007 public void setBarWidth( final String width ) { 1008 barWidth = width; 1009 } 1010 1011 /** 1012 * BOXチャートのバー幅(double)を取得します。 1013 * 1014 * 設定されるのは、org.jfree.chart.renderer.category.BarRenderer を 1015 * 使用した描画のみです。 1016 * 棒グラフのバー幅指定は、直接、CategoryItemRendererState に設定しています。 1017 * 通常は、barMaxWidth(0.0~1.0)とbarItemMargin(0.0~1.0)を用いて比率で指定します。 1018 * 何も指定しない場合は、設定しません。 1019 * 1020 * @og.rev 4.0.3.0 (2008/01/07) 新規追加 1021 * 1022 * @return BOXチャートのバー幅(double)の文字列 1023 */ 1024 protected String getBarWidth() { 1025 return barWidth ; 1026 } 1027 1028 /** 1029 * BOXチャートのバー幅の最大値(0.0~1.0)を指定します。 1030 * 1031 * BOXチャートのバー幅の比率の最大値を指定します。 1032 * 表示領域を1として小数点以下の数値で棒の幅を設定します。 1033 * 設定した幅に無理がある時は適当なサイズに調整されます。 1034 * (小さくしたときには棒が線のようになる) 1035 * 設定されるのは、org.jfree.chart.renderer.category.BarRenderer を 1036 * 使用した描画のみです。 1037 * 何も指定しない場合は、設定しません。 1038 * 1039 * @og.rev 4.0.2.0 (2007/12/20) 新規追加 1040 * 1041 * @param barWidth BOXチャートのバー幅の最大値(0.0~1.0) 1042 */ 1043 public void setBarMaxWidth( final String barWidth ) { 1044 maxBarWidth = barWidth; 1045 } 1046 1047 /** 1048 * BOXチャートのバーアイテムのマージン(0.0~1.0)を指定します。 1049 * 1050 * BOXチャートのバーアイテムのマージンの比率を指定します。 1051 * 棒の間を表示領域を1として小数点以下の数値で幅を設定します。 1052 * 無理がある時は適当なサイズに調整されます。 1053 * barMaxWidth より優先されます。 1054 * 設定されるのは、org.jfree.chart.renderer.category.BarRenderer を 1055 * 使用した描画のみです。 1056 * 何も指定しない場合は、設定しません。 1057 * 1058 * @og.rev 4.0.2.0 (2007/12/20) 新規追加 1059 * 1060 * @param margin BOXチャートのバーアイテムのマージン(0.0~1.0) 1061 */ 1062 public void setBarItemMargin( final String margin ) { 1063 itemMargin = margin; 1064 } 1065 1066 /** 1067 * 表示下限値(これ以下のデータは未表示)の値(double)を指定します。 1068 * 1069 * HybsLine でのみ使用可能です。 1070 * この設定値以下のデータは、存在しない扱いとします。 1071 * Lineを引くとき、このデータと、存在しているデータ間にラインは引かれません。 1072 * 何も指定しない場合は、設定しません。 1073 * 1074 * @og.rev 4.0.3.0 (2008/01/07) 新規追加 1075 * 1076 * @param limit 表示下限値(これ以下のデータは未表示) 1077 */ 1078 public void setVisibleLimit( final String limit ) { 1079 visibleLimit = limit; 1080 } 1081 1082 /** 1083 * グラフの書き出し位置の調整比率を指定します。 1084 * 1085 * グラフを描画する場合の、書き出し位置を少しずらします。 1086 * これは、グラフの幅に対して、比率で指定します。 1087 * 0.0(初期値)の場合は、初期描画位置である、CategoryAnchor.Middle と 1088 * 同じ箇所から、書き出されます。 1089 * 1.0 の場合、中心から、グラフ幅の半分が加算され、END位置に寄ります。 1090 * 同様に、-1.0 の場合は、グラフ幅の半分が減算され、START 位置になります。 1091 * つまり、中心から、グラフ幅の半分単位で、前方/後方にずらす事が出来ます。 1092 * 書き出し位置 = 中心(Middle) + (domainMargin)*幅/2 1093 * 初期値は、0.0(真ん中:MIDDLE)です。 1094 * 1095 * @og.rev 4.1.1.0 (2008/02/14) 新規追加 1096 * 1097 * @param margin グラフの書き出し位置の調整比率 1098 */ 1099 public void setDomainMargin( final double margin ) { 1100 domainMargin = margin; 1101 } 1102 1103 /** 1104 * 時刻を表す場合の表現の仕方を指定します(初期値:null)。 1105 * 1106 * HybsNumberAxis にオーバーライドする 時間を表示する DecimalFormat の内部クラスを利用するに当たり、 1107 * 時刻の表示方法を指定します。 1108 * 外部から与える数字は、連続している必要があるため、10進数です。 1109 * たとえば、1700 → 17:00 , 2150 → 21:30 という感じです。 1110 * 2400 を超えると日付違いになります。 1111 * 1112 * 英語表記(:)と日本語表記(時)の区別と、24時間を超える場合の表示方法によって、6種類のパターンが存在します。 1113 * E1:そのまま、24:00 となり、加算されていく。 1114 * E2:そのまま、0:00 に戻る。(日付は無視) 1115 * E3:そのまま、1 00:00 と日付が付与される。 1116 * H1:そのまま、24時00分 となり、加算されていく。 1117 * H2:そのまま、00時00分 に戻る。(日付は無視) 1118 * H3:そのまま、1日 00時00分 と日付が付与される。 1119 * 初期値は、使用しない(-1)です。 1120 * 1121 * @og.rev 5.5.2.1 (2012/05/07) 新規追加 1122 * 1123 * @param type 時刻の表示方法 [E1/E2/E3/H1/H2/H3] 1124 */ 1125 public void setTimeFormatType( final String type ) { 1126 timeFormatType = type; 1127 } 1128 1129 /** 1130 * ラベルの表示向きを縦にするかどうか[true/false]を指定します(初期値:false)。 1131 * 1132 * ChartCreate の rotationLabel は、角度を指定できましたが、NumberAxis では、 1133 * 縦にするかどうかの指定しかできません。 1134 * ここでは、true を指定するとラベルは、縦書きになります。 1135 * 初期値は、false(横書き)です。 1136 * 1137 * @og.rev 5.5.2.1 (2012/05/07) 新規追加 1138 * 1139 * @param useVLavels ラベルの表示向き [false:横書き/:true:縦書き] 1140 */ 1141 public void setUseVerticalLabels( final boolean useVLavels ) { 1142 useVerticalLabels = useVLavels; 1143 } 1144 1145 /** 1146 * MeterPlot に必要な情報を設定します。 1147 * 1148 * これは、ChartDataset(このクラス)に必要な getterメソッドを用意して、 1149 * 利用側のクラス(ChartPlot_Pie) でセットすべきですが、メソッドが増えるので、 1150 * こちらに MeterPlotオブジェクトを渡して、メソッド数を減らそうとしているだけです。 1151 * 1152 * lowerBound は、最小値(low) 1153 * upperBound は、最大値(upp) 1154 * markValues 値,A,B,C 1155 * markOverColors GREEN,BLUE,YELLOW,RED 1156 * low-A⇒GREEN , A-B⇒BLUE , B-C⇒YELLOW , C-upp⇒RED で、MeterIntervalを指定します。 1157 * 1158 * shapeColors に、NeedlePaint,ValuePaint,TickPaint,TickLabelPaint,DialBackgroundPaint,DialOutlinePaint を指定できます。 1159 * 初期値は、BLACK,BLACK,BLACK,BLACK,透明,BLACK です。 1160 * needleType に、DialShape の指定キーワードとして、CHORD,CIRCLE,PIE が指定可能です。 1161 * 指定方法としては、taglib上で、chartType 指定時に、Meter_PIE などと指定します。 1162 * shapeScale は、MeterAngle(メーターの表示角度) を指定できます。 1163 * valueLabel は、MeterInterval の規定値(値,A,B,C) に対応した凡例ラベルです。 1164 * 1165 * @og.rev 5.7.8.0 (2014/07/04) 新規追加 1166 * 1167 * @return 値をセットし終わった、MeterPlotオブジェクト 1168 */ 1169 protected Plot makeMeterPlot() { 1170 MeterPlot mplot = new MeterPlot(); 1171 1172 // 範囲(上限、下限)指定 1173 double low= lowerBound == null ? 0.0 : Double.parseDouble( lowerBound ) ; 1174 double upp= upperBound == null ? 100.0 : Double.parseDouble( upperBound ) ; 1175 mplot.setRange( new Range( low, upp ) ); 1176 1177 // markValues 値,A,B,C 1178 // markOverColors GREEN,BLUE,YELLOW,RED 1179 // low-A⇒GREEN , A-B⇒BLUE , B-C⇒YELLOW , C-upp⇒RED 1180 // 範囲の指定(MeterInterval)は、markValues に、2番目の値が設定された場合に行う。 1181 if( markValues != null && markValues.length > 1 ) { 1182 int size = markValues.length ; 1183 if( markOverColors != null && size == markOverColors.length ) { 1184 1185 // BasicStroke に、大きな値を指定すると、開始位置がずれてしまう。 1186 BasicStroke bs = new BasicStroke( 2.0F ); 1187 1188 // valueLabel は、markValues の規定値(A,B,C) に対応した凡例ラベルです。 1189 String[] lbls = StringUtil.csv2Array( valueLabel ); 1190 int lblSize = lbls.length ; 1191 int j = 0; // ラベルの配列番号 1192 1193 double st = low; 1194 for( int i=1; i<=size; i++ ) { 1195 double en = i<size ? markValues[i] : upp ; 1196 Color co1 = markOverColors[i-1]; 1197 Color co2 = new Color( co1.getRed() , co1.getGreen() , co1.getBlue() , 128 ); // 透過色(半透明) 1198 String lbl = j < lblSize ? lbls[j++] : "" ; 1199 mplot.addInterval( new MeterInterval( lbl, new Range( st, en ), co1, bs, co2 ) ); 1200 st = en ; 1201 } 1202 } 1203 else { 1204 String errMsg = "Meter で、markValues を複数指定する場合は、同じ数のmarkOverColorsの指定が必要です。" 1205 + HybsSystem.CR ; 1206 throw new HybsSystemException( errMsg ); 1207 } 1208 } 1209 1210// 範囲の指定(MeterInterval) のサンプル 1211// mplot.addInterval(new MeterInterval("Battery LOW", new Range(0.0, 10.0), 1212// Color.RED, new BasicStroke(2.0F), new Color(255, 0, 0, 128))); 1213// mplot.addInterval(new MeterInterval("Moderate", new Range(10.0, 90.0), 1214// Color.YELLOW, new BasicStroke(2.0F), new Color(255, 255, 0, 64))); 1215// mplot.addInterval(new MeterInterval("Battery FULL", new Range(90.0, 100.0), 1216// Color.GREEN, new BasicStroke(2.0F), new Color(0, 255, 0, 64))); 1217 1218 // TickSize を設定。null ならば、初期値を使うので、設定しない。 1219 if( tickSize != null ) { 1220 mplot.setTickSize( Double.parseDouble( tickSize ) ); 1221 } 1222 1223 // shapeColors に、NeedlePaint,ValuePaint,TickPaint,TickLabelPaint,DialBackgroundPaint,DialOutlinePaint を指定できます。 1224 // NeedlePaint , ValuePaint , TickPaint , TickLabelPaint , DialBackgroundPaint(=透明) , DialOutlinePaint 1225 Color[] shCols = new Color[] { Color.BLACK , Color.BLACK , Color.BLACK , Color.BLACK , new Color(255, 255, 255, 0), Color.BLACK }; // 初期値 1226 if( shapeColors != null && shapeColors.length > 0 ) { 1227 for( int i=0; i<shapeColors.length; i++ ) { 1228 shCols[i] = shapeColors[i]; 1229 } 1230 } 1231 mplot.setNeedlePaint( shCols[0] ); // 針の色 1232 mplot.setValuePaint( shCols[1] ); // 値の色 1233 mplot.setTickPaint( shCols[2] ); // メモリの色 1234 mplot.setTickLabelPaint( shCols[3] ); // メモリの文字の色 1235 mplot.setDialBackgroundPaint( shCols[4] ); // 背景色 1236 mplot.setDialOutlinePaint( shCols[5] ); // セットしても、表示が変わらない。 1237 1238 // needleType 属性で、DialShape を指定できます。 1239 DialShape dshape = DialShape.CIRCLE ; // 初期値 1240 if( needleType != null ) { 1241 if( "CHORD".equalsIgnoreCase( needleType ) ) { dshape = DialShape.CHORD; } 1242 else if( "CIRCLE".equalsIgnoreCase( needleType ) ) { dshape = DialShape.CIRCLE; } // 初期値 1243 else if( "PIE".equalsIgnoreCase( needleType ) ) { dshape = DialShape.PIE; } 1244 } 1245 mplot.setDialShape( dshape ); // CHORD,CIRCLE,PIE 1246 1247 // shapeScale は、MeterAngle(メーターの表示角度) を指定 1248 if( shapeScale != null ) { 1249 mplot.setMeterAngle( Integer.parseInt( shapeScale ) ); 1250 } 1251 1252 // isLabelsVisible 指定 1253 mplot.setTickLabelsVisible( isLabelsVisible ); 1254 1255 // その他決め打ちの値設定 1256 // mplot.setValueFont(new Font("Arial", Font.BOLD, 14)); 1257 // mplot.setTickLabelFont(new Font("Arial", Font.BOLD, 14)); 1258 1259 mplot.setDataset( (ValueDataset)dataset ); 1260 return mplot; 1261 } 1262 1263 /** 1264 * ThermometerPlot に必要な情報を設定します。 1265 * 1266 * markValues 値,A,B 1267 * markOverColors GREEN,YELLOW,RED 1268 * xxx-low⇒GRAY , low-A⇒GREEN , A-B⇒YELLOW , B-upp⇒RED , upp-xxx⇒GRAY で、SubrangePaintを指定します。 1269 * markOverColors を指定しない場合は、ThermometerPlot.NORMAL , WARNING , CRITICAL が順に指定されます。 1270 * これは、GREEN,YELLOW,RED になります。 1271 * 1272 * shapeColors に、ValuePaint,ThermometerPaint(温度計の枠線),MercuryPaint を指定できます。 1273 * 1274 * @og.rev 5.7.8.0 (2014/07/04) 新規追加 1275 * 1276 * @return 値をセットし終わった、元のThermometerPlotオブジェクト 1277 */ 1278 protected Plot makeThermometerPlot() { 1279 ThermometerPlot tplot = new ThermometerPlot(); 1280 1281 // 範囲(上限、下限)指定 1282 double low= lowerBound == null ? 0.0 : Double.parseDouble( lowerBound ) ; 1283 double upp= upperBound == null ? 100.0 : Double.parseDouble( upperBound ) ; 1284 tplot.setRange( low , upp ); 1285 1286 // markValues 値,A,B,C 1287 // markOverColors GREEN,YELLOW,RED 1288 // low-A⇒Red , A-B⇒Yellow , B-C⇒Green , C-upp⇒Blue 1289 // 範囲の指定(MeterInterval)は、markValues に、2番目の値が設定された場合に行う。 1290 if( markValues != null && markValues.length > 1 ) { 1291 int size = markValues.length ; 1292 1293 // markOverColors が存在して、個数が一致していれば、true 1294 boolean inCols = ( markOverColors != null && size == markOverColors.length ) ; 1295 if( inCols || markOverColors == null || markOverColors.length == 0 ) { 1296 double st = low; 1297 for( int i=1; i<=size; i++ ) { 1298 double en = i<size ? markValues[i] : upp ; 1299 // 第一引数は、i(順番)ではなく、サブレンジ番号(ThermometerPlot.NORMAL , WARNING , CRITICAL) 1300 tplot.setSubrange( i-1, st, en ); 1301 1302 if( inCols ) { 1303 Color co1 = markOverColors[i-1]; 1304 tplot.setSubrangePaint( i-1,co1 ); 1305 } 1306 st = en ; 1307 } 1308 } 1309 else { 1310 String errMsg = "Meter で、markValues を複数指定する場合は、同じ数のmarkOverColorsの指定が必要です。" 1311 + HybsSystem.CR ; 1312 throw new HybsSystemException( errMsg ); 1313 } 1314 } 1315 1316// 範囲の指定(setSubrange) のサンプル 1317// tplot.setSubrange(ThermometerPlot.NORMAL , 0.0, 55.0); 1318// tplot.setSubrange(ThermometerPlot.WARNING , 55.0, 75.0); 1319// tplot.setSubrange(ThermometerPlot.CRITICAL, 75.0, 150.0); 1320 1321 // shapeColors に、ValuePaint,ThermometerPaint(温度計の枠線),MercuryPaint を指定できます。 1322 // ValuePaint , ThermometerPaint , MercuryPaint 1323 Color[] shCols = new Color[] { Color.BLACK , Color.BLACK , Color.GRAY }; // 初期値 1324 if( shapeColors != null && shapeColors.length > 0 ) { 1325 for( int i=0; i<shapeColors.length; i++ ) { 1326 shCols[i] = shapeColors[i]; 1327 } 1328 } 1329 tplot.setValuePaint( shCols[0] ); // 値の色 1330 tplot.setThermometerPaint( shCols[1] ); // 温度計の枠線 1331 tplot.setMercuryPaint( shCols[2] ); // オーバー時の色 1332 1333 // tplot.setValueFont(new Font("Arial", 1, 14)); 1334 1335 tplot.setDataset( (ValueDataset)dataset ); 1336 return tplot; 1337 } 1338 1339 /** 1340 * CompassPlot に必要な情報を設定します。 1341 * 1342 * shapeColors に、Compassの色を指定できます。(内部的には、SeriesPaint にセットしています) 1343 * SeriesPaint,SeriesOutlinePaint,RoseCenterPaint,RoseHighlightPaint,RosePaint を指定します。 1344 * needleType には、MeterNeedle の指定キーワードとして、下記の9種類が指定可能です。 1345 * 指定は、Arrow,Line,Long,Pin,Plum,Pointer,Ship,Wind,Arrow,MiddlePin という文字列です。 1346 * 初期値は、Pointer です。 1347 * 1348 * @og.rev 5.7.8.0 (2014/07/04) 新規追加 1349 * 1350 * @return 値をセットし終わった、元のCompassPlotオブジェクト 1351 */ 1352 protected Plot makeCompassPlot() { 1353 CompassPlot cplot = new CompassPlot(); 1354 1355 // Series 指定は、0 固定 1356 final int serNo = 0; 1357 1358 // needleType 属性で、SeriesNeedle 番号を指定できます。 1359 int sNeedle = 5 ; // Pointer 1360 if( needleType != null ) { 1361 if( "Arrow".equalsIgnoreCase( needleType ) ) { sNeedle = 0; } // 0 = ArrowNeedle; 1362 else if( "Line".equalsIgnoreCase( needleType ) ) { sNeedle = 1; } // 1 = LineNeedle; 1363 else if( "Long".equalsIgnoreCase( needleType ) ) { sNeedle = 2; } // 2 = LongNeedle; 1364 else if( "Pin".equalsIgnoreCase( needleType ) ) { sNeedle = 3; } // 3 = PinNeedle; 1365 else if( "Plum".equalsIgnoreCase( needleType ) ) { sNeedle = 4; } // 4 = PlumNeedle; 1366 else if( "Pointer".equalsIgnoreCase( needleType ) ) { sNeedle = 5; } // 5 = PointerNeedle; 1367 else if( "Ship".equalsIgnoreCase( needleType ) ) { sNeedle = 6; } // 6 = ShipNeedle; 1368 else if( "Wind".equalsIgnoreCase( needleType ) ) { sNeedle = 7; } // 7 = WindNeedle; 1369 else if( "Arrow".equalsIgnoreCase( needleType ) ) { sNeedle = 8; } // 8 = ArrowNeedle; 1370 else if( "MiddlePin".equalsIgnoreCase( needleType ) ) { sNeedle = 9; } // 9 = MiddlePinNeedle; 1371 } 1372 cplot.setSeriesNeedle( serNo, sNeedle ); 1373 1374 // shapeColors に、SeriesPaint,SeriesOutlinePaint,RoseCenterPaint,RoseHighlightPaint,RosePaint を指定 1375 // SeriesPaint, SeriesOutlinePaint , RoseCenter , RoseHighlight, Rose 1376 Color[] shCols = new Color[] { Color.RED , Color.BLACK , Color.WHITE , Color.BLACK , Color.YELLOW }; // 初期値 1377 if( shapeColors != null && shapeColors.length > 0 ) { 1378 for( int i=0; i<shapeColors.length; i++ ) { 1379 shCols[i] = shapeColors[i]; 1380 } 1381 } 1382 cplot.setSeriesPaint( serNo, shCols[0] ); // 針の色 1383 cplot.setSeriesOutlinePaint( serNo, shCols[1] ); // 針の枠の色 1384 cplot.setRoseCenterPaint( shCols[2] ); // 文字盤の中心の 1385 cplot.setRoseHighlightPaint( shCols[3] ); // 文字盤の文字、枠色 1386 cplot.setRosePaint( shCols[4] ); // 枠の塗りつぶし色 1387 1388 cplot.addDataset( (ValueDataset)dataset ); 1389 1390 return cplot; 1391 } 1392 1393 /** 1394 * HybsNumberAxis にオーバーライドする 時間を表示する DecimalFormat の内部クラスを定義します。 1395 * 1396 * これは、ChartPlot_XY で使用する、HybsNumberAxis に対して、拡張します。 1397 * データが、時刻を表す場合、Date型のオブジェクトを利用して、org.jfree.chart.axis.PeriodAxis 1398 * を利用できればよいのですが、単なる数字で扱っているケースがあり、時刻に内部的に 1399 * 変換するケースで使います。 1400 * 外部から与える数字は、連続している必要があるため、10進数です。 1401 * たとえば、1700 → 17:00 , 2150 → 21:30 という感じです。 1402 * 24時間を超える場合は、 1403 * Type1:そのまま、0:00 に戻る。 1404 * Type2:そのまま、24:00 と、そのまま、加算されていく。 1405 * の2種類が用意されています。 1406 * 1407 * @og.rev 5.5.2.1 (2012/05/07) 新規追加 1408 * 1409 */ 1410 private static final class HybsTimeFormat extends DecimalFormat { 1411 /** For serialization. */ 1412 private static final long serialVersionUID = 201205075512L ; 1413 1414 private final boolean is24repeat ; 1415 private final boolean useDay ; 1416 1417 private final int hsCode ; 1418 1419 /** 1420 * コンストラクター 1421 * 1422 * 引数に、時刻を表す場合の表現の仕方を指定します。 1423 * E1:そのまま、24:00 となり、加算されていく。 1424 * E2:そのまま、0:00 に戻る。(日付は無視) 1425 * E3:そのまま、1 00:00 と日付が付与される。 1426 * H1:そのまま、24時00分 となり、加算されていく。 1427 * H2:そのまま、00時00分 に戻る。(日付は無視) 1428 * H3:そのまま、1日 00時00分 と日付が付与される。 1429 * 1430 * @param type 時刻の表示方法 [E1/E2/E3/H1/H2/H3] 1431 */ 1432 public HybsTimeFormat( final String inType ) { 1433 super(); 1434 1435 DecimalFormatSymbols sym = new DecimalFormatSymbols(); 1436 if( "E1".equals( inType ) ) { 1437 applyPattern( "#0.00" ); 1438 sym.setDecimalSeparator( ':' ); 1439 is24repeat = false; useDay = false; 1440 } 1441 else if( "E2".equals( inType ) ) { 1442 applyPattern( "#0.00" ); 1443 sym.setDecimalSeparator( ':' ); 1444 is24repeat = true; useDay = false; 1445 } 1446 else if( "E3".equals( inType ) ) { 1447 applyPattern( "#,#0.00" ); 1448 sym.setDecimalSeparator( ':' ); 1449 sym.setGroupingSeparator( ' ' ); 1450 is24repeat = true; useDay = true; 1451 } 1452 else if( "H1".equals( inType ) ) { 1453 applyPattern( "#0.00分" ); 1454 sym.setDecimalSeparator( '時' ); 1455 is24repeat = false; useDay = false; 1456 } 1457 else if( "H2".equals( inType ) ) { 1458 applyPattern( "#0.00分" ); 1459 sym.setDecimalSeparator( '時' ); 1460 is24repeat = true; useDay = false; 1461 } 1462 else if( "H3".equals( inType ) ) { 1463 applyPattern( "#,#0.00分" ); 1464 sym.setDecimalSeparator( '時' ); 1465 sym.setGroupingSeparator( '日' ); 1466 is24repeat = true; useDay = true; 1467 } 1468 else { 1469 String errMsg = "timeFormatType は、(E1/E2/E3/H1/H2/H3) から指定してください。timeFormatType=[" + inType + "]" ; 1470 throw new HybsSystemException( errMsg ); 1471 } 1472 setDecimalFormatSymbols( sym ); 1473 1474 hsCode = super.hashCode() + Boolean.valueOf(is24repeat).hashCode() + Boolean.valueOf(useDay).hashCode(); 1475 } 1476 1477 /** 1478 * double をフォーマットして文字列を作成します( format(double,StringBuffer,FieldPosition) のオーバーライド ) 1479 * 1480 * timeFormatType によって、データの処理が変わります。 1481 * E1:そのまま、24:00 となり、加算されていく。 1482 * E2:そのまま、0:00 に戻る。(日付は無視) 1483 * E3:そのまま、1 00:00 と日付が付与される。 1484 * H1:そのまま、24時00分 となり、加算されていく。 1485 * H2:そのまま、00時00分 に戻る。(日付は無視) 1486 * H3:そのまま、1日 00時00分 と日付が付与される。 1487 * 1488 * @param number フォーマットする double 1489 * @param result テキストを追加する位置 1490 * @param fieldPos 入力では、必要であれば位置合わせフィールド。 出力では、その位置合わせフィールドのオフセット 1491 * @return フォーマットされた数値文字列 1492 */ 1493 public StringBuffer format( final double number, final StringBuffer result, final FieldPosition fieldPos ) { 1494 int day = (int)(number/100/24); // 日付。端数は切り捨てる。 1495 int hour = (int)(number/100); // 時間のみ取り出す。 1496 if( is24repeat ) { hour = hour%24; } // 24時間を超えた場合、余りのみ使用する。 1497 1498 int minute = (int)((number%100)*0.6); // 0.6 = 60/100 の事。100 が 60分 となる。 1499 1500 double timeVal = hour + minute/100.0 ; 1501 if( useDay ) { timeVal = timeVal + day*100 ; } // 端数を切り捨てた日付に対して、100倍しておく。 1502 return super.format( timeVal, result, fieldPos ); 1503 } 1504 1505 /** 1506 * このオブジェクトと指定されたオブジェクトを比較します。 1507 * 1508 * @og.rev 5.5.2.4 (2012/05/16) 新規追加 findbug対応 1509 * 1510 * @param anObject 比較されるオブジェクト 1511 * @return 指定されたオブジェクトが等しい場合は true、そうでない場合は false 1512 */ 1513 public boolean equals( final Object anObject ) { 1514 return this == anObject; 1515 } 1516 1517 /** 1518 * このオブジェクトのハッシュコードを取得します。 1519 * 1520 * @og.rev 5.5.2.4 (2012/05/16) 新規追加 findbug対応 1521 * 1522 * @return ハッシュコード 1523 */ 1524 public int hashCode() { 1525 return hsCode; 1526 } 1527 } 1528 1529 /** 1530 * このオブジェクトの文字列表現を返します。 1531 * 基本的にデバッグ目的に使用します。 1532 * 1533 * @return このクラスの文字列表現 1534 */ 1535 @Override 1536 public String toString() { 1537 StringBuilder rtn = new StringBuilder( HybsSystem.BUFFER_MIDDLE ); 1538 1539 rtn.append( "[" ).append( this.getClass().getName() ).append( "]" ).append( HybsSystem.CR ); 1540 rtn.append( "chartType [" ).append( chartType ).append( "]" ).append( HybsSystem.CR ); 1541 rtn.append( "valueLabel [" ).append( valueLabel ).append( "]" ).append( HybsSystem.CR ); 1542 rtn.append( "markValues [" ).append( Arrays.toString( markValues ) ).append( "]" ).append( HybsSystem.CR ); 1543 rtn.append( "markColors [" ).append( Arrays.toString( markColors ) ).append( "]" ).append( HybsSystem.CR ); 1544 rtn.append( "lowerBound [" ).append( lowerBound ).append( "]" ).append( HybsSystem.CR ); 1545 rtn.append( "upperBound [" ).append( upperBound ).append( "]" ).append( HybsSystem.CR ); 1546 rtn.append( "useGradient [" ).append( useGradient ).append( "]" ).append( HybsSystem.CR ); 1547 rtn.append( "shapesVisible [" ).append( shapesVisible ).append( "]" ).append( HybsSystem.CR ); 1548 rtn.append( "useDottedLine [" ).append( useDottedLine ).append( "]" ).append( HybsSystem.CR ); 1549 1550 return rtn.toString(); 1551 } 1552}