Interface PSurface

core/src/processing/core/PSurface.java:26–161

public interface PSurface {
  /**
   * Minimum dimensions for the window holding an applet. This varies between
   * platforms, Mac OS X 10.3 (confirmed with 10.7 and Java 6) can do any
   * height but requires at least 128 pixels width. Windows XP has another
   * set of limitations. And for all I know, Linux probably allows window
   * sizes to be negative numbers.
   */
  static public final int MIN_WINDOW_WIDTH = 128;
  static public final int MIN_WINDOW_HEIGHT = 128;

  // renderer that doesn't draw to the screen
  public void initOffscreen(PApplet sketch);

  // considering removal in favor of separate Component classes for appropriate renderers
  // (i.e. for Java2D or a generic Image surface, but not PDF, debatable for GL or FX)
  //public Component initComponent(PApplet sketch);

  //public Frame initFrame(PApplet sketch, Color backgroundColor,
//  public void initFrame(PApplet sketch, int backgroundColor,
//                        int deviceIndex, boolean fullScreen, boolean spanDisplays);
  public void initFrame(PApplet sketch);

  /**
   * Get the native window object associated with this drawing surface.
   * For Java2D, this will be an AWT Frame object. For OpenGL, the window.
   * The data returned here is subject to the whims of the renderer,
   * and using this method means you're willing to deal with underlying
   * implementation changes and that you won't throw a fit like a toddler
   * if your code breaks sometime in the future.
   */
  public Object getNative();

  //

  // Just call these on an AWT Frame object stored in PApplet.
  // Silly, but prevents a lot of rewrite and extra methods for little benefit.
  // However, maybe prevents us from having to document the 'frame' variable?

  /** Set the window (and dock, or whatever necessary) title. */
  public void setTitle(String title);

  /** Show or hide the window. */
  public void setVisible(boolean visible);

  /** 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);

  //

//  public void placeWindow(int[] location);

  public void placeWindow(int[] location, int[] editorLocation);