Std New: Difference between revisions
Renatorivo (talk | contribs) (Marked this version for translation) |
(Marked this version for translation) |
||
(21 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
<translate> |
<translate> |
||
<!--T:7--> |
<!--T:7--> |
||
{{Docnav |
{{Docnav |
||
| |
| |
||
|[[Std_Open| |
|[[Std_Open|Open]] |
||
|[[Std_File_Menu|Std File Menu]] |
|[[Std_File_Menu|Std File Menu]] |
||
|IconL= |
|IconL= |
||
Line 29: | Line 30: | ||
<!--T:9--> |
<!--T:9--> |
||
# There are several ways to invoke the command: |
# There are several ways to invoke the command: |
||
#* Press the {{Button|[[Image:Std_New.svg|16px]] [[Std_New| |
#* Press the {{Button|[[Image:Std_New.svg|16px]] [[Std_New|New]]}} button. |
||
#* Select the {{MenuCommand|File → [[Image:Std_New.svg|16px]] New}} option from the menu. |
#* Select the {{MenuCommand|File → [[Image:Std_New.svg|16px]] New}} option from the menu. |
||
#* Use the keyboard shortcut: {{KEY|Ctrl}}+{{KEY|N}}. |
#* Use the keyboard shortcut: {{KEY|Ctrl}}+{{KEY|N}}. |
||
==Preferences== <!--T:10--> |
==Preferences== <!--T:10--> |
||
<!--T:19--> |
|||
See also: [[Preferences_Editor|Preferences Editor]]. |
|||
<!--T:11--> |
<!--T:11--> |
||
* FreeCAD |
* By default FreeCAD start without a new document. Check the {{MenuCommand|Edit → Preferences... → General → Document → Create new document at start up}} option to change this behavior. |
||
* Some document properties: author |
* Some document properties: author name, company name and license information, can be preset: {{MenuCommand|Edit → Preferences... → General → Document → Authoring and License}}. |
||
==Properties== <!--T:12--> |
==Properties== <!--T:12--> |
||
Line 43: | Line 47: | ||
<!--T:13--> |
<!--T:13--> |
||
Most properties can also be changed in the dialog box of the [[Std_ProjectInfo|Std ProjectInfo]] command. |
Most properties can also be changed in the dialog box of the [[Std_ProjectInfo|Std ProjectInfo]] command. |
||
===Data=== <!--T:20--> |
|||
<!--T:21--> |
|||
{{TitleProperty|Base}} |
|||
<!--T:14--> |
<!--T:14--> |
||
* {{PropertyData|Comment}}: Any comment that may apply. |
* {{PropertyData|Comment|String}}: Any comment that may apply. |
||
* {{PropertyData|Company}}: Company name |
* {{PropertyData|Company|String}}: Company name. |
||
* {{PropertyData|Created By}}: Author name |
* {{PropertyData|Created By|String}}: Author name. |
||
* {{PropertyData|Creation Date}}: Automatic date stamp |
* {{PropertyData|Creation Date|String}}: Automatic date stamp (read-only). |
||
* {{PropertyData|File Name}}: The full path of the file. Blank if the document has not been saved |
* {{PropertyData|File Name|String}}: The full path of the file. Blank if the document has not been saved (read-only). |
||
* {{PropertyData|Id}}: Not implemented yet. |
* {{PropertyData|Id|String}}: Not implemented yet. |
||
* {{PropertyData|Label}}: The name that will appear in the [[Tree_view|Tree view]]. |
* {{PropertyData|Label|String}}: The name that will appear in the [[Tree_view|Tree view]]. Replaced by the name of the document after reopening. |
||
* {{PropertyData|Last Modified By}}: Author name |
* {{PropertyData|Last Modified By|String}}: Author name. |
||
* {{PropertyData|Last Modified Date}}: Automatic date stamp |
* {{PropertyData|Last Modified Date|String}}: Automatic date stamp (read-only). |
||
* {{PropertyData|License}}: License type |
* {{PropertyData|License|String}}: License type. |
||
* {{PropertyData|License URL}}: License URL |
* {{PropertyData|License URL|String}}: License URL. |
||
* {{PropertyData|Material|Map|Hidden}}: Map with material properties. |
|||
⚫ | |||
* {{PropertyData| |
* {{PropertyData|Meta|Map|Hidden}}: Map with additional meta information. |
||
⚫ | |||
⚫ | |||
* {{PropertyData| |
* {{PropertyData|Tip|Link}}: Not implemented yet. |
||
⚫ | |||
* {{PropertyData|Transient Dir|String}}: The transient directory used for recovery data (read-only). |
|||
* {{PropertyData|Uid|UUID|Hidden}}: UUID of the document (read-only). |
|||
* {{PropertyData|Unit System|Enumeration}}: The document unit system. Initial value depends on the [[Preferences_Editor#General_2|Default unit system]]. {{Version|1.0}} |
|||
==Scripting== <!--T:15--> |
==Scripting== <!--T:15--> |
||
Line 67: | Line 80: | ||
<!--T:17--> |
<!--T:17--> |
||
To create a new document use the {{incode|newDocument}} method of the FreeCAD application. |
To create a new document use the {{incode|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 {{incode|hidden<nowiki>=</nowiki>True}} is used, the new document won't be displayed in the GUI and no tab will appear for it. |
||
</translate> |
</translate> |
||
Line 92: | Line 105: | ||
}} |
}} |
||
<translate> |
<translate> |
||
<!--T:18--> |
<!--T:18--> |
||
{{Docnav |
{{Docnav |
||
| |
| |
||
|[[Std_Open| |
|[[Std_Open|Open]] |
||
|[[Std_File_Menu|Std File Menu]] |
|[[Std_File_Menu|Std File Menu]] |
||
|IconL= |
|IconL= |
||
Line 104: | Line 118: | ||
</translate> |
</translate> |
||
{{ |
{{Std_Base_navi{{#translation:}}}} |
||
{{Userdocnavi{{#translation:}}}} |
{{Userdocnavi{{#translation:}}}} |
||
{{clear}} |
Latest revision as of 11:48, 21 April 2024
Std New |
Menu location |
---|
File → New |
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 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
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 version 1.0
Scripting
See also: 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)
Std Base
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, 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, Edit mode, Preferences
- View:
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- 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, Toggle measurement, Clear measurement
- Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
- Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
- 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, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- 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
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, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub