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}