From 842e49189c67871be0c0d27eaa695be4bd63f1da Mon Sep 17 00:00:00 2001
From: Bruce Smith <bruce@nanorex.com>
Date: Wed, 11 Mar 2009 00:47:28 +0000
Subject: split many Draw methods into their 4 new parts; not fully tested

---
 cad/src/command_support/GraphicsMode.py     | 10 +++++++---
 cad/src/command_support/GraphicsMode_API.py |  3 +++
 2 files changed, 10 insertions(+), 3 deletions(-)

(limited to 'cad/src/command_support')

diff --git a/cad/src/command_support/GraphicsMode.py b/cad/src/command_support/GraphicsMode.py
index 07ab8e3fb..43d3bff9e 100755
--- a/cad/src/command_support/GraphicsMode.py
+++ b/cad/src/command_support/GraphicsMode.py
@@ -317,12 +317,14 @@ class basicGraphicsMode(GraphicsMode_API):
 
     # ==
 
-    def Draw(self): #bruce 090310 deprecated this; will remove it from the GM API
+    def Draw(self): #bruce 090310 refactoring this; will remove it from the GM API very soon
         """
         [temporary method for compatibility as we refactor Draw;
-         should not be overridden or extended]
+         should not be overridden or extended -- instead, override
+         or extend one of the following methods which it calls]
         """
-        # when done, enable this: ## print_compact_stack( "bug: old code is calling %r.Draw(): " % self)
+        ##### when done, enable this debug print:
+        ## print_compact_stack( "bug: old code is calling %r.Draw(): " % self)
         self.Draw_preparation() #bruce 090310 do this first, not last or in middle as before
         self.Draw_axes()
         self.Draw_model()
@@ -517,6 +519,8 @@ class basicGraphicsMode(GraphicsMode_API):
         """
         pass
 
+    # ==
+    
     def Draw_after_highlighting(self, pickCheckOnly = False): #bruce 050610
         """
         Do more drawing, after the main drawing code has completed its
diff --git a/cad/src/command_support/GraphicsMode_API.py b/cad/src/command_support/GraphicsMode_API.py
index 9262d65e4..d9c36de8f 100644
--- a/cad/src/command_support/GraphicsMode_API.py
+++ b/cad/src/command_support/GraphicsMode_API.py
@@ -43,6 +43,9 @@ class Delegating_GraphicsMode(GraphicsMode_interface): #bruce 090307
     """
     Abstract class for GraphicsModes which delegate almost everything
     to their parentGraphicsMode.
+
+    @see: related class Overdrawing_GraphicsMode_preMixin,
+        used in TemporaryCommand_Overdrawing
     """
     # implem note: We can't use idlelib.Delegator to help implement this class,
     # since the delegate needs to be dynamic.
-- 
cgit v1.2.3