Std Open: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(<nowiki>=</nowiki> Instead of {{:=}})
 
(30 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
<!--T:9-->
{{Docnav
|[[Std_New|New]]
|[[Std_CloseActiveWindow|CloseActiveWindow]]
|[[Std_File_Menu|Std File Menu]]
|IconL=Std_New.svg
|IconR=Std_CloseActiveWindow.svg
|IconC=Freecad.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Std Open
|Name=Std Open
|MenuLocation=[[Std_File_Menu|File]] → Open
|MenuLocation=File → Open...
|Workbenches=All
|Workbenches=All
|Shortcut={{KEY|Ctrl}}+{{KEY|O}}
|Shortcut={{KEY|Ctrl}}+{{KEY|O}}
|SeeAlso=[[Std Save|Save]], [[Std Import|Import]]
|SeeAlso=[[Std_Import|Std Import]], [[Std_New|Std New]]
}}
}}


==Description==<!--T:2-->
==Description== <!--T:2-->
The '''Std Open''' command opens and loads project files into FreeCAD's workspace. '''Note:''' depending on the installed extension modules, several file types are supported such as: [http://en.wikipedia.org/wiki/IGES *.IGES], [http://en.wikipedia.org/wiki/Step_file *.STEP], [http://en.wikipedia.org/wiki/BREP *.BREP], [http://en.wikipedia.org/wiki/STL_%28file_format%29 *.STL], [http://en.wikipedia.org/wiki/Wavefront_.obj_file *.OBJ], [http://en.wikipedia.org/wiki/PLY_%28file_format%29 *.PLY], etc...


<!--T:3-->
<!--T:10-->
The '''Std Open''' command opens a file. If the file is not a native FreeCAD file (*.FCStd) its geometry will be imported into a new document. See [[Std_Import|Std Import]] for more information.
When loading files be aware that it's akin to a new document gets created. Alternatively, if you want to load a file into an existing document use the {{KEY|[[File:Std Import.png|16px|Std Import|link=Std Import]] [[Std Import|Std Import]]}} command instead.


<!--T:4-->
==Usage== <!--T:6-->
FreeCAD project files have the extension "FCStd". To get more information about the internal layout of FreeCAD projects files read the article [[File Format FCStd]].


<!--T:11-->
==Usage==
# Invoke the command several ways:
# There are several ways to invoke the command:
#* Pressing the {{KEY|[[File:Std Open.png|16px|Std Open|link=Std Open]] [[Std Open|Std Open]]}} button in the toolbar
#* Press the {{Button|[[Image:Std_Open.svg|16px]] [[Std_Open|Std Open]]}} button.
#* Select the {{MenuCommand|File → [[Image:Std_Open.svg|16px]] Open...}} option from the menu.
#* Using the {{KEY|Ctrl}}+{{KEY|O}} keyboard shortcut
#* Use the keyboard shortcut: {{KEY|Ctrl}}+{{KEY|O}}.
#* {{MenuCommand|[[Std_File_Menu|File]] → Open}}
# Optionally select the correct file format in the dialog box.
# Select a file.
# Press the {{Button|Open}} button.


==Options== <!--T:12-->
==Scripting==


<!--T:5-->
<!--T:13-->
* Press {{KEY|Esc}} or the {{Button|Cancel}} button to abort the command.
{{Std Base navi}}

==Preferences== <!--T:14-->

<!--T:15-->
* The last used file location is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → General → FileOpenSavePath}}.

==Scripting== <!--T:16-->

<!--T:17-->
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].

<!--T:18-->
To open a document use the {{incode|open(filepath)}} method or the {{incode|openDocument(filepath, [hidden<nowiki>=</nowiki>False])}} method of the FreeCAD application.

<!--T:20-->
These methods create and return a document and load a project file into it. The {{incode|filepath}} argument must be a string pointing to an existing file. If the file doesn't exist or the file cannot be loaded an I/O exception is thrown. In this case the created document is kept, but will be empty. If {{incode|hidden<nowiki>=</nowiki>True}} is used, the document won't be displayed in the GUI and no tab will appear for it. This allows performing automatic operations on a document and closing it without disrupting the user interface.

<!--T:21-->
For a scripting example see [[Std_New#Scripting|Std New]].


<!--T:19-->
{{Docnav
|[[Std_New|New]]
|[[Std_CloseActiveWindow|CloseActiveWindow]]
|[[Std_File_Menu|Std File Menu]]
|IconL=Std_New.svg
|IconR=Std_CloseActiveWindow.svg
|IconC=Freecad.svg
}}


{{Userdocnavi}}
</translate>
</translate>
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}

Latest revision as of 03:45, 4 February 2021

Std Open

Menu location
File → Open...
Workbenches
All
Default shortcut
Ctrl+O
Introduced in version
-
See also
Std Import, Std New

Description

The Std Open command opens a file. If the file is not a native FreeCAD file (*.FCStd) its geometry will be imported into a new document. See Std Import for more information.

Usage

  1. There are several ways to invoke the command:
    • Press the Std Open button.
    • Select the File → Open... option from the menu.
    • Use the keyboard shortcut: Ctrl+O.
  2. Optionally select the correct file format in the dialog box.
  3. Select a file.
  4. Press the Open button.

Options

  • Press Esc or the Cancel button to abort the command.

Preferences

  • The last used file location is stored: Tools → Edit parameters... → BaseApp → Preferences → General → FileOpenSavePath.

Scripting

See also: FreeCAD Scripting Basics.

To open a document use the open(filepath) method or the openDocument(filepath, [hidden=False]) method of the FreeCAD application.

These methods create and return a document and load a project file into it. The filepath argument must be a string pointing to an existing file. If the file doesn't exist or the file cannot be loaded an I/O exception is thrown. In this case the created document is kept, but will be empty. If hidden=True is used, the document won't be displayed in the GUI and no tab will appear for it. This allows performing automatic operations on a document and closing it without disrupting the user interface.

For a scripting example see Std New.