Changeset 184 for trunk/src/org/expeditee/gui/FrameGraphics.java

Timestamp:

08/04/08 11:00:13 (16 years ago)

Author:

bjn8

Message:

Widgets are now linkable.
Also made some improvements for popups - improved interaction with free items.

File:

• trunk/src/org/expeditee/gui/FrameGraphics.java (modified) (4 diffs)

trunk/src/org/expeditee/gui/FrameGraphics.java

@@ -36 +36 @@
         // the maximum size that can be used to paint on
         private static Dimension _MaxSize = new Dimension(1000, 1000);
+        
+        // Final passes to renderering the current frame
+        private static LinkedList<FinalFrameRenderPass> _finalPasses = new LinkedList<FinalFrameRenderPass>();
 
         // modes
@@ -457 +460 @@
                                 PaintNonLinesNonPicture(bg, freeItemsToPaint);
 
-                        // Repaint popups / drags...
-                        if (isActualFrame)
+                        // Repaint popups / drags... As well as final passes
+                        if (isActualFrame) {
                                 PopupManager.getInstance().paintLayeredPane(bg, clip);
+                                for (FinalFrameRenderPass pass : _finalPasses) {
+                                        pass.paint(bg);
+                                }
+                        }
 
                         bg.dispose();
@@ -857 +864 @@
                 // Paint frame to window
                 Paint(dg, left, right, Item.DEFAULT_BACKGROUND);
-                
+
                 // Paint any animations
                 PopupManager.getInstance().paintAnimations();
@@ -905 +912 @@
 
         }
+        
+        /**
+         * Adds a FinalFrameRenderPass to the frame-render pipeline...
+         * 
+         * Note that the last added FinalFrameRenderPass will be rendered at the
+         * very top.
+         * 
+         * @param pass
+         *              The pass to add. If already added then nothing results in the call.
+         * 
+         * @throws NullPointerException
+         *              If pass is null.
+         */
+        public static void addFinalFrameRenderPass(FinalFrameRenderPass pass) {
+                if (pass == null) throw new NullPointerException("pass");
+                
+                if (!_finalPasses.contains(pass))
+                        _finalPasses.add(pass);
+        }
+        
+        /**
+         * Adds a FinalFrameRenderPass to the frame-render pipeline...
+         * 
+         * Note that the last added FinalFrameRenderPass will be rendered at the
+         * very top.
+         * 
+         * @param pass
+         *              The pass to remove
+         * 
+         */
+        public static void removeFinalFrameRenderPass(FinalFrameRenderPass pass) {
+                _finalPasses.remove(pass);
+        }
+        
+        /**
+         * A FinalFrameRenderPass is invoked at the very final stages for rendering a frame:
+         * that is, after the popups are drawn.
+         *  
+         * There can be many applications for FinalFrameRenderPass. Such as tool tips, balloons,
+         * or drawing items at the highest Z-order in special situations.
+         * 
+         * Although if there are multiples FinalFrameRenderPasses attatach to the
+         * frame painter then it is not garaunteed to be rendered very last.
+         * 
+         * @see FrameGraphics#addFinalFrameRenderPass(org.expeditee.gui.FrameGraphics.FinalFrameRenderPass)
+         * @see FrameGraphics#removeFinalFrameRenderPass(org.expeditee.gui.FrameGraphics.FinalFrameRenderPass)
+         * 
+         * @author Brook Novak
+         */
+        public interface FinalFrameRenderPass {
+                void paint(Graphics g);
+        }
 
 }