Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
2024.1.0 - English


edit_curv

interactive modal (blocking) graphic curve editor

Syntax

[x, y, ok, gc] = edit_curv()
[x, y, ok, gc] = edit_curv(y)
[x, y, ok, gc] = edit_curv(x, y)
[x, y, ok, gc] = edit_curv(x, y, job)
[x, y, ok, gc] = edit_curv(x, y, job, titles)
[x, y, ok, gc] = edit_curv(x, y, job, titles, gc)
[x, y, ok, gc] = edit_curv(Axes, ..)

[x, y, ok, gc] = edit_curv(hCurve)
[x, y, ok, gc] = edit_curv(hCurve, job)
[x, y, ok, gc] = edit_curv(hCurve, job, titles)
[x, y, ok, gc] = edit_curv(hCurve, job, titles, gc)

Arguments

x
vector of initial or final x coordinates of the curve. Default value: 1:length(y).
y
vector of initial or final y coordinates of the curve. Default value: [].
hCurve
Graphic handle of Polyline type: the existing curve to be edited.
Axes
Graphic handle of the axes in which the given curve must be displayed and edited. The axes may be in a figure or in a uicontrol frame.
job
a character string made of one to four characters in any order among 'a','d','x','y', setting authorizations:
"a": addition of points to the curve.
"d": deletion of points of the curve.
"x": moving points horizontally, along x.
"y": moving points vertically, along y.
Default value: "adxy".

titles
a vector of three character strings: [axes_title, x_axis_legend, y_axis_legend]. By default, the current or default legends and title are unchanged.

gc
a list of graphic parameters: gc=list(dataBounds, xyTicks, lineStyles)
dataBounds: [xmin, ymin, xmax, ymax] values to assign to gca().data_bounds as new axes bounds.
xyTicks: (unused) graduation parameters [nx,Nx,ny,Ny]: Nx = number of major ticks along the x axis (-1 for autoticking). nx = number of minor ticks between 2 major ticks. Ny, ny: same thing along the y axis.
lineStyles: [line_style, colorIndex, thickness, mark_style] of the curve. %nan stands for keeping the default value, that are [1 1 2 1] (solid black 2-thick line with "+" marks).
list(,, lineStyles) will use default values for dataBounds and xyTicks.

ok
Boolean: %t when edit_curv() is quit through the 'ok' menu. %F otherwise ('Abort' menu, Figure closed through its X cross..).

Description

Edition place: edit_curv(), edit_curv(y), edit_curv(x,y) and edit_curv(x,y,…) open a new figure, edit the curve in this one, and finally close the figure when leaving. edit_curv(Axes,…) edits the curve in the given existing Axes set on a uicontrol frame or in a figure and made the current one. edit_curv(hCurve,…) edits the given curve in its parent Axes.

Figure, Axes and curve settings and styles: edit_curv(Axes,…) and edit_curv(hCurve,…) change some settings of the figure: The graphics toolbar and existing menus are hidden. Some menus are added; the title and x and y axis legends may be changed; a grid is displayed in the axes area; the style of the hCurve is changed (thickness, color, markers..). When leaving, all initial settings are restored.

edit_curv(…) edits the curve in blocking mode: While editing, it waits for validating or aborting the edition before returning to the calling level and performing the next instruction.

The edited curve is set as the current graphical entity before returning.

Actions

Enabled actions are set by the job parameter. Clicking or/and pressing are done using the left button of the mouse.

Append a point: Click out of the curve. The new point and a segment connecting it to the nearest tip of the curve are drawn.
Insert a point: Click on an existing segment. The new point is drawn where the segment is split.
Move a point: Click on it ; move the mouse to where the point should go: the point and its segments follow the mouse ; click to set and stop moving the point at its final position.
Delete a point: Click on it. Then press the <suppr> key.
Cancel the previous action (Undo): Press CTRL Z keys (or use the Control → Undo menu)
Cancel the previous cancelation (Redo): Press CTRL Y keys.

Menus
Control
Ok Validates the current curve, and returns
Undo (Ctrl-Z) Iteratively cancels the previous curve's modification. Restores its previous state.
Redo (Ctrl-Y) Iteratively restores the last canceled modification of the curve.
Abort Restores the initial curve, and returns.
Data
Load Opens an interface to choose and load a *.scg graphic file, or a *.sod binary data file, or *.xy text file.

A *.scg file is then scanned for a polyline curve, whose .data xy coordinates are loaded.

A *.sod file is scanned for a variable named xy being a matrix of real numbers. Then xy(:,1:2) coordinates are loaded.

A *.xy file is assumed to contain a matrix of reals. Its first two columns are loaded as x and y coordinates.
Save Opens an interface to choose a directory and *.sod or *.xy filename. Then builds a matrix of size N×2 named xy with the (x,y) coordinates of the edited curve, and records the matrix in the chosen .sod binary or .xy text file.
Clear Clears the current edited curve.
Reframe Sets the axes bounds to the curve's ones.
Bounds Opens a pop-pup window prompting the user to enter new [xmin, ymin, xmax, ymax] bounds of the axes.
Non-blocking edition

An existing curve may be edited in a non-blocking mode, but without constrain on x or y:

  • Activate the asynchronous editor for the targeted figure, either by running useeditor(gcf().figure_id), or by clicking on the edit button in the graphics toolbar.
  • Click or double-click on the curve to edit. Double-click shows its points. Then change its position or shape.
  • Finally, disable the editor: useeditor(gcf().figure_id)
Please see the ieditor page for more information.

Examples

Creating a curve from scratch in an independent GUI, with default styles:
[x, y] = edit_curv();
[x y]'

Allow only moving vertically the points of a predefined curve, without any addition or deletion:
[x, y] = edit_curv(rand(1,8), "y");
[x y]'

Editing a curve in an independent GUI, with a red thick style:
[x, y] = edit_curv(1:8, rand(1,8), "adxy", , list(,,[%nan color("red") 2 %nan]));
[x y]'

When we provide the handle of a plotted curve, its style can be set before calling edit_curv():
clf
plot(1:6)
curve = gce().children;
set(curve, "line_style",8, "foreground",color("red"), "thickness",2)
xtitle("Template", "X axis", "Y axis")
[x,y] = edit_curv(curve, "y");
[x y]'

Editing a curve in a given subplot:
clf
subplot(1,2,2)
title("Main initial title", "fontsize", 4)
xlabel("X axis")
ylabel("Y axis")
[x, y] = edit_curv(gca(), 1:8, rand(1,8), "y", ["Main editing title", "X", ""]);
[x y]'
// Default menus are hidden.
/// After leaving, initial menus, toolbar and legends are restored.

See also

History

VersionDescription
2023.1
  • hCurve and Axes optional inputs added.
  • "d" job: deletion of points now allowed.
  • Undo action actually implemented. CTRL-Z implemented. Redo and CTRL-Y action added.
Report an issue
<< dragrect interaction event handler functions >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Jun 17 17:49:17 CEST 2024