Torus Plugin

Version: Torus 1.0
Release Date: July 21, 2010
Requirements: SketchUp 6.0+
Download Torus Plugin for SketchUp Download Torus Plugin Torus

This plugin creates your garden-variety torus. You could spend five or ten minutes fiddling around with the SketchUp Follow Me Tool to draw a torus. Or you could spend just 10 seconds filling out a dialog box to create a nice smooth torus with this plugin.

You can specify the number of latitude lines and longitude lines to control the amount of geometry created. The more lines, the more smooth the surface will be.

Twisted Torus

You can also use this plugin to draw some interesting twisted tori. This is the shape you would get if you could cut the torus tube, twist the ends, and glue them back together. To notice the twist, the tube needs to have a polygonal cross section. But, you can control this aspect of the geometry by specifying just a few latitude lines for the torus. Below are some examples of a square torus being twisted by different amounts.

Twisted Torus

By square, I mean the tube has four latitude lines (the creased edges), with four sides (surfaces) in between, so the cross section is a square. The torus on the upper left has no twist. The next has one twist; if you follow one side around the torus, you will end up on the adjacent side after one revolution. The next torus has two twists, and so on. The last torus has five twists.

Torus Torus

There is no limit on the number of twists or sides. On the left is a square torus with 20 twists. The torus on the right has 12 sides, and 12 twists, so each side reconnects with itself after one revolution.

Torus

The low-poly versions, with all the edges drawn in, are also kind of interesting. On the left, is a square torus with one twist.

Usage

Torus Dialog Box

To run the script, select the Draw > Torus menu item. This will open a dialog box to enter the torus parameter values.

The inner radius is the radius of the hole. The outer radius is the distance from the center to the outer edge of the torus.

If there is no twist, then the latitude and longitude lines are invisible to create a smooth seamless surface.

If the torus does have a twist, then the latitude lines are drawn as visible edges, because otherwise you wouldn't be able to see the twist.

If the number of longitude lines or latitude lines is 12 or less, then they are drawn as visible hard edges. This way, very low-poly constructions are displayed as torus-shaped polyhedra.

For an ordinary torus, the twist is zero. Otherwise, it is a positive integer. A twist value of n will rotate the tube n/m times, where m is the number of sides (latitude lines).

When you click OK, the torus is created as a component, and the component placement tool is activated to position the torus in the model.

The previous dialog box values will be used for the default values the next time. The previous values are remembered between SketchUp sessions.

Installation and Removal

Click the download button at the top of the page. It will download a file named rp_torus.rbs. Move the file to your SketchUp Plugins folder. Remove the previous version, if there is one. Restart SketchUp.

To remove the plugin, just delete the file rp_torus.rbs.