wolfhece.assets.pie.controller
==============================

.. py:module:: wolfhece.assets.pie.controller






Module Contents
---------------

.. py:class:: PieZonesController(values: Sequence[float], center: tuple[float, float], radius: float, *, id: str = 'pie_chart', labels: Sequence[str] | None = None, colors: Sequence[tuple[int, int, int] | tuple[int, int, int, int]] | None = None, start_angle_deg: float = 90.0, clockwise: bool = False, sectors_as_independent_zones: bool = False, legend_visible: bool = True, legend_show_percent: bool = True, legend_show_value: bool = False, legend_offset_factor: float = 0.65, legend_position_mode: str = 'auto', legend_positions: Sequence[tuple[float, float] | None] | None = None, legend_text_color: tuple[int, int, int] = (0, 0, 0), fill_clock_animation: bool = False, fill_anim_speed: float = 1.0, smoothing: bool = True, border_enabled: bool = True, border_width: float = 1.0, border_color: tuple[int, int, int] = (25, 25, 25), store_fraction_in_z: bool = True)

   Persistent controller for editable pie assets.

   The controller stores editable parameters, keeps a pointer to the current
   Zones object in the mapviewer, and can rebuild geometry dynamically.


   .. py:attribute:: id
      :value: ''



   .. py:attribute:: values


   .. py:attribute:: colors
      :value: []



   .. py:attribute:: center_x


   .. py:attribute:: center_y


   .. py:attribute:: radius


   .. py:attribute:: start_angle_deg


   .. py:attribute:: clockwise
      :value: False



   .. py:attribute:: sectors_as_independent_zones
      :value: False



   .. py:attribute:: legend_visible
      :value: True



   .. py:attribute:: legend_show_percent
      :value: True



   .. py:attribute:: legend_show_value
      :value: False



   .. py:attribute:: legend_offset_factor


   .. py:attribute:: legend_position_mode
      :value: 'auto'



   .. py:attribute:: legend_positions


   .. py:attribute:: legend_text_color


   .. py:attribute:: fill_clock_animation
      :value: False



   .. py:attribute:: fill_anim_speed


   .. py:attribute:: smoothing
      :value: True



   .. py:attribute:: border_enabled
      :value: True



   .. py:attribute:: border_width


   .. py:attribute:: border_color
      :value: (25, 25, 25)



   .. py:attribute:: store_fraction_in_z
      :value: True



   .. py:attribute:: mapviewer
      :value: None



   .. py:attribute:: zones
      :type:  wolfhece.PyVertexvectors.Zones | None
      :value: None



   .. py:attribute:: editor
      :type:  wolfhece.assets.pie.editor.PieZonesEditor | None
      :value: None



   .. py:method:: _normalize_legend_positions(positions: Sequence[tuple[float, float] | None] | None) -> list[tuple[float, float] | None]


   .. py:method:: _ensure_legend_positions_length() -> None


   .. py:method:: _get_mapviewer_objects() -> list

      Return all mapviewer objects, or an empty list if unavailable.



   .. py:method:: _get_vector_draw_type()

      Resolve the viewer enum value for vector objects lazily.



   .. py:method:: _get_vector_by_id(obj_id: str)

      Return a vector object by id without scanning unrelated draw types.



   .. py:method:: _find_bound_zones_in_mapviewer() -> wolfhece.PyVertexvectors.Zones | None

      Return the currently bound Zones object if it is still present in the viewer.



   .. py:method:: _resolve_unique_id(preferred: str, exclude_obj=None) -> str

      Return an id not used by other objects in the viewer.



   .. py:method:: _build_asset() -> wolfhece.assets.pie.zones_asset.PieZonesAsset


   .. py:method:: attach_to_mapviewer(mapviewer, id: str | None = None, ToCheck: bool = True) -> wolfhece.PyVertexvectors.Zones


   .. py:method:: _sync_effective_legend_positions() -> None

      Read back legend positions from the built Zones vectors.

      In 'auto' mode the positions are computed inside ``to_zones()`` but
      never stored in the controller.  This helper copies them back so that
      the editor grid can display them.



   .. py:method:: rebuild(ToCheck: bool = True) -> wolfhece.PyVertexvectors.Zones

      Rebuild geometry from current parameters and update mapviewer.



   .. py:method:: update_data(values: Sequence[float] | None = None, labels: Sequence[str] | None = None, colors: Sequence[tuple[int, int, int] | tuple[int, int, int, int]] | None = None, rebuild: bool = True) -> None


   .. py:method:: update_legend_layout(*, position_mode: str | None = None, positions: Sequence[tuple[float, float] | None] | None = None, offset_factor: float | None = None, legend_text_color: tuple[int, int, int] | None = None, rebuild: bool = True) -> None


   .. py:method:: update_geometry(x: float | None = None, y: float | None = None, radius: float | None = None, start_angle_deg: float | None = None, clockwise: bool | None = None, rebuild: bool = True) -> None


   .. py:method:: get_transform_bounds() -> tuple[float, float, float, float]

      Return editable asset bounds as ``(xmin, ymin, xmax, ymax)``.



   .. py:method:: apply_transform_bounds(bounds: tuple[float, float, float, float], *, rebuild: bool = True) -> None

      Apply rectangle bounds produced by map drag/resize handles.

      Pie is circular: center follows bounds midpoint and radius is derived
      from the smallest side so the circle remains fully inside the box.



   .. py:method:: to_dict() -> dict


   .. py:method:: from_dict(data: dict) -> PieZonesController
      :classmethod:



   .. py:method:: save_json(filepath: str | pathlib.Path) -> pathlib.Path


   .. py:method:: load_json(filepath: str | pathlib.Path) -> PieZonesController
      :classmethod:



   .. py:method:: save_vec_or_vecz(filepath: str | pathlib.Path) -> pathlib.Path


   .. py:method:: show_editor(parent=None)


.. py:function:: build_pie_controller(values: Sequence[float], center: tuple[float, float], radius: float, **kwargs) -> PieZonesController

   Convenience function returning a persistent pie controller.