UModeler X MCPis live — model with an AI agent
UModeler X

Gear

A spur gear with parameters for teeth, pressure angle and bore.

Gear is a spur gear driven by parameters for teeth count, tip and root radii, bore and pressure angle.


Geometry

The topology is the same tube structure as Pipe (inner wall, outer wall, top and bottom plates); only the outer wall radius swings between the tip and root circles along the tooth profile.

Each tooth occupies one pitch (360° ÷ teeth), split into a four-segment trapezoidal profile. Tip Tooth Width is the flat tip as a ratio of the pitch, and the root width is derived from the Pressure Angle.

The pivot is at the center of the bottom face, so a gear of thickness t occupies y=0 to y=t.


Parameters

LabelScript keyDefaultRangeDescription
Tip Radiusr110.02 ~ 1000Tip circle radius — the outer size of the gear, in meters
Root Radiusr20.80.011 ~ 1000Root circle radius — must stay below Tip Radius
Bore Radiusr0.30.001 ~ 1000Center hole (bore) radius, in meters
Thicknessh0.25-1000 ~ 1000Gear thickness in meters
Teethsides123 ~ 128Number of teeth
Tip Tooth Widthth0.250.05 ~ 0.95Flat tip width as a ratio of one tooth pitch
Pressure Angleang200 ~ 45Pressure angle in degrees — larger widens the tooth root
Height Segmentheightsegment11 ~ 32Divisions through the thickness

Gear reinterprets the shared fields with gear terminology. The script keys are r1 (tip), r2 (root), r (bore), h (thickness), sides (teeth), th (tip tooth width ratio) and ang (pressure angle). They mean something different here than on other shapes, so read the Inspector labels.


How to create

  1. Drag in empty space — the drag distance becomes the tip radius. The root radius is set to 80% and the bore to 30% of it automatically.

  2. Click to confirm, then move the mouse up to set the thickness.

  3. Click again to finish, then set teeth and pressure angle in the Inspector.


Scene view editing

The ±X and ±Z handles drive Tip Radius and the ±Y handles drive Thickness. Root Radius and Bore Radius are set separately in the Inspector — growing only the tip makes longer teeth.


Tips

Tip Tooth Width above 0.5 lets the pressure angle widen the root until the valleys nearly vanish, leaving a notched disc. Keep it at 0.2 – 0.3 for a gear-like read.

For a meshing pair, match the pitch (Tip Radius ÷ teeth) across both gears and use the same pressure angle.

A thin gear (0.05 or less) reads as a sprocket.


Script

In a script this shape is written as gear.

gear "DriveGear" r1=1 r2=0.8 r=0.3 h=0.25 sides=16 th=0.25 ang=20 @0,0,0
gear "Sprocket" r1=0.5 r2=0.42 r=0.1 h=0.04 sides=24 @2,0,0

See also — Shape Type List · Creating Shapes and Modes · Scene Script Syntax

Gear | UModeler X Manual