TechDraw Symbol: Difference between revisions

From FreeCAD Documentation
({{TechDraw Tools navi}} and {{Userdocnavi}})
(Usage)
 
(44 intermediate revisions by 10 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:16-->
{{Docnav
|[[TechDraw_GeometricHatch|GeometricHatch]]
|[[TechDraw_Image|Image]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_GeometricHatch.svg
|IconR=TechDraw_Image.svg
|IconC=Workbench_TechDraw.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=TechDraw Symbol|Workbenches=[[TechDraw Module|TechDraw]]|MenuLocation=TechDraw → Symbol|Shortcut=|SeeAlso=}}
|Name=TechDraw Symbol
|MenuLocation=TechDraw → TechDraw Views → Insert SVG Symbol
|Workbenches=[[TechDraw_Workbench|TechDraw]]
|SeeAlso=[[TechDraw_Templates|TechDraw Templates]], [[Draft_SVG|Draft SVG]]
}}


==Description== <!--T:2-->
==Description== <!--T:2-->
The Symbol tool inserts an SVG file into the page as a view


==How to use== <!--T:3-->
<!--T:8-->
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.
# Press the {{KEY|[[Image:Symbol.png|24px]] [[TechDraw Symbol|Symbol]]}} button
# A File Save dialog will open. Select a location and file name.


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


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

* n/a
<!--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]].
# There are several ways to invoke the tool:
#* 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.
# The symbol is inserted.
# Optionally change its {{PropertyData|Scale}} property to adjust its size.

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

<!--T:19-->
* {{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-->
{{Emphasis|See also:}} [[TechDraw API]] and [[FreeCAD Scripting Basics]].


<!--T:12-->
The Symbol tool can be used in [[macros]] and from the [[Python]] console by using the following functions:
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].

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


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

<translate>
<translate>


==Notes== <!--T:7-->
* Symbol appear larger than expected. Use the Scale property to adjust the size.


<!--T:17-->
{{TechDraw Tools navi}}
{{Docnav
{{Userdocnavi}}
|[[TechDraw_GeometricHatch|GeometricHatch]]
|[[TechDraw_Image|Image]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_GeometricHatch.svg
|IconR=TechDraw_Image.svg
|IconC=Workbench_TechDraw.svg
}}

</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)