Connection

java.lang.Object
- de.mcp.cutcad.model.Connection

All Implemented Interfaces:: Pluggable, Drawable2D, java.io.Serializable

public class Connection
extends java.lang.Object
implements Drawable2D, java.io.Serializable, Pluggable

See Also:: Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`private float`	`angle`
`private float`	`boundingBoxSize`
`private static java.util.List<Connection>`	`connections`
`private boolean`	`isActive`
`private boolean`	`isSelected`
`private Edge`	`masterEdge`
`private float`	`scalingFactor`
`private static long`	`serialVersionUID`
`private Edge`	`slaveEdge`
`private float`	`tolerance`

Constructor Summary

Constructors
Constructor and Description
`Connection(Edge masterEdge, Edge slaveEdge, java.util.List<Connection> connections)` Creates a connection-object, specifying the two edges to be connected.
`Connection(java.util.List<Connection> connections)` Creates a basic connection-object without specifying the two edges to be connected.

Method Summary

Methods
Modifier and Type	Method and Description
`private void`	`alignEdges(GShape slave, Edge masterEdge, Edge slaveEdge)`
`private void`	`alignShapes(GShape master, GShape slave, Edge masterEdge, Edge slaveEdge)`
`private float`	`calculateAngleBetweenNormals(GShape master, GShape slave)`
`java.lang.String`	`connect()` Connects the two edges of the connection if possible and returns a success/error-message based on whether or not the connection could be made.
`void`	`connectEdges(Edge masterEdge, Edge slaveEdge, float angle)` Aligns and connects two given edges and their shapes in 3D-space at a given angle.
`void`	`draw2D(processing.core.PGraphics p, Transformation t)`
`float`	`getAngle()`
`static java.util.List<Connection>`	`getConnections()`
`int`	`getControlType(int index)`
`Edge`	`getMasterEdge()`
`java.lang.String`	`getNameOfControl(int index)`
`int`	`getNumberOfControls()`
`Edge`	`getSlaveEdge()`
`int`	`getValue(int index)`
`boolean`	`isActive()`
`private boolean`	`isEqualEdge(Edge masterEdge, Edge slaveEdge)`
`boolean`	`isSelected()`
`void`	`lockConnection(boolean locked)` Sets the locked-variable of the two edges of the connection to the given boolean value.
`boolean`	`mouseOver(Vector2D mousePosition)` Creates a rectangle around the representation of the connection and checks if the given mousePosition is within this rectangle
`private void`	`recalculateConnectedEdge(Edge edge)`
`private float`	`safeAngleBetween(Vector3D masterEdgeDirection, Vector3D slaveEdgeDirection)`
`void`	`setActive(boolean isActive)`
`void`	`setAngle(float angle)` Sets the angle between the two shapes that are connected.
`void`	`setMasterEdge(Edge e)`
`void`	`setSelected(boolean b)` Sets the selection-status of the connection to b
`void`	`setSlaveEdge(Edge e)`
`void`	`setValue0(int size)`
`void`	`undoConnection()` Undos a connection between two edges.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - serialVersionUID
```
private static final long serialVersionUID
```
    See Also:
    Constant Field Values
  - masterEdge
```
private Edge masterEdge
```
  - slaveEdge
```
private Edge slaveEdge
```
  - angle
```
private float angle
```
  - isSelected
```
private boolean isSelected
```
  - isActive
```
private boolean isActive
```
  - connections
```
private static java.util.List<Connection> connections
```
  - tolerance
```
private float tolerance
```
  - scalingFactor
```
private float scalingFactor
```
  - boundingBoxSize
```
private float boundingBoxSize
```
- Constructor Detail
  - Connection
```
public Connection(java.util.List<Connection> connections)
```
    Creates a basic connection-object without specifying the two edges to be connected.
    
    Parameters:
    connections - The list of existing connections
  - Connection
```
public Connection(Edge masterEdge,
          Edge slaveEdge,
          java.util.List<Connection> connections)
```
    Creates a connection-object, specifying the two edges to be connected.
    
    Parameters:
    masterEdge - The edge contained by the shape considered to be master (will not be moved when connecting the two shapes)
    slaveEdge - The edge contained by the shape considered to be slave (will be moved/rotated when connecting the two shapes)
    connections - The list of existing connections
- Method Detail
  - getConnections
```
public static java.util.List<Connection> getConnections()
```
    Returns:
    The list of all existing connections
  - getMasterEdge
```
public Edge getMasterEdge()
```
    Returns:
    The masterEdge of the connection
  - getSlaveEdge
```
public Edge getSlaveEdge()
```
    Returns:
    The slaveEdge of the connection
  - setMasterEdge
```
public void setMasterEdge(Edge e)
```
    Parameters:
    e - The masterEdge of the connection
  - setSlaveEdge
```
public void setSlaveEdge(Edge e)
```
    Parameters:
    e - The slaveEdge of the connection
  - draw2D
```
public void draw2D(processing.core.PGraphics p,
          Transformation t)
```
    Specified by:
    
    draw2D in interface Drawable2D
  - setSelected
```
public void setSelected(boolean b)
```
    Sets the selection-status of the connection to b
    
    Parameters:
    b - The new selection-status of the connection
  - isSelected
```
public boolean isSelected()
```
    Returns:
    The current selection-status of the connection
  - mouseOver
```
public boolean mouseOver(Vector2D mousePosition)
```
    Creates a rectangle around the representation of the connection and checks if the given mousePosition is within this rectangle
    
    Parameters:
    mousePosition - The position of the mouse
    
    Returns:
    true if the given mousePosition is within the rectangle created around the connection
  - undoConnection
```
public void undoConnection()
```
    Undos a connection between two edges. Removes the tenons from the edges, unlocks the edges and sets the number of connections of the connected shapes to the correct number.
  - recalculateConnectedEdge
```
private void recalculateConnectedEdge(Edge edge)
```
  - connect
```
public java.lang.String connect()
```
    Connects the two edges of the connection if possible and returns a success/error-message based on whether or not the connection could be made.
    
    Returns:
    A message that either reports success or contains a description of the problem encountered when trying to connect the edges
  - isEqualEdge
```
private boolean isEqualEdge(Edge masterEdge,
                  Edge slaveEdge)
```
  - lockConnection
```
public void lockConnection(boolean locked)
```
    Sets the locked-variable of the two edges of the connection to the given boolean value.
    
    Parameters:
    locked - The value the locked-variable of the two edges is set to
  - setAngle
```
public void setAngle(float angle)
```
    Sets the angle between the two shapes that are connected.
    
    Parameters:
    angle - the angle between the two shapes connected by this connection in degrees
  - connectEdges
```
public void connectEdges(Edge masterEdge,
                Edge slaveEdge,
                float angle)
```
    Aligns and connects two given edges and their shapes in 3D-space at a given angle.
    
    Parameters:
    masterEdge - the edge of the shape that is considered master (will not be moved during this operation)
    slaveEdge - the edge of the shape that is considered slave (will be moved/rotated to the master)
    angle - the angle between master and slave
  - alignEdges
```
private void alignEdges(GShape slave,
              Edge masterEdge,
              Edge slaveEdge)
```
  - safeAngleBetween
```
private float safeAngleBetween(Vector3D masterEdgeDirection,
                     Vector3D slaveEdgeDirection)
```
  - alignShapes
```
private void alignShapes(GShape master,
               GShape slave,
               Edge masterEdge,
               Edge slaveEdge)
```
  - calculateAngleBetweenNormals
```
private float calculateAngleBetweenNormals(GShape master,
                                 GShape slave)
```
  - getAngle
```
public float getAngle()
```
    Returns:
    The current angle between the two shapes connected by this connection
  - isActive
```
public boolean isActive()
```
  - setActive
```
public void setActive(boolean isActive)
```
    Specified by:
    
    setActive in interface Pluggable
  - getNumberOfControls
```
public int getNumberOfControls()
```
    Specified by:
    
    getNumberOfControls in interface Pluggable
    
    Returns:
    The number of control-elements needed to set the properties of this object
  - getValue
```
public int getValue(int index)
```
    Specified by:
    
    getValue in interface Pluggable
  - getControlType
```
public int getControlType(int index)
```
    Specified by:
    
    getControlType in interface Pluggable
  - getNameOfControl
```
public java.lang.String getNameOfControl(int index)
```
    Specified by:
    
    getNameOfControl in interface Pluggable
  - setValue0
```
public void setValue0(int size)
```

Class Connection

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

serialVersionUID

masterEdge

slaveEdge

angle

isSelected

isActive

connections

tolerance

scalingFactor

boundingBoxSize

Constructor Detail

Connection

Connection

Method Detail

getConnections

getMasterEdge

getSlaveEdge

setMasterEdge

setSlaveEdge

draw2D

setSelected

isSelected

mouseOver

undoConnection

recalculateConnectedEdge

connect

isEqualEdge

lockConnection

setAngle

connectEdges

alignEdges

safeAngleBetween

alignShapes

calculateAngleBetweenNormals

getAngle

isActive

setActive

getNumberOfControls

getValue

getControlType

getNameOfControl

setValue0