Struct CurveEditor 

pub struct CurveEditor { /* private fields */ }

Editable points over a smooth curve that never swings past them. A press on empty space adds a point and a drag moves it; a double click or Delete removes one, except the two ends. From the keyboard, the arrows move the chosen point (with Shift, further), Page Up and Page Down choose another, and Enter adds one on the curve halfway to the next.

Points go from 0 to 1 on both axes, with the input in x. They are kept in order of x.

use ravenrs_core::Point;
use ravenrs_reactive::State;
use ravenrs_widgets::CurveEditor;

let tones = State::new(vec![Point::ZERO, Point::new(0.4, 0.55), Point::new(1.0, 1.0)]);
let editor = CurveEditor::new(tones.binding()).height(220.0).label("Tone curve");
let middle = CurveEditor::value_at(&tones.get(), 0.5);
assert!(middle > 0.55 && middle < 1.0);

Implementations

impl CurveEditor

pub fn new(points: Binding<Vec<Point>>) -> Self

An editor of points, across its parent, 200 logical pixels tall.

pub fn value_at(points: &[Point], x: f32) -> f32

What the curve through points gives for the input x, for applying it. It uses the same curve the editor draws.

pub fn size(self, width: f32, height: f32) -> Self

Fixed size in logical pixels.

pub fn height(self, height: f32) -> Self

Height in logical pixels.

pub fn color(self, color: Color) -> Self

The color of the curve and its handles, as data, such as a channel’s (ink by default).

pub fn baseline(self, baseline: bool) -> Self

Shows the straight line of no change behind the curve (on by default).

pub fn grid(self, parts: u32) -> Self

Divides the plot in this many parts each way, with light lines (4 by default).

pub fn histogram( self, channels: impl IntoIterator<Item = HistogramChannel>, scale: HistogramScale, ) -> Self

Shows these channels behind the curve, as a Histogram does, faintly.

pub fn label(self, label: impl Into<String>) -> Self

The name screen readers announce, instead of the one in Labels.

pub fn disabled(self, disabled: bool) -> Self

Turns the control off: it fades, leaves the tab order and ignores input.

Trait Implementations

impl Debug for CurveEditor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl View for CurveEditor

fn build(&self, cx: &mut BuildCx<'_>) -> NodeId

Creates this view’s node for the current build.

fn type_name(&self) -> &'static str

The name the diagnostics panel shows this view’s cost under.