TechDraw CosmeticVertex: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
(16 intermediate revisions by 5 users not shown)
Line 2: Line 2:
<translate>
<translate>
<!--T:16-->
<!--T:16-->
{{Docnav
{{Docnav|[[TechDraw_RichTextBlock|RichTextBlock]]|[[TechDraw_Midpoints|Midpoints]]|[[TechDraw_Module|TechDraw]]|IconL=Techdraw-textleader.svg|IconC=Workbench_TechDraw.svg|IconR=Techdraw-midpoint.svg}}
|[[TechDraw_RichTextAnnotation|Insert Rich Text Annotation]]
|[[TechDraw_Midpoints|Add Midpoint Vertices]]
|[[TechDraw_Module|TechDraw]]
|IconL=TechDraw_RichTextAnnotation.svg
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw_Midpoints.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=TechDraw CosmeticVertex
|Name=TechDraw CosmeticVertex
|MenuLocation=TechDraw → Add Vertices → Add Cosmetic Vertex
|Icon=techdraw-point.svg
|Workbenches=[[TechDraw_Module|TechDraw]]
|MenuLocation=TechDraw → CosmeticVertex
|SeeAlso=[[TechDraw_Midpoints|TechDraw Add Midpoint Vertices]], [[TechDraw_Quadrants|TechDraw Add Quadrant Vertices]]
|Workbenches=[[TechDraw Module|TechDraw]]
|SeeAlso=[[TechDraw Midpoints]], [[TechDraw Quadrant]]
|Version=0.19
|Version=0.19
}}
}}
Line 17: Line 23:


<!--T:8-->
<!--T:8-->
The Cosmetic Vertex 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.
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.


</translate>
</translate>
[[Image:TechDraw_CosmeticVertex_Sample.png]]
[[Image:TechDraw_CosmeticVertex_Sample.png|300px]]
<translate>
<translate>
<!--T:9-->
<!--T:9-->
{{Caption|Cosmetic Vertex used to create an otherwise impossible Dimension}}
{{Caption|Cosmetic Vertex used to create an otherwise impossible Dimension}}


==How to use== <!--T:3-->
==Usage== <!--T:3-->


<!--T:10-->
<!--T:10-->
# Select a view in the drawing.
# Press the {{Button|[[Image:techdraw-mline.svg|16px]] [[TechDraw CosmeticVertex|CosmeticVertex]]}} button
# Press the {{Button|[[Image:TechDraw_CosmeticVertex.svg|16px]] Add Cosmetic Vertex}} button
# A Task dialog will open. The dialog allows selection of the location of the Cosmetic Vertex though the use of a "point picker" or by entering coordinates. The coordinates are the position within the View relative to the View center.
# The Pick points button starts a "point picker". Once a location is selected a small circle will appear. The Cosmetic Vertex will be added once the "OK" button is pressed.
# 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.
# To exit the "point picker" without creating a Cosmetic Vertex, press the "Escape picking" button in the dialog.
# 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.


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

<!--T:23-->
'''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.


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


<!--T:20-->
<!--T:20-->
Cosmetic Vertices have no properties of their own, as they are not Document Objects. They share color and size settings with regular geometry vertices.
Cosmetic Vertices have no properties of their own, as they are no 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]] and [[FreeCAD Scripting Basics]].
{{Emphasis|See also:}} [[TechDraw_API|TechDraw API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].


<!--T:13-->
<!--T:13-->
Cosmetic Vertices are available to [[macros]] or the [[Python]] console.
Cosmetic Vertices are available to [[Macros|macros]] or the [[Python|Python]] console.


</translate>
</translate>
Line 65: Line 76:


<!--T:17-->
<!--T:17-->
{{Docnav
{{Docnav|[[TechDraw_RichTextBlock|RichTextBlock]]|[[TechDraw_Midpoints|Midpoints]]|[[TechDraw_Module|TechDraw]]|IconL=Techdraw-textleader.svg|IconC=Workbench_TechDraw.svg|IconR=Techdraw-midpoint.svg}}
|[[TechDraw_RichTextAnnotation|Insert Rich Text Annotation]]

|[[TechDraw_Midpoints|Add Midpoint Vertices]]
<!--T:14-->
|[[TechDraw_Module|TechDraw]]
{{TechDraw Tools navi}}
|IconL=TechDraw_RichTextAnnotation.svg
|IconC=Workbench_TechDraw.svg
|IconR=TechDraw_Midpoints.svg
}}


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

Revision as of 21:36, 22 November 2020

TechDraw CosmeticVertex

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

Description

The Cosmetic Vertex 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 Vertex used to create an otherwise impossible Dimension

Usage

  1. Select a view in the drawing.
  2. Press the Add Cosmetic Vertex button
  3. 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.
  4. To pick a position, press the button Point Picker. Click to a position in the view and subsequently press OK to create the point. To exit the point picking without creating a Cosmetic Vertex, press the Escape picking button in the dialog.

To delete a Cosmetic Vertex, select it and use the toolbar button Remove Cosmetic Object.

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.

Properties

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

Scripting

See also: TechDraw API 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)