Salome HOME
First executable version
[modules/smesh.git] / src / SMESHGUI / SMESHGUI_HypothesesUtils.cxx
1 //  Copyright (C) 2003  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
2 //  CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
3 //
4 //  This library is free software; you can redistribute it and/or
5 //  modify it under the terms of the GNU Lesser General Public
6 //  License as published by the Free Software Foundation; either
7 //  version 2.1 of the License.
8 //
9 //  This library is distributed in the hope that it will be useful,
10 //  but WITHOUT ANY WARRANTY; without even the implied warranty of
11 //  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 //  Lesser General Public License for more details.
13 //
14 //  You should have received a copy of the GNU Lesser General Public
15 //  License along with this library; if not, write to the Free Software
16 //  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
17 //
18 //  See http://www.opencascade.org/SALOME/ or email : webmaster.salome@opencascade.org
19
20 #include "SMESHGUI_HypothesesUtils.h"
21
22 #include "SMESHGUI.h"
23 #include "SMESHGUI_Hypotheses.h"
24 #include "SMESHGUI_XmlHandler.h"
25 #include "SMESHGUI_Utils.h"
26 #include "SMESHGUI_GEOMGenUtils.h"
27
28 #include "SUIT_Tools.h"
29 #include "SUIT_Desktop.h"
30 #include "SUIT_MessageBox.h"
31 #include "SUIT_OverrideCursor.h"
32 #include "SUIT_ResourceMgr.h"
33 #include "SUIT_Session.h"
34
35 #include "OB_Browser.h"
36
37 #include "SalomeApp_Study.h"
38 #include "SalomeApp_Tools.h"
39 #include "SalomeApp_Application.h"
40
41 #include <SALOMEDSClient_Study.hxx>
42 #include <SALOMEDSClient_SObject.hxx>
43
44 #include "SALOMEconfig.h"
45 #include CORBA_CLIENT_HEADER(SALOMEDS_Attributes)
46
47 #include <map>
48 #include <string>
49
50 #ifdef WNT
51  #include <windows.h>
52 #else
53  #include <dlfcn.h>
54 #endif
55
56 #ifdef WNT
57  #define LibHandle HMODULE
58  #define LoadLib( name ) LoadLibrary( name )
59  #define GetProc GetProcAddress
60  #define UnLoadLib( handle ) FreeLibrary( handle );
61 #else
62  #define LibHandle void*
63  #define LoadLib( name ) dlopen( name, RTLD_LAZY )
64  #define GetProc dlsym
65  #define UnLoadLib( handle ) dlclose( handle );
66 #endif
67
68 #ifdef _DEBUG_
69 static int MYDEBUG = 0;
70 #else
71 static int MYDEBUG = 0;
72 #endif
73
74 namespace SMESH{
75
76   using namespace std;
77
78   typedef map<string,HypothesisData*> THypothesisDataMap;
79   THypothesisDataMap myHypothesesMap;
80   THypothesisDataMap myAlgorithmsMap;
81
82   typedef map<string,SMESHGUI_GenericHypothesisCreator*> THypCreatorMap;
83   THypCreatorMap myHypCreatorMap;
84
85   list<HypothesesSet*> myListOfHypothesesSets;
86
87   void processHypothesisStatus(const int theHypStatus,
88                                SMESH::SMESH_Hypothesis_ptr theHyp,
89                                const bool theIsAddition)
90   {
91     if (theHypStatus > SMESH::HYP_OK) {
92
93       // get Hyp name
94       QString aHypName ("NULL Hypothesis");
95       if (!CORBA::is_nil(theHyp)) {
96         _PTR(SObject) Shyp = SMESH::FindSObject(theHyp);
97         if (Shyp)
98           // name in study
99           aHypName = Shyp->GetName().c_str();
100         else
101           // label in xml file
102           aHypName = GetHypothesisData(theHyp->GetName())->Label;
103       }
104
105       // message
106       bool isFatal = (theHypStatus >= SMESH::HYP_UNKNOWN_FATAL);
107       QString aMsg;
108       if (theIsAddition)
109         aMsg = (isFatal ? "SMESH_CANT_ADD_HYP" : "SMESH_ADD_HYP_WRN");
110       else
111         aMsg = (isFatal ? "SMESH_CANT_RM_HYP"  : "SMESH_RM_HYP_WRN");
112
113       aMsg = QObject::tr(aMsg).arg(aHypName) +
114         QObject::tr(QString("SMESH_HYP_%1").arg(theHypStatus));
115
116       SUIT_MessageBox::warn1(SMESHGUI::desktop(),
117                             QObject::tr("SMESH_WRN_WARNING"),
118                             aMsg,
119                             QObject::tr("SMESH_BUT_OK"));
120     }
121   }
122
123
124   void InitAvailableHypotheses()
125   {
126     SUIT_OverrideCursor wc;
127     if (myHypothesesMap.empty() && myAlgorithmsMap.empty()) {
128       // Resource manager
129       SUIT_ResourceMgr* resMgr = SMESHGUI::resourceMgr();
130       if (!resMgr) return;
131
132       // Find name of a resource XML file ("SMESH_Meshers.xml");
133       QString HypsXml;
134       char* cenv = getenv("SMESH_MeshersList");
135       if (cenv)
136         HypsXml.sprintf("%s", cenv);
137
138       QStringList HypsXmlList = QStringList::split(":", HypsXml, false);
139       if (HypsXmlList.count() == 0)
140         {
141           SUIT_MessageBox::error1(SMESHGUI::desktop(),
142                                  QObject::tr("SMESH_WRN_WARNING"),
143                                  QObject::tr("MESHERS_FILE_NO_VARIABLE"),
144                                  QObject::tr("SMESH_BUT_OK"));
145           return;
146         }
147
148       // loop on files in HypsXml
149       QString aNoAccessFiles;
150       for (int i = 0; i < HypsXmlList.count(); i++) {
151         QString HypsXml = HypsXmlList[ i ];
152
153         // Find full path to the resource XML file
154         QString xmlFile = resMgr->path("resources", "SMESH", HypsXml + ".xml");
155         if ( xmlFile.isEmpty() ) // try PLUGIN resources
156           xmlFile = resMgr->path("resources", HypsXml, HypsXml + ".xml");
157         
158         QFile file (xmlFile);
159         if (file.exists() && file.open(IO_ReadOnly)) {
160           file.close();
161
162           SMESHGUI_XmlHandler* aXmlHandler = new SMESHGUI_XmlHandler();
163           ASSERT(aXmlHandler);
164
165           QXmlInputSource source (file);
166           QXmlSimpleReader reader;
167           reader.setContentHandler(aXmlHandler);
168           reader.setErrorHandler(aXmlHandler);
169           bool ok = reader.parse(source);
170           file.close();
171           if (ok) {
172             myHypothesesMap.insert( aXmlHandler->myHypothesesMap.begin(),
173                                     aXmlHandler->myHypothesesMap.end() );
174             myAlgorithmsMap.insert( aXmlHandler->myAlgorithmsMap.begin(),
175                                     aXmlHandler->myAlgorithmsMap.end() );
176             myListOfHypothesesSets.splice( myListOfHypothesesSets.begin(),
177                                            aXmlHandler->myListOfHypothesesSets );
178           }
179           else {
180             SUIT_MessageBox::error1(SMESHGUI::desktop(),
181                                    QObject::tr("INF_PARSE_ERROR"),
182                                    QObject::tr(aXmlHandler->errorProtocol()),
183                                    QObject::tr("SMESH_BUT_OK"));
184           }
185         }
186         else {
187           if (aNoAccessFiles.isEmpty())
188             aNoAccessFiles = xmlFile;
189           else
190             aNoAccessFiles += ", " + xmlFile;
191         }
192       } // end loop
193
194
195       if (!aNoAccessFiles.isEmpty()) {
196         QString aMess = QObject::tr("MESHERS_FILE_CANT_OPEN") + " " + aNoAccessFiles + "\n";
197         aMess += QObject::tr("MESHERS_FILE_CHECK_VARIABLE");
198         wc.suspend();
199         SUIT_MessageBox::warn1(SMESHGUI::desktop(),
200                               QObject::tr("SMESH_WRN_WARNING"),
201                               aMess,
202                               QObject::tr("SMESH_BUT_OK"));
203         wc.resume();
204       }
205     }
206   }
207
208
209   QStringList GetAvailableHypotheses( const bool isAlgo, 
210                                       const int theDim,                          
211                                       const bool isAux )
212   {
213     QStringList aHypList;
214
215     // Init list of available hypotheses, if needed
216     InitAvailableHypotheses();
217
218     // fill list of hypotheses/algorithms
219     THypothesisDataMap* pMap = isAlgo ? &myAlgorithmsMap : &myHypothesesMap;
220     THypothesisDataMap::iterator anIter;
221     for ( anIter = pMap->begin(); anIter != pMap->end(); anIter++ )
222     {
223       HypothesisData* aData = (*anIter).second;
224       if ( ( theDim < 0 || aData->Dim.contains( theDim ) ) && aData->IsAux == isAux )
225         aHypList.append(((*anIter).first).c_str());
226     }
227     return aHypList;
228   }
229
230
231   QStringList GetHypothesesSets()
232   {
233     QStringList aSetNameList;
234
235     // Init list of available hypotheses, if needed
236     InitAvailableHypotheses();
237
238     list<HypothesesSet*>::iterator hypoSet = myListOfHypothesesSets.begin();
239     for ( ; hypoSet != myListOfHypothesesSets.end(); ++hypoSet )
240     {
241       HypothesesSet* aSet = *hypoSet;
242       if ( aSet && aSet->AlgoList.count() ) {
243         aSetNameList.append( aSet->HypoSetName );
244       }
245     }
246
247     return aSetNameList;
248   }
249
250   HypothesesSet* GetHypothesesSet(const QString theSetName)
251   {
252     list<HypothesesSet*>::iterator hypoSet = myListOfHypothesesSets.begin();
253     for ( ; hypoSet != myListOfHypothesesSets.end(); ++hypoSet )
254     {
255       HypothesesSet* aSet = *hypoSet;
256       if ( aSet && aSet->HypoSetName == theSetName )
257         return aSet;
258     }
259     return 0;
260   }
261
262   HypothesisData* GetHypothesisData (const char* aHypType)
263   {
264     HypothesisData* aHypData = 0;
265
266     // Init list of available hypotheses, if needed
267     InitAvailableHypotheses();
268
269     if (myHypothesesMap.find(aHypType) == myHypothesesMap.end()) {
270       if (myAlgorithmsMap.find(aHypType) != myAlgorithmsMap.end()) {
271         aHypData = myAlgorithmsMap[aHypType];
272       }
273     }
274     else {
275       aHypData = myHypothesesMap[aHypType];
276     }
277     return aHypData;
278   }
279
280
281   SMESHGUI_GenericHypothesisCreator* GetHypothesisCreator(const char* aHypType)
282   {
283     if(MYDEBUG) MESSAGE("Get HypothesisCreator for " << aHypType);
284
285     SMESHGUI_GenericHypothesisCreator* aCreator = 0;
286
287     // check, if creator for this hypothesis type already exists
288     if (myHypCreatorMap.find(aHypType) != myHypCreatorMap.end()) {
289       aCreator = myHypCreatorMap[aHypType];
290     }
291     else {
292       // 1. Init list of available hypotheses, if needed
293       InitAvailableHypotheses();
294
295       // 2. Get names of plugin libraries
296       HypothesisData* aHypData = GetHypothesisData(aHypType);
297       if (!aHypData) 
298         return aCreator;
299       QString aClientLibName = aHypData->ClientLibName;
300       QString aServerLibName = aHypData->ServerLibName;
301
302       // 3. Load Client Plugin Library
303       try {
304         // load plugin library
305         if(MYDEBUG) MESSAGE("Loading client meshers plugin library ...");
306         LibHandle libHandle = LoadLib( aClientLibName );
307         if (!libHandle) {
308           // report any error, if occured
309     if ( MYDEBUG )
310     {
311 #ifdef WIN32
312       const char* anError = "Can't load client meshers plugin library";
313 #else
314             const char* anError = dlerror();      
315 #endif
316       MESSAGE(anError);
317     }
318         }
319         else {
320           // get method, returning hypothesis creator
321           if(MYDEBUG) MESSAGE("Find GetHypothesisCreator() method ...");
322           typedef SMESHGUI_GenericHypothesisCreator* (*GetHypothesisCreator) \
323             ( const QString& );
324           GetHypothesisCreator procHandle =
325             (GetHypothesisCreator)GetProc(libHandle, "GetHypothesisCreator");
326           if (!procHandle) {
327             if(MYDEBUG) MESSAGE("bad hypothesis client plugin library");
328             UnLoadLib(libHandle);
329           }
330           else {
331             // get hypothesis creator
332             if(MYDEBUG) MESSAGE("Get Hypothesis Creator for " << aHypType);
333             aCreator = procHandle( aHypType );
334             if (!aCreator) {
335               if(MYDEBUG) MESSAGE("no such a hypothesis in this plugin");
336             }
337             else {
338               // map hypothesis creator to a hypothesis name
339               myHypCreatorMap[aHypType] = aCreator;
340             }
341           }
342         }
343       }
344       catch (const SALOME::SALOME_Exception& S_ex) {
345         SalomeApp_Tools::QtCatchCorbaException(S_ex);
346       }
347     }
348
349     return aCreator;
350   }
351
352
353   SMESH::SMESH_Hypothesis_ptr CreateHypothesis(const char* aHypType,
354                                                const char* aHypName,
355                                                const bool isAlgo)
356   {
357     if(MYDEBUG) MESSAGE("Create " << aHypType << " with name " << aHypName);
358
359     SMESH::SMESH_Hypothesis_var Hyp;
360
361     HypothesisData* aHypData = GetHypothesisData(aHypType);
362     QString aServLib = aHypData->ServerLibName;
363
364     try {
365       Hyp = SMESHGUI::GetSMESHGen()->CreateHypothesis(aHypType, aServLib);
366       if (!Hyp->_is_nil()) {
367         _PTR(SObject) SHyp = SMESH::FindSObject(Hyp.in());
368         if (SHyp) {
369           //if (strcmp(aHypName,"") != 0)
370           if (strlen(aHypName) > 0)
371             SMESH::SetName(SHyp, aHypName);
372           //SalomeApp_Application* app =
373           //  dynamic_cast<SalomeApp_Application*>(SUIT_Session::session()->activeApplication());
374           //if (app)
375           //  app->objectBrowser()->updateTree();
376           SMESHGUI::GetSMESHGUI()->updateObjBrowser();
377           return Hyp._retn();
378         }
379       }
380     }
381     catch (const SALOME::SALOME_Exception & S_ex) {
382       SalomeApp_Tools::QtCatchCorbaException(S_ex);
383     }
384
385     return SMESH::SMESH_Hypothesis::_nil();
386   }
387
388
389   bool AddHypothesisOnMesh (SMESH::SMESH_Mesh_ptr aMesh, SMESH::SMESH_Hypothesis_ptr aHyp)
390   {
391     if(MYDEBUG) MESSAGE ("SMESHGUI::AddHypothesisOnMesh");
392     int res = SMESH::HYP_UNKNOWN_FATAL;
393     SUIT_OverrideCursor wc;
394
395     if (!aMesh->_is_nil()) {
396       _PTR(SObject) SM = SMESH::FindSObject(aMesh);
397       GEOM::GEOM_Object_var aShapeObject = SMESH::GetShapeOnMeshOrSubMesh(SM);
398       try {
399         res = aMesh->AddHypothesis(aShapeObject, aHyp);
400         if (res < SMESH::HYP_UNKNOWN_FATAL) {
401           _PTR(SObject) SH = SMESH::FindSObject(aHyp);
402           if (SM && SH) {
403             SMESH::ModifiedMesh(SM, false);
404           }
405         }
406         if (res > SMESH::HYP_OK) {
407           wc.suspend();
408           processHypothesisStatus(res, aHyp, true);
409           wc.resume();
410         }
411       }
412       catch(const SALOME::SALOME_Exception& S_ex) {
413         wc.suspend();
414         SalomeApp_Tools::QtCatchCorbaException(S_ex);
415         res = SMESH::HYP_UNKNOWN_FATAL;
416       }
417     }
418     return res < SMESH::HYP_UNKNOWN_FATAL;
419   }
420
421
422   bool AddHypothesisOnSubMesh (SMESH::SMESH_subMesh_ptr aSubMesh, SMESH::SMESH_Hypothesis_ptr aHyp)
423   {
424     if(MYDEBUG) MESSAGE("SMESHGUI::AddHypothesisOnSubMesh() ");
425     int res = SMESH::HYP_UNKNOWN_FATAL;
426     SUIT_OverrideCursor wc;
427
428     if (!aSubMesh->_is_nil() && ! aHyp->_is_nil()) {
429       try {
430         SMESH::SMESH_Mesh_var aMesh = aSubMesh->GetFather();
431         _PTR(SObject) SsubM = SMESH::FindSObject(aSubMesh);
432         GEOM::GEOM_Object_var aShapeObject = SMESH::GetShapeOnMeshOrSubMesh(SsubM);
433         if (!aMesh->_is_nil() && SsubM && !aShapeObject->_is_nil()) {
434           res = aMesh->AddHypothesis(aShapeObject, aHyp);
435           if (res < SMESH::HYP_UNKNOWN_FATAL)  {
436             _PTR(SObject) meshSO = SMESH::FindSObject(aMesh);
437             if (meshSO)
438               SMESH::ModifiedMesh(meshSO, false);
439           }
440           if (res > SMESH::HYP_OK) {
441             wc.suspend();
442             processHypothesisStatus(res, aHyp, true);
443             wc.resume();
444           }
445         }
446         else {
447           SCRUTE(aHyp->_is_nil());
448           SCRUTE(aMesh->_is_nil());
449           SCRUTE(!SsubM);
450           SCRUTE(aShapeObject->_is_nil());
451         }
452       }
453       catch(const SALOME::SALOME_Exception& S_ex) {
454         wc.suspend();
455         SalomeApp_Tools::QtCatchCorbaException(S_ex);
456         res = SMESH::HYP_UNKNOWN_FATAL;
457       }
458     }
459     else {
460       SCRUTE(aSubMesh->_is_nil());
461       SCRUTE(aHyp->_is_nil());
462     }
463     return res < SMESH::HYP_UNKNOWN_FATAL;
464   }
465
466   bool RemoveHypothesisOrAlgorithmOnMesh (const Handle(SALOME_InteractiveObject)& IObject)
467   {
468     int res = SMESH::HYP_UNKNOWN_FATAL;
469     SUIT_OverrideCursor wc;
470
471     try {
472       _PTR(Study) aStudy = GetActiveStudyDocument();
473       _PTR(SObject) aHypObj = aStudy->FindObjectID( IObject->getEntry() );
474       if( aHypObj )
475       {
476         _PTR(SObject) MorSM = SMESH::GetMeshOrSubmesh( aHypObj );
477         _PTR(SObject) aRealHypo;
478         if( aHypObj->ReferencedObject( aRealHypo ) )
479         {
480           SMESH_Hypothesis_var hypo = SMESH_Hypothesis::_narrow( SObjectToObject( aRealHypo ) );
481           RemoveHypothesisOrAlgorithmOnMesh( MorSM, hypo );
482         }
483         else
484         {
485           SMESH_Hypothesis_var hypo = SMESH_Hypothesis::_narrow( SObjectToObject( aHypObj ) );
486           SObjectList meshList = GetMeshesUsingAlgoOrHypothesis( hypo );
487           for( int i = 0; i < meshList.size(); i++ )
488             RemoveHypothesisOrAlgorithmOnMesh( meshList[ i ], hypo );
489         }
490       }
491     }
492     catch(const SALOME::SALOME_Exception& S_ex)
493     {
494       wc.suspend();
495       SalomeApp_Tools::QtCatchCorbaException(S_ex);
496       res = SMESH::HYP_UNKNOWN_FATAL;
497     }
498     return res < SMESH::HYP_UNKNOWN_FATAL;
499   }
500
501   bool RemoveHypothesisOrAlgorithmOnMesh (_PTR(SObject) MorSM,
502                                           SMESH::SMESH_Hypothesis_ptr anHyp)
503   {
504     SALOMEDS::GenericAttribute_var anAttr;
505     SALOMEDS::AttributeIOR_var anIOR;
506     int res = SMESH::HYP_UNKNOWN_FATAL;
507     SUIT_OverrideCursor wc;
508
509     if (MorSM) {
510       try {
511         GEOM::GEOM_Object_var aShapeObject = SMESH::GetShapeOnMeshOrSubMesh(MorSM);
512         if (!aShapeObject->_is_nil()) {
513           SMESH::SMESH_Mesh_var aMesh = SMESH::SObjectToInterface<SMESH::SMESH_Mesh>(MorSM);
514           SMESH::SMESH_subMesh_var aSubMesh = SMESH::SObjectToInterface<SMESH::SMESH_subMesh>(MorSM);
515
516           if (!aSubMesh->_is_nil())
517             aMesh = aSubMesh->GetFather();
518
519           if (!aMesh->_is_nil()) {
520             res = aMesh->RemoveHypothesis(aShapeObject, anHyp);
521             if (res < SMESH::HYP_UNKNOWN_FATAL) {
522               _PTR(SObject) meshSO = SMESH::FindSObject(aMesh);
523               if (meshSO)
524                 SMESH::ModifiedMesh(meshSO, false);
525             }
526             if (res > SMESH::HYP_OK) {
527               wc.suspend();
528               processHypothesisStatus(res, anHyp, false);
529               wc.resume();
530             }
531           }
532         }
533       } catch(const SALOME::SALOME_Exception& S_ex) {
534         wc.suspend();
535         SalomeApp_Tools::QtCatchCorbaException(S_ex);
536         res = SMESH::HYP_UNKNOWN_FATAL;
537       }
538     }
539     return res < SMESH::HYP_UNKNOWN_FATAL;
540   }
541
542   SObjectList GetMeshesUsingAlgoOrHypothesis(SMESH::SMESH_Hypothesis_ptr AlgoOrHyp)
543   {
544     SObjectList listSOmesh;
545     listSOmesh.resize(0);
546
547     unsigned int index = 0;
548     if (!AlgoOrHyp->_is_nil()) {
549       _PTR(SObject) SO_Hypothesis = SMESH::FindSObject(AlgoOrHyp);
550       if (SO_Hypothesis) {
551         SObjectList listSO =
552           SMESHGUI::activeStudy()->studyDS()->FindDependances(SO_Hypothesis);
553
554         if(MYDEBUG) MESSAGE("SMESHGUI::GetMeshesUsingAlgoOrHypothesis(): dependency number ="<<listSO.size());
555         for (unsigned int i = 0; i < listSO.size(); i++) {
556           _PTR(SObject) SO = listSO[i];
557           if (SO) {
558             _PTR(SObject) aFather = SO->GetFather();
559             if (aFather) {
560               _PTR(SObject) SOfatherFather = aFather->GetFather();
561               if (SOfatherFather) {
562                 if(MYDEBUG) MESSAGE("SMESHGUI::GetMeshesUsingAlgoOrHypothesis(): dependency added to list");
563                 index++;
564                 listSOmesh.resize(index);
565                 listSOmesh[index - 1] = SOfatherFather;
566               }
567             }
568           }
569         }
570       }
571     }
572     if (MYDEBUG) MESSAGE("SMESHGUI::GetMeshesUsingAlgoOrHypothesis(): completed");
573     return listSOmesh;
574   }
575
576 #define CASE2MESSAGE(enum) case SMESH::enum: msg = QObject::tr( #enum ); break;
577   QString GetMessageOnAlgoStateErrors(const algo_error_array& errors)
578   {
579     QString resMsg = QObject::tr("SMESH_WRN_MISSING_PARAMETERS") + ":\n";
580     for ( int i = 0; i < errors.length(); ++i ) {
581       const SMESH::AlgoStateError & error = errors[ i ];
582       QString msg;
583       switch( error.name ) {
584         CASE2MESSAGE( MISSING_ALGO );
585         CASE2MESSAGE( MISSING_HYPO );
586         CASE2MESSAGE( NOT_CONFORM_MESH );
587       default: continue;
588       }
589       // apply args to message:
590       // %1 - algo name
591       if ( error.algoName.in() != 0 )
592         msg = msg.arg( error.algoName.in() );
593       // %2 - dimention
594       msg = msg.arg( error.algoDim );
595       // %3 - global/local
596       msg = msg.arg( QObject::tr( error.isGlobalAlgo ? "GLOBAL_ALGO" : "LOCAL_ALGO" ));
597       // %4 - hypothesis dim == algoDim
598       msg = msg.arg( error.algoDim );
599
600       if ( i ) resMsg += ";\n";
601       resMsg += msg;
602     }
603     return resMsg;
604   }
605
606 }