The basics
Import a grayscale heightmap PNG (white = highest, black = lowest) or open a saved .rutforge project, and set the real-world size in metres (X width, Y length, Z height range). Then paint ruts on top - everything is measured in metres against your map. Heightmaps larger than 2049px work but can be slow; a smaller map is smoother to edit.
Tools
editDraw - place a rut: digs a channel on one side and raises a berm on the other. A Draw / Pen toggle sits in the top-left of the canvas.
blur_onSmooth - soften / flatten an area with a brush.
ink_eraserErase - fade edits back toward the original terrain.
pan_toolPan - drag to move the view.
Drawing ruts
editDraw (freehand) - click and drag to paint a rut along your cursor. Draw fast or slow; the rut renders when you release.
stylus_fountain_penPen - click to drop anchor points, drag for smooth curves. Move an anchor or drag a handle to reshape it while you build. Click the first anchor to close a loop. Enter applies, Esc cancels, Backspace / Ctrl/⌘ Z steps back.
The channel automatically digs toward the inside of a curve (so a circle digs toward its centre), whichever way you draw it. Hold Shift while drawing to flip the side.
Rut shape
Depth and Height are independent (each has its own width and sharpness). Depth Edge rounds the channel's outer wall; Fade blends the berm's outer edge. Taper fades the rut in and out to ground at the start / end of a stroke. Rut Opacity scales every rut for both display and export. Save your favourite settings as a Preset.
Layers & groups
Every rut you place appears in the Layers tab (right panel). Click one (or click it on the canvas) to select it - it flashes so you can find it - then adjust the shape sliders and hit Apply to reshape just that rut. Multi-select with Ctrl / Shift-click and Group them with a name to edit several at once. Each rut can be renamed, hidden, reordered, or deleted.
Heightmap views
Defaultshaded relief - lit by slope so ruts read even on bright, high terrain
Actualthe true grayscale heightmap (what gets exported)
Originalthe imported terrain with no ruts
Keyboard & mouse
Single-key shortcuts work while the pointer is over the canvas / 3D view.
Hold Shiftwhile drawing, flips the rut (channel vs berm side)
Hold Spacetemporarily pan (2D canvas and 3D view)
[ ]resize the brush (Smooth/Erase) or both rut widths (Draw)
B P S E HDraw / Pen / Smooth / Erase / Pan
Ffit the heightmap to the window
Scrollzoom toward the cursor
Ctrl/⌘ Z Yundo / redo (also steps back pen anchors while building)
Ctrl/⌘ Sexport the full 16-bit heightmap
3D view
Toggle the 3D button to see the true-scale ground deform as you paint, shaded like the Default view. Drag to orbit, scroll to zoom, and Space / Shift / right-drag to pan. Drag the divider to resize it.
Saving & exporting
Save / Open store a .rutforge working file (original + your edits + layers + settings). Export Heightmap lets you pick an output size (defaults to the source) and offers:
Fullhm-ruts-full.png - the complete 16-bit heightmap
Ruts onlyhm-ruts-only.png - a transparent 16-bit PNG of just the ruts. Layer it over your original in Photoshop (Normal blend) and flatten for a pixel-exact result.
Edge maskhm-ruts-edgemask.png - a transparent mask of the ruts (white berm to black channel, fading out at the edges) for use as a blend / edge mask.