mirror of
https://github.com/MaSzyna-EU07/maszyna.git
synced 2026-10-17 02:49:19 +02:00
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.
44 lines
1.5 KiB
C++
44 lines
1.5 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 <optional>
|
|
#include <string>
|
|
|
|
export module eu07.editor.plan_document_io;
|
|
export import eu07.editor.plan_model;
|
|
|
|
export {
|
|
|
|
namespace editor::plan::io {
|
|
|
|
/// The `.m0s` format, version 3.
|
|
///
|
|
/// Line-oriented text, one concept per token, every reference by id, and an
|
|
/// explicit version on the first line. Earlier versions are not read: they
|
|
/// described different models — anchored straights with mode-tagged fits between
|
|
/// them (1), then elements whose lengths were solved against construction lines
|
|
/// (2) — and translating either would have meant keeping those concepts alive in
|
|
/// the reader after they were removed from everything else.
|
|
///
|
|
/// Doubles go through std::to_chars/from_chars, so a round trip is exact and
|
|
/// does not depend on the locale.
|
|
[[nodiscard]] std::string serialize(const plan::Document& document);
|
|
|
|
/// Returns nothing when @p text is not a version 3 document or is malformed.
|
|
[[nodiscard]] std::optional<plan::Document> deserialize(const std::string& text);
|
|
|
|
[[nodiscard]] std::string default_project_path();
|
|
bool save(const plan::Document& document, const std::string& path = default_project_path());
|
|
[[nodiscard]] std::optional<plan::Document> load(
|
|
const std::string& path = default_project_path());
|
|
|
|
} // namespace editor::plan::io
|
|
|
|
} // export
|