doc/salome/gui/GEOM/input/modify_location_operation.doc

   1 /*!
   2
   3 \page modify_location_operation_page Modify the Location
   4
   5 \n To <b>Modify the Location</b> in the <b>Main Menu</b> select
   6 <b>Operations - > Transformation - > Modify the Location</b>.
   7
   8 \n This operation modifies the \b Location of \b Objects.
   9
  10 \n The first algorithm places the object(s) so that its center coincides
  11 with the origin of the Local Coordinate System.
  12 \n <b>Create a copy</b> checkbox allows to keep the initial objects, otherwise they
  13 will be removed.
  14 \n <b>Arguments:</b> Name + one or several objects + End Coordinate System.
  15
  16 \image html transformation5.png
  17
  18 \n In the picture the initial cube with the global coordinate system
  19 is to the right and the modified cube with the Local Coordinate
  20 System in the center of it is to the left .
  21
  22 \image html image30.gif
  23
  24 \n The second algorithm  modifies the location of an object using Start
  25 and End LSC, although the final position of the object will not
  26 coincide with the center of  either of the two systems. In this method
  27 the object is shifted from its initial position by the value of the
  28 remainder after subtraction of the coordinates of the Start LSC from
  29 the coordinates of the End LSC.
  30 \n <b>Create a copy</b> checkbox allows to keep the initial object,
  31 otherwise it will be removed.
  32 \n <b>Arguments:</b> Name + one or several objects + Start Coordinate System + End
  33 Coordinate System.
  34
  35 \image html transformation6.png
  36
  37 In this picture we see the initial cube with the global coordinate
  38 system and two LCS: LocalCS1 (GCS+100 along x-axis) and LocalCS2
  39 (GCS+200 along x-axis)
  40
  41 \image html image1.gif
  42
  43 Selecting Start LCS = LCS1 and End LCS = LCS2, we obtain the
  44 translated cube at the position (100;0;0)
  45
  46 \image html image2.gif
  47
  48 Selecting Start LCS = LCS2 and End LCS = LCS1, we obtain the
  49 translated cube at the position (-100;0;0)
  50
  51 \image html image4.gif
  52
  53 \n <b>TUI Command:</b> <em>geompy.MakePosition(theObject, theStartLCS,
  54 theEndLCS),</em>  where \em theObject is a shape, location of which is
  55 modified, \em theStartLCS is a location to move the shape from, \em
  56 theEndLCS is a location to move the shape to.
  57
  58 \n Our <b>TUI Scripts</b> provide you with useful examples of the use
  59 of \ref tui_translation "Transformation Operations".
  60
  61 */