Skip to content

Chart.md

Latest commit

 

History

History
123 lines (102 loc) · 4.74 KB

Chart.md

File metadata and controls

123 lines (102 loc) · 4.74 KB

FROG logo

Default Realization — Waveform Chart Widget

Default realization posture for the composite waveform chart widget
FROG — Free Open Graphical Language

Navigation

Overview

This document describes the default realization posture for frog.widgets.waveform_chart. The default realization exposes a rectangular SVG-backed composite chart template with plot area, history region, plot layer, grid, scales, scale labels, legends, graph palette, scrollbars, cursor layer, cursor readout, plot-image layers, annotation layer, threshold band, caption, label, and focus ring.

The SVG-backed realization is a template and fallback. A runtime may replace plot rendering with a host-native plot, canvas, GPU surface, or optimized polyline layer while preserving the public part model.

Public Parts Realized

  • root
  • label
  • caption
  • frame
  • plot_area
  • history_region
  • plot_layer
  • plot_polyline
  • plot_marker
  • grid
  • axis_tick
  • x_scale
  • y_scale
  • x_scale_label
  • y_scale_label
  • plot_legend
  • scale_legend
  • cursor_legend
  • graph_palette
  • x_scrollbar
  • y_scrollbar
  • cursor_layer
  • cursor_readout
  • plot_image_back
  • plot_image_middle
  • plot_image_front
  • annotation_layer
  • threshold_band
  • focus_ring

Published Assets

  • assets/chart/templates/waveform_chart_shell.svg
  • assets/chart/subobjects/plot_area.svg
  • assets/chart/subobjects/grid.svg
  • assets/chart/subobjects/x_scale.svg
  • assets/chart/subobjects/y_scale.svg
  • assets/chart/subobjects/plot_legend.svg
  • assets/chart/subobjects/scale_legend.svg
  • assets/chart/subobjects/cursor_legend.svg
  • assets/chart/subobjects/graph_palette.svg
  • assets/chart/subobjects/x_scrollbar.svg
  • assets/chart/subobjects/y_scrollbar.svg
  • assets/chart/subobjects/cursor_layer.svg
  • assets/chart/subobjects/plot_image_layer.svg
  • assets/chart/subobjects/axis_tick.svg
  • assets/chart/subobjects/plot_marker.svg
  • assets/chart/subobjects/cursor_readout.svg
  • assets/chart/subobjects/annotation_layer.svg
  • assets/chart/subobjects/threshold_band.svg

Rendering Posture

  • plot_area anchors the visible chart body.
  • history_region defines the retained visible history window.
  • plot_layer and plot_polyline render chart samples.
  • plot_marker renders optional point markers.
  • grid and axis_tick render scale structure.
  • cursor_layer and cursor_readout render cursors and cursor values.
  • annotation_layer and threshold_band render display overlays.

Validation Expectations

  • All declared public parts must exist in chart class law.
  • All declared SVG resources must resolve relative to this package.
  • The declared SVG resources should expose all declared data-frog-part markers.
  • Resources must not become semantic owners of chart value, samples, or history.
  • Host-native plotting handles, canvas handles, GPU surfaces, and renderer caches must remain realization-private.