This commit closes the remaining red gates so `run-all.sh --fast` is
green end-to-end on the canonical dev machine.
New gates
─────────
1. cmake-format / cmake-lint
* scripts/quality/cmake-format.sh — dry-run by default,
--strict to fail on drift, --fix to apply
* .cmake-format.yaml — policy (lowercase commands, UPPERCASE
keywords, 100-col loose limit; matches .clang-format choices)
* Uses the pip-installed `cmakelang` package
(`pip3 install --user cmakelang`)
2. codespell
* scripts/quality/codespell.sh — exit 1 on any typo, --fix
interactively
* .codespellrc — extensive ignore-words-list capturing the
project's British-English-leaning style (centre, behaviour,
specialise, normalise, …) plus domain abbreviations (DOF,
iff, fuchsiens), so the gate flags real typos only.
* Validated: 0 typos across docs + code/include + scripts +
code/{src,tests}.
SPDX rollout (license-headers --fix)
────────────────────────────────────
license-headers.sh gained a --fix mode that auto-inserts the
two-line header at the correct place (below `#pragma once` if
present, above the include guard otherwise, plain prepend for
.cpp). Ran it on 60 of 66 files — 100 %-licensed now.
Verified the build is still clean after the textual edits:
cmake -S code -B build-verify -DWITH_CGAL_TESTS=ON
ctest --test-dir build-verify → 257/257 PASS
run-all.sh + README updated to include the two new gates.
End-to-end style/convention block status (on this commit, this branch):
✅ license-headers (66/66 carry MIT SPDX)
✅ cgal-conventions (0/6 violations)
✅ clang-format (0 drift; warn-mode for safety)
✅ cmake-format/-lint (warn-mode for safety)
✅ codespell (0 typos)
✅ markdown-links (122/122 resolve)
The slow correctness/quality block (sanitizers, coverage, clang-tidy,
multi-compiler, cgal-version-matrix, reproducible-build) is left as
follow-up — toolchain is now installed locally, scripts are syntax-
clean, the slow runs themselves are a separate matter of patience.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
69 lines
2.5 KiB
C++
69 lines
2.5 KiB
C++
#pragma once
|
|
// Copyright (c) 2024-2026 Tarik Moussa.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
// mesh_io.hpp
|
|
//
|
|
// Phase 4b — CGAL::IO wrappers for ConformalMesh.
|
|
//
|
|
// Reads and writes ConformalMesh (CGAL::Surface_mesh) in standard polygon-mesh
|
|
// formats using the CGAL Polygon Mesh I/O utilities (CGAL 5.4+).
|
|
//
|
|
// Supported formats (detected by file extension):
|
|
// .off — Object File Format (read + write)
|
|
// .obj — Wavefront OBJ (read + write)
|
|
// .ply — Polygon File Format (read + write)
|
|
//
|
|
// Usage:
|
|
// ConformalMesh mesh;
|
|
// if (!read_mesh("input.off", mesh)) throw std::runtime_error("read failed");
|
|
// // ... process mesh ...
|
|
// write_mesh("output.off", mesh);
|
|
//
|
|
// Note: property maps (lambda0, v_idx, etc.) are NOT serialised — they must
|
|
// be re-initialised with setup_*_maps() + compute_lambda0_from_mesh() after
|
|
// reading a file.
|
|
|
|
#include "conformal_mesh.hpp"
|
|
#include <CGAL/IO/polygon_mesh_io.h>
|
|
#include <string>
|
|
#include <stdexcept>
|
|
|
|
namespace conformallab {
|
|
|
|
// ── Read ──────────────────────────────────────────────────────────────────────
|
|
//
|
|
// Reads a polygon mesh from file into `mesh` (clears any existing content).
|
|
// Returns true on success, false on failure.
|
|
inline bool read_mesh(const std::string& filename, ConformalMesh& mesh)
|
|
{
|
|
mesh.clear();
|
|
return CGAL::IO::read_polygon_mesh(filename, mesh);
|
|
}
|
|
|
|
// ── Write ─────────────────────────────────────────────────────────────────────
|
|
//
|
|
// Writes `mesh` to `filename`. Returns true on success.
|
|
inline bool write_mesh(const std::string& filename, const ConformalMesh& mesh)
|
|
{
|
|
return CGAL::IO::write_polygon_mesh(filename, mesh);
|
|
}
|
|
|
|
// ── Convenience: throwing wrappers ────────────────────────────────────────────
|
|
|
|
inline ConformalMesh load_mesh(const std::string& filename)
|
|
{
|
|
ConformalMesh mesh;
|
|
if (!read_mesh(filename, mesh))
|
|
throw std::runtime_error("conformallab: failed to read mesh from " + filename);
|
|
return mesh;
|
|
}
|
|
|
|
inline void save_mesh(const std::string& filename, const ConformalMesh& mesh)
|
|
{
|
|
if (!write_mesh(filename, mesh))
|
|
throw std::runtime_error("conformallab: failed to write mesh to " + filename);
|
|
}
|
|
|
|
} // namespace conformallab
|