kapy academy

Text, Artwork and Gears

5 min readUpdated Aug 2026

Use the INSERT group, the third on the sketch toolbar, to place the primitives you do not draw point by point: a text block, an SVG, and the gear family. Reach for it when you want a name plate, a logo or a spur gear. Each one is a single sketch entity that carries its own parameters, so it stays editable instead of freezing into a pile of lines.

Text

Two clicks draw the box the text will live in: opposite corners, dragged out like a rectangle. Then set the content, font, size in millimetres, alignment, style and spacing in the Text window. The outline updates as you type, and it extrudes like any other closed profile, engraved by cutting or raised by adding.

Text is a primitive with a panelDrag out the box, then type into the Text window. The outline follows.

Because the size is in millimetres rather than points, what you type is what gets printed. Sub-millimetre strokes do not survive a 0.4 mm nozzle, so keep letter strokes above roughly one bead width. How FDM shapes your design explains why.

SVG

Artwork from the galleryPick a category, pick a tile, insert, and place it on the plane.

Insert artwork from a file or from the built-in gallery. It arrives anchored to a 4-corner construction frame. Drag any corner to scale and rotate it at once, aspect ratio preserved. Use the frame as the handle: constrain it and the artwork inherits the constraint.

Gears

A gear in Kapy is a real sketch primitive with involute teeth, not a picture of one. Two clicks make it: the centre, then a point that sets the pitch radius and which way the gear faces.

A gear is two clicksCentre, then a point on the pitch circle.

Where the numbers live

You never type a tooth count. Every gear carries two construction lines, and they are what you dimension:

The two lines that drive a gear
Line From → to What it sets
Pitch line Centre → outer point The pitch radius, and the gear's orientation
Module line Off the end of the pitch line The module m — tooth size

The tooth count falls out of the two: z = 2·r / m, rounded. Dimension the pitch line to 20 mm and the module line to 1 mm and you have a 40-tooth gear. Halve the module and you have 80 finer ones in the same circle.

The pitch line and the module line: the gear's parameters, drawn as geometry you can constrain.
The pitch line and the module line: the gear's parameters, drawn as geometry you can constrain.

The three kinds

Gear tools
Tool Clicks Notes
External gear 2 Teeth grow outward from the pitch circle
Internal (ring) gear 2 Teeth grow inward; the outer rim sits at r + 2.25m
Rack 2 Both clicks draw the pitch line. The module starts at one fortieth of its length; drag the end of the perpendicular module line to change it. Tooth pitch along the line is π·m
A rack: the straight gear, with the same module as the pinion that will run on it.
A rack: the straight gear, with the same module as the pinion that will run on it.

Meshing

Two gears that merely look adjacent are not engaged. Apply the Mesh gears constraint to make it real: it forces the same module on both, keeps their pitch circles tangent, and clocks the teeth so they interlock. Drag one and it rides around the other, still meshed. It works external-to-external, ring-and-pinion and rack-and-pinion.

For a chain of them, use the Gear train: click each centre in turn and every vertex of the resulting polyline gets a gear sized so consecutive ones mesh, all sharing one module. Edit the first gear's module line to change them all. A chip between the first two shows the overall ratio, and clicking it lets you set your own. Move a gear and the chain re-solves. Delete one in the middle and the train splits in two.

A train meshes them for youTwo centres, two meshed gears, and the ratio they make written between them.

Press Escape to finish the train, the same key that ends a line chain.

See also

Discord