.. index:: pair: namespace; EE::UI::Charts
.. _doxid-namespace_e_e_1_1_u_i_1_1_charts:

namespace EE::UI::Charts
========================

.. toctree::
	:hidden:

	enum_EE_UI_Charts_AxisPosition.rst
	enum_EE_UI_Charts_DataOrder.rst
	enum_EE_UI_Charts_LineCap.rst
	enum_EE_UI_Charts_LineJoin.rst
	struct_EE_UI_Charts_ChartPoint.rst
	struct_EE_UI_Charts_DataDelta.rst
	struct_EE_UI_Charts_DataRange.rst
	struct_EE_UI_Charts_IndexRange.rst
	struct_EE_UI_Charts_LinearSpan.rst
	struct_EE_UI_Charts_PointTooltipContext.rst
	struct_EE_UI_Charts_RangeConstraints.rst
	struct_EE_UI_Charts_ReducedPoint.rst
	struct_EE_UI_Charts_TooltipData.rst
	struct_EE_UI_Charts_TooltipField.rst
	struct_EE_UI_Charts_TooltipText.rst
	struct_EE_UI_Charts_XYDataChunk.rst
	class_EE_UI_Charts_AxisScale.rst
	class_EE_UI_Charts_AxisViewport.rst
	class_EE_UI_Charts_ChartAxis.rst
	class_EE_UI_Charts_ChartModel.rst
	class_EE_UI_Charts_ImmutableXYDataSource.rst
	class_EE_UI_Charts_LineSeries.rst
	class_EE_UI_Charts_LinearScale.rst
	class_EE_UI_Charts_ModelXYDataSource.rst
	class_EE_UI_Charts_OwnedXYDataSource.rst
	class_EE_UI_Charts_RingXYDataSource.rst
	class_EE_UI_Charts_StridedSpan.rst
	class_EE_UI_Charts_UIChart.rst
	class_EE_UI_Charts_XYDataRead.rst
	class_EE_UI_Charts_XYDataSource.rst

Overview
~~~~~~~~




.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	
	namespace Charts {

	// typedefs

	typedef std::variant<:ref:`TooltipText<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_tooltip_text>`, :ref:`TooltipData<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_tooltip_data>`> :target:`TooltipPayload<doxid-namespace_e_e_1_1_u_i_1_1_charts_1afd1d7cef72e77453ac1b10e82df59305>`;
	typedef std::function<std::optional<:ref:`TooltipPayload<doxid-namespace_e_e_1_1_u_i_1_1_charts_1afd1d7cef72e77453ac1b10e82df59305>`>(const :ref:`PointTooltipContext<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_point_tooltip_context>`&)> :target:`PointTooltipProvider<doxid-namespace_e_e_1_1_u_i_1_1_charts_1aa4c3a4047bdb61547d05ad7ddcc056c4>`;
	typedef std::variant<:ref:`StridedSpan<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_strided_span>`<float>, :ref:`StridedSpan<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_strided_span>`<double>, :ref:`LinearSpan<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_linear_span>`> :target:`XDataView<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a5e1d82aa9031f77ba751a7b39895bc40>`;
	typedef std::variant<:ref:`StridedSpan<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_strided_span>`<float>, :ref:`StridedSpan<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_strided_span>`<double>> :target:`YDataView<doxid-namespace_e_e_1_1_u_i_1_1_charts_1afc7799f5ebcf33ddc8630cbd6aeaae04>`;

	// enums

	enum :ref:`AxisPosition<doxid-namespace_e_e_1_1_u_i_1_1_charts_1add8e9d6a1c9cde013fa3cdd395afb204>`;
	enum :ref:`DataOrder<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a2cf5ef16471dc196583495036b7deb36>`;
	enum :ref:`LineCap<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a465c708c042710abd8395b3339829cc4>`;
	enum :ref:`LineJoin<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a0dd4414cc521827263f61f8d55f99833>`;

	// structs

	struct :ref:`ChartPoint<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_chart_point>`;
	struct :ref:`DataDelta<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_delta>`;
	struct :ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>`;
	struct :ref:`IndexRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_index_range>`;
	struct :ref:`LinearSpan<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_linear_span>`;
	struct :ref:`PointTooltipContext<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_point_tooltip_context>`;
	struct :ref:`RangeConstraints<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_range_constraints>`;
	struct :ref:`ReducedPoint<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_reduced_point>`;
	struct :ref:`TooltipData<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_tooltip_data>`;
	struct :ref:`TooltipField<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_tooltip_field>`;
	struct :ref:`TooltipText<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_tooltip_text>`;
	struct :ref:`XYDataChunk<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_chunk>`;

	// classes

	class :ref:`AxisScale<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_axis_scale>`;
	class :ref:`AxisViewport<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_axis_viewport>`;
	class :ref:`ChartAxis<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_chart_axis>`;
	class :ref:`ChartModel<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_chart_model>`;
	class :ref:`ImmutableXYDataSource<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_immutable_x_y_data_source>`;
	class :ref:`LineSeries<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_line_series>`;
	class :ref:`LinearScale<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_linear_scale>`;
	class :ref:`ModelXYDataSource<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_model_x_y_data_source>`;
	class :ref:`OwnedXYDataSource<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_owned_x_y_data_source>`;
	class :ref:`RingXYDataSource<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_ring_x_y_data_source>`;

	template <typename T>
	class :ref:`StridedSpan<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_strided_span>`;

	class :ref:`UIChart<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_u_i_chart>`;
	class :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`;
	class :ref:`XYDataSource<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_source>`;

	// global functions

	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` :ref:`SmallVector<doxid-class_e_e_1_1_small_vector>`<double, 16> :ref:`linearTicks<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a368aab4a7d447d9b2b5fd33fb939babf>`(:ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>` range, float pixelLength, float targetSpacing = 80.f);
	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` :ref:`String<doxid-class_e_e_1_1_string>` :target:`formatNumericTick<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a590c5f504278707be48410a8d70b9586>`(double value, double step);
	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` std::vector<:ref:`ReducedPoint<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_reduced_point>`> :ref:`reducePixelBuckets<doxid-namespace_e_e_1_1_u_i_1_1_charts_1aad7cb35571c2d493bf6a3f88d9c16d15>`(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, :ref:`IndexRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_index_range>` visible, :ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>` xRange, size_t pixelWidth);
	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` void :ref:`reducePixelBuckets<doxid-namespace_e_e_1_1_u_i_1_1_charts_1ad809b43c3714fd028caa4f085ae585cc>`(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, :ref:`IndexRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_index_range>` visible, :ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>` xRange, size_t pixelWidth, std::vector<:ref:`ReducedPoint<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_reduced_point>`>& output);

	template <typename Object, typename Member>
	:ref:`StridedSpan<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_strided_span>`<Member> :target:`memberSpan<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a1c32f4adb200dcbed1fe1be3526c1d74>`(std::span<const Object> objects, Member Object::* member);

	template <typename X>
	:ref:`DataOrder<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a2cf5ef16471dc196583495036b7deb36>` :target:`detectXOrder<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a2a5e19dc55d340da2454cf5bcd494017>`(:ref:`StridedSpan<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_strided_span>`<X> xs);

	template <typename X, typename Y>
	:ref:`requires<doxid-namespace_e_e_1_1_u_i_1_1_charts_1ad060200421bfd7c8d81311a4f82ee3ef>`(std::is_same_v<X, float>||std::is_same_v<X, double>);

	template <typename Object, typename X, typename Y>
	:ref:`requires<doxid-namespace_e_e_1_1_u_i_1_1_charts_1aa1a257da1f844e49d8abec7efab4726a>`(std::is_same_v<X, float>||std::is_same_v<X, double>);

	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` std::optional<:ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>`> :ref:`xExtent<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a61315a963338d77c7b4a4a614e67afc8>`(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read);
	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` std::optional<:ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>`> :target:`yExtent<doxid-namespace_e_e_1_1_u_i_1_1_charts_1aae5d9dbc9d779b3b76a1ee5d59254d9a>`(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read);
	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` std::optional<:ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>`> :ref:`visibleYExtent<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a6967242e035608ed23ad7d6cc08307d6>`(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, :ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>` xRange);
	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` size_t :ref:`lowerBoundX<doxid-namespace_e_e_1_1_u_i_1_1_charts_1ac472177764bd56cddde8f2cccbba3809>`(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, double value);
	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` :ref:`IndexRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_index_range>` :ref:`visibleLogicalRange<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a959f2f40dcdafb1b10edd4a68dc122ac>`(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, double minimum, double maximum);
	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` :ref:`ChartPoint<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_chart_point>` :target:`pointAt<doxid-namespace_e_e_1_1_u_i_1_1_charts_1a93f5e72d2c2794de1afb63736af38914>`(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, size_t logicalIndex);

	} // namespace Charts
.. _details-namespace_e_e_1_1_u_i_1_1_charts:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~



Global Functions
----------------

.. index:: pair: function; linearTicks
.. _doxid-namespace_e_e_1_1_u_i_1_1_charts_1a368aab4a7d447d9b2b5fd33fb939babf:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` :ref:`SmallVector<doxid-class_e_e_1_1_small_vector>`<double, 16> linearTicks(:ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>` range, float pixelLength, float targetSpacing = 80.f)

Nice-number ticks, independent of label formatting and text measurement.

.. index:: pair: function; reducePixelBuckets
.. _doxid-namespace_e_e_1_1_u_i_1_1_charts_1aad7cb35571c2d493bf6a3f88d9c16d15:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` std::vector<:ref:`ReducedPoint<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_reduced_point>`> reducePixelBuckets(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, :ref:`IndexRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_index_range>` visible, :ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>` xRange, size_t pixelWidth)

Reduces an ascending-X visible interval to at most four source samples per pixel bucket. Each point retains its logical index. Invalid values split line connectivity.

.. index:: pair: function; reducePixelBuckets
.. _doxid-namespace_e_e_1_1_u_i_1_1_charts_1ad809b43c3714fd028caa4f085ae585cc:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` void reducePixelBuckets(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, :ref:`IndexRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_index_range>` visible, :ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>` xRange, size_t pixelWidth, std::vector<:ref:`ReducedPoint<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_reduced_point>`>& output)

Writes into a reusable buffer, retaining its capacity across data updates.

.. index:: pair: function; requires
.. _doxid-namespace_e_e_1_1_u_i_1_1_charts_1ad060200421bfd7c8d81311a4f82ee3ef:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	template <typename X, typename Y>
	requires(std::is_same_v<X, float>||std::is_same_v<X, double>)

Zero-copy shared, separate X/Y arrays. Inputs must be the same length.

.. index:: pair: function; requires
.. _doxid-namespace_e_e_1_1_u_i_1_1_charts_1aa1a257da1f844e49d8abec7efab4726a:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	template <typename Object, typename X, typename Y>
	requires(std::is_same_v<X, float>||std::is_same_v<X, double>)

Zero-copy shared AoS storage with typed member views.

.. index:: pair: function; xExtent
.. _doxid-namespace_e_e_1_1_u_i_1_1_charts_1a61315a963338d77c7b4a4a614e67afc8:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` std::optional<:ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>`> xExtent(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read)

Finite paired values only; NaN and Inf form gaps.

.. index:: pair: function; visibleYExtent
.. _doxid-namespace_e_e_1_1_u_i_1_1_charts_1a6967242e035608ed23ad7d6cc08307d6:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` std::optional<:ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>`> visibleYExtent(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, :ref:`DataRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_data_range>` xRange)

Scans only the raw samples in an ascending-X interval.

.. index:: pair: function; lowerBoundX
.. _doxid-namespace_e_e_1_1_u_i_1_1_charts_1ac472177764bd56cddde8f2cccbba3809:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` size_t lowerBoundX(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, double value)

Ascending-X reads only; returns the first index whose X is at least value.

.. index:: pair: function; visibleLogicalRange
.. _doxid-namespace_e_e_1_1_u_i_1_1_charts_1a959f2f40dcdafb1b10edd4a68dc122ac:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`EE_API<doxid-config_8hpp_1a705e4ce005f895b4953ab2b8f440e171>` :ref:`IndexRange<doxid-struct_e_e_1_1_u_i_1_1_charts_1_1_index_range>` visibleLogicalRange(const :ref:`XYDataRead<doxid-class_e_e_1_1_u_i_1_1_charts_1_1_x_y_data_read>`& read, double minimum, double maximum)

Ascending-X reads only; includes samples in [minimum, maximum].