Donate

Open

Std File Menu

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

Base

• DatosComment (String): Any comment that may apply.
• DatosCompany (String): Company name.
• DatosCreated By (String): Author name.
• DatosCreation Date (String): Automatic date stamp (read-only).
• DatosFile Name (String): The full path of the file. Blank if the document has not been saved (read-only).
• DatosId (String): Not implemented yet.
• DatosLabel (String): The name that will appear in the Tree view. Replaced by the name of the document after reopening.
• DatosLast Modified By (String): Author name.
• DatosLast Modified Date (String): Automatic date stamp (read-only).
• DatosLicense (String): License type.
• DatosLicense URL (String): License URL.
• Datos (Hidden)Material (Map): Map with material properties.
• Datos (Hidden)Meta (Map): Map with additional meta information.
• DatosShow 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.
• DatosTip (Link): Not implemented yet.
• DatosTip Name (String): Not implemented yet.
• DatosTransient Dir (String): The transient directory used for recovery data (read-only).
• Datos (Hidden)Uid (UUID): UUID of the document (read-only).
• DatosUnit System (Enumeration): The document unit system. Initial value depends on the Default unit system. introduced in 1.0

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

To create a new document use the newDocument([name], [hidden=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=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)

Open

Std File Menu