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 New button.
   • Select the File → New option from the menu.
   • Use the keyboard shortcut: Ctrl+N.

Preferences

See also: Preferences Editor.

• By default FreeCAD start without a new document. Check the Edit → Preferences... → General → Document → Create new document at start up option to change this behavior.
• Some document properties: author name, company name and license information, can be preset: Edit → Preferences... → General → Document → Authoring and License.

Properties

See also: Property editor.

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

Data

{{TitleProperty|Base}}

• Comment|String: Any comment that may apply.

• Company|String: Company name.

• Created By|String: Author name.

• Creation Date|String: Automatic date stamp (read-only).

• File Name|String: The full path of the file. Blank if the document has not been saved (read-only).

• Id|String: Not implemented yet.

• Label|String: The name that will appear in the Tree view. Replaced by the name of the document after reopening.

• Last Modified By|String: Author name.

• Last Modified Date|String: Automatic date stamp (read-only).

• License|String: License type.

• License URL|String: License URL.

• Material|Map|Hidden: Map with material properties.

• Meta|Map|Hidden: Map with additional meta information.

• Show Hidden|Bool: 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|Link: Not implemented yet.

• Tip Name|String: Not implemented yet.

• Transient Dir|String: The transient directory used for recovery data (read-only).

• Uid|UUID|Hidden: UUID of the document (read-only).

• Unit System|Enumeration: The document unit system. Initial value depends on the Default unit system. (v1.0)

Scripting

See also: Autogenerated API documentation and 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)

⏵ documentation index > Std New

This page is retrieved from https://github.com/FreeCAD/FreeCAD-documentation/blob/main/wiki/Std_New.md