Manipulator Workbench: Difference between revisions

From FreeCAD Documentation
m (Enlarged and centered workbench logo + added caption + added {{caption}}s)
(Marked this version for translation)
 
(18 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
[[Image:Manipulator_workbench_icon.svg|center|240px]]
<translate>
<translate>

{{Caption|align=center|The Manipulator External Workbench Icon}}
<!--T:53-->
[[Image:Manipulator_workbench_icon.svg|thumb|128px|Manipulator workbench icon]]


==Introduction== <!--T:1-->
==Introduction== <!--T:1-->
Line 11: Line 12:


<!--T:3-->
<!--T:3-->
[[Manipulator Workbench]] is an [[external workbenches|external workbench]] aimed to help FreeCAD users with Aligning, Moving, Rotating and Measuring 3D objects through a friendly GUI.
The [[Manipulator_Workbench|Manipulator Workbench]] is an [[External_workbenches|external workbench]] aimed to help FreeCAD users with Aligning, Moving, Rotating and Measuring 3D objects through a friendly GUI. These series of tools help to Transform the placement and Measure objects and STEP models in FreeCAD.


<!--T:4-->
==Features== <!--T:4-->
==Features==


<!--T:5-->
<!--T:5-->
Line 20: Line 20:


<!--T:6-->
<!--T:6-->
[[File:Mover-ico.png]] '''Mover:''' a set of tools to move and rotate 3D parts on different Axis
[[File:Manipulator_Mover.svg]] '''Mover:''' a set of tools to move and rotate 3D parts on different Axis


<!--T:7-->
<!--T:7-->
[[File:Caliper-ico.png]] '''Caliper:''' a set of tools to measure 3D parts, with some Snap facility and Radius, Length, Angle measurements.
[[File:Manipulator_Caliper.svg]] '''Caliper:''' a set of tools to measure 3D parts, with some Snap facility and Radius, Length, Angle measurements.


<!--T:8-->
<!--T:8-->
Line 33: Line 33:
<!--T:10-->
<!--T:10-->
Each Tool has a '''Help Button''' [[File:Help-btn.png]] to get some useful tips
Each Tool has a '''Help Button''' [[File:Help-btn.png]] to get some useful tips

==Overview== <!--T:32-->
'''Manipulator Workbench''' is an [[External workbenches|external workbench]] containing a series of tools to Transform the placement and Measure objects and STEP models in FreeCAD.


==References== <!--T:11-->
==References== <!--T:11-->


<!--T:12-->
<!--T:54-->
* Author: Github: [https://github.com/easyw @easyw] | FreeCAD Forums: [https://forum.freecadweb.org/memberlist.php?mode=viewprofile&u=6387 easyw-fc]
* Author on github: [https://github.com/easyw @easyw]
* FreeCAD Forums: [https://forum.freecadweb.org/memberlist.php?mode=viewprofile&u=6387 easyw-fc]
* Source code on github: https://github.com/easyw/Manipulator
* Source code on github: https://github.com/easyw/Manipulator
* Forum announcements/discussion: https://forum.freecadweb.org/viewtopic.php?t=24742
== Tutorial ==

== Tutorial == <!--T:12-->


<!--T:27-->
<!--T:27-->
[[Image:Manipulator-WB-@Work.png|1024px |link=https://youtu.be/owGzsd1fyZc |alt=Manipulator-WB-@Work|Title Manipulator-WB-@Work]]
[[Image:Manipulator-WB-@Work.png|1024px|link=https://youtu.be/owGzsd1fyZc|alt=Manipulator-WB-@Work|Title Manipulator-WB-@Work]]


<!--T:28-->
<!--T:28-->
{{Caption|align=center|YouTube Tutorial [https://youtu.be/owGzsd1fyZc Manipulator WorkBench @Work]}}
{{Caption|YouTube Tutorial [https://youtu.be/owGzsd1fyZc Manipulator WorkBench @Work]}}




Line 55: Line 55:
<!--T:14-->
<!--T:14-->
[[Image:Manipulator-WB-Tools.png]]
[[Image:Manipulator-WB-Tools.png]]
{{Caption|center=align|Above: Manipulator workbench dialog. For a more detailed description see [https://github.com/easyw/Manipulator/blob/master/README.md README.md] on Github.}}
{{Caption|Above: Manipulator workbench dialog. For a more detailed description see [https://github.com/easyw/Manipulator/blob/master/README.md README.md] on Github.}}




Line 62: Line 62:
[[Image:Manipulator-WB-Aligner.gif]]
[[Image:Manipulator-WB-Aligner.gif]]
<translate>
<translate>
<!--T:38-->
{{Caption|Aligner: set of tools to move and align 3D parts; it can also align an object (face, edge, point) to the origin in FreeCAD}}
{{Caption|Aligner: set of tools to move and align 3D parts; it can also align an object (face, edge, point) to the origin in FreeCAD}}


Line 68: Line 69:
[[Image:Manipulator-WB-Mover.gif]]
[[Image:Manipulator-WB-Mover.gif]]
<translate>
<translate>
<!--T:39-->
{{Caption|Mover: set of tools to move and rotate 3D parts on different Axis}}
{{Caption|Mover: set of tools to move and rotate 3D parts on different Axis}}


Line 73: Line 75:
[[Image:Manipulator-WB-Mover-with-App_Part&Body.gif]]
[[Image:Manipulator-WB-Mover-with-App_Part&Body.gif]]
<translate>
<translate>
<!--T:40-->
{{Caption|Mover: Using App:Part and Body}}
{{Caption|Mover: Using App:Part and Body}}


Line 78: Line 81:
[[Image:Manipulator-WB-Mover-with-External-Reference.gif]]
[[Image:Manipulator-WB-Mover-with-External-Reference.gif]]
<translate>
<translate>
<!--T:41-->
{{Caption|Mover: with External Reference}}
{{Caption|Mover: with External Reference}}


Line 84: Line 88:
</translate>
</translate>
[[Image:Manipulator-WB-Measure-Radius.gif]]
[[Image:Manipulator-WB-Measure-Radius.gif]]
<translate>
<!--T:42-->
{{Caption|Caliper: measuring Radius}}


</translate>

[[Image:Manipulator-WB-Measure-Angles.gif]]
[[Image:Manipulator-WB-Measure-Angles.gif]]
<translate>
<!--T:43-->
{{Caption|Caliper: measuring Angles}}


</translate>

[[Image:Manipulator-WB-Dimension.gif]]
[[Image:Manipulator-WB-Dimension.gif]]
<translate>
<!--T:45-->
{{Caption|Caliper: measuring Dimensions}}


</translate>

[[Image:Manipulator-WB-Dimension-2.gif]]
[[Image:Manipulator-WB-Dimension-2.gif]]
<translate>
<!--T:46-->
{{Caption|Caliper: measuring Dimensions (cont.)}}


</translate>

[[Image:Manipulator-WB-Parallel-Planes-Distance.gif]]
[[Image:Manipulator-WB-Parallel-Planes-Distance.gif]]
-----
<translate>
<translate>
<!--T:47-->
{{Caption|Caliper: parallel planes distance}}


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

</translate>
</translate>
[[Image:Manipulator-WB-Assembly-Parts.gif]]
[[Image:Manipulator-WB-Assembly-Parts.gif]]
Line 108: Line 128:


<!--T:21-->
<!--T:21-->
The recommended way to install the Manipulator Workbench is via the [[Image:AddonManager.svg|24px|link=Addon Manager]] [[Addon Manager]] under the {{MenuCommand|Tools → Addon Manager}} menu.
The recommended way to install the Manipulator Workbench is via the [[Image:Std_AddonMgr.svg|24px|link=Std_AddonMgr]] [[Std_AddonMgr|Addon Manager]] under the {{MenuCommand|Tools → Addon Manager}} menu.


<!--T:55-->
<div class="mw-collapsible mw-collapsed toccolours" style="width:600px">
<div class="mw-collapsible mw-collapsed toccolours" style="width:600px">

===Manual Installation=== <!--T:22-->
===Manual Installation=== <!--T:22-->


<!--T:48-->
If a manual install is necessary please follow the following instructions:
If a manual install is necessary please follow the following instructions:


<!--T:49-->
<div class="mw-collapsible-content">
<div class="mw-collapsible-content">


Line 120: Line 144:
* Copying the Manipulator source in to the {{FileName|Mod}} sub-directory of the FreeCAD application.
* Copying the Manipulator source in to the {{FileName|Mod}} sub-directory of the FreeCAD application.


<!--T:50-->
{{Code|code=
{{Code|code=
cd ~/.FreeCAD/Mod
cd ~/.FreeCAD/Mod
Line 138: Line 163:
* FreeCAD v0.18+
* FreeCAD v0.18+
* FreeCAD v0.19+
* FreeCAD v0.19+

== History == <!--T:51-->

<!--T:52-->
The workbench evolved out of the [[Macro_Center_Align_Objects_with_Faces_or_Edges|Center Align Objects with Faces or Edges]] macro


== External workbenches == <!--T:33-->
== External workbenches == <!--T:33-->
Line 145: Line 175:


<!--T:35-->
<!--T:35-->
The [[external workbenches|external workbenches]] page has some information and tutorials on some of them, and the [https://github.com/FreeCAD/FreeCAD-addons FreeCAD Addons] project aims at gathering them and making them easily installable from within FreeCAD.
The [[External_workbenches|external workbenches]] page has some information and tutorials on some of them, and the [https://github.com/FreeCAD/FreeCAD-addons FreeCAD Addons] project aims at gathering them and making them easily installable from within FreeCAD.


<!--T:36-->
<!--T:36-->
Line 153: Line 183:
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
[[Category:Addons{{#translation:}}]]
[[Category:Addons{{#translation:}}]]
[[Category:User Documentation{{#translation:}}]]
[[Category:External Workbenches{{#translation:}}]]
{{clear}}
{{clear}}

Latest revision as of 17:46, 11 November 2021

Manipulator workbench icon

Introduction

The Manipulator Workbench is an external workbench aimed to help FreeCAD users with Aligning, Moving, Rotating and Measuring 3D objects through a friendly GUI. These series of tools help to Transform the placement and Measure objects and STEP models in FreeCAD.

Features

Aligner: a set of tools to move and align 3D parts; it can also align an object (face, edge, point) to the origin in FreeCAD.

Mover: a set of tools to move and rotate 3D parts on different Axis

Caliper: a set of tools to measure 3D parts, with some Snap facility and Radius, Length, Angle measurements.

These helpers work with Part, App::Part and Body objects.

The Tools can be Floating or Docked Left or Right.

Each Tool has a Help Button to get some useful tips

References

Tutorial

Manipulator-WB-@Work

YouTube Tutorial Manipulator WorkBench @Work


Tools

Above: Manipulator workbench dialog. For a more detailed description see README.md on Github.


Aligner

Aligner: set of tools to move and align 3D parts; it can also align an object (face, edge, point) to the origin in FreeCAD

Mover

Mover: set of tools to move and rotate 3D parts on different Axis

Mover: Using App:Part and Body

Mover: with External Reference


Caliper

Caliper: measuring Radius

Caliper: measuring Angles

Caliper: measuring Dimensions

Caliper: measuring Dimensions (cont.)

Caliper: parallel planes distance


Manipulator

Installation

Automatic Installation

The recommended way to install the Manipulator Workbench is via the Addon Manager under the Tools → Addon Manager menu.

Manual Installation

If a manual install is necessary please follow the following instructions:

  • Copying the Manipulator source in to the Mod sub-directory of the FreeCAD application.
cd ~/.FreeCAD/Mod 
git clone https://github.com/easyw/Manipulator Manipulator
  • Restart FreeCAD

Supports

  • FreeCAD v0.15 4671
  • FreeCAD v0.16 >= 6712
  • FreeCAD v0.17 >= 11707
  • FreeCAD v0.18+
  • FreeCAD v0.19+

History

The workbench evolved out of the Center Align Objects with Faces or Edges macro

External workbenches

FreeCAD workbenches are easy to program in Python, there are therefore many people developing additional workbenches outside of the FreeCAD main developers.

The external workbenches page has some information and tutorials on some of them, and the FreeCAD Addons project aims at gathering them and making them easily installable from within FreeCAD.

New workbenches are in development, stay tuned!