Repository navigation
TSRE GenX v0.19 — Terrain Textures, Auto Place and Production Workflows
TSRE GenX v0.19 — Terrain Textures, Auto Place and Production Workflows
TSRE GenX is a 64-bit Windows route editor for Microsoft Train Simulator and
Open Rails routes. It combines the established TSRE editor with Qt 6/CMake,
terrain and map tools, Dynamic Track, PolyVeg, Activity Builder and Consist Builder.
Current version: v0.19. Both operator-run clean Release builds passed all 32 registered tests on 26 October 2026. The operator accepted the final manual checks. This full Windows release follows the immutable v0.18 baseline.
Major Updates Since v0.18
Terrain textures, presets and output
- Selecting a saved texture preset immediately loads its source and brush settings;
the separate Apply button is removed. Invalid/missing sources report an error.
Brush Scale, full rotation, previews and Recent controls support repeated painting. - Independent Mipmaps and DDS output switches apply to subsequently painted
patches. DDS uses native opaque RGB24 output; ACE remains available. Presets do
not change output switches. Existing base dimensions are preserved, including
2048-square TERRTEX, and matching seasonal format conversions are coordinated. - Saved mipmaps use linear-light, alpha-aware filtering with repeating texture
edges. Unsupported ACE mip dimensions stop Save instead of silently resizing. - Corrected rectangular painting/cropping, RGB pixel-row alignment and canonical
texture cache keys. Distant-terrain reset chooses terrainDM.dds, terrainDM.ace,
then terrain.ace according to available assets. - Shape textures prefer DDS over ACE within each ordered seasonal directory.
Snow also recognizes WinterSnow-capable vegetation, retaining seasonal precedence
and ordinary missing-texture fallback.
Full-operation progress and final route production
- Route Save reports the combined operation, including pending PolyVeg and wire
baking, terrain/TERRTEX encoding, file publication and generated-asset cleanup.
The display reaches 100% only after the operation succeeds. - Large save payloads use temporary disk staging rather than retaining an entire
terrain batch in memory. Existing transaction backup, rollback and duplicate
destination protections remain; complete route backups are still required. - Selection-sensitive HACKS shows actions relevant to the current object or
terrain. Terrain offers Compress TERRTEX — DXT1 for the complete route,
including seasonal ACE and DDS files and terrain-reference updates. - Production compression introduces loss, removes alpha, should be run once,
and retains no TERRTEX originals or backups. Use it on the final upload copy
after editing is complete. Progress, per-file verification and interruption
checkpoints support large routes; this is not an archival or reversible save.
Ruler (ap), fence posts and wire choices
- F5 Objects can follow the editable cyan Ruler (ap) independently of tracks
and roads. It is also available with the other rulers under F1 TSRE Tools;
placement opens Auto Place on Objects with the appropriate Follow mode. - Spacing, offsets, terrain following and ordinary point-edit controls apply.
Preserve Corners forces posts at 45–90 degree turns. Ordinary post headings
bisect their actual neighboring spans; preserved corner orientation is exempt. - The half-height guide has visible edit handles. Its placement button latches;
a second click clears it. Successful object placement clears/resets the guide;
partial placement retains it for a duplicate-safe retry. Guides are session-only. - Wires find compatible SNAP supports along ruler-placed runs without a nearby
track/road. Existing pair reservations prevent duplicates; Max Span and bounded
nearest-span discovery still require inspection near parallel or branching lines. - Plain remains the default with its existing sagging geometry. Barbed is
straight, with brown steel wire and blunt, constant-width barbs drawn on two
crossed alpha strips. Barbs are shorter and thicker; Width scales the silhouette.
Raw blue guides bake into textured scenery on Save. Existing bakes retain their
material until explicitly deleted and replaced.
PolyVeg planting and controls
- Compact collapsible controls, aligned Density/Cap values, a separate Seed column
and adjacent ruler actions improve F6 layout. The old Jump controls are removed. - Use OSM is optional for local ruler/area/full-tile planting. Turning it off
avoids requiring map derivatives; terrain, slope, water and database clearances
remain. Mapped polygon/flood workflows still require their geodata. - Plant Full Tile arms the next terrain click for one tile, with cancellation
and existing planting exclusions. F5 corridors offer side, setback, width and
range controls with shared schema/settings and duplicate-area checks. - Zero-result reports explain coverage, targets, terrain and exclusion counts;
they scroll and can be copied. Report suppression leaves validation errors visible.
glTF/GLB consists and international path names
- Consist Viewer and on-track previews accept glTF/GLB locomotive/wagon bodies
and freight models alongside legacy shapes. Authored offsets/pivots and Flip
are retained; corrected handedness/direction and depth clears improve previews. - Standard 4096-square textures and bounded larger containers are supported.
Simplified transparent surfaces draw after solids with graphics-state restoration.
Open Rails still owns final PBR shading and animation; TSRE displays rest pose. - Path metadata and standalone cloning preserve German umlauts, sharp s and other
Unicode letters/combining accents without transliteration. Existing UTF-16
route/activity/service/path serialization is retained.
All GenX Features at a Glance
Terrain, textures, seasons and water
- Track/road terrain conforming, selected-object conforming, smoothing and separate
database height biases support track beds, cuts and embankments across tile borders. - Whole-tile patch selection and Track, Road and shoreline painting complement
route-local brush presets, full texture rotation and validated multi-file loading. - Native 4 m/8 m terrain tools and resolution-aware texture matrices keep saved
terrain mapping consistent with Open Rails; ambiguous custom scales are preserved. - Main/Snow previews, Recent textures, seasonal/Night sets, paired Mirror Season
painting, immediate preset loading, texture scale, native ACE/RGB24 DDS output, optional saved mipmaps and coordinated cache refresh improve texturing. - Water rulers, shoreline processing, fitted seam-matched surfaces, terrain
adjustment, Waterbed Offset and Undo support river and shoreline work. - A final-production TERRTEX hack converts the full route and its seasonal ACE/DDS textures to opaque DXT1 with progress and interruption checkpoints. It is lossy, should run once, and retains no TERRTEX originals or backups.
- Confirmed terrain/TERRTEX resets, Water Tiles Off and generated-map cleanup retain
protected source assets. Terrain saves coordinate heights, flags, metadata and textures.
Vegetation and automated scenery
- F6 PolyVeg plants repeatable vegetation from SCO LIDEX geodata, corridors or Area
rulers using route-local schemas, density/rows, seed, caps and clearance controls. - The full-screen Schema Editor manages recipes and assets. Tile/LOD baking,
raw/baked status, bake-group properties and ownership manifests
support review, safe saves, rebaking and cleanup. - Forest-to-PolyVeg replacement and independent vegetation visibility extend that
workflow to existing routes without altering unrelated scenery. Optional OSM, full-tile planting, corridor setback/width and zero-result diagnostics support local planting. - F5 Auto Place supports track/road runs and cyan Ruler (ap) fence lines, finite range, spacing, offsets, selected
scenery as the source and repeatable pole wobble. Ruler placement supports editable points, corner preservation, smooth ordinary post headings and automatic guide reset. - Numbered SNAP attachments support native wire Commit, blue previews, sag/width/
span controls, Bake All Wires and selected-run/route-wide deletion. Recorded pairs
prevent duplicates; saved references and shared textures govern cleanup. Plain wire retains sag; straight Barbed uses adjustable crossed alpha strips and brown steel artwork.
Track, grades and interactive objects
- Classic and NextGen Auto-Flex support compound/S-curves with transactional
connection validation and consistent Dynamic Track mesh/database geometry. - Grade units, Lock Grade, Grade Helper and connectivity-aware Grade Symbols
support exact transitions and highlight direct crest/gully joins. - Place Guard validates scenery, track and interactives, including elevated scenery
and protection against flipping database-connected track. - Pickup track alignment/quarter-turn rotation and eligible turntable/transfer
activation improve interactive placement. Static instance scale is preserved. - Legacy shapes and lightweight glTF/GLB previews coexist in supported viewers
and Static/Pickup placement workflows. Consist previews also support glTF/GLB bodies and freight models, standard 4K textures and simplified transparency.
Maps, paths and Activity Builder
- F3 imagery supports OSM vectors, Google, Mapbox and custom providers; saved maps
load within camera tile range, with independent overlay controls and Shift+M. - F4 Activity Builder provides a scalable TrackDB map with live switches, deep zoom,
rotation, route markers, labels, signals, stations and service-point overlays. - Standalone path New/Edit/Clone/Delete sessions provide metadata validation,
cancellation rollback, atomic PAT saves and repair of stale or disconnected paths. - Natural-end routing, reverse points, duration/clock waits, passing sidings,
overlap display and Undo/Redo support path construction. ORTS Extended AI controls
include horn, uncouple, join/split and pass-red operations. - Existing activity/traffic controls have guarded selection and preview paths;
full Activity Builder and simulator compatibility remain subject to manual checks. Unicode path metadata and cloning retain German umlauts and other supported letters.
Editor workflow, diagnostics and save safety
- Scalable charcoal/orange panels, F7 navigation/control tools, Compass, movement
locks, pinning, search/category filters and bounded placement history simplify editing. - Startup/root selection, Restore Last Session, route-session cleanup, per-user
atomic JSON settings, backups, recovery, F12 controls and restart/restore support
reliable sessions. Interface sounds follow deliberate actions. - F11 route-wide diagnostics report orphan/isolated track, joint defects and
unreadable worlds with progress, navigation and remembered review status. - Create Route Health Report inventories route assets and database issues without
automatic repair. Route-local track-section preservation and guarded conversion
protect compatible existing definitions. - Coordinated key-file save generations, atomic file publication, rollback and
protected generated-asset cleanup reduce interrupted-save risk. A whole route
remains more than one transaction; complete route backups are still required. Overall save progress includes generated baking, texture encoding and publication; large transaction payloads spill to temporary disk staging. - Consist Builder includes normalized ORTS/MSTS includes, missing-stock replacement,
independent preview colours, resource cleanup and isolated rendering state.
Platform and compatibility
- Qt 6/CMake, matched 64-bit MinGW and an independent MSVC v143 lane provide
repeatable builds while retaining legacy-renderer parity as a reference. - MSTS/Open Rails UTF-16 serialization, bounded ACE/DDS/image handling and automated
encoding, geometry, save and generated-asset probes protect file compatibility. - The route-regression harness records file/terrain/database evidence. Automated
checks complement the workflow-specific manual checks in the test matrix.
Installation
The binary asset is tsre-scomod-v0.19.zip with its .sha256 companion.
This full release contains the reviewed, compiler-matched MinGW runtime.
- Download the binary ZIP and matching checksum from the v0.19 release.
GitHub's automatic source archives are not the runnable Windows package. - Verify the ZIP against its SHA-256 companion.
- Extract the complete archive to a permanent writable location.
- Run
AddShortcutDesktop.cmdfrom the extracted folder. - Launch through the generated TSRE GenX shortcut. Move the shortcut only
after creating it, and keep the extracted application folder intact. - Keep the executable, matched runtime libraries, plugins, assets and documents
together. Do not mix compiler runtimes or copy only a new executable into an old pack.
Back up routes before terrain conforming, water processing, route-wide saves,
Forest replacement or PolyVeg baking. Test substantial work on a copy first.
Production DXT1 conversion deliberately retains no TERRTEX backup: use a separate
final upload copy and retain your editable route separately.
Requirements and Limitations
- 64-bit Windows 10 version 1809 or later, or Windows 11. Windows 7 and Qt5/qmake
builds are unsupported. - Existing MSTS/Open Rails route content; SCO LIDEX derivatives for mapped PolyVeg.
- Source builds use Qt 6.11.1; MinGW 13.1 is the release baseline and MSVC v143
is the independent verification lane. - Wire discovery is bounded to 512 supports and 256 tiles per run, with an
8,192-span registry. It cannot infer the intended path among nearby parallel lines. - glTF preview is a bounded base-colour/rest-pose preview, not full simulator
PBR, animation or intersecting-transparency parity. - Both clean Release compiler suites passed 32/32 tests. The operator accepted
the final manual checks. See the current test matrix for hashes and coverage.
Source and Documentation
The immutable v0.19 tag identifies the exact reviewed release source. tsre-scomod-wip remains the maintained public source branch.
TEST-MATRIX-v0.19.md records build hashes, tests and manual coverage. Verify the
binary ZIP with its matching SHA-256 companion before extraction.
The package includes terrain, TERRTEX, seasonal painting, PolyVeg, Water Tools,
Dynamic Track, Grade Helper, Path Editor/Full Map and SNAP Pole/Wire guides.
scoWorkList.txt contains the same grouped feature summary without release history.
The optional SCOsnapPole model example remains a separate route-content download.
Acknowledgments
Piotr Gadecki (GokuMK) created TSRE5 and its core route, terrain, texture,
activity, consist, file and rendering systems. His later TSRE5vc work provided
independent Qt 6 and compressed-texture references.
Eric Olesen (eric-from-trainsim) sustained the TSRE 8.006 line that directly
precedes GenX and provided its principal compatibility and source/API reference.
Peter Gronbaek Andersen produced an independent Qt 6/CMake port whose build,
dependency, deployment and DDS work supplied important reviewed references.
Wayne Campbell and Pete Willard are thanked for their MSTS/ORST exporter code,
which was used as a reference.
License
TSRE GenX is distributed under the GNU General Public License version 3 or later.
Third-party components retain their own licenses; see LICENSE.md and
THIRD-PARTY-NOTICES.txt.