Interacting with Plots - GNU Octave
Description: GNU Octave

Next: Test Plotting Functions, Previous: Printing and Saving Plots, Up: High-Level Plotting

#### 15.2.10 Interacting with Plots

The user can select points on a plot with the `ginput` function or selection the position at which to place text on the plot with the `gtext` function using the mouse. Menus may also be created and populated with specific user commands via the `uimenu` function.

— Function File: [x, y, buttons] = ginput (n)

> Return which mouse buttons were pressed and keys were hit on the current figure. If n is defined, then wait for n mouse clicks before returning. If n is not defined, then `ginput` will loop until the return key <RET> is pressed.

— Function File: b = waitforbuttonpress ()

> Wait for button or mouse press.over a figure window. The value of b returns 0 if a mouse button was pressed or 1 is a key was pressed.

> See also: ginput.

— Function File: gtext (s)
— Function File: gtext ({s1; s2; ...})
— Function File: gtext (..., prop, val)

> Place text on the current figure using the mouse. The text is defined by the string s. If s is a cell array, each element of the cell array is written to a separate line. Additional arguments are passed to the underlying text object as properties.

> See also: ginput, text.

— Function File: uimenu (property, value, ...)
— Function File: uimenu (h, property, value, ...)

> Create a uimenu object and return a handle to it. If h is ommited then a top-level menu for the current figure is created. If h is given then a submenu relative to h is created.

> uimenu objects have the following specific properties:

> "accelerator"
>   A string containing the key combination together with CTRL to execute this menu entry (e.g., "x" for CTRL+x).
> "callback"
>   Is the function called when this menu entry is executed. It can be either a function string (e.g., "myfun"), a function handle (e.g., @myfun) or a cell array containing the function handle and arguments for the callback function (e.g., {@myfun, arg1, arg2}).
> "checked"
>   Can be set "on" or "off". Sets a mark at this menu entry.
> "enable"
>   Can be set "on" or "off". If disabled the menu entry cannot be selected and it is grayed out.
> "foregroundcolor"
>   A color value setting the text color for this menu entry.
> "label"
>   A string containing the label for this menu entry. A "&"-symbol can be used to mark the "accelerator" character (e.g., "E&xit")
> "position"
>   An scalar value containing the relative menu position. The entry with the lowest value is at the first position starting from left or top.
> "separator"
>   Can be set "on" or "off". If enabled it draws a separator line above the current position. It is ignored for top level entries.

> Examples:

>               f = uimenu ("label", "&File", "accelerator", "f");
>               e = uimenu ("label", "&Edit", "accelerator", "e");
>               uimenu (f, "label", "Close", "accelerator", "q", ...
>                          "callback", "close (gcf)");
>               uimenu (e, "label", "Toggle &Grid", "accelerator", "g", ...
>                          "callback", "grid (gca)");

> See also: figure.