Std Import: Difference between revisions
No edit summary |
mNo edit summary |
||
(35 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
<translate> |
<translate> |
||
<!--T:8--> |
<!--T:8--> |
||
{{Docnav |
{{Docnav |
||
|[[Std_Revert| |
|[[Std_Revert|Revert]] |
||
|[[Std_Export| |
|[[Std_Export|Export]] |
||
|[[Std_File_Menu|Std File Menu]] |
|[[Std_File_Menu|Std File Menu]] |
||
|IconL= |
|IconL=Std_Revert.svg |
||
|IconR= |
|IconR=Std_Export.svg |
||
|IconC=Freecad.svg |
|IconC=Freecad.svg |
||
}} |
}} |
||
<!--T:1--> |
<!--T:1--> |
||
<!--Empty=1 to suppress icon--> |
|||
{{GuiCommand |
{{GuiCommand |
||
|Name=Std Import |
|Name=Std Import |
||
|Empty=1 |
|||
|MenuLocation=File → Import... |
|MenuLocation=File → Import... |
||
|Workbenches=All |
|Workbenches=All |
||
Line 26: | Line 25: | ||
<!--T:2--> |
<!--T:2--> |
||
The '''Std Import''' command imports geometry from a different file format into the active document. Many file formats are supported and for some formats multiple import options exist. See [[Import_Export|Import Export]] for more information. |
The '''Std Import''' command imports geometry from a different file format into the active document. Many file formats are supported and for some formats multiple import options exist. See [[Import_Export|Import Export]] for more information. |
||
<!--T:16--> |
|||
{{Version|0.21}}: If an image format is selected the command will create an [[#Image_Plane|Image Plane]]. |
|||
==Usage== <!--T:7--> |
==Usage== <!--T:7--> |
||
Line 45: | Line 47: | ||
<!--T:10--> |
<!--T:10--> |
||
* To convert an imported [[ |
* To convert an imported [[Mesh_Workbench|mesh object]] into a solid see the [[Import_from_STL_or_OBJ|Import from STL or OBJ]] tutorial. |
||
* To import into a new document you can use the [[Std_Open|Std Open]] command. |
* To import into a new document you can use the [[Std_Open|Std Open]] command. |
||
* Some workbenches have additional import commands. See |
* Some workbenches have additional import commands. See [[Import_Export|Import Export]]. |
||
==Preferences== <!--T:11--> |
==Preferences== <!--T:11--> |
||
<!--T:12--> |
<!--T:12--> |
||
* See |
* See [[Import_Export_Preferences|Import Export Preferences]]. |
||
* The last used file location is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → General → FileOpenSavePath}}. |
|||
==Image Plane== <!--T:17--> |
|||
* The last used import filter is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → General → FileImportFilter}}. |
|||
<!--T:18--> |
|||
An Image Plane is a planar representation of an image in the [[3D_view|3D view]]. It can for example be used when creating a model based on photographs of an existing object. |
|||
<!--T:19--> |
|||
By default an Image Plane is placed on the global XY plane. The initial size of an Image Plane is calculated using a 96px/inch resolution. |
|||
===Edit=== <!--T:20--> |
|||
<!--T:21--> |
|||
# To edit an Image Plane do one of the following: |
|||
#* Double-click the Image Plane in the [[Tree_view|Tree view]]. |
|||
#* Right-click the Image Plane in the Tree view and select {{MenuCommand|[[Image:Image-scaling.svg|16px]] Change image...}} from the context menu. |
|||
# If the Image Plane is not plane-parallel to the XY, XZ or YZ plane of the global coordinate system, it is realigned to be plane-parallel to the XY plane. |
|||
# The {{MenuCommand|Image plane settings}} task panel opens. |
|||
# Optionally select the {{MenuCommand|XY-Plane}}, {{MenuCommand|XZ-Plane}} or {{MenuCommand|YZ-Plane}} of the global coordinate system. |
|||
# Check {{MenuCommand|Reverse direction}} to rotate the Image Plane 180°. The rotation axis depends on the selected plane. For the XY plane it is the global X axis. For the XZ and YZ plane it is the global Z axis. |
|||
# The {{MenuCommand|Offset}}, {{MenuCommand|X distance}} and {{MenuCommand|Y distance}} are relative to the coordinate system of the Image Plane. A small negative offset can be useful when tracing the image with a [[Sketcher_Workbench|sketch]] or [[Draft_Workbench|Draft]] geometry. |
|||
# Optionally change the {{MenuCommand|Transparency}}. |
|||
# {{MenuCommand|Image size}} options: |
|||
#* Scale by numerical input: |
|||
#*# Optionally uncheck {{MenuCommand|Keep aspect ratio}} for unequal scaling. |
|||
#*# Enter a {{MenuCommand|Width}} and/or {{MenuCommand|Height}}. |
|||
#* Scale by picking points: |
|||
#*# Press the {{Button|Calibrate}} button. |
|||
#*# Pick two points inside the image. |
|||
#*# A dimension line is displayed. |
|||
#*# Enter the desired dimension. |
|||
#*# Press {{KEY|Enter}} or the {{Button|Apply}} button. |
|||
# Press the {{Button|OK}} button to confirm the changes and close the task panel. |
|||
===Properties=== <!--T:22--> |
|||
<!--T:23--> |
|||
See also: [[Property_editor|Property editor]]. |
|||
<!--T:24--> |
|||
An Image Plane object is derived from an [[App_GeoFeature|App GeoFeature]] object and inherits all its properties. It also has the following additional properties: |
|||
====Data==== <!--T:25--> |
|||
<!--T:26--> |
|||
{{TitleProperty|Image Plane}} |
|||
<!--T:27--> |
|||
* {{PropertyData|Image File|FileIncluded}}: The image file used for the Image Plane. This file is stored in the {{FileName|.FCStd}} file. |
|||
* {{PropertyData|XSize|Length}}: The width of the Image Plane. |
|||
* {{PropertyData|YSize|Length}}: The height of the Image Plane. |
|||
====View==== <!--T:28--> |
|||
<!--T:29--> |
|||
{{TitleProperty|Object Style}} |
|||
<!--T:30--> |
|||
* {{PropertyView|Lighting|Enumeration}}: How the Image Plane is illuminated in the [[3D_view|3D view]]. Can be {{value|Two side}} or {{value|One side}}. |
|||
<!--T:13--> |
<!--T:13--> |
||
{{Docnav |
{{Docnav |
||
|[[Std_Revert| |
|[[Std_Revert|Revert]] |
||
|[[Std_Export| |
|[[Std_Export|Export]] |
||
|[[Std_File_Menu|Std File Menu]] |
|[[Std_File_Menu|Std File Menu]] |
||
|IconL= |
|IconL=Std_Revert.svg |
||
|IconR= |
|IconR=Std_Export.svg |
||
|IconC=Freecad.svg |
|IconC=Freecad.svg |
||
}} |
}} |
||
</translate> |
</translate> |
||
{{ |
{{Std_Base_navi{{#translation:}}}} |
||
{{Userdocnavi{{#translation:}}}} |
{{Userdocnavi{{#translation:}}}} |
||
[[Category:File_Formats{{#translation:}}]] |
|||
{{clear}} |
Latest revision as of 20:04, 20 April 2024
Std Import |
Menu location |
---|
File → Import... |
Workbenches |
All |
Default shortcut |
Ctrl+I |
Introduced in version |
- |
See also |
Std Open, Import Export, Import Export Preferences |
Description
The Std Import command imports geometry from a different file format into the active document. Many file formats are supported and for some formats multiple import options exist. See Import Export for more information.
introduced in version 0.21: If an image format is selected the command will create an Image Plane.
Usage
- There are several ways to invoke the command:
- Optionally select the correct file format in the dialog box.
- Select a file.
- Press the Open button.
Options
- Press Esc or the Cancel button to abort the command.
Notes
- To convert an imported mesh object into a solid see the Import from STL or OBJ tutorial.
- To import into a new document you can use the Std Open command.
- Some workbenches have additional import commands. See Import Export.
Preferences
Image Plane
An Image Plane is a planar representation of an image in the 3D view. It can for example be used when creating a model based on photographs of an existing object.
By default an Image Plane is placed on the global XY plane. The initial size of an Image Plane is calculated using a 96px/inch resolution.
Edit
- To edit an Image Plane do one of the following:
- Double-click the Image Plane in the Tree view.
- Right-click the Image Plane in the Tree view and select Change image... from the context menu.
- If the Image Plane is not plane-parallel to the XY, XZ or YZ plane of the global coordinate system, it is realigned to be plane-parallel to the XY plane.
- The Image plane settings task panel opens.
- Optionally select the XY-Plane, XZ-Plane or YZ-Plane of the global coordinate system.
- Check Reverse direction to rotate the Image Plane 180°. The rotation axis depends on the selected plane. For the XY plane it is the global X axis. For the XZ and YZ plane it is the global Z axis.
- The Offset, X distance and Y distance are relative to the coordinate system of the Image Plane. A small negative offset can be useful when tracing the image with a sketch or Draft geometry.
- Optionally change the Transparency.
- Image size options:
- Scale by numerical input:
- Optionally uncheck Keep aspect ratio for unequal scaling.
- Enter a Width and/or Height.
- Scale by picking points:
- Press the Calibrate button.
- Pick two points inside the image.
- A dimension line is displayed.
- Enter the desired dimension.
- Press Enter or the Apply button.
- Scale by numerical input:
- Press the OK button to confirm the changes and close the task panel.
Properties
See also: Property editor.
An Image Plane object is derived from an App GeoFeature object and inherits all its properties. It also has the following additional properties:
Data
Image Plane
- DataImage File (
FileIncluded
): The image file used for the Image Plane. This file is stored in the .FCStd file. - DataXSize (
Length
): The width of the Image Plane. - DataYSize (
Length
): The height of the Image Plane.
View
Object Style
- ViewLighting (
Enumeration
): How the Image Plane is illuminated in the 3D view. Can beTwo side
orOne side
.
- 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
- 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