Skip to content

Latest commit

 

History

History
102 lines (58 loc) · 3.03 KB

Std_New.md

File metadata and controls

102 lines (58 loc) · 3.03 KB
Raw
Error in user YAML: (<unknown>): did not find expected alphabetic or numeric character while scanning an alias at line 5 column 14
---
- GuiCommand:
   Name: Std New
   MenuLocation: File -> New
   Workbenches: All
   Shortcut: **Ctrl**+**N**
   SeeAlso: Std_Open, Std_Import
---

Std New

Description

The Std New command creates a new empty document and makes it the active document.

Usage

  1. There are several ways to invoke the command:
    • Press the Std New button.
    • Select the File → New option from the menu.
    • Use the keyboard shortcut: Ctrl+N.

Preferences

  • FreeCAD will create a new document at start up if Tools → Edit parameters... → BaseApp → Preferences → Document → CreateNewDoc is set to True. This setting can also be changed in the Preferences Editor.
  • Some document properties: author names, company name and license information, can be preset in the Preferences Editor.

Properties

Most properties can also be changed in the dialog box of the Std ProjectInfo command.

  • Comment: Any comment that may apply.

  • Company: Company name. Can be preset.

  • Created By: Author name. Can be preset.

  • Creation Date: Automatic date stamp. Not editable.

  • File Name: The full path of the file. Blank if the document has not been saved. Not editable.

  • Id: Not implemented yet.

  • Label: The name that will appear in the Tree view. By default the name of the document.

  • Last Modified By: Author name. Can be preset.

  • Last Modified Date: Automatic date stamp. Not editable.

  • License: License type. Can be preset.

  • License URL: License URL. Can be preset.

  • Show Hidden: If true, items that have been hidden in the Tree view will be displayed anyway. Hiding items in the tree can be useful when working on larger models.

  • Tip: Not implemented yet.

  • Tip Name: Not implemented yet.

  • Transient Dir: The transient directory used for recovery data. Not editable.

Scripting

See also:

FreeCAD Scripting Basics.

To create a new document use the newDocument([name], [hidden<nowiki>=</nowiki>False]) method of the FreeCAD application. The document name must be unique, which is checked automatically. If no name is supplied, the document will be named "Untitled". If hidden<nowiki>=</nowiki>True is used, the new document won't be displayed in the GUI and no tab will appear for it.

import FreeCAD
from pathlib import Path

# The folder and filename we will use:
fld = 'D:/testfiles/'
fnm = fld + 'test.FCStd'

# Make sure fld exists:
Path(fld).mkdir(parents=True, exist_ok=True)

doc = FreeCAD.newDocument()
doc.saveAs(fnm)

FreeCAD.closeDocument(doc.Name)

doc = FreeCAD.open(fnm)
doc.save()

FreeCAD.closeDocument(doc.Name)

{{Std Base navi}}

⏵ documentation index > Std New