TechDraw Image

    From FreeCAD Documentation

    TechDraw Image.svg 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.

    TechDraw Image example.png

    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 TechDraw Image.svg Insert Bitmap Image button.
      • Select the TechDraw → TechDraw Views → TechDraw Image.svg 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