TechDraw CosmeticVertex: Difference between revisions

From FreeCAD Documentation
(info how to delete)
No edit summary
 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:16-->
<!--T:16-->
{{Docnav
{{Docnav
|[[TechDraw_RichTextAnnotation|Insert Rich Text Annotation]]
|[[TechDraw_RichTextAnnotation|RichTextAnnotation]]
|[[TechDraw_Midpoints|Add Midpoint Vertices]]
|[[TechDraw_Midpoints|Midpoints]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_RichTextAnnotation.svg
|IconL=TechDraw_RichTextAnnotation.svg
⚫
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw_Midpoints.svg
|IconR=TechDraw_Midpoints.svg
⚫
|IconC=Workbench_TechDraw.svg
}}
}}


Line 15: Line 16:
|Name=TechDraw CosmeticVertex
|Name=TechDraw CosmeticVertex
|MenuLocation=TechDraw → Add Vertices → Add Cosmetic Vertex
|MenuLocation=TechDraw → Add Vertices → Add Cosmetic Vertex
|Workbenches=[[TechDraw Module|TechDraw]]
|Workbenches=[[TechDraw_Workbench|TechDraw]]
⚫
|SeeAlso=[[TechDraw_Midpoints|Add Midpoint Vertices]], [[TechDraw_Quadrants|Add Quadrant Vertices]]
|Version=0.19
|Version=0.19
⚫
|SeeAlso=[[TechDraw_Midpoints|TechDraw Midpoint]], [[TechDraw_Quadrants|TechDraw Quadrant]]
}}
}}


Line 23: Line 24:


<!--T:8-->
<!--T:8-->
The Cosmetic Vertex tool adds a [[Glossary#V|Vertex]], which is not part of the source geometry, to a View. This Vertex behaves like any other vertex and can be used for dimensioning.
The '''TechDraw CosmeticVertex''' tool adds a [[Glossary#V|vertex]], which is not part of the source geometry, to a view. This vertex behaves like any other vertex and can be used for dimensioning.


</translate>
</translate>
Line 29: Line 30:
<translate>
<translate>
<!--T:9-->
<!--T:9-->
{{Caption|Cosmetic Vertex used to create an otherwise impossible Dimension}}
{{Caption|Cosmetic vertices used to create an otherwise impossible dimension}}


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


<!--T:10-->
<!--T:10-->
# Select a view in the drawing.
# Select a view.
# There are several ways to invoke the tool:
# Press the {{Button|[[Image:TechDraw_CosmeticVertex.svg|16px]] Add Cosmetic Vertex}} button
#* Press the {{Button|[[Image:TechDraw_CosmeticVertex.svg|16px]] [[TechDraw_CosmeticVertex|Add Cosmetic Vertex]]}} button.
# A task dialog will open. It allows to set location of the Cosmetic Vertex either by picking a point or by entering an x,y-offset from the center of the selected view.
#* Select the {{MenuCommand|TechDraw → Add Vertices → [[Image:TechDraw_CosmeticVertex.svg|16px]] Add Cosmetic Vertex}} option from the menu.
# To pick a position, press the button {{Button|Point Picker}}. Click to a position in the view and subsequently press {{Button|OK}} to create the point. To exit the point picking without creating a Cosmetic Vertex, press the {{Button|Escape picking}} button in the dialog.
# A task panel opens.
# Optionally press the {{Button|Point Picker}} button and pick a point on the page. Press the {{Button|Escape picking}} button to cancel this operation.
# Optionally change or specify the X and Y coordinates of the point. The coordinates are relative to the center of the view.
# Press the {{Button|OK}} button.


==Notes== <!--T:24-->
To delete a Cosmetic Vertex, select it and use the toolbar button {{Button|[[Image:TechDraw_CosmeticEraser.svg|16px]] [[TechDraw_CosmeticEraser|Remove Cosmetic Object]]}}.


<!--T:25-->
'''Note:''' You cannot change the location of the Cosmetic Vertex after it has been created. At the moment there is no other way than to delete it and creating a new one.
* You cannot change the position of an existing cosmetic vertex. At the moment there is no other way than to delete it and create a new one.


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


<!--T:20-->
<!--T:20-->
Cosmetic Vertices have no properties of their own, as they are no document objects. They share color and size settings with regular geometry vertices.
Cosmetic vertices have no properties of their own, as they are not document objects. They share color and size settings with regular geometry vertices.


==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-->
Cosmetic Vertices are available to [[macros|macros]] or the [[Python|Python]] console.
Cosmetic vertices are available to [[Macros|macros]] or the [[Python|Python]] console.


</translate>
</translate>
Line 70: Line 76:
dvp.makeCosmeticLine(start,end,style, weight, pyGreen)
dvp.makeCosmeticLine(start,end,style, weight, pyGreen)
}}
}}

<translate>
<translate>



<!--T:17-->
<!--T:17-->
{{Docnav
{{Docnav
|[[TechDraw_RichTextAnnotation|Insert Rich Text Annotation]]
|[[TechDraw_RichTextAnnotation|RichTextAnnotation]]
|[[TechDraw_Midpoints|Add Midpoint Vertices]]
|[[TechDraw_Midpoints|Midpoints]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=TechDraw_RichTextAnnotation.svg
|IconL=TechDraw_RichTextAnnotation.svg
⚫
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw_Midpoints.svg
|IconR=TechDraw_Midpoints.svg
⚫
|IconC=Workbench_TechDraw.svg
}}
}}


Latest revision as of 13:07, 26 March 2024

Other languages:

TechDraw CosmeticVertex

Menu location
TechDraw → Add Vertices → Add Cosmetic Vertex
Workbenches
TechDraw
Default shortcut
None
Introduced in version
0.19
See also
TechDraw Midpoint, TechDraw Quadrant

Description

The TechDraw CosmeticVertex tool adds a vertex, which is not part of the source geometry, to a view. This vertex behaves like any other vertex and can be used for dimensioning.

Cosmetic vertices used to create an otherwise impossible dimension

Usage

  1. Select a view.
  2. There are several ways to invoke the tool:
    • Press the Add Cosmetic Vertex button.
    • Select the TechDraw → Add Vertices → Add Cosmetic Vertex option from the menu.
  3. A task panel opens.
  4. Optionally press the Point Picker button and pick a point on the page. Press the Escape picking button to cancel this operation.
  5. Optionally change or specify the X and Y coordinates of the point. The coordinates are relative to the center of the view.
  6. Press the OK button.

Notes

  • You cannot change the position of an existing cosmetic vertex. At the moment there is no other way than to delete it and create a new one.

Properties

Cosmetic vertices have no properties of their own, as they are not document objects. They share color and size settings with regular geometry vertices.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

Cosmetic vertices are available to macros or the Python console. 

dvp = App.ActiveDocument.View
org = App.Vector(0.0, 0.0, 0.0)
dvp.makeCosmeticVertex(org);

#lines too!
start = FreeCAD.Vector (1.0, 5.0, 0.0)
end = FreeCAD.Vector(1.0, -5.0, 0.0)
style = 2
weight = 0.75
pyGreen = (0.0, 0.0, 1.0, 0.0)
dvp.makeCosmeticLine(start,end,style, weight, pyGreen)


TechDraw
User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=TechDraw_CosmeticVertex&oldid=1386158"