TechDraw FaceCenterLine: Difference between revisions

From FreeCAD Documentation
No edit summary
(Marked this version for translation)
 
(51 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:16-->
<!--T:16-->
{{Docnav
{{Docnav
|[[TechDraw_Quadrants|Quadrants]]
|[[TechDraw_Quadrant|Quadrant]]
|[[TechDraw_2LineCenterLine|2LineCenterLine]]
|[[TechDraw_2LineCenterLine|2LineCenterLine]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=techdraw-quadrant.svg
|IconL=TechDraw_Quadrants.svg
|IconR=TechDraw_2LineCenterLine.svg
|IconC=Workbench_TechDraw.svg
|IconC=Workbench_TechDraw.svg
|IconR=techdraw-2linecenterline.svg
}}
}}


Line 14: Line 15:
{{GuiCommand
{{GuiCommand
|Name=TechDraw FaceCenterLine
|Name=TechDraw FaceCenterLine
|MenuLocation=TechDraw → Add Lines → Add Centerline to Faces
|Icon=techdraw-facecenterline.svg
|Workbenches=[[TechDraw_Workbench|TechDraw]]
|MenuLocation=TechDraw → Add Lines → Add Centerline to Face(s)
|Workbenches=[[TechDraw Module|TechDraw]]
|SeeAlso=[[TechDraw CosmeticVertex]], [[TechDraw CosmeticEraser]]
|Version=0.19
|Version=0.19
|SeeAlso=[[TechDraw_2LineCenterLine|TechDraw 2LineCenterLine]], [[TechDraw_2PointCenterLine|TechDraw 2PointCenterLine]]
}}
}}


Line 24: Line 24:


<!--T:8-->
<!--T:8-->
The FaceCenterLine tool adds a center line to one or more Faces.
The '''TechDraw FaceCenterLine''' tool adds a centerline to selected faces.


</translate>
</translate>
[[Image:TechDraw_FaceCenterLine_Sample.png]]
[[Image:TechDraw_FaceCenterLine_Sample.png|400px]]
<translate>
<translate>
<!--T:9-->
<!--T:9-->
{{Caption|Center line added to face}}
{{Caption|Centerline added to a face}}


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


<!--T:10-->
<!--T:10-->
# Select one or more Faces in a View.
# Select one or more faces in a View.
# There are several ways to invoke the tool:
# Press the {{Button|[[Image:techdraw-facecenterline.svg|16px]] [[TechDraw FaceCenterLine|FaceCenterLine]]}} button
#* Press the {{Button|[[Image:TechDraw_FaceCenterLine.svg|16px]] [[TechDraw_FaceCenterLine|Add Centerline to Faces]]}} button.
# A dialog will open where you can specify attributes of the new center line.
#* Select the {{MenuCommand|TechDraw → Add Lines → [[Image:TechDraw_FaceCenterLine.svg|16px]] Add Centerline to Faces}} option from the menu.
# A center line will be added at the midpoint of the bounding box of the selected Face(s).
# A task panel opens. See [[#Options|Options]] for more information.
# Press the {{Button|OK}} button to confirm.
# A centerline is added at the midpoint of the bounding box of the selected face(s).


==Editing Center Lines== <!--T:21-->
==Usage edit== <!--T:28-->


<!--T:22-->
<!--T:22-->
Any of the center line command buttons ({{Button|[[Image:techdraw-facecenterline.svg|16px]] [[TechDraw FaceCenterLine|FaceCenterLine]]}}, {{Button|[[Image:techdraw-2linecenterline.svg|16px]] [[TechDraw 2LineCenterLine|2LineCenterLine]]}},
Any of the centerline tools ([[Image:TechDraw_FaceCenterLine.svg|16px]] TechDraw FaceCenterLine, [[Image:TechDraw_2LineCenterLine.svg|16px]] [[TechDraw_2LineCenterLine|TechDraw 2LineCenterLine]] and [[Image:TechDraw_2PointCenterLine.svg|16px]] [[TechDraw_2PointCenterLine|TechDraw 2PointCenterLine]]) can be used to edit any centerline.
{{Button|[[Image:techdraw-2pointcenterline.svg|16px]] [[TechDraw 2PointCenterLine|2PointCenterLine]]}})
can be used to edit any center line.


<!--T:23-->
<!--T:23-->
# Select a center line.
# Select a centerline.
# Invoke a centerline tool.
# Press any center line command button.
# A task panel opens. See [[#Options|Options]] for more information.
# A dialog will open where you can change attributes of the center line.
# Press OK to see your changes.
# Press the {{Button|OK}} button to confirm.


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

<!--T:20-->
Cosmetic center lines have no properties of their own, as they are not Document Objects. They do have attributes that can be changed in the center line edit dialog. Not all attributes apply to all center lines


<!--T:24-->
<!--T:24-->
* '''Orientation''':
# Mode (radio buttons):
## Vertical: force center line vertical
** '''Vertical''': Forces the centerline vertical. Ignored for 2PointCenterLines.
## Horizontal: force center line horizontal
** '''Horizontal''': Forces the centerline horizontal. Ignored for 2PointCenterLines.
## Aligned: follow the general direction of the Edge for 2 Edge center line
** '''Aligned''': Not available for FaceCenterLines. Forces the centerline to follow the general direction of the selected edges for 2LineCenterLines. Ignored for 2PointCenterLines.
# Shift Horiz: move the center line left or right of its normal position
* '''Shift Horizontal''': Moves the centerline left or right of its normal position.
# Shift Vert: move the center line up or down from its normal position
* '''Shift Vertical''': Moves the centerline up or down from its normal position.
# Rotate: rotate the center line around its center (degrees. + CCW, -CW)
* '''Rotate''': Rotates the centerline around its midpoint (degrees. + counterclockwise, - clockwise).
# Extend: make the center line longer by this amount
* '''Extend By''': Makes the centerline longer by this amount.
# Color: color of center line
* '''Color''': The color of the centerline.
# Weight: thickness of the center line
* '''Weight''': The width of the centerline.
* '''Style''': The linestyle of the centerline. The options are:
# Style: NoLine, Solid, Dash, Dot, DashDot, DashDotDot
** [[Image:Continuous-line.svg|20px]] '''Continuous'''

** [[Image:Dash-line.svg|20px]] '''Dash'''
==Scripting== <!--T:6-->
** [[Image:Dot-line.svg|20px]] '''Dot'''

** [[Image:DashDot-line.svg|20px]] '''DashDot'''
<!--T:12-->
** [[Image:DashDotDot-line.svg|20px]] '''DashDotDot'''
{{Emphasis|See also:}} [[TechDraw API|TechDraw API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].

<!--T:13-->
Cosmetic center lines are not accessible from [[macros|macros]] or the [[Python|Python]] console at this time.


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


<!--T:25-->
<!--T:25-->
* To delete a centerline use [[Image:TechDraw_CosmeticEraser.svg|16px]] [[TechDraw_CosmeticEraser|TechDraw CosmeticEraser]].
* FaceCenterLine will eventually replace two View properties:
* FaceCenterLines will eventually replace two View properties:
** {{PropertyView|HorizCenterLine}}: Show a horizontal centerline through view.
** {{PropertyView|HorizCenterLine}}: Show a horizontal centerline through view.
** {{PropertyView|VertCenterLine}}: Show a vertical centerline through view.
** {{PropertyView|VertCenterLine}}: Show a vertical centerline through view.

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

<!--T:30-->
Centerlines have no properties of their own, as they are not document objects.




<!--T:17-->
<!--T:17-->
{{Docnav
{{Docnav
|[[TechDraw_Quadrants|Quadrants]]
|[[TechDraw_Quadrant|Quadrant]]
|[[TechDraw_2LineCenterLine|2LineCenterLine]]
|[[TechDraw_2LineCenterLine|2LineCenterLine]]
|[[TechDraw_Module|TechDraw]]
|[[TechDraw_Workbench|TechDraw]]
|IconL=techdraw-quadrant.svg
|IconL=TechDraw_Quadrants.svg
|IconR=TechDraw_2LineCenterLine.svg
|IconC=Workbench_TechDraw.svg
|IconC=Workbench_TechDraw.svg
|IconR=techdraw-2linecenterline.svg
}}
}}


<!--T:14-->
{{TechDraw Tools navi}}

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

Latest revision as of 15:08, 26 July 2023

TechDraw FaceCenterLine

Menu location
TechDraw → Add Lines → Add Centerline to Faces
Workbenches
TechDraw
Default shortcut
None
Introduced in version
0.19
See also
TechDraw 2LineCenterLine, TechDraw 2PointCenterLine

Description

The TechDraw FaceCenterLine tool adds a centerline to selected faces.

Centerline added to a face

Usage create

  1. Select one or more faces in a View.
  2. There are several ways to invoke the tool:
    • Press the Add Centerline to Faces button.
    • Select the TechDraw → Add Lines → Add Centerline to Faces option from the menu.
  3. A task panel opens. See Options for more information.
  4. Press the OK button to confirm.
  5. A centerline is added at the midpoint of the bounding box of the selected face(s).

Usage edit

Any of the centerline tools ( TechDraw FaceCenterLine, TechDraw 2LineCenterLine and TechDraw 2PointCenterLine) can be used to edit any centerline.

  1. Select a centerline.
  2. Invoke a centerline tool.
  3. A task panel opens. See Options for more information.
  4. Press the OK button to confirm.

Options

  • Orientation:
    • Vertical: Forces the centerline vertical. Ignored for 2PointCenterLines.
    • Horizontal: Forces the centerline horizontal. Ignored for 2PointCenterLines.
    • Aligned: Not available for FaceCenterLines. Forces the centerline to follow the general direction of the selected edges for 2LineCenterLines. Ignored for 2PointCenterLines.
  • Shift Horizontal: Moves the centerline left or right of its normal position.
  • Shift Vertical: Moves the centerline up or down from its normal position.
  • Rotate: Rotates the centerline around its midpoint (degrees. + counterclockwise, - clockwise).
  • Extend By: Makes the centerline longer by this amount.
  • Color: The color of the centerline.
  • Weight: The width of the centerline.
  • Style: The linestyle of the centerline. The options are:
    • Continuous
    • Dash
    • Dot
    • DashDot
    • DashDotDot

Notes

  • To delete a centerline use TechDraw CosmeticEraser.
  • FaceCenterLines will eventually replace two View properties:
    • ViewHorizCenterLine: Show a horizontal centerline through view.
    • ViewVertCenterLine: Show a vertical centerline through view.

Properties

Centerlines have no properties of their own, as they are not document objects.