Std New
Appearance
|
|
| Menu location |
|---|
| File → New Document |
| Workbenches |
| All |
| Default shortcut |
| Ctrl+N |
| Introduced in version |
| - |
| See also |
| Std Open, Std Import |
Description
The Std New command creates a new empty document and makes it the active document.
Usage
- 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.
- Press the
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)
- File: New Document, Open, Open Recent, Close, Close All, Save, Save As, Save Copy, Save All, Revert, Import, Export,Merge Document, Document Information, Print, Print Preview, Export PDF, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate Object, Recompute, Box Selection, Box Element Selection, Select All, Delete, Send to Python Console, Placement, Transform, Align To, Toggle Edit Mode, Properties, Edit Mode, Preferences
- View:
- Miscellaneous: New 3D View, Orthographic View, Perspective View, Fullscreen, Bounding Box, Toggle Axis Cross, Clipping View, Texture Mapping, Toggle Navigation/Edit Mode, Material, Appearance, Random Color, Appearance 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
- Overlay Docked Panel: Toggle Overlay for All Panels, Toggle Transparent Panels, Toggle Overlay, Toggle Transparent Mode, Bypass Mouse Events in Overlay Panels, Toggle Left, Toggle Right, Toggle Top, Toggle Bottom
- Link Navigation: Go to Linked Object, Go to Deepest Linked Object, Select All Links
- Tree View Actions: Sync View, Sync Selection, Sync Placement, Preselection, Record Selection, Single Document, Multi Document, Collapse/Expand, Initiate Dragging, Go to Selection, Selection Back, Selection Forward
- Tools: Addon Manager, Measure, Clarify Selection, Quick Measure, Units Converter, Load Image, Save Image, Text Document, View Turntable, Scene Inspector, Dependency Graph, Export Dependency Graph, Document Utility, Edit Parameters, Customize
- Macro: Record Macro, Macros, Recent Macros, Execute Macro, Attach to Remote Debugger, Debug Macro, Stop Debugging, Step Over, Step Into, Toggle Breakpoint
- Help: What's This, Start Page, Users Documentation, FreeCAD Forum, Report an Issue, Restart in Safe Mode, Developers Handbook, Python Modules Documentation, FreeCAD Website, Donate to FreeCAD, About FreeCAD
- Additional:
- Miscellaneous: New Part, New Group, Variable Set, Link Group, Select All Instances, Toggle Freeze
- Datums: Coordinate System, Datum Plane, Datum Line, Datum Point
- Link Actions: Make Link, Make Sub-Link, Replace With Link, Unlink, Import Link, Import All Links
- Expression Actions: Copy Selected, Copy Active Document, Copy All Documents, Paste
- Selection Filter: Vertex Selection, Edge Selection, Face Selection, No Selection Filters
- 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
- Hubs: User hub, Power users hub, Developer hub