sketchUcation

All rights reserved.
THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES;
INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE.

TIG-DualDims.rb

Menu:
Plugins || Extensions > TIG-DualDims

Tool to allow you to adjust Dimensions within Model into chosen 'Dual' format,
usually a combination of metric & imperial units.

Usage:
Make a Selection which includes Dimensions [other objects are ignored].
If there are NO Dimensions Selected then you are prompted to process ALL in the
current context: Yes|No.
Then... if there are Groups or Components which might contain 'Nested'
Dimensions you are prompted Yes|No to process those as well...
Run the Tool from the Menu... In the dialog which opens choose the Setting as desired.
The default for the 'Upper Units' is the 'Current Units' -
this will use your current Model Units settings for the number of d.p. and units suffix etc.
If you choose any other units the 'Upper d.p.' you have set up is used,
and also the chosen 'Upper Units' suffix is appended to that text.
The default of the 'Lower Units' depends on your current Model Units -
if imperial it's mm, if metric it's "
Again if the 'Lower Units' are not 'Current Units' [most likely], then the
'Lower d.p.' you have set will be used,
and the chosen 'Lower Units' suffix is appended to that text.
Units for both the Upper Units and the Lower Units text can be selected from
the drop-down list - mm, cm, m, ", ' and 'Current Units'.
The Lower Units also accept ' " for decimal feet & inches [using the set d.p.],
and ' /" for fractional ' " always to nearest 1/64".
Note: you cannot have the 'Upper Units' and 'Lower Units' set to the same value.
You can also choose to have ( ) around the 'Lower Units' [the default is 'Yes'].
The last used Settings are remembered during that session.

It processes both Linear Dimensions and Radial Dimensions.
It there is nothing suitable selected it offers you the chance to process
ALL Dimensions in the Model's current context.
Each Dimension gets its text adjusted as the Settings.
Its actual size is taken from a Linear Dimension's current start and end
points, and a Radial Dimension takes its size from its associated Arc's radius.
If a Radial Dimension is 'Orphaned' it cannot be processed, because there is no
associated Arc available to get a radius - you are told so in a closing dialog,
any such Radial Dimensions are highlighted at the end.
Because editing a Dimension's text breaks its 'associative link',
e.g. when you move an associated Edge's Vertex, or you change an Arc's radius
etc, then that edited Dimension is no longer auto-updated - so you need to
remember to rerun this Tool to update ALL Dimensions
[in each context if applicable], so the current sizes are used...

To reset Dim[s] to the native single line type, you can set the 'Upper Units' to
'Revert'... the 'Lower Units' Settings are then ignored and the Dim[s] revert to
be the native single line type, with their 'associative links' restored where
appropriate.

Note this tool requires SketchUp version 2014 or newer.

1.0 20150522 First Issue.
1.1 20150522 Iterates into all containers if no selection. Also traps stupid d.p values like -1.
1.2 20150523 'Revert' option added.
1.3 20150623 Reported measurements are now correct, even when dim's start/end are non-planar.
1.4 20150624 Further fixes to ensure all offset dims are properly measured.
1.5 20160505 New Lower Units choice of ' " & ' /" added [i.e. feet & inches as decimal-inches using chosen d.p. or fractional - always to nearest 1/64"]. Also made into an Extension and signed for v2016 compatibility.
1.6 20160507 Latest ' " & ' /" formats now suppress the 0' if < 12".