Salome HOME
[bos #29336] problem in inertia calculus
[modules/geom.git] / doc / salome / gui / GEOM / input / extension_operation.doc
1 /*!
2
3 \page extension_operation_page Extension 
4
5 \n To produce an \b Extension of an Edge or a Face select in the <b>Main Menu</b> 
6 <b>Operations - > Transformation - > Extension</b>. The type of extension is defined using the radio buttons.
7
8 Firstly it is possible to resize an \b Edge by modifying its first
9 and last parameters
10
11 \image html extension1.png "Edge Extension" 
12
13 \n <b>TUI Command:</b> <em>geompy.ExtendEdge(theEdge, theMin, theMax)</em>,
14 where \em theEdge the input edge to be resized, \em theMin the minimal
15 parameter value, \em theMax the maximal parameter value.
16 \n <b>Arguments:</b> Name + Object (Edge) + 2 values (Min and Max Parameters).
17
18 \n <b>Example:</b>
19
20 \image html extend_edge_example.png "Original edge (white) and extended edge"
21
22 \note The input Edge parameters range is [0, 1]. If \b theMin parameter is
23       negative, the input Edge is extended, otherwise it is shrinked by
24       \b theMin parameter. If \b theMax is greater than 1, the Edge is
25       extended, otherwise it is shrinked by \b theMax parameter.
26         
27 Secondly it is possible to resize a \b Face by modifying its 
28 minimal and maximal U- and V-Parameters. 
29
30  \image html extension2.png "Face Extension" 
31  
32 \n <b>TUI Command:</b> <em>geompy.ExtendFace(theFace, theUMin, theUMax,
33 theVMin, theVMax)</em>, where \em theFace the input face to be resized,
34 \em theUMin the minimal U-Parameter value, \em theUMax the maximal U-Parameter
35 value, \em theVMin the minimal V-Parameter value, \em theVMax the maximal
36 V-Parameter value.
37 \n <b>Arguments:</b> Name + Object (Face) + 4 values (Min and Max U- and
38 V-Parameters).
39
40
41 \n <b>Example:</b>
42
43 \image html extend_face_example.png "The original face (gray) and a result face shrinked along U-Direction and extended along V-Direction"
44
45 \note The input Face U- and V-Parameters range is [0, 1]. If \b theUMin
46       parameter is negative, the input Face is extended, otherwise it is
47       shrinked along U-Direction by \b theUMin parameter. If \b theUMax is
48       greater than 1, the Face is extended, otherwise it is shrinked along
49       U-Direction by \b theUMax parameter. The same applies to \b theVMin, \b theVMax
50       and V-Direction of the input Face.
51
52 Our <b>TUI Scripts</b> provide you with useful examples of the use of
53 \ref tui_extend "Extension Operations".
54
55 */