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 */
016 package org.opengion.hayabusa.io;
017
018 import org.opengion.hayabusa.common.HybsSystem;
019 import org.opengion.hayabusa.common.HybsSystemException;
020 import org.opengion.fukurou.util.StringUtil;
021
022 import java.util.List;
023 import java.awt.Color;
024 import java.text.SimpleDateFormat;
025
026 import org.jfree.ui.RectangleEdge;
027 import org.jfree.chart.JFreeChart;
028 import org.jfree.chart.plot.Plot;
029 import org.jfree.chart.plot.PlotOrientation;
030 import org.jfree.chart.plot.CategoryPlot;
031 import org.jfree.chart.renderer.category.CategoryItemRenderer;
032 import org.jfree.data.category.CategoryDataset;
033 import org.jfree.chart.axis.CategoryAxis;
034 import org.jfree.chart.axis.CategoryLabelPositions;
035 import org.jfree.chart.axis.CategoryAnchor;
036 import org.jfree.chart.axis.DateAxis; // 5.6.1.0 (2013/02/01)
037 import org.jfree.chart.plot.DatasetRenderingOrder;
038 import org.jfree.chart.plot.CategoryMarker;
039
040 /**
041 * ChartCreate は、JFreeChart オブジェクトを構築するクラスです?
042 * ?の ChartDataset オブジェクトを合?することも?ここで行って?す?
043 * グラフ?種類?、ChartPlot_XXX クラスで設定して?す?
044 * ここでは、簡易的にオブジェクトを構築できるように、チャートタイプ??によって?
045 * ?作?するオブジェクトを?替えて?す?
046 *
047 * @version 0.9.0 2007/06/21
048 * @author Kazuhiko Hasegawa
049 * @since JDK1.1,
050 */
051 public class ChartCreate {
052
053 private String title = null; // タイトル
054 private String chartType = null; // チャート?種?
055 private String domainLabel = null; // チャート?共通横軸のラベル
056 private boolean showLegend = true; // 凡?の表示可否
057 private RectangleEdge rectEdge= RectangleEdge.BOTTOM; // 凡例?表示?
058 private PlotOrientation plotOri = PlotOrientation.VERTICAL; // チャート?軸表示方?
059 private Color chartBackColor = null; // 背景色の設?
060 private Color plotBackColor = null; // 描画領域の設?
061 private int rotationLabel = 0; // 横軸ラベルの傾?1:180度 ?:90度 ?:60度 ?:45度 ?:30度 ??? )
062 // CategoryAxis系は、rotationLabel。ValueAxis系(NumberAxis,DateAxis)は、useVerticalLabels で、ラベルの表示向きを指定します?
063 private boolean useVerticalLabels = false; // 5.6.4.3 (2013/05/24) 横軸ラベルの表示向き(横書?false/縦書?true)
064 private String domainMarker = null; // 横軸のマ?カーライン
065 private boolean useDomainLabel = true; // 横軸ラベルの表示有無
066 private boolean useMarkerLabel = true; // マ?カーライン時??有無
067 private int seriesPikup = -1; // ピックア??するシリーズ番号
068 private HybsURLGenerator urlGen = null; // クリ?ブル・マッ?
069 // 4.0.2.0 (2007/12/20)
070 private String categoryMargin = null; // カ?リマ?ジン(0.0??.0)
071 private String lowerMargin = null; // 下方マ?ジン(0.0??.0)
072 private String upperMargin = null; // 上方マ?ジン(0.0??.0)
073 private boolean isDebug = false; // ??フラグ
074 private boolean useDomainLine = false; // 4.0.3.0 (2008/01/07) 横軸のグリ?表示有無(垂直?
075 private Color domainLineColor = null; // 4.0.3.0 (2008/01/07) 横軸のグリ?線?色
076 private boolean useRangeLine = true; // 4.0.3.0 (2008/01/07) 縦軸のグリ?表示有無(水平?
077 private Color rangeLineColor = null; // 4.0.3.0 (2008/01/07) 縦軸のグリ?線?色
078 private int categorySkip = 1; // 4.0.3.0 (2008/01/07) 横軸ラベルをスキ??する間隔
079 private int categoryCutNo = -1; // 4.1.1.0 (2008/02/04) 横軸ラベルの?位置??キーブレイク
080 private int rangeSkip = 1; // 4.1.1.0 (2008/02/04) 縦軸のグリ?をスキ??する間隔
081 private boolean useToolTip = false; // 4.3.1.0 (2008/08/09) ??ルチップスの利用
082
083 private CategoryAnchor categoryAnchor = null; // 4.1.1.0 (2008/02/14) 横軸のグリ?(垂直?の書き?し位置(START,MIDDLE,END)
084
085 private List<ChartDataset> chartDataset = null; // チャート???タ属?管?ブジェクト?リス?
086
087 private String dateAxisFormat = "MM/dd"; // 5.6.1.0 (2013/02/01) Time,XYTime Polt関係?時間軸を表す?合?フォーマッ?
088
089
090 /**
091 * JFreeChart オブジェクトを作?します?
092 *
093 * ??は、ChartPlot インターフェースに基づ? Plot を構築するクラス?
094 * 呼び出して、JFreeChart の引数に設定します?
095 * ?属?の設定も行います?
096 *
097 * @return JFreeChartオブジェク?
098 */
099 public JFreeChart getChart() {
100
101 ChartPlot chPlot = ChartFactory.newChartPlot( chartType );
102
103 Plot plot = chPlot.getPlot( this );
104
105 // 描画領域の設?
106 if( plotBackColor != null ) {
107 plot.setBackgroundPaint( plotBackColor );
108 }
109
110 JFreeChart chart = new JFreeChart( title, JFreeChart.DEFAULT_TITLE_FONT, plot, showLegend );
111
112 if( showLegend ) {
113 chart.getLegend().setPosition( rectEdge );
114 }
115
116 // 背景色の設?
117 if( chartBackColor != null ) {
118 chart.setBackgroundPaint( chartBackColor );
119 }
120
121 // 以降?処?は、変更イベントが発行される?
122 if( categoryAnchor != null && plot instanceof CategoryPlot ) {
123 ((CategoryPlot)plot).setDomainGridlinePosition( categoryAnchor ) ;
124 }
125
126 // 以降?処?は、変更イベントが発行される?
127 // 5.1.8.0 (2010/07/01) 実質?使用されて???で、削除
128 // if( plot instanceof HybsCategoryPlot ) {
129 // ((HybsCategoryPlot)plot).setNotify( true ) ;
130 // }
131
132 return chart;
133 }
134
135 /**
136 * JFreeChart オブジェクトを変更します?
137 *
138 * すでに作?済みの JFreeChart に対して?
139 * シリーズのピックア??(seriesPikup) のみ、変更します?
140 * 使用するのは、引数の JFreeChart と seriesPikup 属?値のみです?
141 *
142 * @og.rev 3.8.9.2 (2007/07/28) シリーズ?時の色、シェープ対?
143 *
144 * @param chart JFreeChartオブジェク?
145 * @param serNo seriesPikup 属?値
146 *
147 * @return JFreeChartオブジェク?
148 */
149 public static JFreeChart modifying( final JFreeChart chart,final int serNo ) {
150
151 CategoryPlot plot = chart.getCategoryPlot();
152
153 if( plot instanceof HybsCategoryPlot ) {
154 // 以降?処?は、変更イベント?発行されな??
155 // 5.1.8.0 (2010/07/01) 実質?使用されて???で、削除
156 // ((HybsCategoryPlot)plot).setNotify( false ) ;
157 ((HybsCategoryPlot)plot).setSeriesPikup( serNo ) ;
158 }
159
160 CategoryDataset dtset = plot.getDataset();
161 int rowCnt = dtset.getRowCount(); // Series の個数
162
163 CategoryItemRenderer rend = plot.getRenderer();
164
165 if( serNo >= 0 && serNo < rowCnt ) {
166 rend.setBasePaint( Color.CYAN );
167 rend.setSeriesPaint( serNo, Color.RED );
168 }
169
170 // 以降?処?は、変更イベントが発行される?
171 // 5.1.8.0 (2010/07/01) 実質?使用されて???で、削除
172 // if( plot instanceof HybsCategoryPlot ) {
173 // ((HybsCategoryPlot)plot).setNotify( true ) ;
174 // }
175
176 return chart ;
177 }
178
179 /**
180 * CategoryPlotオブジェクトを返します?
181 *
182 * ChartCreate オブジェク?自??身)に設定された?属?を?に?
183 * CategoryPlotオブジェクトを構築します?
184 * ?な属?設定?、済んで?状態です?
185 * ここでは、serNo、categoryAxis、plotOrientation、useDomainLine?
186 * domainLineColor、useRangeLine 、RangeLineColor 、rangeSkip ?
187 * domainMarker を設定しておきます?
188 *
189 * @og.rev 4.1.1.0 (2008/02/04) 新規追?
190 *
191 * @return ?な属?を設定済みのCategoryPlotオブジェク?
192 */
193 protected HybsCategoryPlot makeCategoryPlot() {
194 HybsCategoryPlot cPlot = new HybsCategoryPlot( seriesPikup );
195
196 cPlot.setOrientation( plotOri );
197 cPlot.setDatasetRenderingOrder( DatasetRenderingOrder.FORWARD );
198
199 // ドメイン(横軸)に対する、グリ?ライン(垂直?の??
200 cPlot.setDomainGridlinesVisible( useDomainLine );
201 if( domainLineColor != null ) { cPlot.setDomainGridlinePaint( domainLineColor ); }
202
203 // レンジ(縦軸)に対する、グリ?ライン(水平?の??
204 cPlot.setRangeGridlinesVisible( useRangeLine );
205 if( rangeLineColor != null ) { cPlot.setRangeGridlinePaint( rangeLineColor ); }
206
207 // 4.1.1.0 (2008/02/04) 縦軸のグリ??水平?をスキ??する間隔の??
208 cPlot.setRangeSkip( rangeSkip );
209
210 // 横軸ドメインマ?カーの設?縦ライン)
211 if( domainMarker != null ) {
212 CategoryMarker catMk = new CategoryMarker( domainMarker );
213 catMk.setDrawAsLine( true );
214 if( useMarkerLabel ) {
215 catMk.setLabel( domainMarker );
216 }
217 cPlot.addDomainMarker( catMk );
218 }
219
220 return cPlot ;
221 }
222
223 /**
224 * CategoryAxisオブジェクトを返します?
225 *
226 * ChartCreate オブジェク?自??身)に設定された?属?を?に?
227 * CategoryAxisオブジェクトを構築します?
228 * ?な属?設定?、済んで?状態です?
229 * ここでは、domainLabel、categoryMargin、lowerMargin、upperMargin?
230 * useDomainLabel、rotationLabel を設定しておきます?
231 *
232 * @og.rev 4.1.1.0 (2008/02/04) 横軸ラベルの?位置??キーブレイク追?categoryCutNo)
233 *
234 * @return ?な属?を設定済みの CategoryAxisオブジェク?
235 */
236 protected CategoryAxis makeCategoryAxis() {
237 CategoryAxis categoryAxis = new HybsCategoryAxis(
238 domainLabel,categorySkip,categoryCutNo
239 );
240
241 // カ?リマ?ジン(0.0??.0)を指定します?
242 if( categoryMargin != null ) {
243 double ctMargin = Double.parseDouble( categoryMargin );
244 categoryAxis.setCategoryMargin( ctMargin ) ; // double margin
245 }
246
247 // 下方マ?ジン(0.0??.0)を指定します?
248 if( lowerMargin != null ) {
249 double lwMargin = Double.parseDouble( lowerMargin );
250 categoryAxis.setLowerMargin( lwMargin ) ; // double margin
251 }
252
253 // 上方マ?ジン(0.0??.0)を指定します?
254 if( upperMargin != null ) {
255 double upMargin = Double.parseDouble( upperMargin );
256 categoryAxis.setUpperMargin( upMargin ) ; // double margin
257 }
258
259 // チャート?カ?リーラベルの方向を?します?
260 if( rotationLabel > 0 ) {
261 categoryAxis.setCategoryLabelPositions(
262 CategoryLabelPositions.createUpRotationLabelPositions(
263 Math.PI / rotationLabel ));
264 }
265 else if( rotationLabel < 0 ) {
266 categoryAxis.setCategoryLabelPositions(
267 CategoryLabelPositions.createDownRotationLabelPositions(
268 Math.PI / -rotationLabel ));
269 }
270
271 // 横軸ラベルの表示有無を返します?
272 categoryAxis.setVisible( useDomainLabel ); // ドメインラベルの表示有無
273
274 if( isDebug ) {
275 System.out.println( "CategoryMargin="+categoryAxis.getCategoryMargin());
276 System.out.println( "LowerMargin="+categoryAxis.getLowerMargin());
277 System.out.println( "UpperMargin="+categoryAxis.getUpperMargin());
278 }
279
280 return categoryAxis ;
281 }
282
283 /**
284 * チャート???タ属?管?ブジェクト?リストを設定します?
285 *
286 * ChartDataset オブジェクト?、?部チャート?個?の属?を管?て?す?
287 * こ?オブジェク?は、グラフ?合?に使用できるように、?部にそれぞれの Plot ?
288 * renderer に対応する情報を持って?す?
289 * これらを、?管?るときに、List 管?て?す?で、そのList をセ?します?
290 * JFreeChart には、この?のChartDataset から、それぞれ? Plot と Dataset ?
291 * ?、追?て??があります?そ?処??、ChartPlot インターフェース?
292 * 継承した、サブクラスで実際に行われます?
293 *
294 * @param datasetList チャート???タ属?管??リス?
295 */
296 public void setDatasetList( final List<ChartDataset> datasetList ) {
297 chartDataset = datasetList;
298
299 if( chartDataset != null ) {
300 ChartDataset firstChData = chartDataset.get(0);
301 chartType = firstChData.getChartType();
302 }
303 }
304
305 /**
306 * チャート???タ属?管?ブジェクト?リストを返します?
307 *
308 * @return チャート???タ属?管?ブジェクト?リス?
309 * @see #setDatasetList( List )
310 */
311 protected List<ChartDataset> getDatasetList() { return chartDataset; }
312
313 /**
314 * チャート?タイトルを設定します?
315 *
316 * @param chTitle チャート?タイトル
317 */
318 public void setTitle( final String chTitle ) {
319 title = chTitle;
320 }
321
322 /**
323 * チャート?共通横軸のラベルを設定します?
324 *
325 * @param domLabel チャート?共通横軸のラベル
326 */
327 public void setDomainLabel( final String domLabel ) {
328 domainLabel = domLabel;
329 }
330
331 /**
332 * チャート?共通横軸のラベルを返します?
333 *
334 * @return チャート?共通横軸のラベル
335 */
336 protected String getDomainLabel() { return domainLabel; }
337
338 /**
339 * 凡?の表示可否を設定します?
340 *
341 * @param showLeg 凡?の表示可否
342 */
343 public void setShowLegend( final boolean showLeg ) {
344 showLegend = showLeg;
345 }
346
347 /**
348 * 凡例?表示?を設定しま?TOP、BOTTOM、RIGHT、LEFT)?
349 *
350 * 表示?は、org.jfree.ui.RectangleEdge クラスの設定?を使用します?
351 * ?できるのは、TOP、BOTTOM、RIGHT、LEFT で、各??頭?字で
352 * 判定してます?つまり?T,B,R,L で、判定を行い、それ以外?エラーになります?
353 *
354 * @param edge 凡例?表示?(TOP、BOTTOM、RIGHT、LEFT)
355 */
356 public void setRectangleEdge( final String edge ) {
357 if( edge != null && edge.length() > 0 ) {
358 char ope = edge.charAt(0);
359 switch( ope ) {
360 case 'T' : rectEdge = RectangleEdge.TOP; break;
361 case 'B' : rectEdge = RectangleEdge.BOTTOM;break;
362 case 'R' : rectEdge = RectangleEdge.RIGHT; break;
363 case 'L' : rectEdge = RectangleEdge.LEFT; break;
364 default :
365 String errMsg = "??パラメータは適用できません?" + edge + "]"
366 + HybsSystem.CR
367 + "TOP,BOTTOM,RIGHT,LEFT の中から、指定してください? ;
368 throw new HybsSystemException( errMsg );
369 }
370 }
371 }
372
373 /**
374 * チャート?軸表示方向を設定しま?VERTICAL、HORIZONTAL)?
375 *
376 * 軸表示方向?、org.jfree.chart.plot.PlotOrientation クラスの設定?を使用します?
377 * ?できるのは、VERTICAL、HORIZONTALで、各??頭?字で
378 * 判定してます?つまり?V,H で、判定を行い、それ以外?エラーになります?
379 *
380 * @param orientation 凡例?表示?(VERTICAL、HORIZONTAL)
381 */
382 public void setPlotOrientation( final String orientation ) {
383 if( orientation != null && orientation.length() > 0 ) {
384 char ope = orientation.charAt(0);
385 switch( ope ) {
386 case 'V' : plotOri = PlotOrientation.VERTICAL; break;
387 case 'H' : plotOri = PlotOrientation.HORIZONTAL;break;
388 default :
389 String errMsg = "??パラメータは適用できません?" + orientation + "]"
390 + HybsSystem.CR
391 + "VERTICAL,HORIZONTAL の中から、指定してください? ;
392 throw new HybsSystemException( errMsg );
393 }
394 }
395 }
396
397 /**
398 * チャート?軸表示方向を返します?
399 *
400 * org.jfree.chart.plot.PlotOrientation クラスの設定?を使用します?
401 *
402 * @return チャート?軸表示方?VERTICAL、HORIZONTAL)
403 */
404 protected PlotOrientation getPlotOrientation() { return plotOri; }
405
406 /**
407 * チャート?背景色を指定します?
408 *
409 * ?文字?は、java.awt.Color クラスのstatic フィールド名で?します?
410 * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
411 * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます?
412 * また?#XXXXXX形式?16bitRGB表?でも指定可能です?
413 *
414 * @param chBackClr チャート?背景色
415 * @see java.awt.Color#BLACK
416 */
417 public void setChartBackColor( final String chBackClr ) {
418 if( chBackClr != null && chBackClr.length() > 0 ) {
419 chartBackColor = StringUtil.getColorInstance( chBackClr );
420 }
421 }
422
423 /**
424 * チャート?描画領域の色を指定します?
425 *
426 * ?文字?は、java.awt.Color クラスのstatic フィールド名で?します?
427 * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
428 * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます?
429 * また?#XXXXXX形式?16bitRGB表?でも指定可能です?
430 *
431 * @param plBackClr チャート?描画領域色
432 * @see java.awt.Color#BLACK
433 */
434 public void setPlotBackColor( final String plBackClr ) {
435 if( plBackClr != null && plBackClr.length() > 0 ) {
436 plotBackColor = StringUtil.getColorInstance( plBackClr );
437 }
438 }
439
440 /**
441 * チャート?カ?リーラベルの方向を?します?
442 *
443 * これは、CategoryAxis 系の横軸ラベルに対して、表示方向を?します?
444 * ValueAxis系(NumberAxis,DateAxis)は、setUseVerticalLabels( boolean ) で
445 * true:縦/false:横 のみ?可能です?
446 *
447 * 方向?、上方向に対して?PI / ?数) で求まる?に設定します?
448 * こ??数に相当する?を設定します?
449 * 1:180度 ?:90度 ?:60度 ?:45度 ?:30度 ???
450 * マイナスは、下方向に回転させます?
451 * 0 を指定した?合?、何も設定しません?初期設定?まま)
452 *
453 * @param rotLabel カ?リーラベルの方?
454 * @see #setUseVerticalLabels( boolean )
455 */
456 public void setRotationLabel( final int rotLabel ) {
457 rotationLabel = rotLabel;
458 }
459
460 /**
461 * ラベルの表示向きを縦にするかど?[false/true]を指定しま?初期値:false)?
462 *
463 * これは、ValueAxis系(NumberAxis,DateAxis) 系の横軸ラベルに対して、表示方向を
464 * true:縦/false:横で、指定します?
465 * true に?した?合で、かつ、rotationLabel が未??=0)の場合??:90度 も設定します?
466 *
467 * ChartCreate の rotationLabel は、角度を指定できましたが?NumberAxis,DateAxis では?
468 * 縦にするかど?の?しかできません?
469 * ここでは、true を指定するとラベルは、縦書きになります?
470 * 初期値は、false(横書?です?
471 *
472 * @og.rev 5.6.4.3 (2013/05/24) 新規追?
473 *
474 * @param useVLavels ラベルの表示向き [false:横書?true:縦書き]
475 * @see #setRotationLabel( int )
476 */
477 public void setUseVerticalLabels( final boolean useVLavels ) {
478 useVerticalLabels = useVLavels;
479
480 // useVerticalLabels=true で、rotationLabel ?2:90度 に設定しておきます?
481 if( useVerticalLabels && rotationLabel == 0 ) { rotationLabel = 2; }
482 }
483
484 /**
485 * チャート?カ?リーラベルの方向を取得します?
486 *
487 * 方向?、上方向に対して?PI / ?数) で求まる?に設定します?
488 * こ??数に相当する?を設定します?
489 * 1:180度 ?:90度 ?:60度 ?:45度 ?:30度 ???
490 * マイナスは、した方向に回転させます?
491 * 0 を指定した?合?、何も設定しません?初期設定?まま)
492 *
493 * @return カ?リーラベルの方?
494 * @see #setRotationLabel( int )
495 */
496 protected int getRotationLabel() { return rotationLabel; }
497
498 /**
499 * チャート?横軸の値(ドメイン)に合?する位置にマ?カーラインを設定します?
500 *
501 * こ?属?には、?ーカーラインを設定する?を記述します?
502 *
503 * @param marker ドメインのマ?カーライン
504 */
505 public void setDomainMarker( final String marker ) {
506 if( marker != null && marker.length() > 0 ) {
507 domainMarker = marker;
508 }
509 }
510
511 /**
512 * 横軸ラベルのラベルを表示するかど?[true/false]を指定しま?初期値:true)?
513 *
514 * ドメイン(横軸)が?多数存在する場合?ドメインラベルが見えにくくなります?
515 * そ?ようなケースで、横軸のラベルそ?も?を表示しな??合に、false ?
516 * 設定します?
517 * 初期値は、表示する(true)です?
518 *
519 * @param flag 横軸ラベルの表示有無 [true:表示する/false:表示しない]
520 */
521 public void setUseDomainLabel( final boolean flag ) {
522 useDomainLabel = flag ;
523 }
524
525 /**
526 * 横軸ラベルの表示有無を返します?
527 *
528 * @return boolean横軸ラベルの表示有無(true:表示する/false:表示しな?
529 */
530 protected boolean isUseDomainLabel() { return useDomainLabel; }
531
532 /**
533 * マ?カーラインに、その設定?を表示するかど?[true/false]を指定しま?初期値:true)?
534 *
535 * ドメイン(横軸)が?多数存在する場合?ドメインラベルが見えな??合があります?
536 * そ?ようなケースで、見た??にマ?カーラインを設定し、その横に、ドメインラベル
537 * を表示する事で、ピ?ア??して?軸の値を容易に知ることが可能です?
538 * 初期値は、表示する(true)です?
539 *
540 * @param flag マ?カーラインの設定?表示 [true:表示する/false:表示しない]
541 */
542 public void setUseMarkerLabel( final boolean flag ) {
543 useMarkerLabel = flag ;
544 }
545
546 /**
547 * ?シリーズのピックア??を行う場合?シリーズ番号を指定します?
548 *
549 * ?シリーズ(検索時に??を同時に検索する場?では、チャート上に
550 * ?のグラフが表示されますが、その中の?をピ?ア??する場合に?
551 * シリーズ番号を指定します?
552 * シリーズ番号は? から始まる数字です?
553 * ここでは、ピ?ア??されたシリーズは、赤色で表示されます?
554 * それ以外?、グレー色での表示になります?
555 * (※ 本来は、ChartDataset に持つべき属?です?)
556 *
557 * @param serPikup シリーズ番号
558 */
559 public void setSeriesPikup( final int serPikup ) {
560 seriesPikup = serPikup;
561 }
562
563 /**
564 * 横軸ラベルをスキ??する間隔を指定します?
565 *
566 * 横軸ラベル(カ?リラベル表示)する際に、スキ??する間隔を指定します?
567 * "1" (初期値)では?つづつ表示(つまり?すべて表示する)します?
568 * "2" とすると?つおきに?3" とすると?つおきに表示します?
569 * 初期値は?1" (すべて表示)です?
570 * なお?先?から表示を開始します?
571 *
572 * 注意:これとは別に、ラベル先?に "_" を付けた?合?、ラベルを表示しません?
573 * また?categoryCutNo が指定された場合?、categorySkip は使用されません?
574 *
575 * @param cateSkip ラベルをスキ??する間隔を指?
576 * @see #setCategoryCutNo( int )
577 */
578 public void setCategorySkip( final int cateSkip ) {
579 categorySkip = cateSkip;
580 }
581
582 /**
583 * 横軸ラベルの?位置??キーブレイクを指定します?
584 *
585 * @og.rev 4.1.1.0 (2008/02/04) 新規追?
586 *
587 * 横軸ラベル(カ?リラベル表示)する際に、ラベルの先?から、この?文字数?
588 * カ?して、表示します?
589 * そ?際?前回作?したカ?ラベルと、同?ベルの場合?、表示しません?
590 * 例えば、データは、年月日で、年と月?み(先??文?を指定すると?
591 * 日の??タは、ラベルが表示されません?
592 * ?される数字??以上?整数としてください?
593 * 初期値は、すべて表示です?
594 *
595 * 注意:これとは別に、ラベル先?に "_" を付けた?合?、ラベルを表示しません?
596 * また?categoryCutNo が指定された場合?、categorySkip は使用されません?
597 *
598 * @param cateCutNo キーブレイク位置
599 * @see #setCategorySkip( int )
600 */
601 public void setCategoryCutNo( final int cateCutNo ) {
602 if( cateCutNo > 0 ) {
603 categoryCutNo = cateCutNo;
604 }
605 }
606
607 /**
608 * ?シリーズのピックア??を行う場合?シリーズ番号を取得します?
609 *
610 * 方向?、上方向に対して?PI / ?数) で求まる?に設定します?
611 * こ??数に相当する?を設定します?
612 * 0 を指定した?合?、何も設定しません?初期設定?まま)
613 * (※ 本来は、ChartDataset に持つべき属?です?)
614 *
615 * @return シリーズ番号
616 * @see #setSeriesPikup( int )
617 */
618 protected int getSeriesPikup() { return seriesPikup; }
619
620 /**
621 * 縦軸のグリ??水平?をスキ??する間隔を指定します?
622 *
623 * 縦軸のグリ?線を表示する際に、スキ??する間隔を指定します?
624 * 通常は、ラベルと同じ?のグリ?線が掛かれますが、ラベルより?
625 * 少な?のグリ??例えば?つおき)を?す?合に、?を設定します?
626 * "1" (初期値)では?つづつ表示(つまり?すべて表示する)します?
627 * "2" とすると?つおきに?3" とすると?つおきに表示します?
628 * 初期値は?1" (すべて表示)です?
629 * なお?先?から表示を開始します?
630 *
631 * @og.rev 4.1.1.0 (2008/02/04) 新規追?
632 *
633 * @param rngSkip 縦軸のグリ??水平?をスキ??する間隔
634 */
635 public void setRangeSkip( final int rngSkip ) {
636 rangeSkip = rngSkip;
637 }
638
639 /**
640 * クリ?ブル・マップ用URLを指定します?
641 *
642 * 画像に、クリ?ブル・マップを作?する場合?、URL を指定します?
643 * これは、画像上にエリア?でリンク引数を作?することが可能です?
644 * URL 自身は? 付きで固定?の引数を?結することが可能です?
645 * クリ?したエリアのカ?リ?ン?クスの値(引数)は、?動的に
646 * 設定されます?(?しな??合?チャートによって異なりま?
647 * <pre>
648 * ・Pie ?category、pieIndex
649 * ・XY ?series、item
650 * ・Category ?series、category
651 * </pre>
652 * こ?引数の URL の名称を変更した??合?、URL に続けて、カン?,) で?
653 * 名称を記述してください?
654 * 例:link.jsp,BLOCK
655 *
656 * @param imageMapUrl クリ?ブル・マップ用URL
657 */
658 public void setImageMapUrl( final String imageMapUrl ) {
659 if( imageMapUrl != null ) {
660 urlGen = new HybsURLGenerator( imageMapUrl );
661 }
662 }
663
664 /**
665 * クリ?ブル・マップ用URLを取得します?
666 *
667 * @return クリ?ブル・マップ用URL
668 * @see #setImageMapUrl( String )
669 */
670 protected HybsURLGenerator getURLGenerator() { return urlGen; }
671
672 /**
673 * ??ルチップス利用(true)利用しな?false)のフラグを取得します?
674 *
675 * @og.rev 4.3.1.0 (2008/08/09) 新規追?
676 * @og.rev 4.9.9.9 (2009/08/07) メソ?名変更
677 *
678 * @return ??ルチップス利用(true)利用しな?false)のフラグ
679 * @see #setUseToolTip( boolean )
680 */
681 // protected boolean getUseToolTip() { return useToolTip; }
682 protected boolean isUseToolTip() { return useToolTip; }
683
684 /**
685 * カ?リマ?ジン(0.0??.0)を指定します?
686 *
687 * カ?リ(グラフ?横軸に相?の表示間隔(マ?ジン)の比率を指定します?
688 * こ?比率は??ではなく?数?double)での設定になります?
689 * 何も?しな??合?、デフォルトで自動調整されます?
690 *
691 * @og.rev 4.0.2.0 (2007/12/20) 新規追?
692 *
693 * @param margin カ?リマ?ジン(0.0??.0)
694 */
695 public void setCategoryMargin( final String margin ) {
696 categoryMargin = margin;
697 }
698
699 /**
700 * 下方マ?ジン(0.0??.0)を指定します?
701 *
702 * カ?リ(グラフ?横軸に相?の下方側(左側)のマ?ジンの比率を指定します?
703 * こ?比率は??ではなく?数?double)での設定になります?
704 * 何も?しな??合?、デフォルトで自動調整されます?
705 *
706 * @og.rev 4.0.2.0 (2007/12/20) 新規追?
707 *
708 * @param margin 下方マ?ジン(0.0??.0)
709 */
710 public void setLowerMargin( final String margin ) {
711 lowerMargin = margin;
712 }
713
714 /**
715 * 上方マ?ジン(0.0??.0)を指定します?
716 *
717 * カ?リ(グラフ?横軸に相?の上方側(右側)のマ?ジンの比率を指定します?
718 * こ?比率は??ではなく?数?double)での設定になります?
719 * 何も?しな??合?、デフォルトで自動調整されます?
720 *
721 * @og.rev 4.0.2.0 (2007/12/20) 新規追?
722 *
723 * @param margin 上方マ?ジン(0.0??.0)
724 */
725 public void setUpperMargin( final String margin ) {
726 upperMargin = margin;
727 }
728
729 /**
730 * 横軸のグリ?表示有無(垂直?を指定しま?初期値:false)?
731 *
732 * ドメイン(横軸)に対する、グリ?ラインを表示するかど??します?
733 *
734 * 何も?しな??合?、表示しません?false)
735 *
736 * @og.rev 4.0.3.0 (2008/01/07) 新規追?
737 *
738 * @param useLine 横軸のグリ?表示有無(垂直?
739 */
740 public void setUseDomainLine( final boolean useLine ) {
741 useDomainLine = useLine;
742 }
743
744 /**
745 * 横軸のグリ?線?色を指定します?
746 *
747 * ドメイン(横軸)に対する、グリ?ラインの表示色を指定します?
748 * 何も?しな??合?、デフォルトで自動設定されます?
749 *
750 * @og.rev 4.0.3.0 (2008/01/07) 新規追?
751 *
752 * @param color 横軸のグリ?線?色
753 */
754 public void setDomainLineColor( final String color ) {
755 if( color != null ) {
756 domainLineColor = StringUtil.getColorInstance( color );
757 }
758 }
759
760 /**
761 * 縦軸のグリ?表示有無(水平?を指定しま?初期値:true)?
762 *
763 * レンジ(縦軸)に対する、グリ?ラインを表示するかど??します?
764 *
765 * 何も?しな??合?、表示しません?false)
766 *
767 * @og.rev 4.0.3.0 (2008/01/07) 新規追?
768 *
769 * @param useLine 横軸のグリ?表示有無(垂直?
770 */
771 public void setUseRangeLine( final boolean useLine ) {
772 useRangeLine = useLine;
773 }
774
775 /**
776 * ??ルチップスを利用(true)/利用しな?false)を指定しま?初期値:false)?
777 *
778 * @og.rev 4.3.1.0 (2008/08/09) 新規追?
779 *
780 * @param toolTip ??ルチップスを利用(true)/利用しな?false)
781 */
782 public void setUseToolTip( final boolean toolTip ) {
783 useToolTip = toolTip;
784 }
785
786 /**
787 * 縦軸のグリ?線?色を指定します?
788 *
789 * レンジ(縦軸)に対する、グリ?ラインの表示色を指定します?
790 * 何も?しな??合?、デフォルトで自動設定されます?
791 *
792 * @og.rev 4.0.3.0 (2008/01/07) 新規追?
793 *
794 * @param color 縦軸のグリ?線?色
795 */
796 public void setRangeLineColor( final String color ) {
797 if( color != null ) {
798 rangeLineColor = StringUtil.getColorInstance( color );
799 }
800 }
801
802 /**
803 * 横軸のグリ?(垂直?の書き?し位置(START,MIDDLE,END)を指定します?
804 *
805 * 横軸のグリ?(垂直?を?グラフ?どの位置に記述するかを?します?
806 * 具体的な値は、CategoryAnchor オブジェクト?値になります?
807 * ここでは、文字?で(START,MIDDLE,END)を指定します?(先??字で判?
808 * 何も?しな??合?、デフォル?MIDDLE)です?
809 *
810 * @og.rev 4.1.1.0 (2008/02/14) 新規追?
811 *
812 * @param anchor 横軸のグリ?(垂直?の書き?し位置(START,MIDDLE,END)
813 */
814 public void setCategoryAnchor( final String anchor ) {
815 if( anchor != null && anchor.length() > 0 ) {
816 char anc = anchor.charAt(0);
817 switch( anc ) {
818 case 'S' : categoryAnchor = CategoryAnchor.START; break;
819 case 'M' : categoryAnchor = CategoryAnchor.MIDDLE; break;
820 case 'E' : categoryAnchor = CategoryAnchor.END; break;
821 default :
822 String errMsg = "??Anchorは適用できません?" + anchor + "]"
823 + HybsSystem.CR
824 + "START,MIDDLE,END の中から、指定してください? ;
825 throw new HybsSystemException( errMsg );
826 }
827 }
828 }
829
830 /**
831 * Time,XYTime Polt関係?時間軸を表す?合?フォーマットを?します?
832 *
833 * TimeSeries 関連の??タを扱??合?横軸の日付フォーマットを?します?
834 * 日付フォーマット?、java.text.SimpleDateFormat で使われ?yyyy/MM/dd HH:mm:ss 表記です?
835 *
836 * 初期値は?MM/dd" です?
837 *
838 * @og.rev 5.6.1.0 (2013/02/01) 新規追?
839 *
840 * @param dtFormat Time,XYTime Polt関係?時間軸を表す?合?フォーマッ?
841 */
842 public void setDateAxisFormat( final String dtFormat ) {
843 if( dtFormat != null && dtFormat.length() > 0 ) {
844 dateAxisFormat = dtFormat;
845 }
846 }
847
848 /**
849 * Time,XYTime Polt関係?時間軸を表?DateAxis オブジェクトを返します?
850 *
851 * こ?オブジェクト?、domainLabel で名前付けされ?DateAxis で、日付フォーマット??
852 * dateAxisFormat で DateFormat ?Override して?す?
853 * 初期フォーマット??MM/dd" です?
854 *
855 * @og.rev 5.6.1.0 (2013/02/01) 新規追?
856 * @og.rev 5.6.4.3 (2013/05/24) 横軸ラベルを90度傾ける処?追?
857 *
858 * @return DateAxisオブジェク?Time,XYTime Polt関係?時間軸表現)
859 */
860 protected DateAxis getDateAxis() {
861 DateAxis daxis = new DateAxis( domainLabel );
862 daxis.setDateFormatOverride( new SimpleDateFormat( dateAxisFormat ) );
863
864 // 5.6.4.3 (2013/05/24) 時間関係?横軸は、rotationLabel ではなく?useVerticalLabels を使?す?
865 if( useVerticalLabels ) {
866 daxis.setVerticalTickLabels( useVerticalLabels );
867 }
868
869 return daxis;
870 }
871
872 /**
873 * ??フラグを指定します?
874 *
875 * true に設定すると、チャート?状態を System.out.println します?
876 *
877 * @og.rev 4.0.2.0 (2007/12/20) 新規追?
878 *
879 * @param flag ??フラグ [true:??/false:通常]
880 */
881 public void setDebug( final boolean flag ) {
882 isDebug = flag;
883 }
884 }