X-Git-Url: https://mograsim.net/gitweb/?a=blobdiff_plain;f=net.mograsim.logic.ui%2Fsrc%2Fnet%2Fmograsim%2Flogic%2Fui%2Fmodel%2Fwires%2FWireCrossPoint.java;h=07bddc6ca3149192518d8c5167860e0fcfb7c14d;hb=a8b0c14b999659acc3cc2f1d029581a35ca7444b;hp=625bf8ab14fe1599390fb90cb7464d32c0756837;hpb=e5b1b332c5ae4767e246f1ec5341b36514ce1a79;p=Mograsim.git

diff --git a/net.mograsim.logic.ui/src/net/mograsim/logic/ui/model/wires/WireCrossPoint.java b/net.mograsim.logic.ui/src/net/mograsim/logic/ui/model/wires/WireCrossPoint.java
index 625bf8ab..07bddc6c 100644
--- a/net.mograsim.logic.ui/src/net/mograsim/logic/ui/model/wires/WireCrossPoint.java
+++ b/net.mograsim.logic.ui/src/net/mograsim/logic/ui/model/wires/WireCrossPoint.java
@@ -1,86 +1,116 @@
-package net.mograsim.logic.ui.model.wires;
-
-import java.util.Map;
-
-import net.haspamelodica.swt.helper.gcs.GeneralGC;
-import net.haspamelodica.swt.helper.swtobjectwrappers.Rectangle;
-import net.mograsim.logic.core.LogicObservable;
-import net.mograsim.logic.core.LogicObserver;
-import net.mograsim.logic.core.types.BitVectorFormatter;
-import net.mograsim.logic.core.wires.Wire.ReadEnd;
-import net.mograsim.logic.ui.ColorHelper;
-import net.mograsim.logic.ui.model.ViewModelModifiable;
-import net.mograsim.logic.ui.model.components.GUIComponent;
-import net.mograsim.logic.ui.model.components.SimpleRectangularGUIGate;
-
-public class WireCrossPoint extends GUIComponent
-{
-	private static final int CIRCLE_RADIUS = 1;
-	private static final int CIRCLE_DIAM = CIRCLE_RADIUS * 2;
-
-	private final Pin pin;
-	private final int logicWidth;
-
-	private final LogicObserver logicObs;
-	private ReadEnd end;
-
-	public WireCrossPoint(ViewModelModifiable model, int logicWidth)
-	{
-		super(model);
-		logicObs = (i) -> requestRedraw();
-
-		this.logicWidth = logicWidth;
-		setSize(CIRCLE_DIAM, CIRCLE_DIAM);
-		addPin(this.pin = new Pin(this, "", logicWidth, CIRCLE_RADIUS, CIRCLE_RADIUS));
-	}
-
-	public void moveCenterTo(double x, double y)
-	{
-		moveTo(x - CIRCLE_RADIUS, y - CIRCLE_RADIUS);
-	}
-
-	@Override
-	public void render(GeneralGC gc, Rectangle visibleRegion)
-	{
-		ColorHelper.executeWithDifferentBackground(gc, BitVectorFormatter.formatAsColor(end),
-				() -> gc.fillOval(getPosX(), getPosY(), CIRCLE_DIAM, CIRCLE_DIAM));
-	}
-
-	public void setLogicModelBinding(ReadEnd end)
-	{
-		deregisterLogicObs(this.end);
-		this.end = end;
-		registerLogicObs(end);
-	}
-
-	private void registerLogicObs(LogicObservable observable)
-	{
-		if (observable != null)
-			observable.registerObserver(logicObs);
-	}
-
-	private void deregisterLogicObs(LogicObservable observable)
-	{
-		if (observable != null)
-			observable.deregisterObserver(logicObs);
-	}
-
-	public int getLogicWidth()
-	{
-		return logicWidth;
-	}
-
-	public Pin getPin()
-	{
-		return pin;
-	}
-
-	@Override
-	public Map<String, Object> getInstantiationParameters()
-	{
-		Map<String, Object> m = super.getInstantiationParameters();
-		m.put(SimpleRectangularGUIGate.kLogicWidth, logicWidth);
-		return m;
-	}
-
+package net.mograsim.logic.ui.model.wires;
+
+import java.util.Map;
+
+import net.haspamelodica.swt.helper.gcs.GeneralGC;
+import net.haspamelodica.swt.helper.swtobjectwrappers.Rectangle;
+import net.mograsim.logic.core.LogicObserver;
+import net.mograsim.logic.core.types.BitVectorFormatter;
+import net.mograsim.logic.core.wires.Wire.ReadEnd;
+import net.mograsim.logic.ui.ColorHelper;
+import net.mograsim.logic.ui.model.ViewModelModifiable;
+import net.mograsim.logic.ui.model.components.GUIComponent;
+import net.mograsim.logic.ui.model.components.SimpleRectangularGUIGate;
+
+/**
+ * A {@link GUIComponent} with only one pin. Is used to create wires connecting more than two pins. <br>
+ * Example: There are three pins <code>P1</code>, <code>P2</code>, <code>P3</code> that need to be connected. Solution: Create a
+ * WireCrossPoint (<code>WCP</code>) and create the GUIWires <code>P1</code>-<code>WCP</code>, <code>P2</code>-<code>WCP</code>,
+ * <code>P3</code>-<code>WCP</code>.<br>
+ * Cross points are drawn as circles. The pin of cross points is in the center of this circle.
+ * 
+ * @author Daniel Kirschten
+ */
+public class WireCrossPoint extends GUIComponent implements ConnectionPoint
+{
+	private static final int CIRCLE_RADIUS = 1;
+	private static final int CIRCLE_DIAM = CIRCLE_RADIUS * 2;
+
+	/**
+	 * The (single) pin of this cross point.
+	 */
+	private final Pin pin;
+
+	/**
+	 * A {@link LogicObserver} calling {@link #requestRedraw()}.
+	 */
+	private final LogicObserver logicObs;
+	/**
+	 * The {@link ReadEnd} currently bound to this cross point.
+	 */
+	private ReadEnd end;
+
+	// creation and destruction
+
+	public WireCrossPoint(ViewModelModifiable model, int logicWidth)
+	{
+		super(model);
+		logicObs = (i) -> requestRedraw();
+
+		setSize(CIRCLE_DIAM, CIRCLE_DIAM);
+		addPin(this.pin = new Pin(this, "", logicWidth, CIRCLE_RADIUS, CIRCLE_RADIUS));
+	}
+
+	// pins
+
+	@Override
+	public Pin getPin()
+	{
+		return pin;
+	}
+
+	// "graphical" operations
+
+	/**
+	 * Moves the center (and therefore the pin) of this {@link WireCrossPoint} to the given location.
+	 * 
+	 * @author Daniel Kirschten
+	 */
+	public void moveCenterTo(double x, double y)
+	{
+		moveTo(x - CIRCLE_RADIUS, y - CIRCLE_RADIUS);
+	}
+
+	@Override
+	public void render(GeneralGC gc, Rectangle visibleRegion)
+	{
+		ColorHelper.executeWithDifferentBackground(gc, BitVectorFormatter.formatAsColor(end),
+				() -> gc.fillOval(getPosX(), getPosY(), CIRCLE_DIAM, CIRCLE_DIAM));
+	}
+
+	// logic model binding
+
+	/**
+	 * Binds this {@link WireCrossPoint} to the given {@link ReadEnd}: The color of this {@link WireCrossPoint} will now depend on the state
+	 * of the given {@link ReadEnd}, and further changes of the given {@link ReadEnd} will result in readrawListeners being called.<br>
+	 * The argument can be null, in which case the old binding is stopped.
+	 * 
+	 * @author Daniel Kirschten
+	 */
+	public void setLogicModelBinding(ReadEnd end)
+	{
+		if (this.end != null)
+			this.end.deregisterObserver(logicObs);
+		this.end = end;
+		if (end != null)
+			end.registerObserver(logicObs);
+	}
+
+	/**
+	 * Returns whether this {@link WireCrossPoint} has a logic model binding or not.
+	 */
+	public boolean hasLogicModelBinding()
+	{
+		return end != null;
+	}
+
+	// serializing
+
+	@Override
+	public Map<String, Object> getInstantiationParameters()
+	{
+		Map<String, Object> m = super.getInstantiationParameters();
+		m.put(SimpleRectangularGUIGate.kLogicWidth, pin.logicWidth);
+		return m;
+	}
 }
\ No newline at end of file