wolfhece.assets.pie.controller

Module Contents

class wolfhece.assets.pie.controller.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.

id = ''

values

colors = []

center_x

center_y

radius

start_angle_deg

clockwise = False

sectors_as_independent_zones = False

legend_visible = True

legend_show_percent = True

legend_show_value = False

legend_offset_factor

legend_position_mode = 'auto'

legend_positions

legend_text_color

fill_clock_animation = False

fill_anim_speed

smoothing = True

border_enabled = True

border_width

border_color = (25, 25, 25)

store_fraction_in_z = True

mapviewer = None

zones: wolfhece.PyVertexvectors.Zones | None = None

editor: wolfhece.assets.pie.editor.PieZonesEditor | None = None

_normalize_legend_positions(positions: Sequence[tuple[float, float] | None] | None) → list[tuple[float, float] | None]

_ensure_legend_positions_length() → None

_get_mapviewer_objects() → list

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

_get_vector_draw_type()

Resolve the viewer enum value for vector objects lazily.

_get_vector_by_id(obj_id: str)

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

_find_bound_zones_in_mapviewer() → wolfhece.PyVertexvectors.Zones | None

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

_resolve_unique_id(preferred: str, exclude_obj=None) → str

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

_build_asset() → wolfhece.assets.pie.zones_asset.PieZonesAsset

attach_to_mapviewer(mapviewer, id: str | None = None, ToCheck: bool = True) → wolfhece.PyVertexvectors.Zones

_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.

rebuild(ToCheck: bool = True) → wolfhece.PyVertexvectors.Zones

Rebuild geometry from current parameters and update mapviewer.

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

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

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

get_transform_bounds() → tuple[float, float, float, float]

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

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.

to_dict() → dict

classmethod from_dict(data: dict) → PieZonesController

save_json(filepath: str | pathlib.Path) → pathlib.Path

classmethod load_json(filepath: str | pathlib.Path) → PieZonesController

save_vec_or_vecz(filepath: str | pathlib.Path) → pathlib.Path

show_editor(parent=None)

wolfhece.assets.pie.controller.build_pie_controller(values: Sequence[float], center: tuple[float, float], radius: float, **kwargs) → PieZonesController

Convenience function returning a persistent pie controller.