TechDraw Symbol: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Usage)
 
(19 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:16-->
<!--T:16-->
{{Docnav
{{Docnav
|[[TechDraw_GeometricHatch|Apply Geometric Hatch to Face]]
|[[TechDraw_GeometricHatch|GeometricHatch]]
|[[TechDraw_Image|Insert Bitmap Image]]
|[[TechDraw_Image|Image]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_GeometricHatch.svg
|IconL=TechDraw_GeometricHatch.svg
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw_Image.svg
|IconR=TechDraw_Image.svg
|IconC=Workbench_TechDraw.svg
}}
}}


Line 14: Line 15:
{{GuiCommand
{{GuiCommand
|Name=TechDraw Symbol
|Name=TechDraw Symbol
|MenuLocation=TechDraw → Insert SVG Symbol
|MenuLocation=TechDraw → TechDraw Views → Insert SVG Symbol
|Workbenches=[[TechDraw Module|TechDraw]]
|Workbenches=[[TechDraw_Workbench|TechDraw]]
|SeeAlso=[[TechDraw Templates|TechDraw Templates]], [[Draft SVG|Draft SVG]]
|SeeAlso=[[TechDraw_Templates|TechDraw Templates]], [[Draft_SVG|Draft SVG]]
}}
}}


Line 22: Line 23:


<!--T:8-->
<!--T:8-->
The Symbol tool inserts an [[SVG|SVG]] file into the page. This symbol can be anything that helps annotating your drawing, and that doesn't need to be further modified.
The '''TechDraw Symbol''' tool inserts an [[SVG|SVG]] file into the page. This symbol can be anything that helps annotating your drawing, and that doesn't need to be further modified.


</translate>
</translate>
[[Image:TechDraw_SymbolSVG_sample.png]]
[[Image:TechDraw_SymbolSVG_sample.png|250px]]
<translate>
<translate>
<!--T:9-->
<!--T:9-->
{{Caption|Compass rose added to the drawing page; this symbol is available by installing the SymbolsLibrary macro with the Addon Manager}}
{{Caption|Compass rose added to the drawing page; this symbol is available by installing the "symbols_library" addon with the [[Std_AddonMgr|Addon Manager]]}}


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


<!--T:10-->
<!--T:10-->
# If there are multiple drawing pages in the document: optionally activate the desired page by selecting it in the [[Tree_view|Tree view]].
# Press the {{Button|[[Image:TechDraw_Symbol.svg|16px]] [[TechDraw_Symbol|Insert SVG Symbol]]}} button
# There are several ways to invoke the tool:
# A File Save dialog will open.
#* Press the {{Button|[[Image:TechDraw_Symbol.svg|16px]] [[TechDraw_Symbol|Insert SVG Symbol]]}} button.
#* Select the {{MenuCommand|TechDraw → TechDraw Views → [[Image:TechDraw_Symbol.svg|16px]] Insert SVG Symbol}} option from the menu.
# If there are multiple drawing pages in the document and you have not yet activated a page, the {{MenuCommand|Page Chooser}} dialog box opens: {{Version|0.20}}
## Select the desired page.
## Press the {{Button|OK}} button.
# A file dialog opens.
# Select a location and file name.
# Select a location and file name.
# The symbol is inserted.
# Press {{KEY|OK}}
# Optionally change its {{PropertyData|Scale}} property to adjust its size.

<!--T:11-->
If the symbol appears larger than expected, use the scale property to adjust its size.


== Notes == <!--T:18-->
== Notes == <!--T:18-->


<!--T:19-->
<!--T:19-->
* ScaleType for Symbols is always set to "Custom" at creation. This is for convenience, since symbols are almost always scaled differently from the rest of the objects on the page.
* {{PropertyData|Scale Type}} for Symbols is always set to ''Custom'' at creation. This is for convenience, since symbols are almost always scaled differently from the rest of the objects on the page.

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

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

<!--T:24-->
{{TitleProperty|Drawing view}}

<!--T:25-->
* {{PropertyData|Editable Texts}}: List of editable texts, if any.


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


<!--T:12-->
<!--T:12-->
{{Emphasis|See also:}} [[TechDraw API|TechDraw API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].


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


</translate>
</translate>
Line 64: Line 80:
rc = page.addView(sym)
rc = page.addView(sym)
}}
}}

<translate>
<translate>



<!--T:17-->
<!--T:17-->
{{Docnav
{{Docnav
|[[TechDraw_GeometricHatch|Apply Geometric Hatch to Face]]
|[[TechDraw_GeometricHatch|GeometricHatch]]
|[[TechDraw_Image|Insert Bitmap Image]]
|[[TechDraw_Image|Image]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_GeometricHatch.svg
|IconL=TechDraw_GeometricHatch.svg
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw_Image.svg
|IconR=TechDraw_Image.svg
|IconC=Workbench_TechDraw.svg
}}
}}


<!--T:14-->
{{TechDraw Tools navi}}

<!--T:15-->
{{Userdocnavi}}
</translate>
</translate>
{{TechDraw Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}

Latest revision as of 08:52, 26 July 2023

TechDraw Symbol

Menu location
TechDraw → TechDraw Views → Insert SVG Symbol
Workbenches
TechDraw
Default shortcut
None
Introduced in version
-
See also
TechDraw Templates, Draft SVG

Description

The TechDraw Symbol tool inserts an SVG file into the page. This symbol can be anything that helps annotating your drawing, and that doesn't need to be further modified.

Compass rose added to the drawing page; this symbol is available by installing the "symbols_library" addon with the Addon Manager

Usage

  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 Insert SVG Symbol button.
    • Select the TechDraw → TechDraw Views → Insert SVG Symbol 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 symbol is inserted.
  7. Optionally change its DataScale property to adjust its size.

Notes

  • DataScale Type for Symbols is always set to Custom at creation. This is for convenience, since symbols are almost always scaled differently from the rest of the objects on the page.

Properties

See also TechDraw View.

Drawing view

  • DataEditable Texts: List of editable texts, if any.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

The Symbol tool can be used in macros and from the Python console by using the following functions:

sym = FreeCAD.ActiveDocument.addObject('TechDraw::DrawViewSymbol','TestSymbol')
rc = page.addView(anno)
f = open(unicode(symbolFileSpec,'utf-8'),'r')
svg = f.read()
f.close()
sym.Symbol = svg
rc = page.addView(sym)