Std Import

From FreeCAD Documentation
Revision as of 20:46, 14 April 2023 by Roy 043 (talk | contribs) (Adding Image Plane info...)

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 1.0 If an image format is selected the command will create an Image Plane.

Usage

  1. There are several ways to invoke the command:
    • Select the File → Import... option from the menu.
    • Use the keyboard shortcut: Ctrl+I.
  2. Optionally select the correct file format in the dialog box.
  3. Select a file.
  4. Press the Open button.

Options

  • Press Esc or the Cancel button to abort the command.

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 for BMP images. Image Planes based on SVG images have a default size of 100 mm x 100 mm, the SVG's aspect ratio is ignored.

Edit

  1. 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.
  2. A task panel opens.
  3. Choose orientation options:
    1. Select the XY, XZ or YZ plane of the global coordinate system.
    2. Check Reverse direction to mirror the image.
    3. Optionally change the Offset. A small negative offset can be useful when tracing a photograph with a sketch or Draft geometry.
  4. Scale image options:
    • Scale by numerical input:
      1. Optionally uncheck Keep aspect ratio for unequal scaling.
      2. Enter a Width and/or Height.
    • Scale by picking points in the 3D view:
      1. Optionally check Allow points outside the image.
      2. Press the Interactive button.
      3. Select two points.
      4. Enter the Desired distance.
      5. Press the Accept button.





Notes

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.