Difference between revisions of "TechDraw CosmeticVertex"

From FreeCAD Documentation
Jump to navigation Jump to search
(Marked this version for translation)
 
(13 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
<!--T:16-->
 
<!--T:16-->
 
{{Docnav
 
{{Docnav
|[[TechDraw_RichTextBlock|RichTextBlock]]
+
|[[TechDraw_RichTextAnnotation|Insert Rich Text Annotation]]
|[[TechDraw_Midpoints|Midpoints]]
+
|[[TechDraw_Midpoints|Add Midpoint Vertices]]
 
|[[TechDraw_Module|TechDraw]]
 
|[[TechDraw_Module|TechDraw]]
|IconL=Techdraw-textleader.svg
+
|IconL=TechDraw_RichTextAnnotation.svg
 
|IconC=Workbench_TechDraw.svg
 
|IconC=Workbench_TechDraw.svg
|IconR=Techdraw-midpoint.svg
+
|IconR=TechDraw_Midpoints.svg
 
}}
 
}}
  
Line 14: Line 14:
 
{{GuiCommand
 
{{GuiCommand
 
|Name=TechDraw CosmeticVertex
 
|Name=TechDraw CosmeticVertex
|Icon=techdraw-point.svg
 
 
|MenuLocation=TechDraw → Add Vertices → Add Cosmetic Vertex  
 
|MenuLocation=TechDraw → Add Vertices → Add Cosmetic Vertex  
 
|Workbenches=[[TechDraw Module|TechDraw]]
 
|Workbenches=[[TechDraw Module|TechDraw]]
|SeeAlso=[[TechDraw Midpoints]], [[TechDraw Quadrant]]
+
|SeeAlso=[[TechDraw_Midpoints|Add Midpoint Vertices]], [[TechDraw_Quadrants|Add Quadrant Vertices]]
 
|Version=0.19
 
|Version=0.19
 
}}
 
}}
Line 24: 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-->
# Press the {{Button|[[Image:techdraw-mline.svg|16px]] [[TechDraw CosmeticVertex|CosmeticVertex]]}} button
+
# Select a view in the drawing.
# 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.
+
# Press the {{Button|[[Image:TechDraw_CosmeticVertex.svg|16px]] Add Cosmetic Vertex}} button
# 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-->
Line 73: Line 77:
 
<!--T:17-->
 
<!--T:17-->
 
{{Docnav
 
{{Docnav
|[[TechDraw_RichTextBlock|RichTextBlock]]
+
|[[TechDraw_RichTextAnnotation|Insert Rich Text Annotation]]
|[[TechDraw_Midpoints|Midpoints]]
+
|[[TechDraw_Midpoints|Add Midpoint Vertices]]
 
|[[TechDraw_Module|TechDraw]]
 
|[[TechDraw_Module|TechDraw]]
|IconL=Techdraw-textleader.svg
+
|IconL=TechDraw_RichTextAnnotation.svg
 
|IconC=Workbench_TechDraw.svg
 
|IconC=Workbench_TechDraw.svg
|IconR=Techdraw-midpoint.svg
+
|IconR=TechDraw_Midpoints.svg
 
}}
 
}}
  
<!--T:14-->
 
{{TechDraw Tools navi}}
 
 
<!--T:15-->
 
{{Userdocnavi}}
 
 
</translate>
 
</translate>
 +
{{TechDraw Tools navi{{#translation:}}}}
 +
{{Userdocnavi{{#translation:}}}}
 
{{clear}}
 
{{clear}}

Latest revision as of 21:08, 29 March 2020

Other languages:
Deutsch • ‎English • ‎français • ‎italiano

TechDraw CosmeticVertex.svg TechDraw CosmeticVertex

Menu location
TechDraw → Add Vertices → Add Cosmetic Vertex
Workbenches
TechDraw
Default shortcut
None
Introduced in version
0.19
See also
Add Midpoint Vertices, 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.

TechDraw CosmeticVertex Sample.png

Cosmetic Vertex used to create an otherwise impossible Dimension


Usage

  1. Select a view in the drawing.
  2. Press the TechDraw CosmeticVertex.svg 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 TechDraw CosmeticEraser.svg 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)