TechDraw Image: Difference between revisions

From FreeCAD Documentation
(Properties...)
(Marked this version for translation)
Line 39: Line 39:
==Properties== <!--T:5-->
==Properties== <!--T:5-->


<!--T:18-->
See also [[TechDraw_View#Properties|TechDraw View]].
See also [[TechDraw_View#Properties|TechDraw View]].


=== Data ===
=== Data === <!--T:19-->


<!--T:20-->
{{TitleProperty|Image}}
{{TitleProperty|Image}}


<!--T:21-->
* {{PropertyData|Image File|File}}: The file containing this bitmap.
* {{PropertyData|Image File|File}}: The file containing this bitmap.
* {{PropertyData|Image Included|FileIncluded}}: Embedded image file. System use only.
* {{PropertyData|Image Included|FileIncluded}}: Embedded image file. System use only.
Line 50: Line 53:
* {{PropertyData|Height|Float}}: The height of the cropped image in mm. Idem.
* {{PropertyData|Height|Float}}: The height of the cropped image in mm. Idem.


=== View ===
=== View === <!--T:22-->


<!--T:23-->
{{TitleProperty|Image}}
{{TitleProperty|Image}}


<!--T:24-->
* {{PropertyView|Crop|Bool}}: Crop the image to {{PropertyData|Width}} x {{PropertyData|Height}}.
* {{PropertyView|Crop|Bool}}: Crop the image to {{PropertyData|Width}} x {{PropertyData|Height}}.



Revision as of 09:42, 11 September 2022

TechDraw Image

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

Description

The 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. Press the Insert Bitmap Image button
  2. A file dialog will open. Select a location and file name.

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: TechDraw API 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