TechDraw FaceCenterLine: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
(22 intermediate revisions by 6 users not shown)
Line 2: Line 2:
<translate>
<translate>
<!--T:16-->
<!--T:16-->
{{Docnav
{{Docnav|[[TechDraw_Quadrant|Quadrant]]|[[TechDraw_2LineCenterLine|2LineCenterLine]]|[[TechDraw_Module|TechDraw]]|IconL=techdraw-quadrant.svg|IconC=Workbench_TechDraw.svg|IconR=techdraw-2linecenterline.svg}}
|[[TechDraw_Quadrants|Quadrant]]
|[[TechDraw_2LineCenterLine|Centerline between 2 Lines]]
|[[TechDraw_Module|TechDraw]]
|IconL=TechDraw_Quadrants.svg
|IconR=TechDraw_2LineCenterLine.svg
|IconC=Workbench_TechDraw.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=TechDraw FaceCenterLine
|Name=TechDraw FaceCenterLine
|MenuLocation=TechDraw → Add Lines → Add Centerline to Face(s)
|Icon=techdraw-facecenterline.svg
|Workbenches=[[TechDraw_Module|TechDraw]]
|MenuLocation=TechDraw → FaceCenterLine
|Workbenches=[[TechDraw Module|TechDraw]]
|SeeAlso=[[TechDraw CosmeticVertex]], [[TechDraw CosmeticEraser]]
|Version=0.19
|Version=0.19
|SeeAlso=[[TechDraw_CosmeticVertex|TechDraw Cosmetic Vertex]], [[TechDraw_2LineCenterLine|TechDraw Centerline between 2 Lines]], [[TechDraw_2PointCenterLine|TechDraw Centerline between 2 Points]], [[TechDraw_CosmeticEraser|TechDraw Cosmetic Eraser]]
}}
}}


Line 17: Line 23:


<!--T:8-->
<!--T:8-->
The FaceCenterLine tool adds a center line to one or more Faces.
The 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 face}}


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


<!--T:10-->
<!--T:10-->
# Select one or more Faces in a View.
# Select one or more Faces in a View.
# Press the {{Button|[[Image:techdraw-facecenterline.svg|16px]] [[TechDraw FaceCenterLine|FaceCenterLine]]}} button
# Press the {{Button|[[Image:TechDraw_FaceCenterLine.svg|16px]] Add Centerline to Face(s)}} button
# A dialog will open where you can specify attributes of the new center line.
# A dialog will open where you can specify attributes of the new centerline.
# A center line will be added at the midpoint of the bounding box of the selected Face(s).
# A centerline will be added at the midpoint of the bounding box of the selected Face(s).


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


==Editing Centerlines== <!--T:21-->
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]]}},
{{Button|[[Image:techdraw-2pointcenterline.svg|16px]] [[TechDraw 2PointCenterLine|2PointCenterLine]]}})
can be used to edit any center line.


<!--T:22-->
# Select a center line.
Any of the centerline command buttons ({{Button|[[Image:TechDraw_FaceCenterLine.svg|16px]] Add Centerline to Face(s)}},
# Press any center line command button.
{{Button|[[Image:TechDraw_2LineCenterLine.svg|16px]] [[TechDraw_2LineCenterLine|Add Centerline between 2 Lines]]}},
# A dialog will open where you can change attributes of the center line.
{{Button|[[Image:TechDraw_2PointCenterLine.svg|16px]] [[TechDraw_2PointCenterLine|Add Centerline between 2 Points]]}})
# Press OK to see your changes.
can be used to edit any centerline.

<!--T:23-->
# Select a centerline.
# Press any centerline command button.
# A dialog will open where you can change attributes of the centerline.
# Press {{Button|OK}} to see your changes.


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


<!--T:20-->
<!--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
Centerlines have no properties of their own, as they are no document objects. They have attributes that can be changed in the centerline edit dialog.


<!--T:24-->
# Mode (radio buttons):
# Mode (radio buttons):
## Vertical: force center line vertical
#* '''Vertical''': Forces a centerline vertical
## Horizontal: force center line horizontal
#* '''Horizontal''': Forces a centerline horizontal
## Aligned: follow the general direction of the Edge for 2 Edge center line
#* '''''Aligned''': This option is not possible for centerline to faces''
# Shift Horiz: move the center line left or right of its normal position
# '''Shift Horiz''': Moves the centerline left or right of its normal position
# Shift Vert: move the center line up or down from its normal position
# '''Shift Vert''': 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 center (degrees. + counterclockwise, - clockwise)
# Extend: make the center line longer by this amount
# '''Extend''': Makes the centerline longer by this amount
# Color: color of center line
# '''Color''': Color of centerline
# Weight: thickness of the center line
# '''Weight''': Thickness of the centerline
# '''Style''': [[Image:Continuous-line.svg|20px]] Continuous, [[Image:Dash-line.svg|20px]] Dash, [[Image:Dot-line.svg|20px]] Dot, [[Image:DashDot-line.svg|20px]] DashDot, [[Image:DashDotDot-line.svg|20px]] DashDotDot
# Style: NoLine, Solid, Dash, Dot, DashDot, DashDotDot


==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 center lines are not accessible from [[macros]] or the [[Python]] console at this time.
Centerlines are not accessible from [[Macros|macros]] or the [[Python|Python]] console at this time.


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


<!--T:25-->
* FaceCenterLine will eventually replace two View properties:
* FaceCenterLine 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.



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

|[[TechDraw_2LineCenterLine|Centerline between 2 Lines]]
<!--T:14-->
|[[TechDraw_Module|TechDraw]]
{{TechDraw Tools navi}}
|IconL=TechDraw_Quadrants.svg
|IconR=TechDraw_2LineCenterLine.svg
|IconC=Workbench_TechDraw.svg
}}


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

Revision as of 21:17, 21 December 2020

TechDraw FaceCenterLine

Menu location
TechDraw → Add Lines → Add Centerline to Face(s)
Workbenches
TechDraw
Default shortcut
None
Introduced in version
0.19
See also
TechDraw Cosmetic Vertex, TechDraw Centerline between 2 Lines, TechDraw Centerline between 2 Points, TechDraw Cosmetic Eraser

Description

The FaceCenterLine tool adds a centerline to selected faces.

Centerline added to face

Usage

  1. Select one or more Faces in a View.
  2. Press the Add Centerline to Face(s) button
  3. A dialog will open where you can specify attributes of the new centerline.
  4. A centerline will be added at the midpoint of the bounding box of the selected Face(s).

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

Editing Centerlines

Any of the centerline command buttons ( Add Centerline to Face(s), Add Centerline between 2 Lines, Add Centerline between 2 Points) can be used to edit any centerline.

  1. Select a centerline.
  2. Press any centerline command button.
  3. A dialog will open where you can change attributes of the centerline.
  4. Press OK to see your changes.

Properties

Centerlines have no properties of their own, as they are no document objects. They have attributes that can be changed in the centerline edit dialog.

  1. Mode (radio buttons):
    • Vertical: Forces a centerline vertical
    • Horizontal: Forces a centerline horizontal
    • Aligned: This option is not possible for centerline to faces
  2. Shift Horiz: Moves the centerline left or right of its normal position
  3. Shift Vert: Moves the centerline up or down from its normal position
  4. Rotate: Rotates the centerline around its center (degrees. + counterclockwise, - clockwise)
  5. Extend: Makes the centerline longer by this amount
  6. Color: Color of centerline
  7. Weight: Thickness of the centerline
  8. Style: Continuous, Dash, Dot, DashDot, DashDotDot

Scripting

See also: TechDraw API and FreeCAD Scripting Basics.

Centerlines are not accessible from macros or the Python console at this time.

Notes

  • FaceCenterLine will eventually replace two View properties:
    • ViewHorizCenterLine: Show a horizontal centerline through view.
    • ViewVertCenterLine: Show a vertical centerline through view.