Salome HOME
0022468: [CEA 1048] IMP GEOM: creating groups on materials at STEP import
[modules/geom.git] / doc / salome / gui / GEOM / input / import_export.doc
index 8a5219ebee2af6fc6036ace6d9554b9a864dbd9b..50b79203064ef34c7ac81faabc61c7d22e630ddb 100644 (file)
@@ -3,17 +3,23 @@
 \page import_export_geom_obj_page Importing/exporting geometrical objects
 
 In Geometry module you can import and export geometrical objects
-from/into BREP, IGES, STEP files. The mechanisms of import and export
-are implemented via plug-ins, which gives you the opportunity to
+from/into BREP, IGES, STEP, ACIS and STL files. The mechanisms of import and export
+are implemented via plug-ins, which gives the opportunity to
 expand the range of available formats by adding more plug-ins (for
 example, CATIA 5).
 
-<em>To import geometrical objects from a BREP, IGES, STEP file:</em>
+The \subpage xao_format_page "import and export of shapes in XAO format" is implemented differently.
+
+\note If a plugin supports import of materials associated with shapes, these
+shapes are grouped corresponding to the imported materials. For the moment STEP
+import is the only plugin that supports this feature.
+
+<em>To import geometrical objects from a BREP, IGES, STEP, ACIS or STL file:</em>
 
 \par
 From the \b File menu choose \b Import. In the opening dialog box \b Import
 select the required format of the file for importation and search for
-a *.brep, *.iges or *.step  file.
+a *.brep, *.iges, *.step, *.sat or *.stl file.
 
 \image html geomimport.png
 
@@ -22,7 +28,34 @@ Select the required file and click \b Open. Your file will be imported in
 the module and its contents (geometrical object) will be displayed in
 the <b>Object Browser</b>.
 
-\n <em>To export geometrical objects into a BREP, IGES, STEP
+\note If the selected file is in IGES or STEP format and the length
+is not expressed in meters, it will be asked whether to take or not these
+units into account (see the picture below). This feature can be
+helpful if some wrong units have been written to the IGES or STEP file by a
+3rd-party software.
+
+\image html iges_unit.png
+
+\par
+
+\note If the selected file is in ACIS format (the use of this format
+requires licensing) and the file contains names for some shapes, it
+will be suggested to create groups by types (solid, face, edge and
+vertex) for all named shapes:
+
+\image html sat_named_shapes.png
+
+\par
+
+\note It is possible to re-open from the initial file a previously imported shape if
+the file has been changed on disk. For this, select
+<b>Reload From Disk</b> in the context menu of the imported
+shape. The reloaded shape will have the same representation parameters
+as before this operation.
+
+\image html geomimport_reopen.png
+
+\n <em>To export geometrical objects into a BREP, IGES, STEP, ACIS or STL
 file:</em>
 
 \par
@@ -35,5 +68,8 @@ the name and the location of the file for exportation.
 \par
 Click \b Save to confirm your exportation.
 
+Our <b>TUI Scripts</b> provide you with useful examples of the use of
+\ref tui_import_export_page
+
 */