feat(plot)!: harden pipeline, XY series, dash/markers, touch, packaging
Breaking: Series::gather emits x relative to x0() and takes a GatherMode; consumers reconstruct absolute x in f64 before mapping (series.hpp documents the contract). Bugs, each pinned by a fail-before regression test: - render: f32 staging quantised epoch-time x into 128 px columns; every data-space draw now stages to_space(x) - to_space(origin) with the origin folded into the offset uniform in f64 (epoch/zero-origin twins rasterise identically) - ticks: major test was ULP-fragile and blanked epoch axes; majors are an integer-index test and are never truncated by the minor cap - gather: LOD envelope emitted buckets straddling [begin,end); ceil/floor bucket edges + raw lead/trail spans - live follow: log x axes held a linear span and zoomed every frame; span and offset now live in axis space (plot + both figure link-group paths) - input: a zero-notch wheel disarmed auto_scale on every axis; dy==0 pans x, factor == 1 / inf refused in wheel and drag zoom - render: the single text flush painted legend names over the crosshair readout panel; two batches, under flushed before the panel - data: NaN dropped from min/max unless it seeded the fold; non-finite samples are now excluded from every aggregate and from cached bounds Robustness: viewport normalisation (no clamp UB), non-finite range refusal, pyramid level cap at 57 (no shift/div UB through public gather), rounded ring capacity documented + pre-sized, GL blend func and UNPACK_ALIGNMENT save/restore, Renderer::release_gl() teardown, u64 buffer epochs, annotation captions clamped, button-aware GLFW row capture, cached figure row rects (no per-event layout), ruler-pair measurement refused, span-nonfinite guards in axis_ends. Features: XY series (sorted x, binary-search neighbours/snap, LOD over sample index); StreamSeries::freeze(); ArraySeries::push(); per-trace dash and markers (scatter at width 0) with auto or literal stride; GatherMode Envelope/Nearest/Mean via bucket_sum/sumsq; Style::line_aa_px; per-glyph text colour (readout values in trace colour); wheel-dx x pan; arrow-key pan; Escape cancels a drag and restores captured ranges; modifier-masked box zoom (Shift both, Ctrl x, Alt y); double-click reset via PointerEvent::time_s; ImGui key repeat unified; pinch gestures on Qt and GTK; pixelDelta wheel path and DevicePixelRatioChange handling; GNUInstallDirs, SOVERSION, SameMinorVersion, generated plot/version.hpp, relocatable plot.pc, licence install, FILES_MATCHING, GitHub Actions CI (debug/coverage/asan). Suite 283 -> 350 cases, 0 failed; coverage 93.9% (3730/3971) over 24 files, floor 80/90 held; ASAN preset suite green; all four demos run headless (the GTK scripted-resize check needs a window manager and fails identically on the parent commit); readme_main.cpp committed and compiles with the README command; pkg-config and find_package consumption verified from a relocated install prefix.
This commit is contained in:
Martino Ferrari committed
1 parent
f132a5ec92
commit
38ef459897
77 files changed
+5905
-688
No files matched your search
@@ -16,6 +16,30 @@ option(PLOT_BUILD_GLFW "Build the GLFW adapter and demo" OFF)
|
||||
option(PLOT_BUILD_IMGUI "Build the Dear ImGui adapter and demo" OFF)
|
||||
option(PLOT_BUILD_QT6 "Build the Qt6 adapter and demo" OFF)
|
||||
option(PLOT_BUILD_GTK4 "Build the GTK4 adapter and demo" OFF)
|
||||
# The optional runtime-font backend: plot::text::TrueTypeFont, which bakes a real
|
||||
# TrueType/OpenType file into a fixed-cell atlas at run time (see
|
||||
# include/plot/text/true_type_font.hpp). It is the one target that compiles the
|
||||
# vendored third_party/stb_truetype.h, so it is opt-in and separable -- the core
|
||||
# library, its public headers and its tests build without it -- and its default
|
||||
# follows the vendored header's presence: a tree that has the file wants the
|
||||
# feature, and one that does not cannot have it. Asking for it explicitly without
|
||||
# the header is an error rather than a silent downgrade, because the option is
|
||||
# then the only thing that would have said so. The top-level CMakeLists.txt adds
|
||||
# the target itself; this file only decides whether it exists.
|
||||
if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/third_party/stb_truetype.h")
|
||||
set(PLOT_VENDORED_STB_TRUETYPE TRUE)
|
||||
else()
|
||||
set(PLOT_VENDORED_STB_TRUETYPE FALSE)
|
||||
endif()
|
||||
option(PLOT_BUILD_TTF_FONT
|
||||
"Build the optional plot::text::TrueTypeFont backend (vendored stb_truetype)"
|
||||
${PLOT_VENDORED_STB_TRUETYPE})
|
||||
if(PLOT_BUILD_TTF_FONT AND NOT PLOT_VENDORED_STB_TRUETYPE)
|
||||
message(FATAL_ERROR
|
||||
"plot: PLOT_BUILD_TTF_FONT=ON needs third_party/stb_truetype.h, which this tree does "
|
||||
"not have. Restore it -- include/plot/text/true_type_font.hpp records the version and "
|
||||
"the source URL it came from -- or configure with -DPLOT_BUILD_TTF_FONT=OFF.")
|
||||
endif()
|
||||
option(PLOT_INSTALL "Generate install and export rules (find_package(plot))" ON)
|
||||
set(PLOT_SANITIZE "" CACHE STRING
|
||||
"Sanitizers to build with, as the list a -fsanitize= flag takes (e.g. address); empty for none")
|
||||
@@ -27,9 +51,22 @@ set(PLOT_SANITIZE "" CACHE STRING
|
||||
# presets leave it off, so their target lists, configure time and build product
|
||||
# are exactly what they were before this option existed.
|
||||
option(PLOT_COVERAGE "Add the `coverage` target (needs a --coverage build tree)" OFF)
|
||||
if(PLOT_COVERAGE AND NOT CMAKE_CXX_FLAGS MATCHES "--coverage")
|
||||
# The instrumented tree is one whose *effective* flags carry --coverage, and the
|
||||
# base CMAKE_CXX_FLAGS is only part of those: the active configuration's own
|
||||
# profile (CMAKE_CXX_FLAGS_<CONFIG>) is applied on top, and --coverage is
|
||||
# equally at home in either. The linux-coverage preset sets the base; a user who
|
||||
# sets it on the Debug profile instead gets exactly the same instrumented tree,
|
||||
# which the old base-only string match rejected. Matching the two together is
|
||||
# still just an option check on the configuration profile -- the guard does not
|
||||
# try to read the compiler's mind, only the flags this build will pass it.
|
||||
string(TOUPPER "${CMAKE_BUILD_TYPE}" plot_coverage_config)
|
||||
set(plot_coverage_flags
|
||||
"${CMAKE_CXX_FLAGS} ${CMAKE_CXX_FLAGS_${plot_coverage_config}}")
|
||||
if(PLOT_COVERAGE AND NOT plot_coverage_flags MATCHES "--coverage")
|
||||
message(FATAL_ERROR
|
||||
"plot: PLOT_COVERAGE=ON needs a --coverage build (CMAKE_CXX_FLAGS is \"${CMAKE_CXX_FLAGS}\"). "
|
||||
"plot: PLOT_COVERAGE=ON needs a --coverage build (CMAKE_CXX_FLAGS is "
|
||||
"\"${CMAKE_CXX_FLAGS}\" and CMAKE_CXX_FLAGS_${plot_coverage_config} is "
|
||||
"\"${CMAKE_CXX_FLAGS_${plot_coverage_config}}\"). "
|
||||
"Configure with --preset linux-coverage, or drop -DPLOT_COVERAGE=ON.")
|
||||
endif()
|
||||
if(PLOT_COVERAGE AND NOT PLOT_BUILD_TESTS)
|
||||
|
||||
@@ -32,6 +32,21 @@
|
||||
# to the list below; a caller may override it, and
|
||||
# emptying it is how a test proves the exemption is what
|
||||
# keeps a header out of the "missing" report.
|
||||
# PLOT_EXTRA_PUBLIC_HEADERS generated public headers, relative to
|
||||
# PLOT_INCLUDE_DIR, that the glob below cannot see
|
||||
# because configure_file() writes them into the build
|
||||
# tree (plot/version.hpp). They are checked like any
|
||||
# other public header: the umbrella has to name them,
|
||||
# and the dangling-include check cannot demand them
|
||||
# under PLOT_INCLUDE_DIR, because their existence is
|
||||
# pinned by the configure that generated them. Defaults
|
||||
# to the project's own list, on the same terms as the
|
||||
# optional list: exact paths, because a hole should be
|
||||
# a list of files.
|
||||
# PLOT_GENERATED_INCLUDE_DIR the build-tree directory those headers live in,
|
||||
# consulted when one of them is not under
|
||||
# PLOT_INCLUDE_DIR. Unset in a tree with no generated
|
||||
# headers.
|
||||
|
||||
if(NOT DEFINED PLOT_OPTIONAL_HEADERS)
|
||||
set(PLOT_OPTIONAL_HEADERS
|
||||
@@ -42,6 +57,18 @@ if(NOT DEFINED PLOT_OPTIONAL_HEADERS)
|
||||
"plot/text/true_type_font.hpp")
|
||||
endif()
|
||||
|
||||
if(NOT DEFINED PLOT_EXTRA_PUBLIC_HEADERS)
|
||||
set(PLOT_EXTRA_PUBLIC_HEADERS
|
||||
# <plot/version.hpp>, generated by configure_file() from
|
||||
# include/plot/version.hpp.in into the build tree and installed with the
|
||||
# public headers. The glob cannot see it -- it is not under the source
|
||||
# include root -- and neither can the dangling-include check, so the
|
||||
# default list declares it: the umbrella must still carry its include, and
|
||||
# a script run without the caller's -D inputs (the exemption test, a bare
|
||||
# -P invocation) judges the umbrella exactly as the build does.
|
||||
"plot/version.hpp")
|
||||
endif()
|
||||
|
||||
if(NOT DEFINED PLOT_INCLUDE_DIR)
|
||||
message(FATAL_ERROR "plot: PLOT_INCLUDE_DIR is not set")
|
||||
endif()
|
||||
@@ -52,6 +79,9 @@ endif()
|
||||
file(GLOB_RECURSE plot_umbrella_headers
|
||||
RELATIVE "${PLOT_INCLUDE_DIR}"
|
||||
"${PLOT_INCLUDE_DIR}/plot/*.hpp")
|
||||
if(PLOT_EXTRA_PUBLIC_HEADERS)
|
||||
list(APPEND plot_umbrella_headers ${PLOT_EXTRA_PUBLIC_HEADERS})
|
||||
endif()
|
||||
list(SORT plot_umbrella_headers)
|
||||
file(READ "${PLOT_UMBRELLA}" plot_umbrella_text)
|
||||
|
||||
@@ -100,8 +130,19 @@ string(REGEX MATCHALL "#include <plot/[^>]+>" plot_umbrella_includes "${plot_umb
|
||||
set(plot_umbrella_dangling "")
|
||||
foreach(plot_umbrella_include IN LISTS plot_umbrella_includes)
|
||||
string(REGEX REPLACE "#include <([^>]+)>" "\\1" plot_umbrella_header "${plot_umbrella_include}")
|
||||
# A declared generated header is exempt from the existence demand: it lives
|
||||
# in the build tree by construction -- the configure that produced this
|
||||
# umbrella also produced the header -- so a run without
|
||||
# PLOT_GENERATED_INCLUDE_DIR set (a bare -P invocation) judges it on the
|
||||
# umbrella naming it, which the required-set loop above already checked.
|
||||
if(plot_umbrella_header IN_LIST PLOT_EXTRA_PUBLIC_HEADERS)
|
||||
continue()
|
||||
endif()
|
||||
if(NOT EXISTS "${PLOT_INCLUDE_DIR}/${plot_umbrella_header}")
|
||||
list(APPEND plot_umbrella_dangling "${plot_umbrella_header}")
|
||||
if(NOT DEFINED PLOT_GENERATED_INCLUDE_DIR OR
|
||||
NOT EXISTS "${PLOT_GENERATED_INCLUDE_DIR}/${plot_umbrella_header}")
|
||||
list(APPEND plot_umbrella_dangling "${plot_umbrella_header}")
|
||||
endif()
|
||||
endif()
|
||||
endforeach()
|
||||
|
||||
|
||||
Reference in new issue
Block a user