TechDraw Image

From FreeCAD Documentation
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

TechDraw Image

Menu location
TechDraw → TechDraw Views → Insert Bitmap Image
Workbenches
TechDraw
Default shortcut
None
Introduced in version
-
See also
TechDraw SVG Symbol

Description

The TechDraw Image tool inserts a bitmap image (PNG, TIFF, JPEG, etc.) from a file into the page as a view.

Image inserted in the drawing page

Usage

  1. If there are multiple drawing pages in the document: optionally activate the desired page by selecting it in the Tree view.
  2. There are several ways to invoke the tool:
    • Press the Insert Bitmap Image button.
    • Select the TechDraw → TechDraw Views → Insert Bitmap Image option from the menu.
  3. If there are multiple drawing pages in the document and you have not yet activated a page, the Page Chooser dialog box opens: introduced in version 0.20
    1. Select the desired page.
    2. Press the OK button.
  4. A file dialog opens.
  5. Select a location and file name.
  6. The image is inserted.
  7. Optionally change its DataScale property to adjust its size.

Properties

See also TechDraw View.

Data

Image

  • DataImage File (File): The file containing this bitmap.
  • DataImage Included (FileIncluded): Embedded image file. System use only.
  • DataWidth (Float): The width of the cropped image in mm. Only used if ViewCrop is true.
  • DataHeight (Float): The height of the cropped image in mm. Idem.

View

Image

  • ViewCrop (Bool): Crop the image to DataWidth x DataHeight.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

The Image tool can be used in macros and from the Python console by using the following functions:

dvi = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewImage','TestImage')
rc = page.addView(dvi)
dvi.ImageFile = "pathToMy/imageFile.png"
dvi.Height = 200
dvi.Width  = 200