Image CreateImagePlane

From FreeCAD Documentation

Image CreateImagePlane

Menu location
Default shortcut
Introduced in version
See also
Image Open, Image Scaling


The CreateImagePlane tool imports a bitmap image and places it on one of the XY, YZ or XZ planes.


  1. Press the Image CreateImagePlane button.
  2. Select the desired image in your system.
  3. Choose the plane where the image will be placed, give an offset value, and press OK.

The resulting ImagePlane object uses the ratio of 1 pixel to 1 millimeter; in order for the image to display well, it should have enough resolution.

When importing the image, you may wish to add an offset of -0.1 mm in order to place the image slightly behind the working plane; this will make it easy to trace (draw on top) the image with the Draft or Sketcher tools.

If no offset is given to the image initially, its position can still be adjusted in the property editor.



  • DataPosition: specifies the coordinates of the base point of the image plane.
  • DataAngle: specifies the angle of rotation of the image plane.
  • DataAxis: specifies the axis used for the rotation angle.

Image Plane

  • DataImage File: specifies the image to use for this plane.
  • DataXSize: specifies the width of the image plane.
  • DataYSize: specifies the height of the image plane.