Struct AutoDrawing 

pub struct AutoDrawing { /* private fields */ }

A drawing recalculated from host bars with the same pivots as ZigZag. Swings use the fixed Zig Zag percentage unless with_atr sizes them by the average true range.

Add through the normal study API or calculate directly and read Indicator::drawings. No drawing is emitted until enough pivots exist. A trend line and channel include the moving last extreme; a retracement uses the latest completed swing, an extension projects that swing from the current leg’s extreme. A pitchfork follows the latest three pivots. Updating or replacing bars rebuilds the anchors; generated drawings belong to the study, not the editable drawing list. Output 0 contains anchor prices for scaling and readouts; the drawing renderer paints the construction instead of joining these values. Its colour, width and visibility use plot 0.

Implementations

impl AutoDrawing

pub fn new(kind: AutoDrawingKind, deviation_percent: f64, depth: usize) -> Self

Construct with a fixed Zig Zag deviation in percent and confirmation depth in bars. Parameters have the same bounds and skipped-bar policy as ZigZag::new. with_atr sizes swings by volatility instead, as the study catalogue’s automatic drawings do.

pub fn with_atr(self, multiple: f64, period: usize) -> Self

Size swings by recent volatility instead of the fixed percentage: a reversal counts when it moves from the last extreme by at least multiple times the average true range over period bars (ATR), taken as a percentage of the confirming bar’s close. Bars before the average is defined, and bars without a finite positive close, confirm no reversal. multiple is clamped into 0 to f64::MAX, NaN to 0, where no swing is found; period is at least 1.

pub fn with_fibonacci_config(self, config: FibonacciConfig) -> Self

Set the levels, orientation and price measurement of a Fibonacci construction. As the study inputs hold them, levels whose ratio is not finite are dropped, at most 24 are kept, and each label is kept on one line, without control characters or surrounding spaces.

Trait Implementations

impl Clone for AutoDrawing

fn clone(&self) -> AutoDrawing

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Indicator for AutoDrawing

fn inputs(&self) -> Vec<StudyInput>

The swing size, ATR multiple and period, the Zig Zag deviation and depth and, for a Fibonacci construction, its options, its number of levels and each level’s visibility, ratio, label, colour and price label.

fn set_input(&mut self, id: &str, value: InputValue) -> Result<(), StudyError>

fib_level_count resizes the Fibonacci levels, so it comes first among the level inputs of an applied set; an input of a level past the last has nothing to edit and is accepted unchanged. Levels added take the kind’s default level at their place, or 100% in the study’s colour, as the drawing properties add one.

fn name(&self) -> &str

Return the short display name of this indicator (e.g. "SMA", "RSI", "MACD").

fn desc(&self) -> &str

Return a human-readable description of what this indicator measures.

fn calculate(&mut self, data: &[Bar])

Compute the indicator’s output from the given bar data.

fn update(&mut self, data: &[Bar], from: usize)

Bring values up to date after data[from..] changed or grew, given that data[..from] is unchanged since the previous call. The values equal those of calculate on the same data, bit for bit. After bars are prepended, or after a setting of the study changed, pass 0; after bars are removed from the end pass the new length.

fn is_incremental(&self) -> bool

Whether live updates avoid recomputing unaffected history. Causal studies do work independent of the series length; studies that redraw earlier legs or periods also revisit the bars whose output changes. Earlier corrections may recompute in full. Defaults to false.

fn values(&self) -> &IndicatorValues

Return the computed output columns, with NaN for missing values.

fn drawings(&self) -> &[Drawing]

Drawing geometry generated by this study, styled as plot 0, empty by default. Calculations belong in calculate; use tools whose renderer needs only their anchors and settings, such as trend lines, parallel channels, Fibonacci levels and pitchforks.

fn colors(&self) -> Vec<Color32>

Return the plot colours and any extra palette entries used by fills or per-bar colouring.

fn set_colors(&mut self, colors: Vec<Color32>)

Replace all line colors at once.

fn set_color(&mut self, line: usize, color: Color32)

Set the color of a single line by its zero-based index.

fn is_overlay(&self) -> bool

Whether this indicator is drawn on the main price chart (overlay) or in a separate sub-pane.

fn is_visible(&self) -> bool

Whether this indicator should currently be rendered.

fn set_visible(&mut self, visible: bool)

Show or hide this indicator.

fn clone_box(&self) -> Box<dyn Indicator>

Clone this indicator into a new Box<dyn Indicator>.

fn projections(&self) -> &[StudyProjection]

Sparse projected price bands, with fractional endpoints in future whitespace.

fn table(&self) -> Option<&StudyTable>

A labelled table of the latest study statistics, drawn independently of the plots.

fn has_settings(&self) -> bool

Whether this study stores presentation edits itself. Charts wrap other studies once.

fn projection_fill_color(&self, projection: &StudyProjection) -> Color32

Colour inside a projected price band.

fn plot_label_colors(&self, _line: usize) -> Option<(Color32, Color32)>

Optional background and text colours for captions on plotted markers.

fn marker_style(&self) -> Option<PlotStyle>

Optional presentation of crossing markers; absent uses directional triangles.

fn level_style(&self, _value: f64) -> LineStyle

Stroke pattern for a pane level at the given value.

fn level_fill_color(&self) -> Color32

Colour of the band between the outer pane levels.

fn plot_style(&self, line: usize) -> PlotStyle

Presentation defaults for a zero-based output line. Any line is accepted: one at or past line_count, which renderers do not draw, still gets a style, so an implementation must not panic on it. The default takes the line’s colour from colors, white for a line without one, and its width from line_style.

fn legend_visible(&self, line: usize) -> bool

Whether output line appears in the legend. Defaults to plot visibility; a study can retain a labelled readout for a quantity excluded from its plot and scale by default.

fn plot_tagged(&self, line: usize) -> bool

Whether plot line shows its last value in a tag on the price scale while the chart shows study values. By default every plot of a study with up to four plots does and no plot of a study with more, whose values stay in the legend, so that the tags leave the scale’s tick labels readable. A study on a chart starts from this choice and keeps the user’s in StudySettings::untagged_plots.

fn plot_output(&self, line: usize) -> usize

The output whose visibility in the style tab also applies to plot line, for a plot past line_count that draws zones or candles for one of the outputs. The default is line itself.

fn plot_offset(&self, line: usize) -> isize

Horizontal displacement in bars. Positive values draw into future whitespace. Values remain indexed by their source bar; missing bars still occupy a position.

fn plot_color(&self, line: usize, bar: usize) -> Option<Color32>

Optional per-bar colour, overriding the plot colour at a source bar.

fn provisional_after(&self, line: usize) -> Option<usize>

The last source bar whose value on a zero-based line is final. The segments after it can still move with later bars and are drawn dashed when the line is solid. None, the default, draws the whole line as styled.

fn plot_text(&self, line: usize, bar: usize) -> Option<String>

Optional text beside the shape a circle, cross or triangle plot draws at a source bar: under an upward triangle and over the other shapes, in the shape’s colour.

fn fills(&self) -> Vec<StudyFill>

Filled bands, painted beneath this study’s plots. Missing endpoints break a band.

fn plot_value(&self, line: usize, bar: usize) -> Option<f64>

Value at a displayed bar, accounting for the plot’s displacement.

fn settings(&self) -> StudySettings

Current applied presentation, initialized from the study’s own defaults.

fn snapshot_settings(&self) -> StudySettingsSnapshot

Capture editable inputs and presentation without copying calculated values. The chart presentation wrapper also retains visibility before interval filtering. Custom presentations can use super::StudySettingsSnapshot::capture with their global visibility toggle to do the same.

fn restore_settings( &mut self, snapshot: &StudySettingsSnapshot, ) -> Result<(), StudyError>

Restore a snapshot from this study. Recalculate against current data afterwards. The default applies changed inputs and presentation through Self::apply_settings. Returns an error if the snapshot is no longer accepted.

fn apply_settings( &mut self, inputs: &[(String, InputValue)], settings: StudySettings, ) -> Result<(), StudyError>

Apply a complete edit atomically. Charts wrap studies in ConfiguredStudy, which validates inputs on a clone before replacing the calculation and presentation.

fn set_visible_range(&mut self, range: Range<usize>) -> bool

Visible source bars, end exclusive, supplied after pan, zoom and resize and before autoscaling. Returns whether values need recalculation. Direct callers may supply it too.

fn set_timeframe(&mut self, timeframe: Timeframe)

The chart’s current interval, supplied when added and when the interval changes.

fn set_bar_clock(&mut self, clock: &BarClock) -> bool

Source bar calendar, including the chart’s selected timezone and session anchor. Returns whether cached values must be recalculated. Direct callers default to UTC.

fn value_format(&self) -> StudyFormat

Units of this study’s values. Placement defaults preserve price overlays and numeric panes.

fn scale(&self) -> StudyScale

Scale used in the pane selected by is_overlay.

fn scale_mapping(&self) -> Option<PriceMap>

Price mapping supplied by the chart for a shared scale, independent of pane bounds. Custom presentation implementations can retain it to support shared scales.

fn set_scale_mapping(&mut self, mapping: Option<PriceMap>)

Updates the chart’s shared-scale mapping. None restores the ordinary pane mapping.

fn set_value_formatter( &mut self, formatter: Option<Arc<dyn PriceFormatter>>, ) -> bool

Replaces value formatting when supported by the presentation. None restores the declared units and precision. Returns false when this study owns its formatting.

fn format_value(&self, value: f64) -> String

Format a value using the declared units and current precision override.

fn format_plot_value(&self, line: usize, value: f64) -> String

Formats one output, including readouts whose units differ from the study’s scale. The default uses format_value.

fn precision(&self) -> Option<usize>

Decimal places for study readouts, or the format’s default precision.

fn data_requests(&self) -> Vec<StudyDataRequest>

Additional histories this study needs. The chart resolves defaults, requests history and live updates from its feed, and supplies them before recalculating the study.

fn data_start(&self, request: &StudyDataRequest) -> Option<DateTime<Utc>>

The oldest time this study reads from request, one of its data_requests. A connected feed stops loading older history of that series once it holds a bar at or before the earliest such time of the studies reading it, and loads more when that time moves earlier. None, the default, and a time before the chart’s first bar load the series back to that bar. Price-based chart types such as Renko do not use the times and always load it back to that bar.

fn update_data(&mut self, data: &[Bar], from: usize, sources: &[StudyData<'_>])

Update with requested histories. Studies using only chart bars keep the default. Pass 0 when a requested history changes; nonzero from retains the same requested histories and follows update’s unchanged-prefix contract.

fn source(&self) -> Option<StudySource>

The single price series this study reads, or None for OHLC or multi-source studies. Configured studies expose this as a Source input. Study references use chart ids and undisplaced output columns; missing or cyclic references produce missing values.

fn update_source(&mut self, data: &[Bar], from: usize, source: &[f64])

Update using an aligned source column. Missing source values remain gaps. The default substitutes the source for OHLC and retains the bar’s other fields.

fn order_flow_inputs(&self) -> &[OrderFlowInput]

Order-flow sources this study reads: OrderFlowInputs of fixed aggregations, footprints or books. A chart with a feed connects them before its updates are coalesced, gives them its instrument’s tick size, applies the trade store’s retention and the replay cutoff, and updates the study from the first bar that changed. Hosts without a feed push events through the handles and recalculate. Several studies may return the same source; it receives each event once.

fn needs_order_flow(&self) -> bool

Whether the study has results only with its order_flow_inputs, so that it cannot be calculated on the bars of another interval or symbol, whose order flow the chart does not hold. The default is whether it names any. A study that builds its results from the bars and refines them with order flow where the chart holds it returns false, and keeps its Interval input.

fn set_instrument(&mut self, instrument: Option<&Instrument>) -> bool

Apply the chart instrument’s time zone and trading session. Returns true if calculation settings changed and the caller must recalculate from bar 0. The chart calls this on add and before calculation after its symbol or metadata changes. None clears chart metadata and restores the study’s own settings. Studies independent of instrument metadata keep the default.

fn set_time_scale_events(&mut self, events: &[TimeScaleEvent]) -> bool

The typed events the chart holds for its symbol, those given to Chart::set_time_scale_events, in the order supplied. Returns true if calculation settings changed and the caller must recalculate from bar 0. The chart calls this on add and before calculation. Studies that read no events keep the default.

fn line_style(&self, line: usize) -> IndicatorLineStyle

Rendering style of an overlay line. Defaults to a 1 px line in its configured colour. Any line is accepted, as for plot_style.

fn candles(&self) -> &[StudyCandle]

Candle bodies and wicks, rendered in place of line plots when nonempty. Source ranges and OHLCV remain available to hosts for per-bar readouts.

fn tpo(&self) -> Option<&TPOConfig>

Market Profile settings of a study whose session profiles the chart builds with to_tpo_profiles and draws on the price pane, beside each session’s bars, as it does for the TPO chart type. None by default.

fn zones(&self) -> &[StudyZone]

Price bands painted beneath this study’s plots, stored per zone rather than per bar. Empty by default.

fn zones_cover_whole_bars(&self) -> bool

Whether each of zones spans its bars from the left edge of the first to the right edge of the last, as study candles do, rather than from the centre of the first to the centre of the last. Off by default.

fn labels(&self) -> &[StudyLabel]

Text beside study values, in order of bar. The chart draws the labels near the visible bars, in the colour of their plot, inside the plot area, so they never run under the price axis. Empty by default. Keep the text from the last calculation: it is drawn every frame.

fn labels_on_price(&self) -> bool

Draw labels on the main price chart, even when the study has its own pane. Label prices use the main series’ scale. Off by default.

fn set_label_precision(&mut self, precision: Option<usize>)

The decimal places the study’s presentation settings set for the prices in labels, None when they set none and the instrument’s decimals apply. The text is written when the study calculates, so calculate again afterwards, as a chart does after any settings edit. Studies without price labels keep the default.

fn volume_profiles(&self, visible: Range<usize>) -> Vec<StudyProfile>

Price-row volume profiles intersecting a half-open visible source-bar range. Fixed and calendar profiles include their whole selected span, even offscreen bars. Visible-range studies recompute for this range; ordinary studies return no profiles.

fn markers(&self) -> &[IndicatorMarker]

Shapes attached to study values, empty by default.

fn extend_right(&self) -> bool

Extend the last two values of each overlay line to the plot’s right edge.

fn plot_label(&self) -> Option<(usize, String)>

An annotation beside the latest value of a zero-based overlay line.

fn pane(&self) -> StudyPane

Default separate-pane layout and reference levels, independent of the study name. ConfiguredStudy returns its levels where its settings place them, in their colours, and a hidden level in Color32::TRANSPARENT, which still bounds the fill.

fn set_overlay(&mut self, _overlay: bool) -> bool

Changes placement between the main chart and a separate pane. Returns whether this study supports the change. The chart’s presentation wrapper does.

fn set_scale(&mut self, _scale: StudyScale) -> bool

Changes the scale used in the study’s pane. Returns whether this study supports the change. The chart’s presentation wrapper does.

fn is_volume(&self) -> bool

Volume plots use an independent zero-based scale: up columns, down columns and MA. Renderers size columns to 80% of the bar pitch and format values as volume.

fn line_count(&self) -> usize

The number of output columns this indicator plots. Renderers draw lines 0..line_count().

fn line_names(&self) -> Vec<String>

Return display names for each line, used in chart legends.