Drawing Dimensioning Addon: Difference between revisions

From FreeCAD Documentation
(→‎Limitations: Information from GUI Tools, which previously described the tools for Drawing Dimensioning Addon)
(Added the information from Sandbox:Drawing_Dimensioning To have only one page with information on this workbench)
Line 1: Line 1:
{{VeryImportantMessage|The [[Drawing Workbench]] was superseded by the [[TechDraw Workbench]] in FreeCAD 0.17. While both workbenches are included in v0.17, the Drawing Workbench is no longer maintained, and may be removed in future versions of FreeCAD. Users are advised to make the switch to the [[TechDraw Workbench]] which also includes dimensioning and annotation tools.}}
{{VeryImportantMessage|The [[Drawing Workbench]] was superseded by the [[TechDraw Workbench]] in FreeCAD 0.17. While both workbenches are included in v0.17, the Drawing Workbench is no longer maintained, and may be removed in future versions of FreeCAD. Users are advised to make the switch to the [[TechDraw Workbench]] which also includes dimensioning and annotation tools.}}


== Introduction ==
==Introduction==
Welcome to the FreeCAD_drawing_dimensioning wiki!
Intended work-flow:

* create a drawing page and a drawing of the part using the drawing workbench
* switch to the drawing dimensioning workbench to add dimensions to that drawing

The [https://github.com/hamish2014/FreeCAD_drawing_dimensioning Drawing dimensioning workbench] adds powerful dimensioning and annotation tools to the [[Drawing Workbench]] (see [http://forum.freecadweb.org/viewtopic.php?f=10&t=8395 forum thread]).
The [https://github.com/hamish2014/FreeCAD_drawing_dimensioning Drawing dimensioning workbench] adds powerful dimensioning and annotation tools to the [[Drawing Workbench]] (see [http://forum.freecadweb.org/viewtopic.php?f=10&t=8395 forum thread]).


[[Image:Drawing_Dimensioning_example.jpg]]
[[Image:Drawing_Dimensioning_example.jpg]]


Drawing dimensioning workbench for FreeCAD v0.15 or later. Take note that this workbench is experimental and still contains bugs.
== Features ==

=== Intended work-flow: ===
* create a drawing page and a drawing of the part using the drawing workbench
* switch to the drawing dimensioning workbench to add dimensions to that drawing


=== Features: ===
* linear dimensioning
* linear dimensioning
* circular and radial dimensioning
* circular and radial dimensioning
* angular dimension
* angular dimension
* center lines
* center lines
* adding, editing and moving dimension text
* adding, editing and moving dimension text
* deleting dimensions
* deleting dimensions
* draw a dimension or a symbol anywhere on the drawing with "Add grab point"
* Draw a dimension or a symbol anywhere on the drawing with "Add grab point"


== Limitations ==
=== Limitations: ===
* No parametric updating, if the drawing is updated the dimensions need to be redone
* only works with FreeCAD version 0.15+


==References==
* no parametric updating, if the drawing is updated the dimensions need to be redone
* only works with FreeCAD version 0.15 and newer


* Author: hamish
== GUI Tools ==
* Home page: [https://github.com/hamish2014/FreeCAD_drawing_dimensioning Drawing Dimensioning]
* Source code on github: [https://github.com/hamish2014/FreeCAD_drawing_dimensioning Drawing Dimensioning]


==Installation==
Add linear dimension Add linear dimension


===Automatic installation===
Add linear dimension stack Add linear dimension stack
See [[Installing|Installing]]


===From GitHub===
Add circular dimension Add circular dimension


====Prerequisites====
Add radius dimension Add radius dimension


.........
Add angular dimension Add angular dimension


====Linux Installation Instructions (From GitHub)====
Add center lines Add center lines


To use this workbench clone this git repository under your FreeCAD MyScripts directory, and install the pyside and numpy python libraries. On a Linux Debian based system such as Ubuntu, installation can be done through BASH as follows
Add center line Add center line


$ sudo apt-get install git python-numpy python-pyside
Add note with circle Add note with circle
$ mkdir ~/.FreeCAD/Mod
$ cd ~/.FreeCAD/Mod
$ git clone https://github.com/hamish2014/FreeCAD_drawing_dimensioning.git


Once installed, use git to easily update to the latest version:
Add grab point Add grab point


$ cd ~/.FreeCAD/Mod/FreeCAD_drawing_dimensioning
Add text Add text
$ git pull
$ rm *.pyc


====Windows Installation Instructions (From GitHub)====
Add tolerance to dimension Add tolerance to dimension

Tested with 015.4415 Development Snapshot on a Windows 7 64bit-System (thanks BPLRFE )

* download the git repository as ZIP
* assuming FreeCAD is installed in "C:\PortableApps\FreeCAD 0_15", go to "C:\PortableApps\FreeCAD 0_15\Mod" within Windows Explorer
* create new directory named "DrawingDimensioning"
* unzip downloaded repository in "C:\PortableApps\FreeCAD 0_15\Mod\DrawingDimensioning"

FreeCAD will now have a new workbench-entry called "DrawingDimensioning".

Pyside and Numpy are integrated in the FreeCAD dev-Snapshots 0.15, so these Python packages do not need to be installed individually.

To update to the latest version, delete the DrawingDimensioning folder and redownload the git repository.

====Mac Installation Instructions (From GitHub)====

Copy or unzip the drawing dimensioning folder to the directory FreeCAD.app/Contents/Mod

where FreeCAD.app is the folder where FreeCAD is installed. (thanks PLChris)

==Setting your dimensioning preferences==

Unit preferences are taken from the General unit preferences (excluding number of decimal places!). To set unit preferences goto edit -> preferences -> general -> units

To set up your desired dimensioning style
# open FreeCAD
# switch to the Drawing dimensioning workbench
# edit -> preferences -> drawing dimensioning

==Tools==

Toolbar

[[Image:Drawing-Dimensioning-menu-orizz.png]]

*[[Image:DrawingDimensioning_LinearDimension.png|32px]] '''Linear Dimension''': adds linear dimension
*[[Image:DrawingDimensioning_LinearDimensionStack.png|32px]] '''Linear Dimension Stack''': adds linear dimension stack
*[[Image:DrawingDimensioning_CircularDimension.png|32px]] '''Circular Dimension''': adds circular dimension
*[[Image:DrawingDimensioning_RadiusDimension.png|32px]] '''Radius Dimension''': adds radius dimension
*[[Image:DrawingDimensioning_AngularDimension.png|32px]] '''Angular Dimension''': adds radius dimension
*[[Image:DrawingDimensioning_CenterLines.png|32px]] '''Center Lines''': shows center lines (axes)
*[[Image:DrawingDimensioning_CenterLine.png|32px]] '''Center Line''': shows center line (axis)
*[[Image:DrawingDimensioning_NoteCircle.png|32px]] '''Note Circle''': creates a notation indicator
*[[Image:DrawingDimensioning_GrabPoint.png|32px]] '''Grab Point''': adds grab point to draw a free dimension
*[[Image:DrawingDimensioning_TextAdd.png|32px]] '''Text Add''': adds text to drawing
*[[Image:DrawingDimensioning_ToleranceAdd.png|32px]] '''Tolerance Add''': adds tolerance super and subscript to dimension
*[[Image:DrawingDimensioning_TableAdd.png|32px]] '''Table Add''': adds table to drawing
*[[Image:DrawingDimensioning_DeleteDimension.png|32px]] '''Delete Dimension''': deletes a dimension
*[[Image:DrawingDimensioning_EscapeDimensioning.png|32px]] '''Escape Dimensioning''': escapes dimensioning
*[[Image:DrawingDimensioning_RecomputeDimensions.png|32px]] '''Recompute Dimensions''': recomputes dimensions
*[[Image:DrawingDimensioning_UnfoldFaces.png|32px]] '''Unfold Faces''':
*[[Image:DrawingDimensioning_BendingNote.png|32px]] '''Bending Note''':
*[[Image:DrawingDimensioning_CenterView.png|32px]] '''Center View''': centers a view on its page
*[[Image:DrawingDimensioning_ExportToDxf.png|32px]] '''Export To Dxf''': alternative dxf export command
*[[Image:DrawingDimensioning_LineWithArrow.png|32px]] '''Line With Arrow''': welding/grove symbols command
*[[Image:DrawingDimensioning_Help.png|32px]] '''Help''':

Other

*[[Image:DrawingDimensioning_DrawLine.png|32px]] '''Draw Line'''
*[[Image:DrawingDimensioning_TextEdit.png|32px]] '''Text Edit'''
*[[Image:DrawingDimensioning_TextMove.png|32px]] '''Text Move'''
*[[Image:DrawingDimensioning_LandscapeNew.png|32px]] '''Landscape New'''
*[[Image:DrawingDimensioning_OrthoViews.png|32px]] '''Ortho Views'''
*[[Image:DrawingDimensioning_ShortcutSettings.png|32px]] '''Shortcut Settings'''
*[[Image:DrawingDimensioning_HalfLinerarDimension.png|32px]] '''Half Linerar Dimension'''
*[[Image:DrawingDimensioning_NewDrawingPage1.png|32px]] '''New Drawing Page 1'''
*[[Image:DrawingDimensioning_NewDrawingPage2.png|32px]] '''New Drawing Page 2'''
*[[Image:DrawingDimensioning_NewDrawingPage3.png|32px]] '''New Drawing Page 3'''
*[[Image:DrawingDimensioning_NewDrawingPage4.png|32px]] '''New Drawing Page 4'''
*[[Image:DrawingDimensioning_Preferences.png|32px]] '''Preferences'''
*[[Image:DrawingDimensioning_DrawingDimensioningIcon.png|32px]] '''Drawing Dimensioning Icon'''


Symbols

[[Image:Drawing-Dimensioning-symbol.png]]


== Linear dimensions ==
== Linear dimensions ==
Line 116: Line 201:


* changing the dimension to a half linear dimension ca be done by selecting the dimension in the tree view and setting the value for "half Dimension_linear" to true. The dimension will be using the half towrds the second click point
* changing the dimension to a half linear dimension ca be done by selecting the dimension in the tree view and setting the value for "half Dimension_linear" to true. The dimension will be using the half towrds the second click point

==Links to Drawing Dimensioning WB==

* Workbench Wiki: https://github.com/hamish2014/FreeCAD_drawing_dimensioning/wiki
* FreeCAD Wiki:
* FreeCAD Forum: http://forum.freecadweb.org/viewtopic.php?f=10&t=8395&start=40
* Tutorials:
* Videos:
* Files:
* Report bugs: Please report bugs at https://github.com/hamish2014/FreeCAD_drawing_dimensioning/issues

==Other useful links==

* [xxxxxxxxxxx]:
* [xxxxxxxxxxx]: xxxxxxxxxxxx
* [[Template:DevWorkbenches|DevWorkbenches]]: List of workbenches in development.
* [[Macros_recipes|Macros recipes]]


[[Category:User Documentation]]
[[Category:User Documentation]]

Revision as of 06:26, 8 December 2018

The Drawing Workbench was superseded by the TechDraw Workbench in FreeCAD 0.17. While both workbenches are included in v0.17, the Drawing Workbench is no longer maintained, and may be removed in future versions of FreeCAD. Users are advised to make the switch to the TechDraw Workbench which also includes dimensioning and annotation tools.

Introduction

The Drawing dimensioning workbench adds powerful dimensioning and annotation tools to the Drawing Workbench (see forum thread).

Drawing dimensioning workbench for FreeCAD v0.15 or later. Take note that this workbench is experimental and still contains bugs.

Intended work-flow:

  • create a drawing page and a drawing of the part using the drawing workbench
  • switch to the drawing dimensioning workbench to add dimensions to that drawing

Features:

  • linear dimensioning
  • circular and radial dimensioning
  • angular dimension
  • center lines
  • adding, editing and moving dimension text
  • deleting dimensions
  • Draw a dimension or a symbol anywhere on the drawing with "Add grab point"

Limitations:

  • No parametric updating, if the drawing is updated the dimensions need to be redone
  • only works with FreeCAD version 0.15+

References

Installation

Automatic installation

See Installing

From GitHub

Prerequisites

.........

Linux Installation Instructions (From GitHub)

To use this workbench clone this git repository under your FreeCAD MyScripts directory, and install the pyside and numpy python libraries. On a Linux Debian based system such as Ubuntu, installation can be done through BASH as follows

$ sudo apt-get install git python-numpy python-pyside $ mkdir ~/.FreeCAD/Mod $ cd ~/.FreeCAD/Mod $ git clone https://github.com/hamish2014/FreeCAD_drawing_dimensioning.git

Once installed, use git to easily update to the latest version:

$ cd ~/.FreeCAD/Mod/FreeCAD_drawing_dimensioning $ git pull $ rm *.pyc

Windows Installation Instructions (From GitHub)

Tested with 015.4415 Development Snapshot on a Windows 7 64bit-System (thanks BPLRFE )

  • download the git repository as ZIP
  • assuming FreeCAD is installed in "C:\PortableApps\FreeCAD 0_15", go to "C:\PortableApps\FreeCAD 0_15\Mod" within Windows Explorer
  • create new directory named "DrawingDimensioning"
  • unzip downloaded repository in "C:\PortableApps\FreeCAD 0_15\Mod\DrawingDimensioning"

FreeCAD will now have a new workbench-entry called "DrawingDimensioning".

Pyside and Numpy are integrated in the FreeCAD dev-Snapshots 0.15, so these Python packages do not need to be installed individually.

To update to the latest version, delete the DrawingDimensioning folder and redownload the git repository.

Mac Installation Instructions (From GitHub)

Copy or unzip the drawing dimensioning folder to the directory FreeCAD.app/Contents/Mod

where FreeCAD.app is the folder where FreeCAD is installed. (thanks PLChris)

Setting your dimensioning preferences

Unit preferences are taken from the General unit preferences (excluding number of decimal places!). To set unit preferences goto edit -> preferences -> general -> units

To set up your desired dimensioning style

  1. open FreeCAD
  2. switch to the Drawing dimensioning workbench
  3. edit -> preferences -> drawing dimensioning

Tools

Toolbar

  • Linear Dimension: adds linear dimension
  • Linear Dimension Stack: adds linear dimension stack
  • Circular Dimension: adds circular dimension
  • Radius Dimension: adds radius dimension
  • Angular Dimension: adds radius dimension
  • Center Lines: shows center lines (axes)
  • Center Line: shows center line (axis)
  • Note Circle: creates a notation indicator
  • Grab Point: adds grab point to draw a free dimension
  • Text Add: adds text to drawing
  • Tolerance Add: adds tolerance super and subscript to dimension
  • Table Add: adds table to drawing
  • Delete Dimension: deletes a dimension
  • Escape Dimensioning: escapes dimensioning
  • Recompute Dimensions: recomputes dimensions
  • Unfold Faces:
  • Bending Note:
  • Center View: centers a view on its page
  • Export To Dxf: alternative dxf export command
  • Line With Arrow: welding/grove symbols command
  • Help:

Other

  • Draw Line
  • Text Edit
  • Text Move
  • Landscape New
  • Ortho Views
  • Shortcut Settings
  • Half Linerar Dimension
  • New Drawing Page 1
  • New Drawing Page 2
  • New Drawing Page 3
  • New Drawing Page 4
  • Preferences
  • Drawing Dimensioning Icon


Symbols

Linear dimensions

Linear dimensions / Linear dimension stack

Upon clicking on linear dimensions or linear dimension stack you will get a menu with different choices. repeat: If checked the menu won't close after defining one dimension Grid Options: allow you to snap the dimensions to a grid

grid on will toggle the visibility of the grid

spacing: will define the spacing of the main grid (default: 1 mm)

display period: will define how often the lines are displayed (default: 20)

color: line color of the grid lines

line width: line width of the grid lines (default: 0,15) Unit Options: will define the units of the dimensions

Edit > Preferences > Unit: use same units as defined in FreeCAD preferences

mm: force units to be in mm

inch: force units to be in inch

m: force units to be in m

custom: use custum scaling of units (default: 1/mm) Preferences: define preferences of the dimension appearence

compact:

format mask: changes the format of the dimension (default "%(value)3.3f"). Overwrite with manual text possible

arrows: changes arrow style (auto/in/out/off)

auto place text: place dimension text manually

comma: use comma instead of point

gap: (default: 2)

overshoot: (default: 1)

arrowL1: first Length of arrow (default: 3)

arrowL2: second length of arrow (default: 1)

arrowW: width of arrow (default: 2)

strokeWidth: change line with of dimension lines (default: 0,3)

lineColor: change color of dimension lines

text properties: choose font name, font size and color (default: Verdana, 3.6, red)

auto place offset:

Set as default: Accept settings as default

Tipps:

  • changing the placement of the dimensions afterwards can be done by selecting the dimension in the tree view, and changing the values in the section "Placement Clicks" in the data tab
  • changing the dimension to a half linear dimension ca be done by selecting the dimension in the tree view and setting the value for "half Dimension_linear" to true. The dimension will be using the half towrds the second click point

Links to Drawing Dimensioning WB

Other useful links