Image CreateImagePlane: Difference between revisions

From FreeCAD Documentation
(Removed translation marks)
(Separating headers from content; typo; fix link to Draft Module; there is no Image menu)
Line 4: Line 4:
{{GuiCommand
{{GuiCommand
|Name=Image CreateImagePlane
|Name=Image CreateImagePlane
|MenuLocation=Image → Create a planar image in the 3D space
|MenuLocation=None
|Workbenches=[[Image Workbench|Image]]
|Workbenches=[[Image Workbench|Image]]
|SeeAlso=[[Image Open]], [[Image Scaling]]
|SeeAlso=[[Image Open]], [[Image Scaling]]
Line 10: Line 10:


==Description==
==Description==

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


==How to use==
==How to use==

# Press the {{Button|[[Image:Image CreateImagePlane.svg|16px]] [[Image CreateImagePlane|Image Plane]]}} button.
# Press the {{Button|[[Image:Image CreateImagePlane.svg|16px]] [[Image CreateImagePlane|Image Plane]]}} button.
# Select the desired image in your system.
# Select the desired image in your system.
Line 19: Line 21:
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.
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 {{incode|-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 Workbench|Draft]] or [[Sketcher Workbench|Sketcher]] tools.
When importing the image, you may wish to add an offset of {{incode|-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 Module|Draft]] or [[Sketcher Workbench|Sketcher]] tools.


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

Revision as of 23:07, 15 December 2018

Image CreateImagePlane

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

Description

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

How to use

  1. Press the Image Plane 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.

Properties

Base

  • 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

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