Manipulator Workbench: Difference between revisions

From FreeCAD Documentation
m ({{Userdocnavi}} already includes Category:User Documentation! (Removed) + added [[Category:External Workbenches{{#translation:}}]])
(Marked this version for translation)
 
(13 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. These series of tools help to Transform the placement and Measure objects and STEP models in FreeCAD.
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 36: Line 36:
==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 52: 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 59: 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 65: 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 70: 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 75: 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 81: 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 105: 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 117: 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 136: Line 164:
* FreeCAD v0.19+
* FreeCAD v0.19+


== History ==
== 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
The workbench evolved out of the [[Macro_Center_Align_Objects_with_Faces_or_Edges|Center Align Objects with Faces or Edges]] macro


Line 146: 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-->

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!