Std New

Open

Std File Menu

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 Document button.
   • Select the File → New Document 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 View.

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

Data

Base

• DataComment (String): Any comment that may apply.
• DataCompany (String): Company name.
• DataCreated By (String): Author name.
• DataCreation Date (String): Automatic date stamp (read-only).
• DataFile Name (String): The full path of the file. Blank if the document has not been saved (read-only).
• DataId (String): Not implemented yet.
• DataLabel (String): The name that will appear in the Tree View. Replaced by the name of the document after reopening.
• DataLast Modified By (String): Author name.
• DataLast Modified Date (String): Automatic date stamp (read-only).
• DataLicense (String): License type.
• DataLicense URL (String): License URL.
• Data (Hidden)Material (Map): Map with material properties.
• Data (Hidden)Meta (Map): Map with additional meta information.
• DataShow 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.
• DataTip (Link): Not implemented yet.
• DataTip Name (String): Not implemented yet.
• DataTransient Dir (String): The transient directory used for recovery data (read-only).
• Data (Hidden)Uid (UUID): UUID of the document (read-only).
• DataUnit System (Enumeration): The document unit system. Initial value depends on the Default unit system. introduced in 1.0
• DataUse Hasher (Bool): If true, a hasher is used to mitigate the topological naming problem. 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

Std Base

• File: New, Open, Open Recent, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Document information, Print, Print preview, Export PDF, Exit

---

• Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Properties, Edit mode, Preferences

---

• View:
  • Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Persistent section cut, Texture mapping, Toggle navigation/Edit mode, Material, Appearance, Random color, Color per face, Toggle transparency, Workbench, Status bar
  • Standard views: Fit all, Fit selection, Align to selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right, Store working view, Recall working view
  • Freeze display: Save views, Load views, Freeze view, Clear views
  • Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
  • Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
  • Zoom: Zoom In, Zoom Out, Box zoom
  • Document window: Docked, Undocked, Fullscreen
  • Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability
  • Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Individual views, Structure, Help, Lock toolbars
  • Panels: Tree view, Property view, Model, Selection view, Python console, Report view, Tasks, DAG view
  • Dock window overlay: Toggle overlay for all, Toggle transparent for all, Toggle overlay, Toggle transparent, Bypass mouse events in docked overlay windows, Toggle left, Toggle right, Toggle top, Toggle bottom
  • Link navigation: Go to linked object, Go to the deepest linked object, Select all links
  • Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection back, Selection forward

---

• Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Export dependency graph, Document utility, Add text document, View turntable, Units converter, Customize, Addon manager, Measure

---

• Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint

---

• Windows: Next, Previous, Tile, Cascade, Windows

---

• Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This, Start

---

• Additional:
  • Miscellaneous: Create part, Create group, Create a variable set, Make link group, Select all instances, Toggle freeze
  • Create datums: Create coordinate system, Create datum plane, Create datum line, Create datum point
  • Link tools: Make link, Make sub-link, Replace with link, Unlink, Import links, Import all links
  • Expression actions: Copy selected, Copy active document, Copy all documents, Paste
  • Selection filter: Vertex selection, Edge selection, Face selection, All selection filters cleared

User documentation

• Getting started
• Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
• Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

---

• Help: Tutorials, Video tutorials
• Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework

---

• Addons: Addon Manager, External workbenches, Scripting and macros

---

• Hubs: User hub, Power users hub, Developer hub