org.simBio.sim.analyzer.graph.plot
インタフェース IPlot

既知の実装クラスの一覧:

AbstractPlot, PlotDisplay, PlotPrinter

public interface IPlot

グラフ、描画対象（画面／プリンタ）毎の描画処理を行うためのインターフェイス.
simBioの描画処理では、対象デバイス（画面／プリンタ）毎の要求に合った描画処理を、 Plot interface にて一括して取り扱います。
これにより、描画を指示するプログラムでは、対象デバイス毎の描画処理を区別する 必要がありません。
Plot以外で、画面／プリンタで処理を切り替えているプログラムは、下記の通りです。

1. Graph

また、画面サイズ等も画面／プリンタ等で異なりますので、本インターフェイスで管理します。

作成者:

misaki

入れ子のクラスの概要

static interface

IPlot.Item タイトル／凡例描画用のオブジェクト

メソッドの概要

void	drawLine(java.awt.Graphics2D graphics2d, double x1, double y1, double x2, double y2, int nGraph) 線を描画する.
void	drawPoint(java.awt.Graphics2D graphics2d, double x, double y, int nGraph) 点を描画する.
IPlot.Item	getLegend() 凡例描画用のItemオブジェクトを取得する.
java.awt.Rectangle	getRectangleBounds() グラフ・タイトル・凡例の描画領域を取得する.
java.awt.Rectangle	getRectanglePage() ページ全体の領域を取得する.
java.awt.Rectangle	getRectangleView() グラフ本体の描画領域を取得する.
IPlot.Item	getTitle() タイトル描画用のItemオブジェクトを取得する.
void	init(int nTarget, int nTargetOrigin) 初期化を行う.
void	prepareLegend(java.awt.Graphics2D graphics2d, java.awt.Rectangle rectangleBounds, AttributeString[] texts) 凡例描画の準備を行う.
void	prepareTitle(java.awt.Graphics2D graphics2d, java.awt.Rectangle rectangleBounds, AttributeString text) タイトル描画の準備を行う.
void	setRectanglePage(java.awt.Rectangle rect) ページ全体の領域をセットする.
void	setSizePage(java.awt.Dimension size) 左上座標を(0,0)として、ページ全体のサイズをセットする.

メソッドの詳細

init

void init(int nTarget,
          int nTargetOrigin)

初期化を行う.

パラメータ:

nTarget - 描画する系列数

nTargetOrigin - 描画する系列の最小値

setSizePage

void setSizePage(java.awt.Dimension size)

左上座標を(0,0)として、ページ全体のサイズをセットする.

パラメータ:

size -

setRectanglePage

void setRectanglePage(java.awt.Rectangle rect)

ページ全体の領域をセットする.

パラメータ:

rect -

getRectanglePage

java.awt.Rectangle getRectanglePage()

ページ全体の領域を取得する.

戻り値:

ページ全体の領域

getRectangleView

java.awt.Rectangle getRectangleView()

グラフ本体の描画領域を取得する. グラフ領域の設定時は、本メソッドで取得したRectangleに対して設定すること。

戻り値:

グラフ本体の描画領域

getRectangleBounds

java.awt.Rectangle getRectangleBounds()

グラフ・タイトル・凡例の描画領域を取得する. グラフ領域の設定時は、本メソッドで取得したRectangleに対して設定すること。

戻り値:

グラフ・タイトル・凡例の描画領域

drawLine

void drawLine(java.awt.Graphics2D graphics2d,
              double x1,
              double y1,
              double x2,
              double y2,
              int nGraph)

線を描画する.

1. 高速に描画するために、最適化処理を入れている。
2. 本メソッドは、グラフ枠、目盛り等の描画には使用しないこと。

パラメータ:

graphics2d - 描画対象のGraphics2D

x1 - 始点X座標

y1 - 始点Y座標

x2 - 終点X座標

y2 - 終点Y座標

nGraph - グラフの系列番号(0..n)

drawPoint

void drawPoint(java.awt.Graphics2D graphics2d,
               double x,
               double y,
               int nGraph)

点を描画する.

1. 高速に描画するために、最適化処理を入れている。
2. 本メソッドは、グラフ枠、目盛り等の描画には使用しないこと。

パラメータ:

graphics2d - 描画対象のGraphics2D

x - X座標

y - Y座標

nGraph - グラフの系列番号(0..n)

prepareTitle

void prepareTitle(java.awt.Graphics2D graphics2d,
                  java.awt.Rectangle rectangleBounds,
                  AttributeString text)

タイトル描画の準備を行う.

• 画面の場合：高速再描画が必要なため、本メソッドを呼び出した時点で描画イメージを作成しておく。
• 印刷の場合：プリンタ解像度に合わせた描画が必要なため、印刷内容を保持するのみとする。

パラメータ:

graphics2d - 描画対象のGraphics2D

rectangleBounds - 描画対象のグラフ領域（暫定値）

text - 表示するテキスト,フォント,色のセット

getTitle

IPlot.Item getTitle()

タイトル描画用のItemオブジェクトを取得する.

戻り値:

タイトル描画用のItemオブジェクト

prepareLegend

void prepareLegend(java.awt.Graphics2D graphics2d,
                   java.awt.Rectangle rectangleBounds,
                   AttributeString[] texts)

凡例描画の準備を行う.

• 画面の場合：高速再描画が必要なため、本メソッドを呼び出した時点で描画イメージを作成しておく。
• 印刷の場合：プリンタ解像度に合わせた描画が必要なため、印刷内容を保持するのみとする。

パラメータ:

graphics2d - 描画対象のGraphics2D

rectangleBounds - 描画対象のグラフ領域（暫定値）

texts - 表示するテキスト,フォント,色のセットの配列

getLegend

IPlot.Item getLegend()

凡例描画用のItemオブジェクトを取得する.

戻り値:

凡例描画用のItemオブジェクト