From 5fac63df82eed6f8873716bf0bed64ad38bae2d5 Mon Sep 17 00:00:00 2001
From: maintenance team <salome-mnt@opencascade.com>
Date: Mon, 5 Nov 2007 08:33:24 +0000
Subject: [PATCH] Common update

---
 doc/salome/gui/GEOM/chamfer.htm               | 136 ++++++++++++++----
 doc/salome/gui/GEOM/fillet.htm                |  20 ++-
 .../gui/GEOM/viewing_geometrical_objects.htm  |  34 +++--
 3 files changed, 145 insertions(+), 45 deletions(-)

diff --git a/doc/salome/gui/GEOM/chamfer.htm b/doc/salome/gui/GEOM/chamfer.htm
index 573ad682f..735228f20 100755
--- a/doc/salome/gui/GEOM/chamfer.htm
+++ b/doc/salome/gui/GEOM/chamfer.htm
@@ -17,12 +17,15 @@ if (navigator.appName !="Netscape")
 img_whs1 { width:20px; height:20px; border-style:none; }
 p.whs2 { font-size:12pt; }
 p.whs3 { font-size:12pt; margin-left:40px; }
-img_whs4 { border:none; width:312px; height:319px; float:none; border-style:none; }
+img_whs4 { border:none; width:400px; height:319px; float:none; border-style:none; }
 img_whs5 { border:none; width:225px; height:239px; float:none; border-style:none; }
-img_whs6 { border:none; width:312px; height:381px; float:none; border-style:none; }
+img_whs6 { border:none; width:400px; height:426px; float:none; border-style:none; }
 img_whs7 { border:none; width:230px; height:245px; float:none; border-style:none; }
 img_whs8 { border:none; width:221px; height:238px; float:none; border-style:none; }
 p.whs9 { list-style:disc; margin-left:0in; margin-right:0in; margin-top:0px; margin-bottom:0px; }
+p.whs10 { list-style:disc; margin-left:0in; margin-right:0in; margin-top:0px; margin-bottom:0px; font-size:12pt; }
+p.whs11 { list-style:disc; margin-right:0in; margin-top:0px; margin-bottom:0px; font-size:12pt; margin-left:40px; }
+img_whs12 { border:none; width:400px; height:426px; float:none; }
 -->
 </style><script type="text/javascript" language="JavaScript">
 <!--
@@ -30,6 +33,8 @@ if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))
 {
   var strNSS = "<style type='text/css'>";
   strNSS += "p.whs9 {margin-left:1pt;margin-right:1pt;margin-top:1pt;margin-bottom:1pt; }";
+  strNSS += "p.whs10 {margin-left:1pt;margin-right:1pt;margin-top:1pt;margin-bottom:1pt; }";
+  strNSS += "p.whs11 {margin-right:1pt;margin-top:1pt;margin-bottom:1pt; }";
   strNSS +="</style>";
   document.write(strNSS);
 }
@@ -119,35 +124,67 @@ if (window.writeIntopicBar)
  chamfer. &nbsp;</p>
 
 <p class="whs2"><b style="font-weight: bold;">TUI Command:</b><i> 
- </i><span style="font-style: italic;"><I>geompy.MakeChamferAll(Shape, D)</I></span> 
- </p>
+ </i><span style="font-style: italic;"><I>geompy.MakeChamferAll(Shape, 
+ D)</I></span> </p>
 
 <p class="whs2"><b style="font-weight: bold;">Arguments: </b>Name 
  + 1 SHAPE + 1 value (Chamfer dimension).</p>
 
 <p class="whs2">&nbsp;</p>
 
-<p class="whs3"><img src="pics/chamfer1.png" x-maintain-ratio="TRUE" width="312px" height="319px" border="0" class="img_whs4"> &nbsp;<img src="pics/chamfer_all.png" x-maintain-ratio="TRUE" width="225px" height="239px" border="0" class="img_whs5"></p>
+<p class="whs3"><img src="pics/chamfer1.png" x-maintain-ratio="TRUE" width="400px" height="319px" border="0" class="img_whs4"> &nbsp;<img src="pics/chamfer_all.png" x-maintain-ratio="TRUE" width="225px" height="239px" border="0" class="img_whs5"></p>
 
 <p class="whs2">&nbsp;</p>
 
-<p class="whs2">To create chamfer on the specified edges of 
- the given shape, &nbsp;you 
+<p class="whs2">In the algorithms below there exist two ways 
+ to define the <span style="font-weight: bold;"><B>Dimension</B></span> of the 
+ Chamfer.</p>
+
+<p class="whs2">Firstly the <span style="font-weight: bold;"><B>Dimension</B></span> 
+ can be defined via <span style="font-weight: bold;"><B>D1</B></span> 
+ and <span style="font-weight: bold;"><B>D2</B></span>, 
+ which represent the offset on the first and the second face forming the 
+ edge. </p>
+
+<p class="whs2">Secondly the <span style="font-weight: bold;"><B>Dimension</B></span> 
+ can be defined via <span style="font-weight: bold;"><B>D,</B></span> which represents 
+ the offset on the first face, and the <span style="font-weight: bold;"><B>Angle,</B></span> 
+ which is the angle between the first face and the chamfer plane. </p>
+
+<p class="whs2">&nbsp;</p>
+
+<p class="whs2">To create chamfer on the edges lying between 
+ the specified faces of the given shape, &nbsp;you 
  need to define the <span style="font-weight: bold;"><B>Main Object</B></span> 
- to create a fillet on, select the two faces to which belongs the <span 
- style="font-size: 12pt;"><font size=3 style="font-size:12pt;">necessary common edge in the viewer and define 
- the </font></span><span style="font-size: 12pt; font-weight: bold;"><font size=3 style="font-size:12pt;"><B>Dimension</B></font></span><span 
- style="font-size: 12pt;"><font size=3 style="font-size:12pt;"> of the Chamfer.</font></span></p>
+ to create a fillet on, select the two (or more) faces to which belongs 
+ the necessary common edge(s) 
+ in the viewer and define the <span style="font-weight: bold;"><B>Dimension</B></span> 
+ of the Chamfer.</p>
+
+<p class="whs2"><b>TUI Command:</b><i> </i><span style="font-style: italic;"><I>geompy.MakeChamferEdge(Shape, 
+ D1, D2, 
+ Face1, Face2)</I></span>, 
+ where Shape is a shape to create a chamfer on, D1 
+ is a chamfer size along Face1, 
+ D2 is a chamfer 
+ size along Face2 
+ and Face1 and 
+ Face2 are indices 
+ of faces in Shape.</p>
 
-<p class="whs2"><b style="font-weight: bold;">TUI Command:</b><i> 
- </i><span style="font-style: italic;"><I>geompy.MakeChamferEdge(Shape, D1, 
- D2, Face1, Face2)</I></span>, where Shape is a shape to create a chamfer on, 
- D1 is a chamfer size along Face1, D2 is a chamfer size along Face2, Face1 
- and Face2 are indices of faces in Shape.</p>
+<p class="whs2">&nbsp;</p>
+
+<p class="whs2"><b>Alternative TUI Command:</b><i> </i><span 
+ style="font-style: italic;"><I>geompy.MakeChamferEdge(Shape, 
+ D, Angle, Face1, 
+ Face2), where 
+ </I></span>D is a chamfer size along Face1 
+ and Angle is the angle between Face1 
+ and the chamfer plane.</p>
 
 <p class="whs2">&nbsp;</p>
 
-<p class="whs3"><img src="pics/chamfer2.png" x-maintain-ratio="TRUE" width="312px" height="381px" border="0" class="img_whs6"> &nbsp;<img src="pics/chamfer_edge.png" x-maintain-ratio="TRUE" width="230px" height="245px" border="0" class="img_whs7"></p>
+<p class="whs3"><img src="pics/chamfer2.png" x-maintain-ratio="TRUE" width="400px" height="426px" border="0" class="img_whs6"> &nbsp;<img src="pics/chamfer_edge.png" x-maintain-ratio="TRUE" width="230px" height="245px" border="0" class="img_whs7"></p>
 
 <p class="whs2">&nbsp;</p>
 
@@ -157,22 +194,67 @@ if (window.writeIntopicBar)
  to create a fillet on, select the necessary faces the OCC Viewer and define 
  the <span style="font-weight: bold;"><B>Dimension</B></span> of the Chamfer.</p>
 
-<p class="whs2"><b style="font-weight: bold;">TUI Command:</b><i> 
- </i><span style="font-style: italic;"><I>geompy.MakeChamferFaces(Shape, D1, 
- D2, ListOfFaceID)</I></span>, where Shape is a shape to create chamfer on, 
- D1 is a chamfer size along a face from &nbsp;ListOfFaceID, 
- &nbsp;D2 is a 
- chamfer size along two faces connected to the edge to which the chamfer 
- is applied, ListOfFaceID is a list of indices of faces in Shape.</p>
+<p class="whs2"><b>TUI Command:</b><i> </i><span style="font-style: italic;"><I>geompy.MakeChamferFaces(Shape, 
+ D1, D2, 
+ ListOfFaceID)</I></span>, 
+ where Shape is a shape to create chamfer on, D1 
+ and D2 &nbsp;are 
+ chamfer sizes along faces from &nbsp;ListOfFaceID. 
+ For each Edge Face1 
+ and Face2 are 
+ defined basing on their indices. </p>
+
+<p class="whs2">&nbsp;</p>
+
+<p class="whs2"><b>Alternative TUI Command:</b><i> </i><span 
+ style="font-style: italic;"><I>geompy.MakeChamferFaces(Shape, 
+ D, Angle, ListOfFaceID), 
+ where </I></span>D is a chamfer size along Face1 
+ and Angle is the angle between Face1 
+ and the chamfer plane.</p>
 
 <p class="whs2">&nbsp;</p>
 
-<p class="whs3"><img src="pics/chamfer3.png" x-maintain-ratio="TRUE" width="312px" height="381px" border="0" class="img_whs6"> &nbsp;<img src="pics/chamfer_faces.png" x-maintain-ratio="TRUE" width="221px" height="238px" border="0" class="img_whs8"></p>
+<p class="whs3"><img src="pics/chamfer3.png" x-maintain-ratio="TRUE" width="400px" height="426px" border="0" class="img_whs6"> &nbsp;<img src="pics/chamfer_faces.png" x-maintain-ratio="TRUE" width="221px" height="238px" border="0" class="img_whs8"></p>
 
 <p class="whs3">&nbsp;</p>
 
-<p class="whs9">&nbsp;&nbsp;<span 
- style="font-size: 12pt;"><font size=3 style="font-size:12pt;">Our </font></span><span 
+<p class="whs9">To create chamfer on an arbitrary set 
+ of edges of the given shape <span style="font-size: 12pt;"><font size=3 style="font-size:12pt;">you need to 
+ define the </font></span><span style="font-weight: bold;"><B>Main Object</B></span><span 
+ style="font-size: 12pt;"><font size=3 style="font-size:12pt;"> to create a fillet on, select the necessary 
+ edges in the OCC Viewer and define the </font></span><span style="font-weight: bold;"><B>Dimension</B></span><span 
+ style="font-size: 12pt;"><font size=3 style="font-size:12pt;"> of the Chamfer.</font></span> &nbsp;&nbsp;</p>
+
+<p class="whs9"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"><b>TUI 
+ Command:</b><i> </i></font></span><span style="font-style: italic;"><I>geompy.MakeChamferEdges(Shape, 
+ D1, D2, 
+ ListOfEdgeID)</I></span><span 
+ style="font-size: 12pt;"><font size=3 style="font-size:12pt;">, where Shape is a shape to create a chamfer 
+ on, D1 and 
+ D2 are chamfer 
+ sizes faces defined by the algorithm basing on ListOfEdgeID, 
+ which is a list of &nbsp;indices 
+ of edges in Shape. For each Edge the algorithm selects Face1 
+ and Face2 basing 
+ on their indices. </font></span></p>
+
+<p class="whs9">&nbsp;</p>
+
+<p class="whs10"><b>Alternative TUI Command:</b><i> </i><span 
+ style="font-style: italic;"><I>geompy.MakeChamferEdges(Shape, 
+ D, Angle, ListOfEdgeID), 
+ where </I></span>D is a chamfer size along Face1 
+ and Angle is the angle between Face1 
+ and the chamfer plane.</p>
+
+<p class="whs9">&nbsp;</p>
+
+<p class="whs11"><img src="pics/chamfer4.png" x-maintain-ratio="TRUE" width="400px" height="426px" border="0" class="img_whs12"></p>
+
+<p class="whs9">&nbsp;</p>
+
+<p class="whs9"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;">Our </font></span><span 
  style="font-weight: bold;"><B>TUI Scripts</B></span><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"> 
  provide you with useful examples of the use of <a href="transformation_operations.htm#bookmark4">Transformation 
  Operations</a>. </font></span></p>
diff --git a/doc/salome/gui/GEOM/fillet.htm b/doc/salome/gui/GEOM/fillet.htm
index 611536ba5..817448ff4 100755
--- a/doc/salome/gui/GEOM/fillet.htm
+++ b/doc/salome/gui/GEOM/fillet.htm
@@ -18,7 +18,7 @@ img_whs1 { width:20px; height:20px; border-style:none; }
 p.whs2 { font-size:12pt; }
 p.whs3 { font-size:12pt; margin-left:40px; }
 img_whs4 { border:none; width:312px; height:315px; float:none; border-style:none; }
-img_whs5 { border:none; width:312px; height:346px; float:none; border-style:none; }
+img_whs5 { border:none; width:400px; height:376px; float:none; }
 p.whs6 { font-size:12pt; font-style:italic; margin-left:40px; }
 img_whs7 { border:none; width:226px; height:250px; float:none; border-style:none; }
 img_whs8 { border:none; float:none; width:208px; height:250px; border-style:none; }
@@ -118,7 +118,8 @@ if (window.writeIntopicBar)
  of the Fillet. &nbsp;</p>
 
 <p class="whs2"><b style="font-weight: bold;">TUI Command:</b><i> 
- </i>geompy.MakeFilletAll(Shape, R) </p>
+ </i>geompy.MakeFilletAll(Shape, 
+ R) </p>
 
 <p class="whs2"><span style="font-style: italic;"><I><b style="font-weight: bold;">A</I></span><span 
  style="font-weight: bold;"><B>rguments: </B></span></b>Name + 1 shape + 1 value 
@@ -138,7 +139,9 @@ if (window.writeIntopicBar)
  of the Fillet. </p>
 
 <p class="whs2"><span style="font-style: italic;"><I><b style="font-weight: bold; font-style: normal;">TUI 
- Command:</b><i> </i>geompy.MakeFillet(Shape, R, ShapeType, ListShapes) 
+ Command:</b><i> </i>geompy.MakeFillet(Shape, 
+ R, ShapeType, 
+ ListShapes) 
  </I></span></p>
 
 <p class="whs2"><span style="font-style: italic;"><I><b style="font-weight: bold;">A</I></span><span 
@@ -147,7 +150,16 @@ if (window.writeIntopicBar)
 
 <p class="whs2">&nbsp;</p>
 
-<p class="whs3"><img src="pics/fillet2.png" x-maintain-ratio="TRUE" width="312px" height="346px" border="0" class="img_whs5"> &nbsp;<img src="pics/fillet3.png" x-maintain-ratio="TRUE" width="312px" height="346px" border="0" class="img_whs5"></p>
+<p class="whs2">Alternatively, there is a possibility to create 
+ a fillet with a variable radius. For this, toggle the lower radio button 
+ and define <span style="font-weight: bold;"><B>R1</B></span> 
+ (the radius at the start of the selected edge(s)) 
+ and <span style="font-weight: bold;"><B>R2</B></span> 
+ (the radius at the end of the selected edge(s))</p>
+
+<p class="whs2">&nbsp;</p>
+
+<p class="whs3"><img src="pics/fillet2.png" x-maintain-ratio="TRUE" width="400px" height="376px" border="0" class="img_whs5"> &nbsp;<img src="pics/fillet3.png" x-maintain-ratio="TRUE" width="400px" height="376px" border="0" class="img_whs5"></p>
 
 <p class="whs2">&nbsp; </p>
 
diff --git a/doc/salome/gui/GEOM/viewing_geometrical_objects.htm b/doc/salome/gui/GEOM/viewing_geometrical_objects.htm
index 98ac4090b..39df73592 100755
--- a/doc/salome/gui/GEOM/viewing_geometrical_objects.htm
+++ b/doc/salome/gui/GEOM/viewing_geometrical_objects.htm
@@ -14,12 +14,13 @@ if (navigator.appName !="Netscape")
 </script>
 <style type="text/css">
 <!--
-img_whs1 { border:none; width:340px; height:308px; border-style:none; }
-ul.whs2 { list-style:disc; }
-p.whs3 { font-weight:bold; }
-img_whs4 { border:none; width:26px; height:26px; border-style:none; }
-img_whs5 { border:none; width:23px; height:24px; border-style:none; }
-img_whs6 { border:none; width:279px; height:230px; border-style:none; }
+p.whs1 { margin-left:40px; }
+img_whs2 { border:none; width:187px; height:288px; float:none; border-style:none; }
+ul.whs3 { list-style:disc; }
+p.whs4 { font-weight:bold; }
+img_whs5 { border:none; width:26px; height:26px; border-style:none; }
+img_whs6 { border:none; width:23px; height:24px; border-style:none; }
+img_whs7 { border:none; width:279px; height:230px; border-style:none; }
 -->
 </style><script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">
 <!--
@@ -80,6 +81,8 @@ if (window.writeIntopicBar)
 	writeIntopicBar(4);
 //-->
 </script>
+<h1>&nbsp;</h1>
+
 <h1>Viewing Geometrical Objects</h1>
 
 <p>Newly created geometrical objects are automatically displayed in the 
@@ -96,17 +99,20 @@ if (window.writeIntopicBar)
 
 <p>&nbsp;</p>
 
-<p><img src="image1.jpg" width="340px" height="308px" border="0" class="img_whs1"></p>
+<p class="whs1"><img src="pics/dialog.png" x-maintain-ratio="TRUE" width="187px" height="288px" border="0" class="img_whs2"></p>
 
 <p>&nbsp;</p>
 
-<ul type="disc" class="whs2">
+<ul type="disc" class="whs3">
 	
 	<li class=kadov-p><p><span style="font-weight: bold;"><B>Rename - </B></span>allows 
  to change the name of the geometrical object.<span style="font-weight: bold;"> 
  <B></B></span></p></li>
 	
-	<li class=kadov-p><p class="whs3"><a href="wireframe_and_shading.htm">Display 
+	<li class=kadov-p><p><span style="font-weight: bold;"><B>Delete - </B></span>irreversibly 
+ deletes the selected object from the viewer and from the Object Browser</p></li>
+	
+	<li class=kadov-p><p class="whs4"><a href="wireframe_and_shading.htm">Display 
  Mode</a> - <span style="font-weight: normal;">allows to select between 
  Wireframe and Shading presentation.</span></p></li>
 	
@@ -122,15 +128,15 @@ if (window.writeIntopicBar)
  - allows to <span style="font-size: 12pt;"><font size=3 style="font-size:12pt;">change the number of isolines 
  displayed within a shape.</font></span></p></li>
 	
-	<li class=kadov-p><p><span style="font-weight: bold;"><B><img src="image18.gif" width="26px" height="26px" border="0" class="img_whs4"> Erase</B></span> - allows to hide the selected geometrical object 
+	<li class=kadov-p><p><span style="font-weight: bold;"><B><img src="image18.gif" width="26px" height="26px" border="0" class="img_whs5"> Hide</B></span> - allows to hide the selected geometrical object 
  from the viewer. <b><span style="font-size: 12pt; font-weight: normal;"><font size=3 style="font-size:12pt;">TUI 
  Command</font></span><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"> :</b><i> sg.EraseOnly(ID)</i></font></span></p></li>
 	
-	<li class=kadov-p><p><span style="font-weight: bold;"><B><img src="image26.gif" width="26px" height="26px" border="0" class="img_whs4"> Erase all</B></span> &nbsp;- 
+	<li class=kadov-p><p><span style="font-weight: bold;"><B><img src="image26.gif" width="26px" height="26px" border="0" class="img_whs5"> Hide all</B></span> &nbsp;- 
  allows to hide all objects from the viewer. <span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"><b 
  style="font-weight: normal;">TUI Command:</b><i> sg.EraseAll()</i></font></span></p></li>
 	
-	<li class=kadov-p><p><span style="font-weight: bold;"><B><img src="image33.gif" width="23px" height="24px" border="0" class="img_whs5"> Display Only</B></span> -allows to display only the selected 
+	<li class=kadov-p><p><span style="font-weight: bold;"><B><img src="image33.gif" width="23px" height="24px" border="0" class="img_whs6"> Display Only</B></span> -allows to display only the selected 
  geometrical object, hiding all other from the viewer. <span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"><b 
  style="font-weight: normal;">TUI Command:</b><i> sg.DisplayOnly(ID)</i></font></span></p></li>
 	
@@ -154,11 +160,11 @@ if (window.writeIntopicBar)
 
 <p>&nbsp;</p>
 
-<p><img src="image2.jpg" width="279px" height="230px" border="0" class="img_whs6"></p>
+<p class="whs1"><img src="image2.jpg" width="279px" height="230px" border="0" class="img_whs7"></p>
 
 <p>&nbsp;</p>
 
-<ul type="disc" class="whs2">
+<ul type="disc" class="whs3">
 	
 	<li class=kadov-p><p><span style="font-weight: bold;"><B>Select Only</B></span> 
  provides a filter for exclusive selection of objects of a certain type. 
-- 
2.39.2