add surface.setAlwaysOnTop(boolean) for all renderers (fixes #3718)

core/src/processing/awt/PSurfaceAWT.java

@@ -594,6 +594,12 @@ public class PSurfaceAWT extends PSurfaceNone {
   }
 
 
+  @Override
+  public void setAlwaysOnTop(boolean always) {
+    frame.setAlwaysOnTop(always);
+  }
+
+
   List<Image> iconImages;
 
   protected void setProcessingIcon(Frame frame) {

core/src/processing/core/PSurface.java

@@ -71,6 +71,9 @@ public interface PSurface {
   /** Set true if we want to resize things (default is not resizable) */
   public void setResizable(boolean resizable);
 
+  /** Dumb name, but inherited from Frame and no better ideas. */
+  public void setAlwaysOnTop(boolean always);
+
   public void setIcon(PImage icon);
 
   //

core/src/processing/core/PSurfaceNone.java

@@ -111,6 +111,10 @@ public class PSurfaceNone implements PSurface {
   public void setupExternalMessages() { }
 
 
+  @Override
+  public void setAlwaysOnTop(boolean always) { }
+
+
   //
 
 

core/src/processing/javafx/PSurfaceFX.java

@@ -302,6 +302,12 @@ public class PSurfaceFX implements PSurface {
   }
 
 
+  @Override
+  public void setAlwaysOnTop(boolean always) {
+    stage.setAlwaysOnTop(always);
+  }
+
+
   /*
   @Override
   public void placeWindow(int[] location) {

core/src/processing/opengl/PSurfaceJOGL.java

@@ -459,6 +459,12 @@ public class PSurfaceJOGL implements PSurface {
   }
 
 
+  @Override
+  public void setAlwaysOnTop(boolean always) {
+    window.setAlwaysOnTop(always);
+  }
+
+
   protected void initIcons() {
     final int[] sizes = { 16, 32, 48, 64, 128, 256, 512 };
     String[] iconImages = new String[sizes.length];

core/todo.txt

@@ -10,6 +10,8 @@ o   this is the difference between a lot of loadPixels() and not
 o   so important to have it in before beta if that's the change
 o   https://github.com/processing/processing/issues/99
 X   won't fix for now, requires too much reworking on the image system
+X add surface.setAlwaysOnTop(boolean)
+X   https://github.com/processing/processing/issues/3718
 
 andres
 X P2D: error calling surface.setTitle()