overlay: add movable and snappable overlay flags

This merges DETACHED and DYNAMIC into one position, DYNAMIC. And, allows
detached/dynamic overlays to be snappable.

runelite-client/src/main/java/net/runelite/client/plugins/screenmarkers/ScreenMarkerCreationOverlay.java

@@ -42,9 +42,10 @@ class ScreenMarkerCreationOverlay extends Overlay
 	private ScreenMarkerCreationOverlay(final ScreenMarkerPlugin plugin)
 	{
 		this.plugin = plugin;
-		setPosition(OverlayPosition.DETACHED);
+		setPosition(OverlayPosition.DYNAMIC);
 		setLayer(OverlayLayer.ABOVE_WIDGETS);
 		setPriority(OverlayPriority.HIGH);
+		setMovable(true);
 	}
 
 	@Override

runelite-client/src/main/java/net/runelite/client/plugins/screenmarkers/ScreenMarkerOverlay.java

@@ -45,9 +45,10 @@ public class ScreenMarkerOverlay extends Overlay
 	{
 		this.marker = marker;
 		this.screenMarkerRenderable = new ScreenMarkerRenderable();
-		setPosition(OverlayPosition.DETACHED);
+		setPosition(OverlayPosition.DYNAMIC);
 		setLayer(OverlayLayer.ALWAYS_ON_TOP);
 		setPriority(OverlayPriority.HIGH);
+		setMovable(true);
 		setResizable(true);
 		setMinimumSize(16);
 		setResettable(false);

runelite-client/src/main/java/net/runelite/client/plugins/screenmarkers/ScreenMarkerWidgetHighlightOverlay.java

@@ -51,9 +51,10 @@ class ScreenMarkerWidgetHighlightOverlay extends Overlay
 	{
 		this.plugin = plugin;
 		this.client = client;
-		setPosition(OverlayPosition.DETACHED);
+		setPosition(OverlayPosition.DYNAMIC);
 		setLayer(OverlayLayer.ABOVE_WIDGETS);
 		setPriority(OverlayPriority.HIGH);
+		setMovable(true);
 	}
 
 	@Override

runelite-client/src/main/java/net/runelite/client/ui/overlay/Overlay.java

@@ -64,12 +64,25 @@ public abstract class Overlay implements LayoutableRenderableEntity
 	@Setter(AccessLevel.PROTECTED)
 	private boolean dragTargetable;
 
+	/**
+	 * Whether this overlay can be moved with alt
+	 */
+	@Setter(AccessLevel.PROTECTED)
+	private boolean movable = true;
+
+	/**
+	 * Whether this overlay can be moved to a snap corner
+	 * and have its preferredPosition changed
+	 */
+	@Setter(AccessLevel.PROTECTED)
+	private boolean snappable = true;
+
 	protected Overlay()
 	{
 		plugin = null;
 	}
 
-	protected Overlay(Plugin plugin)
+	protected Overlay(@Nullable Plugin plugin)
 	{
 		this.plugin = plugin;
 	}
@@ -161,4 +174,25 @@ public abstract class Overlay implements LayoutableRenderableEntity
 	public void revalidate()
 	{
 	}
+
+	public void setPosition(OverlayPosition position)
+	{
+		this.position = position;
+
+		switch (position)
+		{
+			case TOOLTIP:
+			case DYNAMIC:
+				movable = false;
+				snappable = false;
+				break;
+			case DETACHED:
+				movable = true;
+				snappable = false;
+				break;
+			default:
+				movable = true;
+				snappable = true;
+		}
+	}
 }

runelite-client/src/main/java/net/runelite/client/ui/overlay/OverlayManager.java

@@ -313,23 +313,31 @@ public class OverlayManager
 	private void loadOverlay(final Overlay overlay)
 	{
 		final Point location = loadOverlayLocation(overlay);
-		overlay.setPreferredLocation(location);
 		final Dimension size = loadOverlaySize(overlay);
-		overlay.setPreferredSize(size);
 		final OverlayPosition position = loadOverlayPosition(overlay);
-		if (position != null)
+
+		if (overlay.isMovable())
 		{
-			if (overlay.getPosition() != OverlayPosition.DYNAMIC && overlay.getPosition() != OverlayPosition.TOOLTIP)
+			overlay.setPreferredLocation(location);
+		}
+		else
+		{
+			log.info("Resetting preferred location of non-movable overlay {} (class {})", overlay.getName(), overlay.getClass().getName());
+			saveOverlayLocation(overlay);
+		}
+
+		overlay.setPreferredSize(size);
+
+		if (overlay.isSnappable())
 		{
 			overlay.setPreferredPosition(position);
 		}
 		else
 		{
-				log.info("Resetting preferred position of dynamic overlay {}", overlay.getClass().getSimpleName());
+			log.info("Resetting preferred position of non-snappable overlay {} (class {})", overlay.getName(), overlay.getClass().getName());
 			saveOverlayPosition(overlay);
 		}
 	}
-	}
 
 	private void updateOverlayConfig(final Overlay overlay)
 	{

runelite-client/src/main/java/net/runelite/client/ui/overlay/OverlayPosition.java

@@ -28,7 +28,9 @@ public enum OverlayPosition
 {
 	/**
 	 * Not attached anywhere, but still movable
+	 * Deprecated. Use DYNAMIC and setMovable(true)
 	 */
+	@Deprecated
 	DETACHED,
 	/**
 	 * Overlay places itself where it wants

runelite-client/src/main/java/net/runelite/client/ui/overlay/OverlayRenderer.java

@@ -256,7 +256,7 @@ public class OverlayRenderer extends MouseAdapter
 		OverlayUtil.setGraphicProperties(graphics);
 
 		// Draw snap corners
-		if (inOverlayDraggingMode && layer == OverlayLayer.UNDER_WIDGETS && currentManagedOverlay != null && currentManagedOverlay.getPosition() != OverlayPosition.DETACHED)
+		if (inOverlayDraggingMode && layer == OverlayLayer.UNDER_WIDGETS && currentManagedOverlay != null && currentManagedOverlay.isSnappable())
 		{
 			final OverlayBounds translatedSnapCorners = snapCorners.translated(
 				-SNAP_CORNER_SIZE.width,
@@ -288,21 +288,6 @@ public class OverlayRenderer extends MouseAdapter
 		for (Overlay overlay : overlays)
 		{
 			final OverlayPosition overlayPosition = getCorrectedOverlayPosition(overlay);
-
-			if (overlayPosition == OverlayPosition.DYNAMIC || overlayPosition == OverlayPosition.TOOLTIP)
-			{
-				safeRender(client, overlay, layer, graphics, new Point());
-
-				// Restore graphics2d properties
-				graphics.setTransform(transform);
-				graphics.setStroke(stroke);
-				graphics.setComposite(composite);
-				graphics.setPaint(paint);
-				graphics.setRenderingHints(renderingHints);
-				graphics.setBackground(background);
-			}
-			else
-			{
 			final Rectangle bounds = overlay.getBounds();
 			final Dimension dimension = bounds.getSize();
 			final Point preferredLocation = overlay.getPreferredLocation();
@@ -310,7 +295,8 @@ public class OverlayRenderer extends MouseAdapter
 			Rectangle snapCorner = null;
 
 			// If the final position is not modified, layout it
-				if (overlayPosition != OverlayPosition.DETACHED && (preferredLocation == null || overlay.getPreferredPosition() != null))
+			if (overlayPosition != OverlayPosition.DYNAMIC && overlayPosition != OverlayPosition.TOOLTIP
+				&& overlayPosition != OverlayPosition.DETACHED && preferredLocation == null)
 			{
 				snapCorner = snapCorners.forPosition(overlayPosition);
 				final Point translation = OverlayUtil.transformPosition(overlayPosition, dimension); // offset from corner
@@ -387,7 +373,6 @@ public class OverlayRenderer extends MouseAdapter
 			}
 		}
 	}
-	}
 
 	@Override
 	public MouseEvent mousePressed(MouseEvent mouseEvent)
@@ -511,7 +496,7 @@ public class OverlayRenderer extends MouseAdapter
 				// ABOVE_SCENE overlays aren't managed
 				.filter(c -> layerOrder.contains(c.getLayer()))
 				// never allow moving dynamic or tooltip overlays
-				.filter(c -> c.getPosition() != OverlayPosition.DYNAMIC && c.getPosition() != OverlayPosition.TOOLTIP)
+				.filter(Overlay::isMovable)
 				.sorted(
 					Comparator.<Overlay>comparingInt(c -> layerOrder.indexOf(c.getLayer()))
 						.thenComparing(OverlayManager.OVERLAY_COMPARATOR)
@@ -686,8 +671,8 @@ public class OverlayRenderer extends MouseAdapter
 			}
 		}
 
-		// Check if the overlay is over a snapcorner and move it if so, unless it is a detached overlay
+		// Check if the overlay is over a snapcorner and snap it if so
-		if (currentManagedOverlay.getPosition() != OverlayPosition.DETACHED && inOverlayDraggingMode)
+		if (currentManagedOverlay.isSnappable() && inOverlayDraggingMode)
 		{
 			final OverlayBounds snapCorners = this.emptySnapCorners.translated(-SNAP_CORNER_SIZE.width, -SNAP_CORNER_SIZE.height);
 

runelite-client/src/main/java/net/runelite/client/ui/overlay/WidgetOverlay.java

@@ -43,14 +43,14 @@ public class WidgetOverlay extends Overlay
 	{
 		return Arrays.asList(
 			// classic resizable
-			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_CHATBOX_PARENT, OverlayPosition.DETACHED, OverlayPriority.HIGH),
+			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_CHATBOX_PARENT, OverlayPosition.DYNAMIC, OverlayPriority.HIGH),
-			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_BOTTOM_LINE_CHATBOX_PARENT, OverlayPosition.DETACHED, OverlayPriority.HIGH),
+			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_BOTTOM_LINE_CHATBOX_PARENT, OverlayPosition.DYNAMIC, OverlayPriority.HIGH),
-			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_INVENTORY_PARENT, OverlayPosition.DETACHED),
+			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_INVENTORY_PARENT, OverlayPosition.DYNAMIC),
 			new WidgetOverlay(client, WidgetInfo.RESIZABLE_MINIMAP_WIDGET, OverlayPosition.CANVAS_TOP_RIGHT, OverlayPriority.MED),
 			// modern resizable
-			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_BOTTOM_LINE_TABS1, OverlayPosition.DETACHED),
+			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_BOTTOM_LINE_TABS1, OverlayPosition.DYNAMIC),
-			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_BOTTOM_LINE_TABS2, OverlayPosition.DETACHED),
+			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_BOTTOM_LINE_TABS2, OverlayPosition.DYNAMIC),
-			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_BOTTOM_LINE_INVENTORY_PARENT, OverlayPosition.DETACHED),
+			new WidgetOverlay(client, WidgetInfo.RESIZABLE_VIEWPORT_BOTTOM_LINE_INVENTORY_PARENT, OverlayPosition.DYNAMIC),
 			new WidgetOverlay(client, WidgetInfo.RESIZABLE_MINIMAP_STONES_WIDGET, OverlayPosition.CANVAS_TOP_RIGHT, OverlayPriority.MED),
 			// The client forces the oxygen bar below the xp tracker, so set its priority lower
 			new WidgetOverlay(client, WidgetInfo.FOSSIL_ISLAND_OXYGENBAR, OverlayPosition.TOP_CENTER, OverlayPriority.HIGH),
@@ -84,7 +84,7 @@ public class WidgetOverlay extends Overlay
 			new WidgetOverlay(client, WidgetInfo.TEMPOROSS_STATUS_INDICATOR, OverlayPosition.TOP_LEFT),
 			new WidgetOverlay(client, WidgetInfo.BA_HEAL_TEAMMATES, OverlayPosition.BOTTOM_LEFT),
 			new WidgetOverlay(client, WidgetInfo.BA_TEAM, OverlayPosition.TOP_RIGHT),
-			new WidgetOverlay(client, WidgetInfo.PVP_WILDERNESS_SKULL_CONTAINER, OverlayPosition.DETACHED)
+			new WidgetOverlay(client, WidgetInfo.PVP_WILDERNESS_SKULL_CONTAINER, OverlayPosition.DYNAMIC)
 		);
 	}
 
@@ -105,6 +105,8 @@ public class WidgetOverlay extends Overlay
 		setPriority(overlayPriority);
 		setLayer(OverlayLayer.UNDER_WIDGETS);
 		setPosition(overlayPosition);
+		setMovable(true);
+		setSnappable(true);
 		// It's almost possible to drawAfterInterface(widgetInfo.getGroupId()) here, but that fires
 		// *after* the native components are drawn, which is too late.
 	}