Std Import: Difference between revisions
(Initial size of SVG images is now correct.) |
(Updated the Image Plane Edit paragraph.) |
||
Line 71: | Line 71: | ||
#* Double-click the Image Plane in the [[Tree_view|Tree view]]. |
#* 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. |
#* 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. |
|||
# A task panel opens. |
|||
# {{MenuCommand| |
# 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 X axis of the plane. For the XZ and YZ plane it is the Z axis of the plane. |
||
# |
# 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: |
# {{MenuCommand|Image size}} options: |
||
#* Scale by numerical input: |
#* Scale by numerical input: |
||
Line 82: | Line 83: | ||
#* Scale by picking points: |
#* Scale by picking points: |
||
#*# Press the {{Button|Calibrate}} button. |
#*# Press the {{Button|Calibrate}} button. |
||
#*# Pick two points. |
#*# Pick two points inside the image. |
||
#*# A dimension line is displayed. |
|||
#*# Enter the |
#*# Enter the desired dimension. |
||
#*# Press the {{Button|Apply}} button |
#*# Press {{KEY|Enter}} or the {{Button|Apply}} button. |
||
# Press the {{Button|OK}} button to confirm the changes and close the task panel. |
# Press the {{Button|OK}} button to confirm the changes and close the task panel. |
||
Revision as of 08:36, 4 June 2023
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
- See: Import Export Preferences.
- The last used file location is stored: Tools → Edit parameters... → BaseApp → Preferences → General → FileOpenSavePath.
- The last used import filter is stored: Tools → Edit parameters... → BaseApp → Preferences → General → FileImportFilter.
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 96 px/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 X axis of the plane. For the XZ and YZ plane it is the Z axis of the plane.
- 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