TechDraw Image

From FreeCAD Documentation

TechDraw Image

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


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


  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.


See also TechDraw View.



  • 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.



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


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