TechDraw Image: Difference between revisions

From FreeCAD Documentation
No edit summary
(relink module to workbench)
(24 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:16-->
{{Docnav
|[[TechDraw_Symbol|Symbol]]
|[[TechDraw_ToggleFrame|ToggleFrame]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_Symbol.svg
|IconR=TechDraw_ToggleFrame.svg
|IconC=Workbench_TechDraw.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=TechDraw Image|Workbenches=[[TechDraw Module|TechDraw]]|MenuLocation=TechDraw → Image|Shortcut=|SeeAlso=}}
|Name=TechDraw Image
|MenuLocation=TechDraw → Insert Bitmap Image
|Workbenches=[[TechDraw_Workbench|TechDraw]]
|SeeAlso=[[TechDraw_Symbol|TechDraw SVG Symbol]]
}}


==Description== <!--T:2-->
==Description== <!--T:2-->
The Image tool inserts an bitmap image (png,jpeg,jpg,bmp,etc) from a file into the page as a view


==How to use== <!--T:3-->
<!--T:8-->
The Image tool inserts a [[bitmap|bitmap]] image (PNG, TIFF, JPEG, etc.) from a file into the page as a view.
# Press the {{KEY|[[Image:Techdraw-image.png|24px]] [[TechDraw Image|Image]]}} button
# A file dialog will open. Select a location and file name.


</translate>
==Options== <!--T:4-->
[[Image:TechDraw_Image_example.png]]
None.
<translate>
<!--T:9-->
{{Caption|Image inserted in the drawing page}}

==Usage== <!--T:3-->

<!--T:10-->
# Press the {{Button|[[Image:TechDraw_Image.svg|16px]] [[TechDraw_Image|Insert Bitmap Image]]}} button
# A file dialog will open. Select a location and file name.


==Properties== <!--T:5-->
==Properties== <!--T:5-->

* n/a
<!--T:11-->
* Use the Scale property to adjust the size of the image.
* Use the Width and Height properties to clip the image.


==Scripting== <!--T:6-->
==Scripting== <!--T:6-->

Bitmap Image files can be inserted into a drawing page using Python.
<!--T:12-->
{{Emphasis|See also:}} [[TechDraw_API|TechDraw API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].

<!--T:13-->
The Image tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following functions:

</translate>
</translate>
{{Code|code=
{{Code|code=
Line 27: Line 59:
dvi.Width = 200
dvi.Width = 200
}}
}}

<translate>
<translate>



==Notes== <!--T:7-->
<!--T:17-->
* Use the Scale property to adjust the size of the image.
{{Docnav
* Use the Width and Height properties to clip the image.
|[[TechDraw_Symbol|Symbol]]
|[[TechDraw_ToggleFrame|ToggleFrame]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_Symbol.svg
|IconR=TechDraw_ToggleFrame.svg
|IconC=Workbench_TechDraw.svg
}}

</translate>
</translate>
{{TechDraw Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}

Revision as of 19:31, 24 August 2021

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

  • Use the Scale property to adjust the size of the image.
  • Use the Width and Height properties to clip the image.

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