2003/09/23 08:24:59
[org.ibex.core.git] / src / org / xwt / Surface.java
index 5f44098..e1cb141 100644 (file)
@@ -17,122 +17,65 @@ import java.util.*;
  *  MessageQueue-time (the size/position/state at the time that the
  *  now-executing message was enqueued). This distinction is important.
  */
-public abstract class Surface {
+public abstract class Surface extends PixelBuffer {
 
-    // Static Data ////////////////////////////////////////////////////////////////////////////////
+    /** Dirty regions on the screen which need to be rebuilt using Surface.blit() */
+    DirtyList screenDirtyRegions = new DirtyList();
 
-    /** true iff a user-created surface was created */
-    static boolean refreshableSurfaceWasCreated = false;
+    public int getWidth() { return root == null ? 0 : root.width; }
+    public int getHeight() { return root == null ? 0 : root.height; }
+        
+    // Static Data ////////////////////////////////////////////////////////////////////////////////
 
-    /** a reference to the most recently enqueued Move message; used to throttle the message rate */
+    /**< the most recently enqueued Move message; used to throttle the message rate */
     private static Message lastMoveMessage = null;
 
     /** all instances of Surface which need to be refreshed by the MessageQueue */
     public static Vec allSurfaces = new Vec();
-
-    /** true iff the alt button is pressed down, in real time */
-    public static boolean alt = false;
     
-    /** true iff the control button is pressed down, in real time */
-    public static boolean control = false;
-
-    /** true iff the shift button is pressed down, in real time */
-    public static boolean shift = false;
-
-    /** true iff button 1 is depressed, in MessageQueue-time */
-    public static boolean button1 = false;
-
-    /** true iff button 2 is depressed, in MessageQueue-time */
-    public static boolean button2 = false;
-
-    /** true iff button 3 is depressed, in MessageQueue-time */
-    public static boolean button3 = false;
-
-    /** true iff all surfaces created from now on should be scarred */
-    public static boolean scarAllSurfacesFromNowOn = false;
-
-    /** false if the surface has never been rendered; used to determine if the surface should be repositioned to be centered on the screen */
-    public boolean centerSurfaceOnRender = true;
-
-    /** the x position of the mouse, relative to this Surface, in MessageQueue-time */
-    public int mousex;
+    /** When set to true, render() should abort as soon as possible and restart the rendering process */
+    static volatile boolean abort = false;
 
-    /** the y position of the mouse, relative to this Surface, in MessageQueue-time */
-    public int mousey;
+    public static boolean alt = false;          /**< true iff the alt button is pressed down, in real time */
+    public static boolean control = false;      /**< true iff the control button is pressed down, in real time */
+    public static boolean shift = false;        /**< true iff the shift button is pressed down, in real time */
+    public static boolean button1 = false;      /**< true iff button 1 is depressed, in MessageQueue-time */
+    public static boolean button2 = false;      /**< true iff button 2 is depressed, in MessageQueue-time */
+    public static boolean button3 = false;      /**< true iff button 3 is depressed, in MessageQueue-time */
 
-    /** True iff this surface is minimized, in real time */
-    public boolean minimized = false;
 
-    /** True iff this surface is maximized, in real time */
-    public boolean maximized = false;
+    // Instance Data ///////////////////////////////////////////////////////////////////////
 
-    /** The name of the cursor on this surface -- this value fluctuates during rendering, so it may not be accurate;
-     *  syncCursor() is called once the value is stable, to prevent the "flickering cursor" phenomenon
-     */
+    public Box root;      /**< The Box at the root of this surface */
     public String cursor = "default";
 
-    /** The Box at the root of this surface */
-    public Box root;
-
-    /** The number of SizeChange/PosChange traps triggered since the last successful render -- used to detect infinite loops */
-    public int sizePosChangesSinceLastRender = 0;
+    public int mousex;      /**< the x position of the mouse, relative to this Surface, in MessageQueue-time */
+    public int mousey;      /**< the y position of the mouse, relative to this Surface, in MessageQueue-time */
+    public boolean minimized = false;      /**< True iff this surface is minimized, in real time */
+    public boolean maximized = false;      /**< True iff this surface is maximized, in real time */
 
 
     // Used For Simulating Clicks and DoubleClicks /////////////////////////////////////////////////
 
-    /** the x-position of the mouse the last time a Press message was enqueued */
-    int last_press_x = Integer.MAX_VALUE;
-
-    /** the y-position of the mouse the last time a Press message was enqueued */
-    int last_press_y = Integer.MAX_VALUE;
-
-    /** the last button to recieve a Click message; used for simulating DoubleClick's */
-    static int lastClickButton = 0;
-
-    /** the last time a Click message was processed; used for simulating DoubleClick's */
-    static long lastClickTime = 0;
+    int last_press_x = Integer.MAX_VALUE;      /**< the x-position of the mouse the last time a Press message was enqueued */
+    int last_press_y = Integer.MAX_VALUE;      /**< the y-position of the mouse the last time a Press message was enqueued */
+    static int lastClickButton = 0;            /**< the last button to recieve a Click message; used for simulating DoubleClick's */
+    static long lastClickTime = 0;             /**< the last time a Click message was processed; used for simulating DoubleClick's */
     
     
     // Methods to be overridden by subclasses ///////////////////////////////////////////////////////
 
-    /** when this method is invoked, the surface should push itself to the back of the stacking order */
-    public abstract void toBack();
-
-    /** when this method is invoked, the surface should pull itself to the front of the stacking order */
-    public abstract void toFront();
-
-    /** sets the <i>actual</i> cursor for this surface to the cursor referenced by <tt>cursor</tt> */
-    public abstract void syncCursor();
-
-    /** If <tt>b == true</tt>, make the window invisible; otherwise, make it non-invisible. */
-    public abstract void setInvisible(boolean b);
-
-    /** If <tt>b == true</tt>, maximize the surface; otherwise, un-maximize it. */
-    protected abstract void _setMaximized(boolean b);
-
-    /** If <tt>b == true</tt>, minimize the surface; otherwise, un-minimize it. */
-    protected abstract void _setMinimized(boolean b);
-
-    /** Sets the surface's width and height. */
-    protected abstract void setSize(int width, int height);
-
-    /** Sets the surface's x and y position. */
-    public abstract void setLocation(int x, int y);
-    public void setLocation() { setLocation(root.x, root.y); }
-
-    /** Sets the surface's title bar text, if applicable */
-    public abstract void setTitleBarText(String s);
-
-    /** Sets the surface's title bar text, if applicable */
-    public abstract void setIcon(Picture i);
-
-    /** copies a region from the doublebuffer to this surface */
-    public abstract void blit(PixelBuffer source, int sx, int sy, int dx, int dy, int dx2, int dy2);
-
-    /** Destroy the surface */
-    public abstract void _dispose();
-
-    /** Notifies the surface that limits have been imposed on the surface's size */
+    public abstract void toBack();      /**< when invoked, the surface should push itself to the back of the stacking order */
+    public abstract void toFront();     /**< when invoked, the surface should pull itself to the front of the stacking order */
+    public abstract void syncCursor();  /**< the <i>actual</i> cursor for this surface to the cursor referenced by <tt>cursor</tt> */
+    public abstract void setInvisible(boolean b);      /**< If <tt>b</tt>, make window invisible; otherwise, make it non-invisible. */
+    protected abstract void _setMaximized(boolean b);  /**< If <tt>b</tt>, maximize the surface; otherwise, un-maximize it. */
+    protected abstract void _setMinimized(boolean b);  /**< If <tt>b</tt>, minimize the surface; otherwise, un-minimize it. */
+    protected abstract void setSize(int width, int height);  /**< Sets the surface's width and height. */
+    public abstract void setLocation();                      /**< Set the surface's x/y position to that of the root box */
+    public abstract void setTitleBarText(String s);      /**< Sets the surface's title bar text, if applicable */
+    public abstract void setIcon(Picture i);      /**< Sets the surface's title bar text, if applicable */
+    public abstract void _dispose();      /**< Destroy the surface */
     public void setLimits(int min_width, int min_height, int max_width, int max_height) { }
 
 
@@ -150,7 +93,7 @@ public abstract class Surface {
         else if (button == 2) new SimpleMessage("Press2", Boolean.TRUE, Box.whoIs(root, mousex, mousey));
         else if (button == 3) {
             final Box who = Box.whoIs(root, mousex, mousey);
-            MessageQueue.add(new Message() { public void perform() {
+            Message.Q.add(new Message() { public void perform() {
                 Platform.clipboardReadEnabled = true;
                 root.put("Press3", Boolean.TRUE);
                 Platform.clipboardReadEnabled = false;
@@ -204,7 +147,7 @@ public abstract class Surface {
         else if (control) key = "C-" + key;
 
         final String fkey = key;
-        MessageQueue.add(new KMessage(key));
+        Message.Q.add(new KMessage(key));
     }
 
     // This is implemented as a private static class instead of an anonymous class to work around a GCJ bug
@@ -213,12 +156,14 @@ public abstract class Surface {
         public KMessage(String k) { key = k; }
         public void perform() {
             if (key.equals("C-v") || key.equals("A-v")) Platform.clipboardReadEnabled = true;
+            /* FIXME
             outer: for(int i=0; i<keywatchers.size(); i++) {
                 Box b = (Box)keywatchers.elementAt(i);
                 for(Box cur = b; cur != null; cur = cur.getParent())
                     if ((cur.flags & cur.INVISIBLE_FLAG) != 0) continue outer;
                 b.put("KeyPressed", key);
             }
+            */
             Platform.clipboardReadEnabled = false;
         }
     }
@@ -229,13 +174,15 @@ public abstract class Surface {
         if (key.toLowerCase().equals("alt")) alt = false;
         else if (key.toLowerCase().equals("control")) control = false;
         else if (key.toLowerCase().equals("shift")) shift = false;
-        MessageQueue.add(new Message() { public void perform() {
+        Message.Q.add(new Message() { public void perform() {
+            /* FIXME
             outer: for(int i=0; i<keywatchers.size(); i++) {
                 Box b = (Box)keywatchers.elementAt(i);
                 for(Box cur = b; cur != null; cur = cur.getParent())
                     if ((cur.flags & cur.INVISIBLE_FLAG) != 0) continue outer;
                 b.put("KeyReleased", key);
             }
+            */
         }});
     }
 
@@ -246,7 +193,7 @@ public abstract class Surface {
      *  message), the subclass should use (-1,-1).
      */
     protected final void Move(final int newmousex, final int newmousey) {
-        MessageQueue.add(lastMoveMessage = new Message() { public void perform() {
+        Message.Q.add(lastMoveMessage = new Message() { public void perform() {
             synchronized(Surface.this) {
 
                 // if move messages are arriving faster than we can process them, we just start ignoring them
@@ -271,7 +218,7 @@ public abstract class Surface {
     }
 
     protected final void SizeChange(final int width, final int height) {
-        MessageQueue.add(new Message() { public void perform() {
+        Message.Q.add(new Message() { public void perform() {
             if (width == root.width && height == root.height) return;
             root.width = width;
             root.height = height;
@@ -281,7 +228,7 @@ public abstract class Surface {
     }
 
     protected final void PosChange(final int x, final int y) {
-        MessageQueue.add(new Message() { public void perform() {
+        Message.Q.add(new Message() { public void perform() {
             root.put("x", new Integer(x));
             root.put("y", new Integer(y));
         }});
@@ -291,70 +238,19 @@ public abstract class Surface {
     protected final void Minimized(boolean b) { minimized = b; new SimpleMessage("Minimized", b ? Boolean.TRUE : Boolean.FALSE, root); }
     protected final void Maximized(boolean b) { maximized = b; new SimpleMessage("Maximized", b ? Boolean.TRUE : Boolean.FALSE, root); }
     protected final void Focused(boolean b) { new SimpleMessage("Focused", b ? Boolean.TRUE : Boolean.FALSE, root); }
-    public static void Refresh() { MessageQueue.refresh(); }
-
-    // the following value is split into two int's to work around GCJ bug java/6393
-
-    /** This is how subclasses signal a 'shallow dirty', indicating that although the backbuffer is valid, the screen is not */
-    public final void Dirty(int x, int y, int w, int h) {
-        screenDirtyRegions.dirty(x, y, w, h);
-        Refresh();
-    }
-
-
-    // Private Instance Data /////////////////////////////////////////////////////////////////////////////////////////////
-
-    /** The automatic double buffer for the root box */
-    PixelBuffer backbuffer = null;
-
-    /** Dirty regions on the backbuffer which need to be rebuilt using Box.render() */
-    private DirtyList backbufferDirtyRegions = new DirtyList();
-
-    /** Dirty regions on the screen which need to be rebuilt using Surface.blit() */
-    private DirtyList screenDirtyRegions = new DirtyList();
-
-    /** A list of all the Boxes on this Surface that should be notified of keyboard events */
-    Vec keywatchers = new Vec();
-
-    /** When set to true, render() should abort as soon as possible and restart the rendering process */
-    static volatile boolean abort = false;
-
-    /** a solid red 10x10 double buffer */
-    private PixelBuffer showRenderBuf = null;
-
-    /** a striped 100x100 double buffer */
-    private PixelBuffer showRenderBuf2 = null;
-
-    /** true iff this window should be scarred */
-    private boolean scarred = true;
+    public static void Refresh() { Message.Q.refresh(); }
 
 
     // Other Methods ///////////////////////////////////////////////////////////////////////////////
 
-    /** If <tt>b == true</tt>, maximize the surface; otherwise, un-maximize it. */
-    public final void setMaximized(boolean b) {
-        if (b == maximized) return;
-        _setMaximized(b);
-        maximized = b;
-    }
-
-    /** If <tt>b == true</tt>, minimize the surface; otherwise, un-minimize it. */
-    public final void setMinimized(boolean b) {
-        if (b == minimized) return;
-        _setMinimized(b);
-        minimized = b;
-    }
+    public final void setMaximized(boolean b) { if (b != maximized) _setMaximized(maximized = b); }
+    public final void setMinimized(boolean b) { if (b != minimized) _setMinimized(minimized = b); }
 
     /** wrapper for setSize() which makes sure to dirty the place where the scar used to be */
     void setSize() {
-        if (scarred) {
-            root.width = Math.max(root.width, scarPicture.getWidth());
-            root.height = Math.max(root.height, scarPicture.getHeight());
-            dirty(hscar,
-                  root.height - vscar - scarPicture.getHeight(),
-                  scarPicture.getWidth(),
-                  scarPicture.getHeight());
-        }
+        root.width = Math.max(root.width, scarPicture.getWidth());
+        root.height = Math.max(root.height, scarPicture.getHeight());
+        dirty(hscar, root.height - vscar - scarPicture.getHeight(), scarPicture.getWidth(), scarPicture.getHeight());
         setSize(root.width, root.height);
     }
 
@@ -367,23 +263,17 @@ public abstract class Surface {
 
         // quit when all windows are closed
         if (allSurfaces.size() == 0 && quitIfAllSurfacesGone && Main.doneInitializing) {
-            if (Log.on) {
-                if (refreshableSurfaceWasCreated) Log.log(this, "exiting because last remaining surface was disposed");
-                else Log.log(this, "exiting because no surface was ever created");
-            }
-            Platform.exit();
+            if (Log.on) Log.log(this, "exiting because last surface was destroyed");
+            System.exit(0);
         }
     }
 
-    /** Indicates that the backbuffer region x,y,w,h is no longer correct and must be regenerated */
     public void dirty(int x, int y, int w, int h) {
         backbufferDirtyRegions.dirty(x, y, w, h);
         Refresh();
     }
 
     public Surface(Box root) {
-        this.scarred = scarAllSurfacesFromNowOn;
-        scarAllSurfacesFromNowOn = true;
         this.root = root;
         if (root.surface != null && root.surface.root == root) {
             root.surface.dispose(false);
@@ -393,13 +283,7 @@ public abstract class Surface {
         root.surface = this;
 
         // make sure the root is properly sized
-        do {
-            abort = false;
-            root.reflow();
-        } while(abort);
-
-        // this is a bit dangerous since we're passing ourselves to another method before subclasses' ctors have run...        
-        backbuffer = Platform.createPixelBuffer(Platform.getScreenWidth(), Platform.getScreenHeight(), this);
+        do { abort = false; root.reflow(); } while(abort);
 
         root.dirty();
         Refresh();
@@ -419,16 +303,7 @@ public abstract class Surface {
             if (!cursor.equals(oldcursor)) syncCursor();
         } while(abort);
 
-        if (centerSurfaceOnRender) {
-            centerSurfaceOnRender = false;
-            int x = (Platform.getScreenWidth() - root.width) / 2;
-            int y = (Platform.getScreenHeight() - root.height) / 2;
-            setLocation(x, y);
-            root.x = x;
-            root.y = y;
-        }
-
-        sizePosChangesSinceLastRender = 0;
+        Box.sizePosChangesSinceLastRender = 0;
         int[][] dirt = backbufferDirtyRegions.flush();
         for(int i = 0; dirt != null && i < dirt.length; i++) {
             if (dirt[i] == null) continue;
@@ -442,28 +317,27 @@ public abstract class Surface {
             if (y+h > root.height) h = root.height - y;
             if (w <= 0 || h <= 0) continue;
 
-            root.render(0, 0, x, y, w, h, backbuffer);
+            root.render(0, 0, x, y, w, h, this);
             
             // if any area under the scar was repainted, rescar that area
-            if (scarred && x < hscar + scarPicture.getWidth() &&
+            if (x < hscar + scarPicture.getWidth() &&
                 y + h > root.height - scarPicture.getHeight() - vscar) {
                 int _x1 = Math.max(x, hscar);
                 int _x2 = Math.min(x + w, hscar + scarPicture.getWidth());
                 int _y1 = Math.max(y, root.height - scarPicture.getHeight() - vscar);
                 int _y2 = Math.min(y + h, root.height - vscar);
                 
-                backbuffer.drawPicture(scarPicture, _x1, _y1, _x2, _y2,
-                                       _x1 - (hscar),
-                                       _y1 - (root.height - scarPicture.getHeight() - vscar),
-                                       _x2 - (hscar),
-                                       _y2 - (root.height - scarPicture.getHeight() - vscar)
-                                       );
+                drawPicture(scarPicture, _x1, _y1, _x2, _y2,
+                            _x1,
+                            _y1 - (root.height - scarPicture.getHeight()),
+                            _x2,
+                            _y2 - (root.height - scarPicture.getHeight())
+                            );
             }
 
             if (abort) {
 
                 // x,y,w,h is only partially reconstructed, so we must be careful not to re-blit it
-                blitDirtyScreenRegions(x, y, w, h);
                 screenDirtyRegions.dirty(x, y, w, h);
 
                 // put back all the dirty regions we haven't yet processed (including the current one)
@@ -480,67 +354,6 @@ public abstract class Surface {
             screenDirtyRegions.dirty(x, y, w, h);
         }
 
-        // blit out all the areas we've just reconstructed
-        blitDirtyScreenRegions();
-    }
-
-    /** blits from the backbuffer to the screen for all regions of the screen which have become dirty */
-    public synchronized void blitDirtyScreenRegions() { blitDirtyScreenRegions(-1, -1, 0, 0); }
-
-    /** same as blitDirtyScreenRegions(), except that it will skip any regions within a,b,c,d */
-    private synchronized void blitDirtyScreenRegions(int a, int b, int c, int d) {
-
-        int[][] dirt = screenDirtyRegions.flush();
-        if (Main.showRenders && dirt != null && dirt.length > 0 && a == -1)
-            blit(backbuffer, 0, 0, 0, 0, root.width, root.height);
-
-        for(int i = 0; dirt != null && i < dirt.length; i++) {
-            if (dirt[i] == null) continue;
-            int x = dirt[i][0];
-            int y = dirt[i][1];
-            int w = dirt[i][2];
-            int h = dirt[i][3];
-            if (x < 0) x = 0;
-            if (y < 0) y = 0;
-            if (x+w > root.width) w = root.width - x;
-            if (y+h > root.height) h = root.height - y;
-            if (w <= 0 || h <= 0) continue;
-
-            // if any part of this region falls within the "bad region", just skip it
-            boolean hhit = (x >= a && x <= a + c) || (x+w >= a && x+w <= a + c);
-            boolean vhit = (y >= b && y <= b + d) || (y+h >= b && y+h <= b + d);
-            if (hhit && vhit) {
-                screenDirtyRegions.dirty(x, y, w, h);
-                continue;
-            }
-
-            blit(backbuffer, x, y, x, y, w + x, h + y);
-            
-            if (Main.showRenders) {
-                if (showRenderBuf == null) {
-                    showRenderBuf = Platform.createPixelBuffer(10, 10, this);
-                    showRenderBuf.fillRect(0, 0, 10, 10, 0x00FF0000);
-                    showRenderBuf2 = Platform.createPixelBuffer(100, 100, this);
-                    for(int y1 = 0; y1<100; y1++)
-                        for(int x1 = 0; x1<100; x1++)
-                            if ((x1 + y1) % 5 == 0)
-                                showRenderBuf2.fillRect(x1, y1, x1 + 1, y1 + 1, 0x00FF0000);
-                }
-                for(int x1 = x; x1<x + w; x1 += 100)
-                    for(int y1 = y; y1< y + h; y1 += 100) {
-                        blit(showRenderBuf2, 0, 0, x1, y1, Math.min(x1 + 100, x + w), Math.min(y1 + 100, y + h));
-                    }
-                for(int j=x; j<x + w; j += 10) {
-                    blit(showRenderBuf, 0, 0, j, y, Math.min(j+ 10, x + w), y + 1);
-                    blit(showRenderBuf, 0, 0, j, y + h, Math.min(j + 10, x + w), y + h + 1);
-                }
-                for(int j=y; j<y + h; j += 10) {
-                    blit(showRenderBuf, 0, 0, x, j, x + 1, Math.min(j + 10, y + h));
-                    blit(showRenderBuf, 0, 0, x + w, j, x + w + 1, Math.min(j + 10, y + h));
-                }
-            }
-
-        }
     }
 
     // FEATURE: reinstate recycler
@@ -554,23 +367,93 @@ public abstract class Surface {
             this.boxContainingMouse = boxContainingMouse;
             this.name = name;
             this.value = value;
-            MessageQueue.add(this);
+            Message.Q.add(this);
         }
         
         public void perform() { boxContainingMouse.put(name, value); }
         public String toString() { return "SimpleMessage [name=" + name + ", value=" + value + "]"; }
-        
+
     }
 
+    /** Dirty regions on the backbuffer which need to be rebuilt using Box.render() */
+    private DirtyList backbufferDirtyRegions = new DirtyList();
+        
     // Scar-Related Stuff ////////////////////////////////////////////////////////////////////
 
-    /** The scar's horizontal offset */
-    int hscar = 0;
-
-    /** The scar's vertical offset */
-    int vscar = 0;
-
     /** the scar image drawn on the bottom right hand corner */
     static Picture scarPicture = null;
 
+
+    // Default PixelBuffer implementation /////////////////////////////////////////////////////////
+
+    public static abstract class DoubleBufferedSurface extends Surface {
+
+        public DoubleBufferedSurface(Box root) {
+            super(root);
+
+            // this is a bit dangerous since we're passing ourselves to another method before subclasses' ctors have run...        
+            backbuffer = Platform.createPixelBuffer(Platform.getScreenWidth(), Platform.getScreenHeight(), this);
+        }
+
+        /** The automatic double buffer for the root box */
+        PixelBuffer backbuffer = null;
+        
+        public void drawPicture(Picture source, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2) {
+            backbuffer.drawPicture(source, dx1, dy1, dx2, dy2, sx1, sy1, sx2, sy2);
+        }
+        
+        public void fillRect(int x1, int y1, int x2, int y2, int color) {
+            backbuffer.fillRect(x1, y1, x2, y2, color);
+        }
+        
+        /** This is how subclasses signal a 'shallow dirty', indicating that although the backbuffer is valid, the screen is not */
+        public final void Dirty(int x, int y, int w, int h) {
+            screenDirtyRegions.dirty(x, y, w, h);
+            Refresh();
+        }
+
+        /** copies a region from the doublebuffer to this surface */
+        public abstract void blit(PixelBuffer source, int sx, int sy, int dx, int dy, int dx2, int dy2);
+
+
+        /** blits from the backbuffer to the screen for all regions of the screen which have become dirty */
+        public synchronized void blitDirtyScreenRegions() { blitDirtyScreenRegions(-1, -1, 0, 0); }
+        
+        /** same as blitDirtyScreenRegions(), except that it will skip any regions within a,b,c,d */
+        private synchronized void blitDirtyScreenRegions(int a, int b, int c, int d) {
+            
+            int[][] dirt = screenDirtyRegions.flush();
+            if (Main.showRenders && dirt != null && dirt.length > 0 && a == -1)
+                blit(backbuffer, 0, 0, 0, 0, root.width, root.height);
+            
+            for(int i = 0; dirt != null && i < dirt.length; i++) {
+                if (dirt[i] == null) continue;
+                int x = dirt[i][0];
+                int y = dirt[i][1];
+                int w = dirt[i][2];
+                int h = dirt[i][3];
+                if (x < 0) x = 0;
+                if (y < 0) y = 0;
+                if (x+w > root.width) w = root.width - x;
+                if (y+h > root.height) h = root.height - y;
+                if (w <= 0 || h <= 0) continue;
+                
+                // if any part of this region falls within the "bad region", just skip it
+                boolean hhit = (x >= a && x <= a + c) || (x+w >= a && x+w <= a + c);
+                boolean vhit = (y >= b && y <= b + d) || (y+h >= b && y+h <= b + d);
+                if (hhit && vhit) {
+                    screenDirtyRegions.dirty(x, y, w, h);
+                    continue;
+                }
+                
+                blit(backbuffer, x, y, x, y, w + x, h + y);
+                
+            }
+
+        }
+    }
+
+    public static final int hscar = 0;
+    public static final int vscar = 0;
+
 }