# Permission to use this software for any purpose and without fee is hereby granted
# Distribution of this software for any purpose is subject to:
# - the expressed, written consent of the author
# - the inclusion of the present copyright notice in all copies.
Please UPGRADE to this latest version 2.2 if you run SU 2016.
Tools on Surface is a Suite of Tools drawing on curved surfaces, with lines, various shapes, offset and Freehand / Polyline. It provides an inference mechanism, a Contour Editor and a dedicated Eraser.
- Circle and Polygon
- Rectangle, defined by its length and width
- Parallelogram, defined by its length, width and angle
- Ellipses, defined by axes
- Circle defined by 3 points
- Arcs (circular)
- Sectors, defined by origin, direction and angle
The inference mechanism tries to simulate some stickiness when lines are drawn along some remarkable directions. There is also a Lock inference mechanism to force drawing in a particular direction. A Protractor can help to pick particular angles.
ToolsOnSurface also works to draw lines and shapes 'without' a surface.
See videos in the tutorial
- Language: English, French, Spanish, Chinese, Russian
- Menus: by default, it is installed in Tools > Fredo6 Collection > ToolsOnSurface
- Icon toolbar: by Default ‘Tools on Surface’. A lot of icons are available, but you can configure which ones to display (menu Default Parameters…). There is also a generic icon which launch the last tools used. Then you can switch to another tool for the lateral button palette.
- The plugin is free, for private and commercial usage. There is a donation menu however.
There are now multiple ways to install scripts
- SCF Plugin Store (SU8 and above) - recommended method
- Unzip (all SU versions and for installations in an alternate Plugins directory)
- Extension Manager with RBZ files (SU8 and SU13)
Whatever way you install, you must end up with the following footprint:
The standard SU Plugins root directories are:
Windows SU8: C:\Program Files\Google\Google SketchUp 8\Plugins
Windows SU13: C:\Program Files\SketchUp\SketchUp 2013/Plugins
Windows SU14: C:\Users\<username>\AppData\Roaming\SketchUp\SketchUp 2014\SketchUp\Plugins
Mac SU8: Macintosh HD/Library/Application Support/Google SketchUp 8/SketchUp/Plugins
Mac SU13: ~/Library/Application Support/SketchUp 2013/SketchUp/Plugins
CAUTION: NEVER rename or move files from their folders. If you are unsure of your unzip operation, do it in a neutral folder and check that you reconstruct the right footprint. Then transfer the folders and files to the SU Plugin Directory.
Deleting old files and folders: Once you have installed, it is a good idea to clean up your Plugins directory. Use the dialogbox in the menu Windows > LibFredo6 Settings...> Purge Obsolete Files.
If you run SU8, or above, the strongly recommended installation method is to Autoinstall with the SCF Plugin Store tool.
Otherwise, you can download the ToolsOnSurface rbz file from the Plugin Store page for ToolsOnSurface.
IMPORTANT: Requires to download LibFredo6 6.9 or higher if not already installed
Note for SU6 and SU7 users, download the rbz file from the plugin store page, and change its extension from .rbz to .zip
1) Open the zip archive
2) Select All (Ctrl A)
3) Extract into the Sketchup Plugin Directory
4) Answer YES to OVERWRITE all existing files if any
5) Make sure you get the correct footprint (one rb file and one folder)
CONFLICTING PLUGINS: some plugins conflicts with some of my scripts
- Some versions of Podium
Tutorial in English
Tutorial en francais
- Line tool: use it pretty much as the native SU line tool
- Shape tools: Shape are specified with one or two axes directions to have an accurate positioning
- for other tools, please refer to documentation
Note: Tools on Surface works better when the surface is not closed (i.e. when there only one path from a point to another one).
Tools on Surface 2.2a - 13 Nov 15: Maintenance release
Here is the start post for this release
[b]Tools on Surface 2.1a - 19 Oct 14: Release for support of non-ascii usernames
Here is the start post for this release
[b]Tools on Surface 2.0a - 12 Nov 13: Release for future SU compatibility. No functional changes, but it is advised to upgrade for better support.
Tools on Surface 1.8a - 12 Jan 11: Technical upgrade along with LibFredo6 3.6. No functional changes, but it is advised to upgrade for support.
Here is the old archive, just in case
Tools on Surface 1.6c - 11 Nov 09: Critical upgrade
This version fixes a number of critical bugs:
- the bug contributing to the menu gray-out issue.
- a bug introduced in 1.6b on inference for Line on Surface
As a bonus, TOS v1.6 includes a new feature allowing to draw shapes perpendicular to lonely edges or couple of edges (i.e. without a surface).
v 1.6 also includes a revised Spanish translation by Defisto.
Tools on Surface 1.6a - 11 Nov 09: Major functional upgrade
Here are the main evolutions of versions 1.5 and 1.6:
- Button palette to view and access all options (also available from contextual menu and Short cuts)
- You can Switch to Any tool from within Any tool, with the side palette
- There is a generic icon button, keeping in memory the latest selected tool when used. Actually you can keep only this button in the toolbar if you have real estate problems.
- All parameters are preserved across Sketchup sessions (by default)
- The VCB accept formulas and unit specification for Length (for instance 3.2mm+0.4cm will mean 0.72cm). Angles can be specifed in degrees, radians, grades or % for slope.
- Rings for Shapes can be visualized in a special palette (but can still be entered in the VCB with offset folowed by 'x')
- Freehand On Surface now includes a Point & Click mode, in addition to the existing drag-over mode. You can mix up drawing with and without inferences (see video at http://www.youtube.com/watch?v=mdqsYAbUfTE)
- Line On Surface now generate faces
- Angular Shapes like Rectangle, Parallelogram and Sector are generated as discrete curves so that you keep the sharp angles as plain lines when doing a Push Pull
- The script comes with my ugly icons at installation, but you can switch to CadFather's ones, much nicer, in the Default Parameter dialog box, and also select the one you want to keep and discard.
- And it's good to know that ToolsOnSurface also works without a surface. There is a trick explained in the doc to select the plane (mouse over a face and just press SHIFT, without clicking)
I did not change the algorithm for computing contours on surface. So you'll find the same limitations, especially on closed surfaces. I'll do something in a next release.