説明

説明

マウスボタンを押したとき、SelectionLS (図形選択クラス)のmousePressedメソッドが呼ばれる。 マウス位置が選択ボックスまたはリサイズハンドル上にあることが確認できれば(注)、move/resizeコマンドと判断しSelectionLSの prepareMoveResizeCommandメソッドを呼ぶ。

(注)マウスが図形上にあるか、選択ボックスまたはリサイズハンドル上にあるかなどは、 MousePositionLSで常に計算している。

prepareMoveResizeCommandで マウスが選択ボックス(または図形内部)上にあればmoveコマンド、リサイズハンドル上にあればresizeコマンドと判断し、 標準的なコマンド列を作成してコマンドディスパッチャーExecCommandを呼ぶ。

MoveResizeShapeLSのstartメソッドでマウスリスナー(MoveResizeShapeLS自身)をListenerPanelにセットする。これで制御がマウスリスナーであるMoveResizeShapeLSに移りマウスイベントが起きるまで待機状態に入る。

リサイズ前の図形をundoManagerに設定。これはContainerManagerのundoサポート機能を使う。

マウスドラッグをが始まると、 MoveResizeShapeLS.mouseDraggedメソッドでマウスの動きを取得し図形要素の resizeメソッドを呼ぶ （図形のmoveはresizeメソッドで位置だけを変更する場合に相当する）。
マウスが端点移動ハンドル上にあるときは、図形要素の moveEndPointメソッドを呼ぶ。
参照=>ShapeElementのmove/resizeメソッド(このページ)

MoveResizeShapeLSのmouseReleasedが呼ばれると、endメソッドを呼んで終了処理。

リサイズ後の図形をundoManagerに設定 =>ContainerManagerのundoサポート機能

説明

コネクター端点を移動しコネクター端点が他の図形(ターゲット図形)に近づいたとき、その図形の境界上に接続候補点を表示する。MoveResizeShapeLSのmouseDraggedメソッドから、ConnectionLSのdrawMouseHitPTメソッドを呼んで接続候補点を表示する。
=> 図 2.1, 2.2

drawMouseHitPTメソッドから接続点が戻れば、 ShapeElement.moveEndPointメソッドで コネクターの端点を接続点に移動する。 接続点は高精度に計算されるので、コネクターの端点をターゲット図形上に計算機誤差の範囲で載せる。

説明

この処理はMoveResizeShapeLSのstartメソッドから ConnectionUtil.setTargetsメソッド を呼んで、移動/リサイズされる図形とそれに接続するコネクターの一覧を作成する。

MoveResizeShapeLSのmouseDraggedメソッドから ConnectionUtil.resizeConnectorsメソッド を呼んで、コネクターのリサイズ（変形）を行いターゲット図形との接続を保持する。

MoveResizeShapeLSのmouseReleasedメソッドからConnectionUtil.endメソッドを呼んで終了処理を行う。

説明

private MousePositionInfo mousePositionInfo

マウスで選択ボックスまたはリサイズハンドルを押した時のマウス位置情報。

このクラスのstartメソッドの引数で渡される。

ShapeContainer[] selectedContainers

移動/リサイズされる図形。 グループ図形でも可。 this.startメソッドで設定する。

ConnectionUtil connectionUtil=new ConnectionUtil()

コネクターのリサイズを一括して行うConnectionUtilオブジェクトを設定。 なおConnectionUtilはundoの設定も行う。

Point2D startPoint：ドラッグ開始点

Point2D newPoint：ドラッグ現在点

Point2D oldPoint：一回前に呼ばれた時のドラッグ点

Rectangle2D startBox：ドラッグ開始時に selectedContainersを全て囲むBoundingBox

Rectangle2D newBox：現在のselectedContainersを 全て囲むBoundingBox

Rectangle2D oldBox：mouseDraggedメソッドが 一回前に呼ばれた時のBoundingBox

説明

public void start(MousePositionInfo info, MouseEvent e)
引数:

info - 選択図形を移動/リサイズするために、 選択図形上でマウスボタンが押されたときのMousePositionInfo データ。 このデータから選択ボックスが押されたのか、リサイズハンドルが押されたのかなどがわかる。

e - SelectionLSのmousePressedメソッドで受け取ったMouseEventオブジェクト。

処理:
ExecCommandでMoveResizeShapeLSオブジェクトを作成した後にこのメソッドを呼が呼ばれる。

・MoveResizeShapeLSをマウスリスナーとして、ListenerPanelに設定する。

これと同時にSelectionLS（図形選択クラス）を一時停止する。

・initメソッドを呼ぶ。

このクラスでは、MouseListenerインターフェイスのmousePressedメソッドは呼ばれない。 マウスで選択ボックスまたはリサイズハンドルを押した時のマウスイベントはSelectionLSのmousePressedメソッドが受け取ってしまうからである。 このクラスのmousePressedを呼ぶ代わりにinitメソッドを呼ぶ。

・ContainerManager.undoSetupStartを呼んで 図形変更前の図形、コネクターを設定する。

public void init(MouseEvent e)
引数はstartメソッドと同じ。
・引数mousePositionInfoをチェックしてmodeを設定する。
・選択図形をフィールド変数selectedContainersに設定する。

modeが端点移動(MOVE_ENDPT)の場合、直線、閉じていない折れ線、曲線だけが許されるので isSuitableForMoveEndPTでチェックして設定する。

これは端点移動ハンドルをドラッグする場合に必須であり、 始点、終点のどちらを動かすかなどを決定する。

・AUTO_ALIGNの設定を行うため、 AutoAlign.startメソッドを呼ぶ。

・Connector関係の処理(2.1 (2), 2.1 (3))を行うため ConnectionUtil.startメソッドを呼ぶ。

public void end()

・MoveResizeShapeLSを、ListenerPanelから削除する。

SelectionLS（図形選択クラス）を再開する。

・ConnectionUtilに移動･リサイズ後の図形を設定する。

public void mousePressed(MouseEvent e)

・このメソッドは呼ばれないので何もしない。

public void mouseDragged(MouseEvent e)

・Sift/Ctrl keyを押している場合

moveの方向は、水平/垂直方向に限定する。
基本閉図形のリサイズは縦横比を1にする。

・フィールド変数modeの値により所定のメソッドを呼ぶ。これは結構複雑かつ重要である。

・mode=Command.MOVING_MODEのとき

ShapeElement.moveメソッドを呼ぶ。

・mode=Command.RESIZING_MODEのとき

ShapeElement.resizeメソッドを呼ぶ。

・mode=Command.MOVING_ENDPT_MODEのとき

ShapeElement.moveEndPointメソッドを呼ぶ。

・Auto_Align, Connector処理のためAutoAlign.mouseDragged, ConnectionUtil.mouseDraggedを呼ぶ

public void mouseReleased(MouseEvent e)

・Auto_Align, Connector処理のためAutoAlign.mouseReleased, ConnectionUtil.mouseReleasedを呼ぶ

public void mouseMoved(MouseEvent e)

・なにもしない

public void mouseClicked(MouseEvent e)

・なにもしない

public void mouseEntered(MouseEvent e)

・なにもしない

public void mouseExited(MouseEvent e)

・なにもしない

説明

MoveResizeShapeLS.initメソッドからAutoAlign.startメソッドを呼びだして初期設定を行い、 AutoAlign.drawHitAlignsメソッドで整列状況の初期表示を行う。

マウスがドラッグされるたびに整列状況のチェック・表示を行う。 このためMoveResizeShapeLS.mouseDraggedメソッドから AutoAlign.mouseDraggedメソッドを呼びだし、 AutoAlign.drawHitAlignsメソッドで整列状況を表示する。

マウスボタンを離したときに、移動またはリサイズされている図形が 隣の図形とある誤差範囲で整列していれば、誤差のないように正確に整列する。 これはMoveResizeShapeLS.mouseReleasedメソッドから AutoAlign.mouseReleasedメソッドを呼び、 さらにAutoAlign.ajustAlignmentメソッドを呼んで正確に整列する。
=>　コネクターとの接続は保証される(Figure 3.4)

: もし図1.3, 図2.1, 2.2に示すようなコネクターの接続がなされた場合にはこの処理はスキップされる。 コネクターの接続のほうが優先度が高い。

説明

: 赤い点線の表示
ターゲット図形とhitAlignの元の図形が矩形や楕円など単純な図形ならば、点線を描画する範囲は簡単に決まる。下図はAlign.TOP、Align.BOTTOMのケースでターゲット図形とhitAlignの元の図形は共に三次曲線である。このとき点線y値は上記の整列チェックで決まっているのでよいが、xの範囲は、Align.TOP、Align.BOTTOMを実現する図形上の点を選んで描画する。あまり精度がいらないので、AlignCouple.setAlignPointsメソッドで曲線から点サンプリングしてAlign.TOP、Align.BOTTOMに最も近い点を選び、xの範囲を決める。点の選択はAlignクラスのgetAlignedPointsで行い、点線の描画はAutoAlignクラスのdrawAlignで行う。

図 (e) Align top	図 (f) Align Bottom

説明

MousePositionInfo mousePositionInfo

コンストラクタでMoveResizeShapeLSから渡されたMousePositionInfoを設定する。

ShapeContainer[] selectedContainers

コンストラクタでMoveResizeShapeLSのフィールド変数selectedContainersが設定される。selectedContainersはmove, resize, move_endPTの対象となる図形である。

MoveResizeShapeLSオブジェクト。コンストラクタで設定する。

int mode

コンストラクタでMoveResizeShapeLSのstatic定数MOVE, RESIZE, MOVE_ENDPTのどれかが設定する。

ArrayList xAlignList

このリストはx軸整列の目盛りに相当する。移動/リサイズ対象図形が この目盛りにある誤差範囲で一致すれば整列状況を示す点線を表示する。
画面に表示されている図形からフィールド変数selectedContainers(移動/リサイズ対象図形)の 図形を除外した図形から、x-align(垂直方向)のデータを作成してputAlignメソッドでこのArrayListに登録する。 このArrayListに登録されるデータはAlignオブジェクトである。
=>処理概要Step1

ArrayList yAlignList

このリストはy軸整列の目盛りに相当する。移動/リサイズ対象図形が この目盛りにある誤差範囲で一致すれば整列状況を示す点線を表示する。
y-align(水平方向)のデータを作成してputAlignメソッドでこのArrayListに登録する。
=>処理概要Step1

Vector hitAlignedCouples

マウスドラッグで移動/リサイズ対象図形(ターゲット)が、 xAlignList、yAlignListのどれかのAlignオブジェクト(hitAlign)と整列したときに、ターゲット図形のAlignオブジェクトを作成し、hitAlignオブジェクトを組にしてAlignedCoupleオブジェクトを作成し、 このVector配列に格納する。この処理はcreateHitAlignedCouplesメソッドで実行する。

=>処理概要 Step2

Vector selectedHitAlignedCouples

ターゲット図形にヒットするxAlignList、yAlignListのAlignオブジェクト(hitAlign)は多数見つかる可能性がある。 表示を見やすくするため、この中からAlign.LEFT～Align.BOTTOMごとにひとつ選び、 drawHitAlignsメソッドでこのVector配列に格納する。 Align.LEFT～Align.BOTTOMごとにhitAlignをひとつ選ぶ処理はselectHitAlignedCoupleで行う。

=>処理概要 Step3

public static double errorMargin

整列チェックをするときの許容誤差。現在4ピクセルを設定。

Color color

整列を示す点線の色。

説明

public AutoAlign(int mode, MousePositionInfo mousePositionInfo, ShapeContainer[] selectedContainers)

public void start(int mode, MousePositionInfo mousePositionInfo, ShapeContainer[] selectedContainers)

• Auto_Alignの初期設定を行う。

: このメソッドはMoveResizeShapeLS.initメソッドが複雑になるのを避けるために用意した。このメソッドは MoveResizeShapeLS.init メソッドから呼ばれる。.

ConnectionUtil.connectedフィールドをチェック、 trueでなければAutoAlign.ajustAlignmentメソッドを呼ぶ。

ConnectionUtil.guidedフィールドをチェック, trueでなければこのクラスのajustAlignmentメソッドを呼ぶ。

private void createAlign()

コンストラクタから呼び出される。次のputAlignメソッドで、 選択図形(selectedContainers) を除く全ての図形のAlignオブジェクトをxAlignList、yAlignListに登録する。

=>処理概要Step1

private void putAlign(int alignAxis, int alignType, double value, ShapeContainer shapeContainer)

引数:

alignAxis - Align.XALIGN/Align.YALIGN

alignType- Align.LEFT/Align.CENTER/Align.RIGHT/Align.TOP/Align.MIDDLE/Align.BOTTOM

value - 整列位置。Align.XALIGNの場合x値、Align.YALIGNの場合y値。

shapeContainer - フィールド変数selectedContainers以外の表示されている図形コンテナ。

処理:

createAlignから呼び出される。alignType=Align.XALIGNならばAlignオブジェクトをxAlignListに、alignAxis=Align.YALIGNならばyAlignListに登録する。

整列位置を示すvalueが小さい順になるように登録する。

private void createHitAlignedCouples(ShapeContainer targetContainer, int endPTindex)

引数:

targetContainer - マウスドラッグしている図形。

フィールド変数selectedContainersに設定されている図形のどれかに一致する。

endPTindex - mode=Command.MOVE_ENDPTのときに、targetContainerのどちらの端点を動かすかを示す。

endPTindex=0のときは始点、endPTindxe=1のときは終点を動かす。
mode=Command.MOVE/RESIZEのときはendPTindexは無効で何を指定しても良い。

処理:

targetContainerの現在の位置、サイズに対して、 xAlignList、yAlignListに登録されているAlignオブジェクトのどれかとある誤差範囲で整列しているか否かをチェックする。
もし一致していればtargetContainerからAlignオブジェクト(targetAlign)を作成し、 xAlignListまたはyAlignListのAlignオブジェクト(hitAlign)を組にしてAlignedCoupleオブジェクトを作成し、 フィールド変数hitAlignedCouples(Vector配列)に格納する。

: this.mode==Command.MOVING_ENDPT_MODEの場合の処理
• このメソッドで作成するtargetAlignのalignTypeにAlign.ENDPTをセットする。
• targetAlignのboundingBoxに、 endPTindexが指す端点を覆う幅と高さがゼロの矩形を設定する。

private int selectMovingEndPT()

コンストラクタから呼ばれる。 mode= Command.MOVE_ENDPTの時に図形(直線、折れ線、曲線)のどちらの端点を動かすかを決定して、戻り値で返す。 0ならば始点、1ならば終点を動かす。

dir=0ならば、画面上でhitAlignPointが targetAlignPoint左側または上側にあるAlignedCoupleを返す。 dir=１ならば画面上でhitAlignPointが、 targetAlignPoint右側または下側にあるAlignedCoupleを返す。

private void drawAlign(AlignedCouple couple)

引数:
couple - 整列状況を示す赤い点線を表示するAlignedCoupleオブジェクト。
処理:
drawHitAlignsメソッドから呼ばれる。 赤い点線の表示はDrawShapeUtil.drawTempShapeメソッドで行う。

• 通常表示(Figure 3.1)

targetP=couple.getTargetAlignPoint(), hitP=couple.getHitAlignPoint()を参照して赤い点線を描画する直線を作成し表示する。
例えばalignType=Align.LEFTの場合、移動/リサイズ図形をhitPのx座標に整列させる。 このため始終点のx座標はhitPのx座標を使い、始終点のy座標はtargetPとhitPのを使って垂直方向の直線を作成する。

bestCoupleX=this.getBestAlignedCouple(Align.XALIGN);
bestCoupleY=this.getBestAlignedCouple(Align.YALIGN);

errorX=bestCoupleX.getAlignedError();
errorY=bestCoupleY.getAlignedError();

this.selectedContainers[i].getElement().move(ctrl, newP, true); 0≦i<this.selectedContainers.length, newP(Point2D.double)は現在点に(errorX, errorY)を加えた点

bestCoupleX = this.getBestAlignedCouple(Align.XALIGN, Align.LEFT);
bestCoupleY = this.getBestAlignedCouple(Align.YALIGN, Align.TOP);

this.selectedContainers[i].getElement().mouseStart(ctrl, P0);
this.selectedContainers[i].getElement().resize(ctrl, P1, mousePosition, true);

bestCoupleX = this.getBestAlignedCouple(Align.XALIGN, Align.ENDPT);
bestCoupleY = this.getBestAlignedCouple( Align.YALIGN, Align.ENDPT);

this.selectedContainers[0].getElement().moveEndPoint(ctrl, ptIndex, newPoint);

: MoveResizeShapeLS.mouseReleasedから呼ばれるのでコネクターとの接続は保証される
=> Figure 3.4

private AlignedCouple getBestAlignedCouple(int alignAxis)

引数:
alignAxis - XALIGNまたはYALIGN
戻り値:
AlignedCouple - 選ばれたAlignedCoupleオブジェクト
処理:
フィールド変数のselectedHitAlignedCouples(Vector配列)から 引数alignAxisに一致するAlignedCoupleを取り出す。
該当のAlignedCoupleが複数ある場合、次の優先順位で選択する。

(1)重なり部分があり、区間が最大のAlignedCouple

重なり部分はAlignedCouple.checkIntersectionメソッドで求める。

(2)alignAxis方向の誤差が最も小さいAlignedCouple。

alignAxis方向の誤差はAlignedCouple.getAlignedErrorメソッドで求める。

private AlignedCouple getBestAlignedCouple(int alignAxis, int targetAlignType)

引数targetAlignTypeを追加することにより、上のgetBestAlignedCoupleより詳細な指定ができる。 引数:
alignAxis - XALIGNまたはYALIGN
targetAlignType - Align.LEFT～Align.ENDPTのいずれか
戻り値:
AlignedCouple - 選ばれたAlignedCoupleオブジェクト
処理:
フィールド変数のselectedHitAlignedCouples(Vector配列)から 引数alignAxis、targetAlignTypeに一致するAlignedCoupleを取り出す。 targetAlignTypeは、couple.targetAlignのalignTypeと比較する。
該当のAlignedCoupleが複数ある場合、次の優先順位で選択する。

(1)重なり部分があり、区間が最大のAlignedCouple

重なり部分はAlignedCouple.checkIntersectionメソッドで求める。

(2)alignAxis方向の誤差が最も小さいAlignedCouple。

alignAxis方向の誤差はAlignedCouple.getAlignedErrorメソッドで求める。

説明

説明

int alignAxis

static定数XALIGNまたはYALIGNを設定する。

int alignType

static定数LEFT/CENTER/RIGHT/TOP/MIDDLE/BOTTOM/ENDPTのどれかを設定する。

double value

整列位置を示す値。x-alignの時はx値、y-alignの時はy値。

ShapeContainer shapeContainer

このオブジェクトの元になる図形(=>ShapeContainer)

int endPTindex

shapeContainerが直線、閉じていない折れ線、曲線のときに、始点、終点のどちらを動かすかを示す。 endPTindex=0のとき始点、endPTindex=1のとき終点。endPTindex=-1は無効を示す。

Point2D[] alignedPoints

フィールド変数alignTypeを実現する点。 setAlignedPointsメソッドでセットする。

static final int XALIGN=10

Alignオブジェクトがx方向整列であることを示す。

static final int YALIGN=11

Alignオブジェクトがy方向整列であることを示す。

static final int LEFT=0

Alignオブジェクトがx方向整列で整列位置が図形の左端であることを示す。

static final int CENTER=1

Alignオブジェクトがx方向整列で整列位置が図形の中心であることを示す。

static final int RIGHT=2

Alignオブジェクトがx方向整列で整列位置が図形の右端であることを示す。

static final int TOP=3

Alignオブジェクトがy方向整列で整列位置が図形の上端であることを示す。

static final int MIDDLE=4

Alignオブジェクトがy方向整列で整列位置が図形の中央であることを示す。

static final int BOTTOM=5

Alignオブジェクトがy方向整列で整列位置が図形の下端であることを示す。

static final int ENDPT=6

Alignオブジェクトがxまたはy方向整列で整列位置が点であることを示す。

String[] alignString

整数値XALIGN, YALIGN, LEFT, CENTER, RIGHT, TOP, MIDDLE, BOTTOM, ENDPTの文字列表現

説明

Align(int alignType, int alignType, double value, ShapeContainer shapeContainer)

引数をフィールド変数に設定する。
setBoundingBox, setAlignedPointsメソッドを呼んでフィールド変数boundingBox, alignedPointsに値をセットする。

Align(int alignType, int alignType, double value, ShapeContainer shapeContainer, int endPTindex)

引数をフィールド変数に設定する。shapeContainerが直線、閉じていない折れ線、曲線のときに、このコンストラクタを使う。setBoundingBox, setAlignedPointsメソッドを呼んでフィールド変数boundingBox, alignedPointsに値をセットする。

public Point2D[] getAlignedPoints()

フィールド変数alignTypeを実現する点を返す。
例えばalignType=Align.TOPの場合
矩形、コーナR矩形、楕円など基本図形の場合は、図形を覆う矩形上端の線の中点を返す。
基本図形でないとき(折れ線、三次曲線など)は図形境界線から点をサンプリングし、y座標でAlign.TOPのy座標にに最も近い点を返す。 このメソッドは表示のために使われるので高精度である必要はない。

=> 処理概要 Step3 Figure (e), (f)

int getAlignAxis()

フィールド変数alignAxisを返す。

int getAlignType()

フィールド変数alignTypeを返す。

double getValue()

フィールド変数valueを返す。

ShapeContainer getShapeContainer()

フィールド変数shapeContainerを返す。

int getEndPTindex()

フィールド変数endPTindexを返す。

Rectangle2D getBoundingBox()

フィールド変数boundingBoxを返す。

public Point2D[] getAlignedPoints()

フィールド変数alignedPointsを返す。

public void update()

this.shapeContainerなどを更新したときに、このオブジェクトも更新する。

public String toString()

このオブジェクトの文字列表現を返す。

説明

protected Align targetAlign

マウスドラッグで移動/リサイズ/端点移動している図形(ターゲット)から作られるAlignオブジェクト

protected Align hitAlign

xAlignList, yAlignListに格納されている Alignオブジェクトで、ターゲット図形のAlignと一定誤差範囲(tolerance)で一致するもの。

protected Point2D targetAlignPoint

targetAlignとhitAlignの整列を赤い点線で表示するときのtargetAlign図形の点。 setAlignPointsメソッドで設定する。

protected Point2D hitAlignPoint

targetAlignとhitAlignの整列を赤い点線で表示するときのhitAlign図形の点。 setAlignPointsメソッドで設定する。

説明

public Point2D getTargetAlignPoint()

フィールド変数targetAlignPointを返す。

public Point2D getHitAlignPoint()

フィールド変数hitAlignPointを返す。

public double getAlignOrthogonalDistance()

targetAlignとhitAlignからそれぞれAlign.getAlignedPointsで2点を取り出し、 整列がXALIGNならば2点間のY方向距離を、YALIGNならばX方向距離を計算して返す。
このメソッドはAutoAlign.selectHitAlignedCoupleから呼ばれる。

public double getAlignedError()

このメソッドはAutoAlign.ajustAlignmentから呼ばれ、 ターゲット図形を移動/リサイズ/端点移動して誤差ゼロで整列させるために使う。
整列がXALIGNの時はhitAlignに対するtargetAlignのx値の誤差、 YALIGNの時はhitAlignに対するtargetAlignのy値の誤差を返す。

public double[] checkIntersection()

戻り値:
double[] - 重なり部分の区間。重なり部分がないときはnullを返す。
処理:
this.targetAlignとthis.hitAlignの 図形のboundingBoxの間に重なりがあるとき、その区間を返す。
整列がXALIGNのときはy座標での区間、YALIGNのときはx座標での区間を返す。
: Figure 3.2, Figure 3.3の太い赤の点線が重なり部分である。

public String toString()

このオブジェクトの文字列表現を返す。