mirror of
https://github.com/MaSzyna-EU07/maszyna.git
synced 2026-10-17 14:29:20 +02:00
321c9dd7ab
The track layout library came in as a subproject of its own -- its own CMakeLists, its own install and export rules, its own include tree -- which only made the build harder to follow now that everything else is a module. It is part of the editor, so it lives where the editor lives. - editor/plan_*.cppm / plan_*.cpp: the fifteen interface units and twelve implementation units, flat in editor/ beside editorTerrain and orthophoto, with the plan_ prefix keeping them clear of what was already there (editor/turnouts is the preset catalogue, so the geometry is plan_turnout_geometry). - modules are named eu07.editor.plan_*, like every other module in the tree. - namespaces move under the editor's own: editor::plan, editor::plan::geometry, ::io, ::render. The library's old name is gone from the sources and the docs. - every moved file carries the MPL header the rest of the tree carries; it had none. version.hpp went with the subproject: macros only, and unused. - the umbrella header is dropped -- nothing imported it. - the unit tests survive the fold: editor/tests, behind EU07_EDITOR_PLAN_TESTS (off by default), compiles the interfaces a second time into a small library of its own, because a test can only import modules from a target it links and linking the game would drag the whole simulator in. The code under test needs nothing but a compiler. 7/7 pass. - a switch may now be written with two dashes as well: --editor beside -editor. Builds with clang 22 (-DWITH_BETTER_RENDERER=OFF); -editor and --editor both come up in the editor on empty ground.
53 lines
2.2 KiB
C++
53 lines
2.2 KiB
C++
/*
|
|
This Source Code Form is subject to the
|
|
terms of the Mozilla Public License, v.
|
|
2.0. If a copy of the MPL was not
|
|
distributed with this file, You can
|
|
obtain one at
|
|
http://mozilla.org/MPL/2.0/.
|
|
*/
|
|
module;
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
export module eu07.editor.plan_layout;
|
|
export import eu07.editor.plan_turnout_geometry;
|
|
export import eu07.editor.plan_model;
|
|
export import eu07.editor.plan_solution;
|
|
|
|
export {
|
|
|
|
namespace editor::plan {
|
|
|
|
/// Solves a whole document: lays every turnout on its through track, lays every
|
|
/// track from its anchor, and moves the tracks that are held parallel to another
|
|
/// track's element until they really lie at the offset they were given.
|
|
///
|
|
/// The order is not fixed in advance — it is worked out from what refers to
|
|
/// what. A branch anchored to a turnout's frog is laid after that turnout, which
|
|
/// is laid after its through track, however deep that goes: a turnout on the
|
|
/// branch of a turnout is nothing special. A reference that runs in a circle is
|
|
/// reported and its members are left unlaid, rather than being fed through a
|
|
/// fixed number of relaxation passes and whatever came out.
|
|
///
|
|
/// Nothing here writes to @p document. Never throws.
|
|
[[nodiscard]] Solution solve(const Document& document);
|
|
|
|
/// The catalogue type as the geometry layer wants it: the piece list with its
|
|
/// curvatures signed for @p hand (+1 diverges left). Public because the editor
|
|
/// dimensions a *type* with it — laying one from an identity pose is how the
|
|
/// catalogue numbers are checked before any instance stands on a track.
|
|
[[nodiscard]] plan::Turnout to_domain(const TurnoutType& type, int hand);
|
|
|
|
/// The construction points of a turnout laid from @p start: where its parts meet,
|
|
/// where its blade is dimensioned, and the points the drawing takes its lengths
|
|
/// between. Public for the same reason as to_domain — so a bare type is drawn from
|
|
/// the very same list the solver reports for a placement, rather than from a second
|
|
/// idea of what a construction point is.
|
|
[[nodiscard]] std::vector<TurnoutMark> turnout_marks(const plan::TurnoutGeometry& geometry,
|
|
const geometry::Pose& start);
|
|
|
|
} // namespace editor::plan
|
|
|
|
} // export
|