1 package net.mograsim.logic.model.model.components.submodels;
3 import static net.mograsim.logic.model.preferences.RenderPreferences.DEFAULT_LINE_WIDTH;
4 import static net.mograsim.logic.model.preferences.RenderPreferences.SUBMODEL_ZOOM_ALPHA_0;
5 import static net.mograsim.logic.model.preferences.RenderPreferences.SUBMODEL_ZOOM_ALPHA_1;
7 import java.util.Collections;
8 import java.util.HashMap;
10 import java.util.Map.Entry;
11 import java.util.function.Consumer;
13 import net.haspamelodica.swt.helper.gcs.GCConfig;
14 import net.haspamelodica.swt.helper.gcs.GeneralGC;
15 import net.haspamelodica.swt.helper.gcs.TranslatedGC;
16 import net.haspamelodica.swt.helper.swtobjectwrappers.Rectangle;
17 import net.mograsim.logic.model.LogicUIRenderer;
18 import net.mograsim.logic.model.model.LogicModel;
19 import net.mograsim.logic.model.model.LogicModelModifiable;
20 import net.mograsim.logic.model.model.components.ModelComponent;
21 import net.mograsim.logic.model.model.wires.MovablePin;
22 import net.mograsim.logic.model.model.wires.Pin;
23 import net.mograsim.logic.model.model.wires.PinUsage;
24 import net.mograsim.logic.model.preferences.RenderPreferences;
25 import net.mograsim.logic.model.serializing.IdentifyParams;
26 import net.mograsim.logic.model.serializing.IndirectModelComponentCreator;
27 import net.mograsim.logic.model.serializing.SubmodelComponentParams;
28 import net.mograsim.logic.model.serializing.SubmodelComponentSerializer;
29 import net.mograsim.logic.model.snippets.Renderer;
30 import net.mograsim.logic.model.util.JsonHandler;
33 * A {@link ModelComponent} consisting of another model. A <code>SubmodelComponent</code> can have so-called "interface pins" connecting the
34 * inner and outer models.
36 public abstract class SubmodelComponent extends ModelComponent
38 public static final String SUBMODEL_INTERFACE_NAME = "_submodelinterface";
40 * A modifiable view of {@link #submodel}.
42 protected final LogicModelModifiable submodelModifiable;
44 * The model this {@link SubmodelComponent} consists of.
46 public final LogicModel submodel;
48 * The list of all submodel interface pins of this {@link SubmodelComponent} on the submodel side.
50 private final Map<String, MovablePin> submodelPins;
52 * An unmodifiable view of {@link #submodelPins}.
54 private final Map<String, MovablePin> submodelMovablePinsUnmodifiable;
56 * An unmodifiable view of {@link #submodelPins} where pins are not movable.
58 private final Map<String, Pin> submodelUnmovablePinsUnmodifiable;
60 * The list of all submodel interface pins of this {@link SubmodelComponent} on the supermodel side.
62 private final Map<String, MovablePin> supermodelPins;
64 * An unmodifiable view of {@link #supermodelPins}.
66 private final Map<String, MovablePin> supermodelMovablePinsUnmodifiable;
68 * An unmodifiable view of {@link #supermodelPins} where pins are not movable.
70 private final Map<String, Pin> supermodelUnmovablePinsUnmodifiable;
72 * A pseudo-component containing all submodel interface pins on the submodel side.
74 private final SubmodelInterface submodelInterface;
76 * The factor by which the submodel is scaled when rendering.
78 private double submodelScale;
80 * The renderer used for rendering the submodel.
82 private final LogicUIRenderer renderer;
84 * The {@link Renderer} used to render the symbol of this SubmodelCoponent.
86 private Renderer symbolRenderer;
88 * The {@link Renderer} used to render the outline of this SubmodelCoponent.
90 private Renderer outlineRenderer;
92 // creation and destruction
94 public SubmodelComponent(LogicModelModifiable model, String name)
96 this(model, name, true);
99 protected SubmodelComponent(LogicModelModifiable model, String name, boolean callInit)
101 super(model, name, false);
102 this.submodelModifiable = new LogicModelModifiable();
103 this.submodel = submodelModifiable;
104 this.submodelPins = new HashMap<>();
105 this.submodelMovablePinsUnmodifiable = Collections.unmodifiableMap(submodelPins);
106 this.submodelUnmovablePinsUnmodifiable = Collections.unmodifiableMap(submodelPins);
107 this.supermodelPins = new HashMap<>();
108 this.supermodelMovablePinsUnmodifiable = Collections.unmodifiableMap(supermodelPins);
109 this.supermodelUnmovablePinsUnmodifiable = Collections.unmodifiableMap(supermodelPins);
110 this.submodelInterface = new SubmodelInterface(submodelModifiable);
112 this.submodelScale = 1;
113 this.renderer = new LogicUIRenderer(submodelModifiable);
115 Consumer<Runnable> redrawHandlerChangedListener = submodelModifiable::setRedrawHandler;
116 model.addRedrawHandlerChangedListener(redrawHandlerChangedListener);
117 model.addComponentRemovedListener(c ->
120 model.removeRedrawHandlerChangedListener(redrawHandlerChangedListener);
122 submodelModifiable.setRedrawHandler(model.getRedrawHandler());
131 * Adds a new submodel interface pin.
133 * @param supermodelPin the submodel interface pin on the supermodel side
135 * @return the submodel interface pin on the submodel side
137 * @author Daniel Kirschten
139 protected Pin addSubmodelInterface(MovablePin supermodelPin)
141 super.addPin(supermodelPin);// do this first to be fail-fast if the supermodel does not belong to this component
143 String name = supermodelPin.name;
144 // TODO if we upgrade to Java 12, replace with switch-expression
145 PinUsage submodelPinUsage = supermodelPin.usage.getOpposite();
146 MovablePin submodelPin = new MovablePin(submodelModifiable, submodelInterface, name, supermodelPin.logicWidth, submodelPinUsage,
147 supermodelPin.getRelX() / submodelScale, supermodelPin.getRelY() / submodelScale);
149 submodelPin.addPinMovedListener(p ->
151 double newRelX = p.getRelX() * submodelScale;
152 double newRelY = p.getRelY() * submodelScale;
153 if (supermodelPin.getRelX() != newRelX || supermodelPin.getRelY() != newRelY)
154 supermodelPin.setRelPos(newRelX, newRelY);
156 supermodelPin.addPinMovedListener(p ->
158 double newRelX = p.getRelX() / submodelScale;
159 double newRelY = p.getRelY() / submodelScale;
160 if (submodelPin.getRelX() != newRelX || submodelPin.getRelY() != newRelY)
161 submodelPin.setRelPos(newRelX, newRelY);
164 submodelInterface.addPin(submodelPin);
166 submodelPins.put(name, submodelPin);
167 supermodelPins.put(name, supermodelPin);
169 // no need to call requestRedraw() because addPin() will request a redraw
174 * Removes a submodel interface pin.
176 * @author Daniel Kirschten
178 protected void removeSubmodelInterface(String name)
180 super.removePin(name);// do this first to be fail-fast if this component doesn't have a pin with the given name
181 Pin submodelPin = submodelPins.remove(name);
182 submodelInterface.removePin(submodelPin.name);
183 supermodelPins.remove(name);
185 // no need to call requestRedraw() because removePin() will request a redraw
189 * Returns a collection of submodel interface pins on the submodel side of this component.
191 * @author Daniel Kirschten
193 public Map<String, Pin> getSubmodelPins()
195 return submodelUnmovablePinsUnmodifiable;
199 * Returns the submodel interface pin with the given name on the submodel side of this component.
201 * @author Daniel Kirschten
203 public Pin getSubmodelPin(String name)
205 return getSubmodelMovablePin(name);
209 * Returns a collection of movable submodel interface pins on the submodel side of this component.
211 * @author Daniel Kirschten
213 protected Map<String, MovablePin> getSubmodelMovablePins()
215 return submodelMovablePinsUnmodifiable;
219 * Returns the movable submodel interface pin with the given name on the submodel side of this component.
221 * @author Daniel Kirschten
223 protected MovablePin getSubmodelMovablePin(String name)
225 return submodelPins.get(name);
229 * Returns a collection of submodel interface pins on the supermodel side of this component.
231 * @author Daniel Kirschten
233 public Map<String, Pin> getSupermodelPins()
235 return supermodelUnmovablePinsUnmodifiable;
239 * Returns the submodel interface pin with the given name on the supermodel side of this component.
241 * @author Daniel Kirschten
243 public Pin getSupermodelPin(String name)
245 return getSupermodelMovablePin(name);
249 * Returns a collection of movable submodel interface pins on the supermodel side of this component.
251 * @author Daniel Kirschten
253 protected Map<String, MovablePin> getSupermodelMovablePins()
255 return supermodelMovablePinsUnmodifiable;
259 * Returns the movable submodel interface pin with the given name on the supermodel side of this component.
261 * @author Daniel Kirschten
263 protected MovablePin getSupermodelMovablePin(String name)
265 return supermodelPins.get(name);
268 // "graphical" operations
271 * Sets the factor by which the submodel is scaled when rendering and calls redrawListeners. Note that the submodel interface pins will
272 * stay at their position relative to the supermodel, which means they will move relative to the submodel.
274 * @author Daniel Kirschten
276 protected void setSubmodelScale(double submodelScale)
278 this.submodelScale = submodelScale;
280 for (Entry<String, MovablePin> e : supermodelPins.entrySet())
281 getSubmodelMovablePin(e.getKey()).setRelPos(e.getValue().getRelX() * submodelScale, e.getValue().getRelY() * submodelScale);
283 model.requestRedraw();// needed if there is no submodel interface pin
287 * Returns the current factor by which the submodel is scaled when rendering.
289 * @author Daniel Kirschten
291 public double getSubmodelScale()
293 return submodelScale;
297 * @see #renderSymbol(GeneralGC, Rectangle)
299 * @author Daniel Kirschten
301 protected void setSymbolRenderer(Renderer symbolRenderer)
303 this.symbolRenderer = symbolRenderer;
304 model.requestRedraw();
308 * @see #renderSymbol(GeneralGC, Rectangle)
310 * @author Daniel Kirschten
312 public Renderer getSymbolRenderer()
314 return symbolRenderer;
318 * @see #renderOutline(GeneralGC, Rectangle)
320 * @author Daniel Kirschten
322 protected void setOutlineRenderer(Renderer outlineRenderer)
324 this.outlineRenderer = outlineRenderer;
325 model.requestRedraw();
329 * @see #renderOutline(GeneralGC, Rectangle)
331 * @author Daniel Kirschten
333 public Renderer getOutlineRenderer()
335 return outlineRenderer;
339 public boolean clicked(double x, double y)
341 double scaledX = (x - getPosX()) / submodelScale;
342 double scaledY = (y - getPosY()) / submodelScale;
343 for (ModelComponent component : submodel.getComponentsByName().values())
344 if (component.getBounds().contains(scaledX, scaledY) && component.clicked(scaledX, scaledY))
350 public void render(GeneralGC gc, RenderPreferences renderPrefs, Rectangle visibleRegion)
352 GCConfig conf = new GCConfig(gc);
353 GeneralGC tgc = new TranslatedGC(gc, getPosX(), getPosY(), submodelScale, true);
355 double visibleRegionFillRatio = getWidth() * getHeight() / (visibleRegion.width * visibleRegion.height);
357 * If this {@link SubmodelComponent} fills at least this amount of the visible region vertically or horizontally, the submodel
358 * starts to be visible.
360 // TODO add a listener
361 double maxVisibleRegionFillRatioForAlpha0 = renderPrefs.getDouble(SUBMODEL_ZOOM_ALPHA_0);
363 * If this {@link SubmodelComponent} fills at least this amount of the visible region vertically or horizontally, the submodel is
366 // TODO add a listener
367 double minVisibleRegionFillRatioForAlpha1 = renderPrefs.getDouble(SUBMODEL_ZOOM_ALPHA_1);
368 double alphaFactor = map(visibleRegionFillRatio, maxVisibleRegionFillRatioForAlpha0, minVisibleRegionFillRatioForAlpha1, 0, 1);
369 alphaFactor = Math.max(0, Math.min(1, alphaFactor));
370 // we need to take the old alpha into account to support nested submodules better.
371 int oldAlpha = gc.getAlpha();
372 int submodelAlpha = Math.max(0, Math.min(255, (int) (oldAlpha * alphaFactor)));
373 int labelAlpha = Math.max(0, Math.min(255, (int) (oldAlpha * (1 - alphaFactor))));
374 if (submodelAlpha != 0)
376 gc.setAlpha(submodelAlpha);
377 renderer.render(tgc, renderPrefs,
378 visibleRegion.translate(getPosX() / submodelScale, getPosY() / submodelScale, 1 / submodelScale));
382 gc.setAlpha(labelAlpha);
383 renderSymbol(gc, renderPrefs, visibleRegion);
386 // reset line width explicitly to avoid rounding errors causing weird glitches
387 gc.setLineWidth(renderPrefs.getDouble(DEFAULT_LINE_WIDTH));
388 // draw the outline after all other operations to make interface pins look better
389 renderOutline(gc, renderPrefs, visibleRegion);
393 * Render the symbol of this {@link SubmodelComponent}, e.g. the things that should be hidden if the submodel is drawn.
395 * @author Daniel Kirschten
397 private void renderSymbol(GeneralGC gc, RenderPreferences renderPrefs, Rectangle visibleRegion)
399 if (symbolRenderer != null)
400 symbolRenderer.render(gc, renderPrefs, visibleRegion);
404 * Render the outline of this {@link SubmodelComponent}, e.g. the graphical elements that should stay visible if the submodel is drawn.
406 * @author Daniel Kirschten
408 private void renderOutline(GeneralGC gc, RenderPreferences renderPrefs, Rectangle visibleRegion)
410 if (outlineRenderer != null)
411 outlineRenderer.render(gc, renderPrefs, visibleRegion);
414 private static double map(double val, double valMin, double valMax, double mapMin, double mapMax)
416 return mapMin + (val - valMin) * (mapMax - mapMin) / (valMax - valMin);
422 * {@link SubmodelComponent}'s implementation of {@link ModelComponent#getIDForSerializing(IdentifyParams)} returns "submodel". It is
423 * recommended to override this behaviour.
425 * @see ModelComponent#getIDForSerializing(IdentifyParams)
426 * @see ModelComponent#getParamsForSerializing(IdentifyParams)
429 public String getIDForSerializing(IdentifyParams idParams)
431 return "submodel";// TODO what ID?
435 * {@link SubmodelComponent}'s implementation of {@link ModelComponent#getParamsForSerializing(IdentifyParams)} returns an instance of
436 * {@link SubmodelComponentParams}. It is recommended to override this behaviour.
438 * @see ModelComponent#getIDForSerializing(IdentifyParams)
439 * @see ModelComponent#getParamsForSerializing(IdentifyParams)
442 public Object getParamsForSerializing(IdentifyParams idParams)
444 return SubmodelComponentSerializer.serialize(this, idParams);
447 // operations no longer supported
450 protected void addPin(Pin pin)
452 throw new UnsupportedOperationException("Can't add pins to a SubmodelComponent directly, call addSubmodelInterface instead");
456 protected void removePin(String name)
458 throw new UnsupportedOperationException("Can't remove pins of a SubmodelComponent directly, call removeSubmodelInterface instead");
463 IndirectModelComponentCreator.setComponentSupplier(SubmodelComponent.class.getCanonicalName(),
464 (m, p, n) -> SubmodelComponentSerializer.deserialize(m, JsonHandler.fromJsonTree(p, SubmodelComponentParams.class), n));