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 0.21: If an image format is selected the command will create an Image Plane.
Usage
- There are several ways to invoke the command:
- Select the File →
Import… option from the menu.
- Use the keyboard shortcut: Ctrl+I. 1.0 and below
- Use the keyboard shortcut: Ctrl+Shift+I. introduced in 1.1
- 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
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.
- Press the OK button to confirm the changes and close the task panel.
Properties
See also: Property View.
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
- ÚdajeImage File (
FileIncluded): The image file used for the Image Plane. This file is stored in the .FCStd file.
- ÚdajeXSize (
Length): The width of the Image Plane.
- ÚdajeYSize (
Length): The height of the Image Plane.
View
Object Style
- PohledLighting (
Enumeration): How the Image Plane is illuminated in the 3D View. Can be Two side or One side.
Std Base
- 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
- 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
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