Std Open: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(<nowiki>=</nowiki> Instead of {{:=}})
 
(44 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Std_Open|Workbenches=All|SeeAlso=[[Std_Save]],[[Std_Import]]}}
<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-->
Opens and loads project files into FreeCAD's workspace and depending on the installed extension modules further file types are supported such as IGES, STEP, BREP, STL, OBJ, PLY and so on.
{{GuiCommand
|Name=Std Open
|MenuLocation=File → Open...
|Workbenches=All
|Shortcut={{KEY|Ctrl}}+{{KEY|O}}
|SeeAlso=[[Std_Import|Std Import]], [[Std_New|Std New]]
}}


==Description== <!--T:2-->
When loading files always a new document gets created. If you want to load a file into an existing document use the [[Std_Import]] instead.


<!--T:10-->
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]].
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.


==Usage== <!--T:6-->
{{languages | {{es|Std_Open/es}} }}

<!--T:11-->
# There are several ways to invoke the command:
#* 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.
#* Use the keyboard shortcut: {{KEY|Ctrl}}+{{KEY|O}}.
# Optionally select the correct file format in the dialog box.
# Select a file.
# Press the {{Button|Open}} button.

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

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

==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
}}

</translate>
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{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.