0025748: Parallel version of progress indicator

Progress indication mechanism is refactored to support incrementing progress within multithreaded algorithms.

The class Message_ProgressIndicator is only an interface to the user application.
It accumulates the progress provided by progress scopes.
The counter is protected by mutex for thread-safety.

The new class Message_ProgressScope replacing Message_ProgressSentry should be used to advance the progress.
The scopes are nested to each other to reflect the nested nature of operations.
The new class Message_ProgressRange should be used to pass the progress to sub-scopes.

All OCCT algorithms involving progress indication have been updated to new API.

Improvements in Draw_ProgressIndicator:
- Separate console mode has been added in order to make possible to put the progress into std::cout instead
  or in addition to the draw interpreter, instead of trigger option "-tclOutput".
- Treatment of Ctrl-Break signal has been added.
  Now any operation can be aborted by Ctrl-C or Ctrl-Break keystroke.

Added new test case 'perf fclasses progr_par' for testing of parallel work of the progress.

src/XmlDrivers/XmlDrivers_DocumentRetrievalDriver.cxx

@@ -49,9 +49,9 @@ Handle(XmlMDF_ADriverTable) XmlDrivers_DocumentRetrievalDriver::AttributeDrivers
 //purpose  : Implementation of ReadShapeSection
 //=======================================================================
 Handle(XmlMDF_ADriver) XmlDrivers_DocumentRetrievalDriver::ReadShapeSection(
-                               const XmlObjMgt_Element&       theElement,
+                               const XmlObjMgt_Element&         theElement,
                                const Handle(Message_Messenger)& theMsgDriver,
-                               const Handle(Message_ProgressIndicator)& theProgress)
+                               const Message_ProgressRange&     theRange)
 {
   if (myDrivers.IsNull()) myDrivers = AttributeDrivers (theMsgDriver);
   Handle(XmlMDF_ADriver) aDriver;
@@ -59,7 +59,7 @@ Handle(XmlMDF_ADriver) XmlDrivers_DocumentRetrievalDriver::ReadShapeSection(
   {
     Handle(XmlMNaming_NamedShapeDriver) aNamedShapeDriver = 
       Handle(XmlMNaming_NamedShapeDriver)::DownCast (aDriver);
-    aNamedShapeDriver->ReadShapeSection (theElement, theProgress);
+    aNamedShapeDriver->ReadShapeSection (theElement, theRange);
   }
   return aDriver;
 }

src/XmlDrivers/XmlDrivers_DocumentRetrievalDriver.hxx

@@ -43,7 +43,7 @@ public:
   Standard_EXPORT virtual Handle(XmlMDF_ADriver) ReadShapeSection
                          (const XmlObjMgt_Element& thePDoc, 
                           const Handle(Message_Messenger)& theMsgDriver,
-                          const Handle(Message_ProgressIndicator)& theProgress = NULL) Standard_OVERRIDE;
+                          const Message_ProgressRange& theRange = Message_ProgressRange()) Standard_OVERRIDE;
   
   Standard_EXPORT virtual void ShapeSetCleaning
                          (const Handle(XmlMDF_ADriver)& theDriver) Standard_OVERRIDE;  

src/XmlDrivers/XmlDrivers_DocumentStorageDriver.cxx

@@ -52,7 +52,7 @@ Handle(XmlMDF_ADriverTable) XmlDrivers_DocumentStorageDriver::AttributeDrivers
 //=======================================================================
 Standard_Boolean XmlDrivers_DocumentStorageDriver::WriteShapeSection
                                          (XmlObjMgt_Element&  theElement,
-                                          const Handle(Message_ProgressIndicator)& theProgress)
+                                          const Message_ProgressRange& theRange)
 {
   Standard_Boolean isShape(Standard_False);
   Handle(XmlMDF_ADriver) aDriver;
@@ -60,7 +60,7 @@ Standard_Boolean XmlDrivers_DocumentStorageDriver::WriteShapeSection
   {
     Handle(XmlMNaming_NamedShapeDriver) aNamedShapeDriver = 
       Handle(XmlMNaming_NamedShapeDriver)::DownCast (aDriver);
-    aNamedShapeDriver->WriteShapeSection (theElement, theProgress);
+    aNamedShapeDriver->WriteShapeSection (theElement, theRange);
     isShape = Standard_True;
   }
   return isShape;

src/XmlDrivers/XmlDrivers_DocumentStorageDriver.hxx

@@ -43,7 +43,7 @@ public:
   
   Standard_EXPORT virtual Standard_Boolean WriteShapeSection
                       (XmlObjMgt_Element& thePDoc, 
-                       const Handle(Message_ProgressIndicator)& theProgress = NULL) Standard_OVERRIDE;
+                       const Message_ProgressRange& theRange = Message_ProgressRange()) Standard_OVERRIDE;
 
   DEFINE_STANDARD_RTTIEXT(XmlDrivers_DocumentStorageDriver,XmlLDrivers_DocumentStorageDriver)