Chart2 Direct Series Data Series Transparency (Static)

Overview

Classes in the ooodev.format.chart2.direct.series.data_series.transparency module contains classes that are used to set the data series transparency of a chart.

Calls to the Chart2.style_data_series() method are used to set the data series transparency of a Chart.

Calls to the Chart2.style_data_series() and Chart2.style_data_point() methods are used to set the data series transparency of a Chart.

Setup

General setup for examples.

import uno
from ooodev.format.chart2.direct.series.data_series.transparency import Transparency as SeriesTransparency
from ooodev.format.chart2.direct.general.borders import LineProperties as ChartLineProperties
from ooodev.format.chart2.direct.general.area import Gradient as ChartGradient, PresetGradientKind
from ooodev.office.calc import Calc
from ooodev.office.chart2 import Chart2
from ooodev.utils.color import StandardColor
from ooodev.gui import GUI
from ooodev.loader.lo import Lo

def main() -> int:
    with Lo.Loader(connector=Lo.ConnectPipe()):
        doc = Calc.open_doc("col_chart.ods")
        GUI.set_visible(True, doc)
        Lo.delay(500)
        Calc.zoom(doc, GUI.ZoomEnum.ZOOM_100_PERCENT)

        sheet = Calc.get_active_sheet()

        Calc.goto_cell(cell_name="A1", doc=doc)
        chart_doc = Chart2.get_chart_doc(sheet=sheet, chart_name="col_chart")

        chart_bdr_line = ChartLineProperties(color=StandardColor.BLUE_LIGHT3, width=0.7)
        chart_grad = ChartGradient.from_preset(chart_doc, PresetGradientKind.TEAL_BLUE)
        Chart2.style_background(chart_doc=chart_doc, styles=[chart_grad, chart_bdr_line])

        data_series_transparency = SeriesTransparency(value=50)
        Chart2.style_data_series(chart_doc=chart_doc, styles=[data_series_transparency])

        Lo.delay(1_000)
        Lo.close_doc(doc)
    return 0

if __name__ == "__main__":
    SystemExit(main())

Transparency

Before formatting the chart is seen in Fig. 829.

Setting Transparency

The ooodev.format.chart2.direct.series.data_series.transparency.Transparency class can be used to set the data series transparency of a chart.

Style Data Series

from ooodev.format.chart2.direct.series.data_series.transparency import Transparency as SeriesTransparency
# ... other code

data_series_transparency = SeriesTransparency(value=50)
Chart2.style_data_series(chart_doc=chart_doc, styles=[data_series_transparency])

The results can bee seen in Fig. 759 and Fig. 760.

Chart with data series transparency set

Fig. 759 Chart with data series transparency set

Chart Data Series Area Transparency Dialog

Fig. 760 Chart Data Series Area Transparency Dialog

Style Data Point

# ... other code
Chart2.style_data_point(
    chart_doc=chart_doc, series_idx=0, idx=-1, styles=[data_series_transparency]
)

The results can bee seen in Fig. 761.

Chart with data point transparency set

Fig. 761 Chart with data point transparency set

Gradient Transparency

Before formatting the chart is seen in Fig. 829.

Setting Gradient

The ooodev.format.chart2.direct.series.data_series.transparency.Gradient class can be used to set the data series gradient transparency of a chart.

Style Data Series

from ooodev.format.chart2.direct.series.data_series.transparency import Gradient as SeriesGradient
from ooodev.format.chart2.direct.series.data_series.transparency import IntensityRange
from ooodev.utils.data_type.angle import Angle
# ... other code

data_series_grad_transparency = SeriesGradient(
    chart_doc=chart_doc, angle=Angle(30), grad_intensity=IntensityRange(0, 100)
)
Chart2.style_data_series(chart_doc=chart_doc, styles=[data_series_grad_transparency])

The results can bee seen in Fig. 762 and Fig. 763.

Chart data series with gradient transparency set

Fig. 762 Chart data series with gradient transparency set

Chart Data Series Area Transparency Dialog

Fig. 763 Chart Data Series Area Transparency Dialog

Style Data Point

# ... other code
Chart2.style_data_point(
    chart_doc=chart_doc, series_idx=0, idx=-1, styles=[data_series_grad_transparency]
)

The results can bee seen in Fig. 764.

Chart data point with gradient transparency set

Fig. 764 Chart data point with gradient transparency set