Martino Ferrari
ed3a8ce645
The repository had no licence at all, so every source was all-rights-reserved by default. Add the verbatim MIT text at LICENSE (Copyright (c) 2026 Martino Ferrari) and a two-line SPDX header to each of the 113 first-party sources -- 48 include/plot, 26 src, 10 adapters, 5 examples, 21 tests, 3 tools -- so the grant travels with each file rather than relying on the root document alone. Scripts keep their shebang on line 1; the SPDX lines follow it. Genuinely vendored code is untouched: third_party/stb_truetype.h carries no header of ours. src/render/embedded_mono_font.cpp is generated, so tools/fonts/gen_atlas.py emit() now writes the two lines into its header comment and the file was regenerated -- gen_atlas.py --check passes and the regeneration adds only those comment lines to the previously committed file. README's provenance section now states MIT and links LICENSE. No code, test or public API change.
51 lines
2.1 KiB
C++
51 lines
2.1 KiB
C++
// SPDX-License-Identifier: MIT
|
|
// SPDX-FileCopyrightText: 2026 Martino Ferrari
|
|
|
|
#pragma once
|
|
#include <plot/core/color.hpp>
|
|
#include <plot/core/types.hpp>
|
|
#include <plot/data/series.hpp>
|
|
#include <string>
|
|
|
|
namespace plot {
|
|
|
|
/// How a caller asks for a trace. The series pointer is borrowed and must outlive
|
|
/// the plot's use of it; `axis_x`/`axis_y` index the plot's x and y axis lists.
|
|
struct TraceDesc {
|
|
const data::Series* series = nullptr;
|
|
Color color = Color::hex(0x4FA3FF);
|
|
/// The stroke's width in **logical** pixels, like every stroke in `Style` (see
|
|
/// that struct's unit rule): the renderer converts it once, so a trace has the
|
|
/// same weight against the axis lines whatever the display's DPI.
|
|
f32 width = 1.5f;
|
|
u32 axis_x = 0, axis_y = 0;
|
|
/// What the trace is called, for the legend. Empty means "do not list it", which
|
|
/// is the whole cost of a legend for a caller that never names one: the trailing
|
|
/// default is what keeps the five-field aggregate initialisation every existing
|
|
/// caller writes -- `{&series, colour, width, axis_x, axis_y}` -- working
|
|
/// unchanged, exactly as `AxisDesc`'s trailing format does (and, in a build with
|
|
/// `-Wextra`, warning-clean).
|
|
std::string name{};
|
|
};
|
|
|
|
/// A series bound to a colour, width and axis pair. The series pointer may be
|
|
/// null (a trace whose data has not arrived yet): every consumer skips such a
|
|
/// trace rather than dereferencing it.
|
|
struct Trace {
|
|
const data::Series* series = nullptr;
|
|
Color color = Color::hex(0x4FA3FF);
|
|
/// Logical pixels, as in `TraceDesc::width`: converted to device pixels by the
|
|
/// renderer's one `Style::device()` call per stroke.
|
|
f32 width = 1.5f;
|
|
u32 axis_x = 0, axis_y = 0;
|
|
/// The legend's entry for this trace, empty when it has none. A name does not
|
|
/// make a trace drawable: the legend lists a trace only when it is visible, so a
|
|
/// null series is skipped there exactly as it is by every other consumer.
|
|
std::string name{};
|
|
|
|
/// True when the trace has a series with at least one sample to draw.
|
|
bool visible() const noexcept { return series != nullptr && series->size() > 0; }
|
|
};
|
|
|
|
} // namespace plot
|