doc/salome/gui/GEOM/input/import_export.doc

   1 /*!
   2
   3 \page import_export_geom_obj_page Importing/exporting geometrical objects
   4
   5 In Geometry module you can import and export geometrical objects
   6 from/into BREP, IGES, STEP, ACIS and STL files. The mechanisms of import and export
   7 are implemented via plug-ins, which gives the opportunity to
   8 expand the range of available formats by adding more plug-ins (for
   9 example, CATIA 5).
  10
  11 The \subpage xao_format_page "import and export of shapes in XAO format" is implemented differently.
  12
  13 \note If a plugin supports import of materials associated with shapes, these
  14 shapes are grouped corresponding to the imported materials. For the moment STEP
  15 import is the only plugin that supports this feature.
  16
  17 <em>To import geometrical objects from a BREP, IGES, STEP, ACIS or STL file:</em>
  18
  19 \par
  20 From the \b File menu choose \b Import. In the opening dialog box \b Import
  21 select the required format of the file for importation and search for
  22 a *.brep, *.iges, *.step, *.sat or *.stl file.
  23
  24 \image html geomimport.png
  25
  26 \par
  27 Select the required file and click \b Open. Your file will be imported in
  28 the module and its contents (geometrical object) will be displayed in
  29 the <b>Object Browser</b>.
  30
  31 \note If the selected file is in IGES or STEP format and the length
  32 is not expressed in meters, it will be asked whether to take or not these
  33 units into account (see the picture below). This feature can be
  34 helpful if some wrong units have been written to the IGES or STEP file by a
  35 3rd-party software.
  36
  37 \image html iges_unit.png
  38
  39 \par
  40
  41 \note If the selected file is in ACIS format (the use of this format
  42 requires licensing) and the file contains names for some shapes, it
  43 will be suggested to create groups by types (solid, face, edge and
  44 vertex) for all named shapes:
  45
  46 \image html sat_named_shapes.png
  47
  48 \par
  49
  50 \note It is possible to re-open from the initial file a previously imported shape if
  51 the file has been changed on disk. For this, select
  52 <b>Reload From Disk</b> in the context menu of the imported
  53 shape. The reloaded shape will have the same representation parameters
  54 as before this operation.
  55
  56 \image html geomimport_reopen.png
  57
  58 \n <em>To export geometrical objects into a BREP, IGES, STEP, ACIS or STL
  59 file:</em>
  60
  61 \par
  62 Select the object you wish to export, then from the \b File menu choose
  63 \b Export. In the opening dialog box \b Export define the required format,
  64 the name and the location of the file for exportation.
  65
  66 \image html geomexport.png
  67
  68 \par
  69 Click \b Save to confirm your exportation.
  70
  71 Our <b>TUI Scripts</b> provide you with useful examples of the use of
  72 \ref tui_import_export_page
  73
  74 */
  75