de.tesis.dynaware.grapheditor.utils

Class GeometryUtils

java.lang.Object

de.tesis.dynaware.grapheditor.utils.GeometryUtils

public class GeometryUtils
extends java.lang.Object

Utility class containing helper methods relating to geometry, positions, etc.

Constructor Summary

Constructors

Constructor and Description
GeometryUtils()

Method Summary

Modifier and Type	Method and Description
static boolean	checkInRange(double firstValue, double secondValue, double position) Checks if the given position is between two values.
static boolean	checkIntersection(javafx.geometry.Point2D a, javafx.geometry.Point2D b, javafx.geometry.Point2D c, javafx.geometry.Point2D d) Checks if a horizontal line segment AB intersects with a vertical line segment CD.
static javafx.geometry.Point2D	getConnectorPosition(de.tesis.dynaware.grapheditor.model.GConnector connector, SkinLookup skinLookup) Gets the position of the center of a connector in the coordinate system of the view.
static javafx.geometry.Point2D	getCursorPosition(de.tesis.dynaware.grapheditor.model.GConnector connector, double x, double y, SkinLookup skinLookup) Gets the position of the cursor relative to the coordinate system of the view.
static java.util.List<javafx.geometry.Point2D>	getJointPositions(de.tesis.dynaware.grapheditor.model.GConnection connection) Gets the x and y values from all joints within a connection.
static java.util.List<javafx.geometry.Point2D>	getJointPositions(de.tesis.dynaware.grapheditor.model.GConnection connection, SkinLookup skinLookup) Gets the layout x and y values from all joints within a connection.
static java.util.List<javafx.geometry.Point2D>	getJointPositions(java.util.List<GJointSkin> jointSkins) Gets the layout x and y values from all joints in a list of joint skins.
static java.util.List<GJointSkin>	getJointSkins(de.tesis.dynaware.grapheditor.model.GConnection connection, SkinLookup skinLookup) Gets all joint skins for a connection.
static double	moveOffPixel(double position) Moves an x or y position value off-pixel.
static double	moveOnPixel(double position) Moves an x or y position value on-pixel.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GeometryUtils

public GeometryUtils()

Method Detail

getConnectorPosition

public static javafx.geometry.Point2D getConnectorPosition(de.tesis.dynaware.grapheditor.model.GConnector connector,
                                                           SkinLookup skinLookup)

Gets the position of the center of a connector in the coordinate system of the view.

Only works for connectors that are attached to nodes.

Parameters:

connector - the GConnector whose position is desired

skinLookup - the SkinLookup instance for this graph editor

Returns:

the x and y coordinates of the connector, or null if the connector isn't attached to a node

getCursorPosition

public static javafx.geometry.Point2D getCursorPosition(de.tesis.dynaware.grapheditor.model.GConnector connector,
                                                        double x,
                                                        double y,
                                                        SkinLookup skinLookup)

Gets the position of the cursor relative to the coordinate system of the view.

Parameters:

connector - a GConnector instance

x - the x position of the cursor relative to the given connector's region

y - the y position of the cursor relative to the given connector's region

skinLookup - the SkinLookup instance for this graph editor

Returns:

the position of the cursor in the view

getJointPositions

public static java.util.List<javafx.geometry.Point2D> getJointPositions(java.util.List<GJointSkin> jointSkins)

Gets the layout x and y values from all joints in a list of joint skins.

Parameters:

jointSkins - a list of joint skin instances

Returns:

a List of Point2D objects containing joint x and y values

getJointPositions

public static java.util.List<javafx.geometry.Point2D> getJointPositions(de.tesis.dynaware.grapheditor.model.GConnection connection,
                                                                        SkinLookup skinLookup)

Gets the layout x and y values from all joints within a connection.

Uses the JavaFX properties of the skins, not the model values. Is therefore always up-to-date, even during a drag gesture where the model is not necessarily updated.

Parameters:

connection - the GConnection for which the positions are desired

skinLookup - the SkinLookup instance for this graph editor

Returns:

a List of Point2D objects containing joint x and y values

getJointPositions

public static java.util.List<javafx.geometry.Point2D> getJointPositions(de.tesis.dynaware.grapheditor.model.GConnection connection)

Gets the x and y values from all joints within a connection.

Parameters:

connection - a GConnection instance

Returns:

a List of Point2D objects containing joint x and y values

getJointSkins

public static java.util.List<GJointSkin> getJointSkins(de.tesis.dynaware.grapheditor.model.GConnection connection,
                                                       SkinLookup skinLookup)

Gets all joint skins for a connection.

Parameters:

connection - the GConnection for which the joint skins

skinLookup - the SkinLookup instance for this graph editor

Returns:

a List of GJointSkin objects for this connection

moveOnPixel

public static double moveOnPixel(double position)

Moves an x or y position value on-pixel.

Lines drawn off-pixel look blurry. They should therefore have integer x and y values.

Parameters:

position - the position to move on-pixel

Returns:

the position rounded to the nearest integer

moveOffPixel

public static double moveOffPixel(double position)

Moves an x or y position value off-pixel.

This is for example useful for a 1-pixel-wide stroke with a stroke-type of centered. The x and y positions need to be off-pixel so that the stroke is on-pixel.

Parameters:

position - the position to move off-pixel

Returns:

the position moved to the nearest value halfway between two integers

checkInRange

public static boolean checkInRange(double firstValue,
                                   double secondValue,
                                   double position)

Checks if the given position is between two values.

Also returns true if the given position is equal to either of the values.

Parameters:

firstValue - an x or y position value

secondValue - another x or y position value

position - the cursor's position value

Returns:

true if the cursor position is between the two points

checkIntersection

public static boolean checkIntersection(javafx.geometry.Point2D a,
                                        javafx.geometry.Point2D b,
                                        javafx.geometry.Point2D c,
                                        javafx.geometry.Point2D d)

Checks if a horizontal line segment AB intersects with a vertical line segment CD.

Parameters:

a - start of line segment AB

b - end of line segment AB

c - start of line segment CD

d - end of line segment CD

Returns:

true if AB and CD intersect, false otherwise