TechDraw Symbol: Difference between revisions

From FreeCAD Documentation
No edit summary
(Usage)
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:16-->
<!--T:16-->
{{Docnav
{{Docnav
|[[TechDraw_GeometricHatch|Geometric Hatch]]
|[[TechDraw_GeometricHatch|GeometricHatch]]
|[[TechDraw_Image|Bitmap Image]]
|[[TechDraw_Image|Image]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_GeometricHatch.svg
|IconL=TechDraw_GeometricHatch.svg
|IconR=TechDraw_Image.svg
|IconR=TechDraw_Image.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>
Line 33: Line 34:


<!--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-->
Line 45: Line 50:
<!--T:19-->
<!--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.
* {{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-->
Line 64: Line 80:
rc = page.addView(sym)
rc = page.addView(sym)
}}
}}

<translate>
<translate>



<!--T:17-->
<!--T:17-->
{{Docnav
{{Docnav
|[[TechDraw_GeometricHatch|Geometric Hatch]]
|[[TechDraw_GeometricHatch|GeometricHatch]]
|[[TechDraw_Image|Bitmap Image]]
|[[TechDraw_Image|Image]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_GeometricHatch.svg
|IconL=TechDraw_GeometricHatch.svg
|IconR=TechDraw_Image.svg
|IconR=TechDraw_Image.svg

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)