Manipulator Workbench: Difference between revisions

Revision as of 01:24, 28 February 2020

Other languages:

The Manipulator External Workbench Icon

Introduction

Manipulator Workbench is an external workbench aimed to help FreeCAD users with Aligning, Moving, Rotating and Measuring 3D objects through a friendly GUI.

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

Overview

Manipulator Workbench is an external workbench containing a series of tools to Transform the placement and Measure objects and STEP models in FreeCAD.

References

Author: Github: @easyw | FreeCAD Forums: easyw-fc
Source code on github: https://github.com/easyw/Manipulator

Tutorial

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

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+

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!

User documentation

Getting started
Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

Help: Tutorials, Video tutorials
Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web

Addons: Addon Manager, External workbenches, Scripting and macros

Hubs: User hub, Power users hub, Developer hub

@@ Line 1: / Line 1: @@
 <languages/>
+[[Image:Manipulator_workbench_icon.svg|center|240px]]
+<translate>
+{{Caption|align=center|The Manipulator External Workbench Icon}}
+==Introduction== <!--T:1-->
+</translate>
 {{TOCright}}
 <translate>
-==Introduction== <!--T:1-->
 <!--T:3-->
-[[File:Manipulator-ico.png]] '''Manipulator WB''' is aimed to help FreeCAD users in Aligning, Moving, Rotating and Measuring 3D objects through a friendly GUI.
+[[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.
 <!--T:4-->
-'''Features:'''
+==Features==
 <!--T:5-->
@@ Line 37: / Line 42: @@
 * Author: 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
+== Tutorial ==
+<!--T:27-->
+[[Image:Manipulator-WB-@Work.png|1024px |link=https://youtu.be/owGzsd1fyZc |alt=Manipulator-WB-@Work|Title Manipulator-WB-@Work]]
+<!--T:28-->
+{{Caption|align=center|YouTube Tutorial [https://youtu.be/owGzsd1fyZc Manipulator WorkBench @Work]}}
 ==Tools== <!--T:13-->
@@ Line 42: / Line 55: @@
 <!--T:14-->
 [[Image:Manipulator-WB-Tools.png]]
-Detailed description [https://github.com/easyw/Manipulator/blob/master/README.md here]
+{{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.}}
-<!--T:27-->
-[[Image:Manipulator-WB-@Work.png|1024px |link=https://youtu.be/owGzsd1fyZc |alt=Manipulator-WB-@Work|Title Manipulator-WB-@Work]]
-<!--T:28-->
-YouTube Tutorial [https://youtu.be/owGzsd1fyZc Manipulator-WB-@Work]
 === Aligner === <!--T:15-->
 </translate>
 [[Image:Manipulator-WB-Aligner.gif]]
------
 <translate>
+{{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}}
 === Mover === <!--T:16-->
 </translate>
 [[Image:Manipulator-WB-Mover.gif]]
+<translate>
+{{Caption|Mover: set of tools to move and rotate 3D parts on different Axis}}
+</translate>
 [[Image:Manipulator-WB-Mover-with-App_Part&Body.gif]]
+<translate>
+{{Caption|Mover: Using App:Part and Body}}
+</translate>
 [[Image:Manipulator-WB-Mover-with-External-Reference.gif]]
------
 <translate>
+{{Caption|Mover: with External Reference}}
 === Caliper === <!--T:17-->
 </translate>
@@ Line 90: / Line 105: @@
 ==Installation== <!--T:19-->
-===Automatic installation=== <!--T:20-->
+===Automatic Installation=== <!--T:20-->
 <!--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.
-- automatically using the [https://github.com/FreeCAD/FreeCAD-addons FreeCAD Add-on Manager] (bundled in to 0.17 dev version under Tools Menu)
+<div class="mw-collapsible mw-collapsed toccolours" style="width:600px">
-===From GitHub=== <!--T:22-->
+===Manual Installation=== <!--T:22-->
+If a manual install is necessary please follow the following instructions:
+<div class="mw-collapsible-content">
 <!--T:23-->
-- manually by copying the Manipulator folder to the Mod sub-directory of the FreeCAD application.
+* Copying the Manipulator source in to the {{FileName|Mod}} sub-directory of the FreeCAD application.
+{{Code|code=
-<!--T:24-->
+cd ~/.FreeCAD/Mod
-[https://github.com/easyw/Manipulator Manipulator github page]
+git clone https://github.com/easyw/Manipulator Manipulator
+}}
+* Restart FreeCAD
+</translate>
+</div> <!-- END of collapsible div. do not remove! -->
+</div> <!-- END of collapsible div. do not remove! -->
+<translate>
 === Supports === <!--T:25-->
@@ Line 109: / Line 136: @@
 * FreeCAD v0.16 >= 6712
 * FreeCAD v0.17 >= 11707
+* FreeCAD v0.18+
+* FreeCAD v0.19+
 == External workbenches == <!--T:33-->