TechDraw FaceCenterLine/en: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(One intermediate revision by the same user not shown)
Line 21: Line 21:
The FaceCenterLine tool adds a centerline to selected faces.
The FaceCenterLine tool adds a centerline to selected faces.


[[Image:TechDraw_FaceCenterLine_Sample.png]]
[[Image:TechDraw_FaceCenterLine_Sample.png|400px]]
{{Caption|Center line added to face}}
{{Caption|Centerline added to face}}


==Usage==
==Usage==


# 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|Add Centerline to Face(s)]]}} 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).


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


==Editing Centerlines==
Any of the centerline command buttons(

{{Button|[[Image:TechDraw_FaceCenterLine.svg|16px]] [[TechDraw_FaceCenterLine|Add Centerline to Face(s)]]}},
Any of the centerline command buttons ({{Button|[[Image:TechDraw_FaceCenterLine.svg|16px]] Add Centerline to Face(s)}},
{{Button|[[Image:TechDraw_2LineCenterLine.svg|16px]] [[TechDraw_2LineCenterLine|Add Centerline between 2 Lines]]}},
{{Button|[[Image:TechDraw_2LineCenterLine.svg|16px]] [[TechDraw_2LineCenterLine|Add Centerline between 2 Lines]]}},
{{Button|[[Image:TechDraw_2PointCenterLine.svg|16px]] [[TechDraw_2PointCenterLine|Add Centerline between 2 Points]]}})
{{Button|[[Image:TechDraw_2PointCenterLine.svg|16px]] [[TechDraw_2PointCenterLine|Add Centerline between 2 Points]]}})
can be used to edit any centerline.
can be used to edit any centerline.


# Select a center line.
# Select a centerline.
# Press any center line command button.
# Press any centerline command button.
# A dialog will open where you can change attributes of the center line.
# A dialog will open where you can change attributes of the centerline.
# Press {{Button|OK}} to see your changes.
# Press {{Button|OK}} to see your changes.


==Properties==
==Properties==


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.


# 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: NoLine, Continuous, Dash, Dot, DashDot, DashDotDot
# '''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


==Scripting==
==Scripting==
Line 64: Line 65:
{{Emphasis|See also:}} [[TechDraw API|TechDraw API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
{{Emphasis|See also:}} [[TechDraw API|TechDraw API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


Cosmetic center lines are not accessible from [[macros|macros]] or the [[Python|Python]] console at this time.
Centerlines are not accessible from [[macros|macros]] or the [[Python|Python]] console at this time.


==Notes==
==Notes==
Line 81: Line 82:
}}
}}


{{TechDraw Tools navi}}
{{TechDraw Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

{{Userdocnavi}}
{{clear}}
{{clear}}

Revision as of 21:09, 29 March 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
Add Cosmetic Vertex, Add Centerline between 2 Lines, Add Centerline between 2 Points, Remove Cosmetic Object

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.