Language

図形の描画・描画パネル

Frame (Index), No frame                 version:0.3(latest)  

DrawPanel.paint メソッドが起点になり、全ての描画メソッドが呼ばれる。 DrawPanel.paint メソッドはContainerManagerで 図形データ(ShapeContainer オブジェクト) を読み出し、 ShapeContainer.drawShapeメソッドを呼ぶ。 ShapeContainer.drawShape メソッドは DrawShapeUtil.drawShapeElementメソッドや DrawShapeUtilのほかのメソッドを呼んで図形描画を行う。 DrawShapeUtil クラスは、様々な種類の図形と 補助データ(選択ボックス、リサイズマークなど)を描画するメソッドを集めたものである。
一時的な図形 (TempShape オブジェクト) はユーザの入力に応答して描画する図形で、 drawTempShapeメソッドで描画する。

: キャンバスに図形を描画するためには、図形を現す ShapeContainer オブジェクトを ContainerManager.addContainerメソッドで ContainerListに登録する。 一旦登録すると、DrawPanelのrepaintメソッドを呼べば、その図形はキャンバスに描画される。

図1 描画ダイアグラム

=> DrawPanel.paint, ShapeContainer.drawShape, DrawShapeUtil, ContainerManager, ContainerList

メソッド	説明
drawShapeElement (static)	public static void drawShapeElement(Graphics g, ShapeContainer shapeContainer) ElementContainerのdrawShapeメソッドから呼ばれる。 図形要素（shapeElement）の種類に応じて、 drawStandardElement、drawImageElement、drawArrowLineElementのどれかを呼び出す。
drawStandardElement (static)	private static void drawStandardElement(Graphics g, ShapeContainer shapeContainer) 閉図形を描画する。 ・図形を囲むboxを少し拡大してクリップ領域を設定する。 ・AlphaCompositeを設定（不透明率のアルファはDrawParametersクラスで設定：0.9-1.0ぐらい） ・DrawParameters.DRAW_BOUNDINGBOX=trueのとき、 図形を覆うBounding boxを表示する。 通常表示Bounding box表示
drawImageElement (static)	private static void drawImageElement(Graphics g, ShapeContainer shapeContainer) 画像要素(ImageElement)を描画する。 ・描画領域に枠がつくので、線幅分だけ小さくした領域に画像を描画する。 ・画像はimageElement.getBufferedImage()で取得する。
drawLineElement (static)	private static void drawLineElement(Graphics g, ShapeContainer shapeContainer) このクラスのdrawShapeから呼ばれる。 直線、折れ線など矢印をつけられる図形を描画する。drawArrowLineを呼んで、矢印と直線/曲線を描画する。 閉曲線には矢印をつけられない。 ・矢印、斜め線をきれいに描画するためアンチエイリアスをonにする。 g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_OFF) ・図形作成モードのとき、閉曲線になったら図形の中心付近に”closed”のメッセージを表示する。
drawClosedMessage (static)	private static void drawClosedMessage(Graphics g, ShapeContainer shapeContainer) このクラスのdrawArrowShapeから呼ばれる。 曲線の始点と終点の距離を計算し、一定以下になったら、図形の中心付近に”closed”のメッセージを表示する。
drawLine (static)	private static void drawLine(Graphics g, ShapeContainer shapeContainer) このクラスのdrawArrowShapeから呼ばれ、矢印つきで直線または折れ線を描画する。 ・paintStyle.startArrowType=0の時は始点に矢印なし、1の時は図4.1のタイプ1の矢印、2の時はタイプ2の矢印を描く。 ・paintStyle.endArrowTypeも意味は同じ。
getTrimmedLine (static)	private static Curve2D getTrimmedLine(ShapeContainer shapeContainer) このクラスのdrawArrowLineから呼ばれる。矢印を書く線分の先端を少しカットする。 下図から分かるように、端点まで線を描画すると、先端に線幅が4角形状に見えてしまう。 線幅が太くなると特に目立つ。 (a)先端をカットしない場合(b)先端をカットした場合
createArrowShape (static)	private static ArrowShape createArrowShape(int position , ShapeContainer shapeContainer) このクラスのdrawArrowLineから呼ばれる。ArrowShapeクラスのコンストラクタに渡す引数を作成する。 矢印の広がり、高さは線幅から決める。 ただし線幅に敏感すぎて矢印が小さくなりすぎるのを防ぐため、最小値を設定してある。
drawNodeMark (static)	private static void drawNodeMark(Graphics g, ShapeContainer shapeContainer) このクラスのdrawShapeから呼ばれる。 折れ線、三次曲線の節点(セグメント接続点)を描画する。
drawCharacteristicMark (static)	private static void drawCharacteristicMark(Graphics g, ShapeContainer shapeContainer) このクラスのdrawShapeElementから呼ばれる。 Curve2D.getCharacteristicPointsメソッドで出力される特徴点を描画する。 通常表示Draw characteristic points
drawConnectorMark (static)	private static void drawConnectorMark(Graphics g, ShapeContainer shapeContainer) このクラスのdrawShapeから呼ばれる。 コネクターの資格を持つ図形を識別するためのマークを表示する。 またコネクターのターゲットとなる資格を持つ図形を識別するためのマークを表示する。
drawSelection (static)	public static void drawSelection(Graphics g, ShapeContainer shapeContainer) ShapeContainer.drawShapeメソッドから呼ばれる。 図形が選択されている時、選択ボックス、リサイズハンドルを描画する(図3.1, 図3.3)。 直線の場合は、選択ボックスを描画せず、両端にハンドルを描くだけなので、drawLineSelectionメソッドを呼ぶ。 その他はdrawRegularSelectionを呼ぶ。 選択ボックスを描画する時の図形を囲むボックスからのオフセット量、選択ボックスの幅、 リサイズハンドルのサイズ、表示位置などは、表示倍率に依存しないように描くのが重要。 倍率を小さくしたときに、図形の選択ができなくなるようでは困る。 => drawSelection詳細
drawSelectionBox (static)	private static void drawSelectionBox(Graphics g, ShapeContainer shapeContainer) ・選択ボックスは図形を囲む矩形をオフセットした矩形を作り、これをを中心線として線幅を持たせ灰色で描く。 ・閉じていない曲線の場合は端点に4角マーク(□)を描く。このマークを動かすと、端点を移動できるようにする。 ・折れ線の場合はコネクターの役割があるので、端点につながる線分が水平線/垂直線ならば、リサイズしても水平線/垂直線になるよう特殊なリサイズを行う。参照=> PolyLineElement.moveEndPoint。
drawLineSelection (static)	private static void drawLineSelection(Graphics g, ShapeContainer shapeContainer) 両端に端点移動ハンドルの4角マーク(□)を描く。
drawSegmentModifiers (static)	public static void drawSegmentModifiers(Graphics g, ShapeContainer shapeContainer) ElementContainerがMODIFYING_SHAPE_MODEの時に呼ばれる。図形を変形するための制御点を描画する。 三次曲線の場合には、接線方向を示す線分も表示する。 制御点を描画するためのデータ（制御点の種類、位置、接線方向を示す線分など）は SegmentModifierオブジェクトの配列に格納されているので、 必要なデータをControlShapeオブジェクトから取り出して描画する。 =>図形の変形
drawTempShape (static)	public static void drawTempShape(String id, Point2D point, int size, String message, Color color) 引数: id - TempShapeオブジェクトにつけるId。 point - TempShapeオブジェクトの表示位置。 size - マークのサイズ(0または1)。0だとDrawParameters.Mark_SmallSize, 1だとDrawParameters.Mark_NormalSizeのサイズ。 message - TempShapeオブジェクトの横に表示する文字列 color - TempShapeオブジェクト、messageの表示色 処理: TempShapeオブジェクトを作成し、DrawPanel.addTempShapeでDrawPanelに登録する。
drawTempShape (static)	public static void drawTempShape(String id, Shape shape, Stroke stroke, Color lineColor, Color fillColor, String message, Color messageColor) 引数: id - TempShapeオブジェクトにつけるId。 shape - 図形 stroke - 図形描画のStrokeオブジェクト. lineColor - 図形の境界線の色。. fillColor - 図形の塗りつぶし色。 message - 図形の横に表示するメッセージ。 messageColor - メッセージの色。 処理: TempShapeオブジェクトを作成し、DrawPanel.addTempShapeでDrawPanelに登録する。

図 3.1 選択ボックス、リサイズハンドル

表示倍率=100%	表示倍率=144%	表示倍率=173%

図 3.2 選択ボックスの線幅、リサイズハンドルのサイズ

直線の両端にリサイズハンドル

折れ線の選択ボックス、リサイズハンドル 閉じていない場合は両端にリサイズハンドル

図 3.3 直線、折れ線端点のリサイズハンドル

直線、折れ線などの先端に描く矢印の図形を作成する。

図4.1 矢印の形状

　図4.2 矢印データ
　

図6.1 線幅	図6.2 線種	図6.3 矢印スタイル