Part Mirror: Difference between revisions

From FreeCAD Documentation
No edit summary
mNo edit summary
 
(66 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{UnfinishedDocu}}
<languages/>
<languages/>
<translate>
<translate>

<!--T:13-->
<!--T:13-->
{{Docnav
{{Docnav
|[[Part_Chamfer|Chamfer]]
|[[Part_Revolve|Revolve]]
|[[Part_Scale|Scale]]
|[[Part_RuledSurface|Ruled Surface]]
|[[Part_Module|Part]]
|[[Part_Workbench|Part]]
|IconL=Part_Chamfer.png
|IconL=Part_Revolve.svg
|IconR=Part_Scale.svg
|IconC=Workbench_Part.svg
|IconC=Workbench_Part.svg
|IconR=Part_RuledSurface.svg
}}
}}


Line 15: Line 15:
{{GuiCommand
{{GuiCommand
|Name=Part Mirror
|Name=Part Mirror
|MenuLocation=Part → Mirror
|MenuLocation=Part → Mirroring...
|Workbenches=[[Part Workbench|Part]]
|Workbenches=[[Part_Workbench|Part]]
|SeeAlso=
}}
}}


==Description==
==Description== <!--T:17-->


<!--T:2-->
<!--T:2-->
'Mirror Object' - This tool creates a new object (image) which is a reflection of the original object (source). The image object is created behind a mirror plane. The mirror plane may be standard plane ('''XY''', '''YZ''', or '''XZ'''), or any plane parallel to a standard plane.
'''Part Mirror''' creates a new object (image) which is a reflection of the original object (source). The image object is created behind a mirror plane. The mirror plane may be standard plane ('''XY''', '''YZ''', or '''XZ'''), any plane parallel to a standard plane, or ({{Version|0.22}}) any arbitrary plane by using a reference object.


<!--T:3-->
<!--T:3-->
An example:
An example:


</translate>
<!--T:4-->
[[Image:PARTMirrorBeforev11.png|frame|left|Before]]
[[Image:PARTMirrorBeforev11.png]]
<translate>


<!--T:5-->
<!--T:21-->
{{Caption|Before}}
[[Image:PARTMirrorAfterv11.png|frame|left|After (mirrored through '''YZ''' plane)]]

{{clear}}
</translate>
[[Image:PARTMirrorAfterv11.png]]
<translate>

<!--T:22-->
{{Caption|After mirrored through YZ plane}}


==Usage== <!--T:6-->
==Usage== <!--T:6-->


<!--T:7-->
<!--T:23-->
[[Image:PARTMirrorDialogv11.png]]
[[Image:PartMirroring_Scr1.png]]


<!--T:8-->
<!--T:8-->
# Optionally select one or more source objects.
# Select the source object from the Mirroring Panel list.
# There are several ways to invoke the command:
# Select a standard '''Mirror plane''' from the dropdown menu.
#* Press the {{Button|[[Image:Part_Mirror.svg|16px]] [[Part_Mirror|Mirroring...]]}} button.
# Press {{Button|OK}} to create the image object.
#* Select the {{MenuCommand|Part → [[Image:Part_Mirror.svg|16px]] Mirroring...}} option from the menu.
# If you have not yet selected objects or want to change the selection: pick one or more objects from the '''Shapes''' list.
# Do one of the following:
#* Select a standard '''Mirror plane''' from the dropdown list.
#* {{Version|0.22}}: Select a reference object in the [[Tree_view|Tree view]] or the [[3D_view|3D view]]. The reference object can be any planar face or circular edge.
# Press the {{Button|OK}} button.
# For each source object a separate Part Mirror object is created.


<!--T:24-->
{{clear}}
When the select button label says {{Button|Selecting}} you are in reference selection mode and there is a selection gate in effect, which disallows the selection of unsupported reference objects. Click the button to toggle the selection gate off, the button label then changes to {{Button|Select reference}}.


<!--T:25-->
==Options==
The mirror plane is defined by a {{PropertyData|Normal}} (direction) and a {{PropertyData|Base}} (position). When the {{PropertyData|Mirror Plane}} property contains a reference object these properties are made read-only as they are then computed based on that object. The plane is infinite even if the reference object is not.

<!--T:26-->
A reference object can be a planar face, such as the face of a [[Part_Box|Part Box]], a circular edge, a [[PartDesign_Plane|Datum Plane]], an [[App_OriginGroupExtension|origin plane]] of a [[Std_Part|Std Part]] container, or any object with a single planar face or single circular edge. There is also support for [[App_Link|Links]]. Note, however, that B-spline surfaces, such as [[Part_RuledSurface|ruled surfaces]] or [[Part_Loft|loft faces]] are not supported.

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


<!--T:10-->
<!--T:10-->
The '''Base point''' boxes can be used to move the mirror plane parallel to the selected standard mirror plane. Only one of the '''X''', '''Y''', or '''Z''' boxes is effective for a given standard plane.
If a standard plane instead of a reference object is selected, the '''Base point''' boxes can be used to move it. Only one of the '''X''', '''Y''', or '''Z''' boxes is effective for a given standard plane.


<!--T:11-->
<!--T:11-->
{| class="wikitable" border="1"
{| class="wikitable" border="1"
!Standard Plane!!Base Point Box!!Effect
!Standard plane!!Base point box!!Effect
|- align="center"
|- align="center"
|'''XY'''||'''Z'''|| align="left" |Move mirror plane along '''Z''' axis.
|'''XY'''||'''Z'''||align="left"|Move mirror plane along '''Z''' axis
|- align="center"
|- align="center"
|'''XY'''||'''X''', '''Y'''|| align="left" |No effect.
|'''XY'''||'''X''', '''Y'''||align="left"|No effect
|- align="center"
|- align="center"
|'''XZ'''||'''Y'''|| align="left" |Move mirror plane along '''Y''' axis.
|'''XZ'''||'''Y'''||align="left"|Move mirror plane along '''Y''' axis
|- align="center"
|- align="center"
|'''XZ'''||'''X''', '''Z'''|| align="left" |No effect.
|'''XZ'''||'''X''', '''Z'''||align="left"|No effect
|- align="center"
|- align="center"
|'''YZ'''||'''X'''|| align="left" |Move mirror plane along '''X''' axis.
|'''YZ'''||'''X'''||align="left"|Move mirror plane along '''X''' axis
|- align="center"
|- align="center"
|'''YZ'''||'''Y''', '''Z'''|| align="left" |No effect.
|'''YZ'''||'''Y''', '''Z'''||align="left"|No effect
|}
|}


==Limitations== <!--T:12-->
==Notes== <!--T:20-->

* Arbitrary mirror planes (ie not parallel to a standard plane) are not supported (as of FC version 0.13).
<!--T:12-->
* [[App_Link|App Link]] objects linked to the appropriate object types and [[App_Part|App Part]] containers with the appropriate visible objects inside can also be used as source objects. {{Version|0.20}}
* After selecting a standard mirror plane, the {{PropertyData|Normal}} and {{PropertyData|Base}} of the Part Mirror object can be changed to any value. So that even without a reference object you are not restricted to the standard planes.




<!--T:14-->
<!--T:14-->
{{Docnav
{{Docnav
|[[Part_Chamfer|Chamfer]]
|[[Part_Revolve|Revolve]]
|[[Part_Scale|Scale]]
|[[Part_RuledSurface|Ruled Surface]]
|[[Part_Module|Part]]
|[[Part_Workbench|Part]]
|IconL=Part_Chamfer.png
|IconL=Part_Revolve.svg
|IconR=Part_Scale.svg
|IconC=Workbench_Part.svg
|IconC=Workbench_Part.svg
|IconR=Part_RuledSurface.svg
}}
}}

<!--T:15-->
{{Part Tools navi}}

<!--T:16-->
{{Userdocnavi}}


</translate>
</translate>
{{Part Tools navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 11:12, 7 February 2024

Part Mirror

Menu location
Part → Mirroring...
Workbenches
Part
Default shortcut
None
Introduced in version
-
See also
None

Description

Part Mirror creates a new object (image) which is a reflection of the original object (source). The image object is created behind a mirror plane. The mirror plane may be standard plane (XY, YZ, or XZ), any plane parallel to a standard plane, or (introduced in version 0.22) any arbitrary plane by using a reference object.

An example:

Before

After mirrored through YZ plane

Usage

  1. Optionally select one or more source objects.
  2. There are several ways to invoke the command:
    • Press the Mirroring... button.
    • Select the Part → Mirroring... option from the menu.
  3. If you have not yet selected objects or want to change the selection: pick one or more objects from the Shapes list.
  4. Do one of the following:
  5. Press the OK button.
  6. For each source object a separate Part Mirror object is created.

When the select button label says Selecting you are in reference selection mode and there is a selection gate in effect, which disallows the selection of unsupported reference objects. Click the button to toggle the selection gate off, the button label then changes to Select reference.

The mirror plane is defined by a DataNormal (direction) and a DataBase (position). When the DataMirror Plane property contains a reference object these properties are made read-only as they are then computed based on that object. The plane is infinite even if the reference object is not.

A reference object can be a planar face, such as the face of a Part Box, a circular edge, a Datum Plane, an origin plane of a Std Part container, or any object with a single planar face or single circular edge. There is also support for Links. Note, however, that B-spline surfaces, such as ruled surfaces or loft faces are not supported.

Options

If a standard plane instead of a reference object is selected, the Base point boxes can be used to move it. Only one of the X, Y, or Z boxes is effective for a given standard plane.

Standard plane Base point box Effect
XY Z Move mirror plane along Z axis
XY X, Y No effect
XZ Y Move mirror plane along Y axis
XZ X, Z No effect
YZ X Move mirror plane along X axis
YZ Y, Z No effect

Notes

  • App Link objects linked to the appropriate object types and App Part containers with the appropriate visible objects inside can also be used as source objects. introduced in version 0.20
  • After selecting a standard mirror plane, the DataNormal and DataBase of the Part Mirror object can be changed to any value. So that even without a reference object you are not restricted to the standard planes.