| Index: charted/lib/charts/chart_area.dart
|
| diff --git a/charted/lib/charts/chart_area.dart b/charted/lib/charts/chart_area.dart
|
| deleted file mode 100644
|
| index f6c9d2fb2384c61744612da081e1445fc3040753..0000000000000000000000000000000000000000
|
| --- a/charted/lib/charts/chart_area.dart
|
| +++ /dev/null
|
| @@ -1,165 +0,0 @@
|
| -//
|
| -// Copyright 2014 Google Inc. All rights reserved.
|
| -//
|
| -// Use of this source code is governed by a BSD-style
|
| -// license that can be found in the LICENSE file or at
|
| -// https://developers.google.com/open-source/licenses/bsd
|
| -//
|
| -
|
| -part of charted.charts;
|
| -
|
| -///
|
| -/// Area for rendering cartesian charts. A cartesian chart creates
|
| -/// visualization by carefully placing elements along the dimension
|
| -/// and measure axes (in a 2 dimensional plane).
|
| -///
|
| -/// Some renderers may use additional dimensions that is made visible
|
| -/// by size and color of the rendered elements.
|
| -///
|
| -/// For example:
|
| -/// - A bar-chart draws bars indicating a value along measure axis.
|
| -/// - A bubble-chart where a circle is positioned across two dimension
|
| -/// axes. A bubble-chart may also use color and size of circles to
|
| -/// indicate more dimensions.
|
| -///
|
| -/// In a [CartesianArea], more than one series can be rendered together.
|
| -///
|
| -abstract class CartesianArea implements ChartArea {
|
| - /// When set to true, [ChartArea] uses both 'x' and 'y' axes for dimensions.
|
| - /// Examples:
|
| - /// - A bar-chart has one dimension axis (typically the 'x' axis)
|
| - /// - A bubble-chart has two dimension axis (both 'x' and 'y')
|
| - bool get useTwoDimensionAxes;
|
| -
|
| - /// Scales used to render the measure axis of the given [ChartSeries]. Each
|
| - /// series may use more than one measure scale.
|
| - ///
|
| - /// For example, a scatter plot may use different scales for color, shape
|
| - /// and size of the rendering.
|
| - Iterable<Scale> measureScales(ChartSeries s);
|
| -
|
| - /// Scales used to render the dimension axes. The number of scales returned
|
| - /// is either one or two based on [useTwoDimensions]
|
| - Iterable<Scale> get dimensionScales;
|
| -
|
| - /// List of dimensions using a band of space on the axis
|
| - Iterable<int> get dimensionsUsingBands;
|
| -
|
| - /// Stream to notify when chart axes get updated.
|
| - Stream<ChartArea> get onChartAxesUpdated;
|
| -
|
| - /// Factory method to create an instance of the default implementation
|
| - /// - [host] must be an Element that has clientHeight and clientWidth
|
| - /// properties defined (i.e cannot be inline elements)
|
| - /// - [data] is an instance of [ChartData]
|
| - /// - [config] is an implementation of [ChartConfig]
|
| - /// - If [autoUpdate] is set, chart is updated when data or config
|
| - /// change. When not set, [draw] must be called to update the chart.
|
| - /// - When [useTwoDimensionAxes] is set, the chart uses both 'x' and 'y'
|
| - /// axes as dimensions.
|
| - factory CartesianArea(
|
| - dynamic host,
|
| - ChartData data,
|
| - ChartConfig config, {
|
| - bool autoUpdate: false,
|
| - bool useTwoDimensionAxes: false,
|
| - bool useRowColoring: false,
|
| - ChartState state }) =>
|
| - new DefaultCartesianAreaImpl(host, data, config, autoUpdate,
|
| - useTwoDimensionAxes, useRowColoring, state);
|
| -}
|
| -
|
| -///
|
| -/// Area for rendering layout charts. A layout chart creates visualization by
|
| -/// distributing available space to each measure.
|
| -///
|
| -/// For example:
|
| -/// - A pie-chart distributes a radial area to each measure.
|
| -/// - In a tree-map a rectangular area is distributed to each measure.
|
| -///
|
| -/// In a [LayoutArea], only one series can be rendered and the area does
|
| -/// not have any scales and axes.
|
| -///
|
| -abstract class LayoutArea implements ChartArea {
|
| - /// Layout area always uses row coloring.
|
| - bool get useRowColoring => true;
|
| -
|
| - factory LayoutArea(
|
| - dynamic host,
|
| - ChartData data,
|
| - ChartConfig config, {
|
| - bool autoUpdate: false,
|
| - ChartState state }) =>
|
| - new DefaultLayoutAreaImpl(host, data, config, autoUpdate, state);
|
| -}
|
| -
|
| -///
|
| -/// Base interface for all implementations of a chart drawing area.
|
| -///
|
| -abstract class ChartArea implements ChartAreaBehaviorSource {
|
| - /// Data used by the chart. Chart isn't updated till the next call to
|
| - /// draw function if [autoUpdate] is set to false.
|
| - ///
|
| - /// Setting new value to [data] will update chart if [autoUpdate] is set.
|
| - ChartData data;
|
| -
|
| - /// Configuration for this chart. [ChartArea] subscribes to changes on
|
| - /// [config] and calls draw upon any changes.
|
| - ///
|
| - /// Refer to [ChartConfig] for further documentation about which changes
|
| - /// are added to the stream, which in turn trigger an update on the chart.
|
| - ChartConfig config;
|
| -
|
| - /// Theme for this chart. Any changes to [theme] are not applied to the chart
|
| - /// until it is redrawn. Changes can be forced by calling [draw] function.
|
| - ChartTheme theme;
|
| -
|
| - /// When set to true, [ChartArea] subscribes to changes on data and updates
|
| - /// the chart when [data] or [config] changes. Defaults to false.
|
| - bool autoUpdate;
|
| -
|
| - /// Geometry of components in this [ChartArea]
|
| - ChartAreaLayout get layout;
|
| -
|
| - /// Host element of the ChartArea
|
| - Element get host;
|
| -
|
| - /// True when all components of the chart have been updated - either already
|
| - /// drawn or are in the process of transitioning in.
|
| - bool get isReady;
|
| -
|
| - /// When true, [ChartArea] and renderers that support coloring by row,
|
| - /// use row indices and values to color the chart. Defaults to false.
|
| - bool get useRowColoring;
|
| -
|
| - /// State of the chart - selection and highlights.
|
| - ChartState get state;
|
| -
|
| - /// Draw the chart with current data and configuration.
|
| - /// - If [preRender] is set, [ChartArea] attempts to build all non data
|
| - /// dependant elements of the chart.
|
| - /// - When [schedulePostRender] is not null, non-essential elements/tasks
|
| - /// of chart building are postponed until the future is resolved.
|
| - void draw({bool preRender: false, Future schedulePostRender});
|
| -
|
| - /// Force destroy the ChartArea.
|
| - /// - Clear references to all passed objects and subscriptions.
|
| - /// - Call dispose on all renderers and behaviors.
|
| - void dispose();
|
| -}
|
| -
|
| -///
|
| -/// Class representing geometry of the [ChartArea] and various components
|
| -/// that are created by the ChartArea.
|
| -///
|
| -abstract class ChartAreaLayout {
|
| - /// Sizes of axes by orientation.
|
| - /// Only valid on [CartesianArea], null otherwise.
|
| - Map<String, Rect> get axes;
|
| -
|
| - /// Size of render area.
|
| - Rect get renderArea => new Rect();
|
| -
|
| - /// Size of chart area.
|
| - Rect get chartArea => new Rect();
|
| -}
|
|
|