Source code for lightningchart.series.point_series_3d

from __future__ import annotations
from typing import Optional

from lightningchart.charts import Chart
from lightningchart.series import (
    SeriesWithAddDataPoints,
    SeriesWithAddDataXYZ,
    SeriesWith3DPoints,
    SeriesWith3DShading,
    SeriesWithAddEventListener,
    SeriesWithClear,
    SeriesWithCursor,
    SeriesWithXYZAxes,
)
from lightningchart.utils.utils import LegendOptions, build_series_legend_options




class PointSeries3D(
    SeriesWithAddDataPoints,
    SeriesWithAddDataXYZ,
    SeriesWith3DPoints,
    SeriesWith3DShading,
    SeriesWithClear,
    SeriesWithAddEventListener,
    SeriesWithXYZAxes,
    SeriesWithCursor,
):
    """Series for visualizing 3D datapoints."""

    def __init__(
        self,
        chart: Chart,
        automatic_color_index: int = None,
        render_2d: bool = False,
        individual_lookup_values_enabled: bool = False,
        individual_point_color_enabled: bool = False,
        individual_point_size_axis_enabled: bool = False,
        individual_point_size_enabled: bool = False, 
        legend: Optional[LegendOptions] = None,
    ):
        super().__init__(chart)
        legend_options = build_series_legend_options(legend)
            
        self.instance.send(
            self.id,
            'pointSeries3D',
            {
                'chart': self.chart.id,
                'automaticColorIndex': automatic_color_index,
                'individualLookupValuesEnabled': individual_lookup_values_enabled,
                'individualPointColorEnabled': individual_point_color_enabled,
                'individualPointSizeAxisEnabled': individual_point_size_axis_enabled,
                'individualPointSizeEnabled': individual_point_size_enabled,
                'pointCloudSeries': render_2d,
                'legend': legend_options if legend_options else None
            },
        )



    def set_individual_point_color_enabled(self, enabled: bool):
        """
        Enable or disable individual point color attributes for a 3D series.
        When enabled, the JS side will update the point style to use IndividualPointFill;
        otherwise, it will revert to a default SolidFill color.

        Args:
            enabled (bool): True to enable individual point coloring, False to disable.

        Returns:
            self: The instance of the series for fluent interfacing.
        """
        self.instance.send(self.id, 'setIndividualPointColorEnabled3D', {'enabled': enabled})
        return self