/usr/share/doc/octave/octave.html/Interacting-with-Plots.html is in octave-doc 4.2.2-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Interacting with Plots (GNU Octave)</title>
<meta name="description" content="Interacting with Plots (GNU Octave)">
<meta name="keywords" content="Interacting with Plots (GNU Octave)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="High_002dLevel-Plotting.html#High_002dLevel-Plotting" rel="up" title="High-Level Plotting">
<link href="Test-Plotting-Functions.html#Test-Plotting-Functions" rel="next" title="Test Plotting Functions">
<link href="Printing-and-Saving-Plots.html#Printing-and-Saving-Plots" rel="prev" title="Printing and Saving Plots">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
<link rel="stylesheet" type="text/css" href="octave.css">
</head>
<body lang="en">
<a name="Interacting-with-Plots"></a>
<div class="header">
<p>
Next: <a href="Test-Plotting-Functions.html#Test-Plotting-Functions" accesskey="n" rel="next">Test Plotting Functions</a>, Previous: <a href="Printing-and-Saving-Plots.html#Printing-and-Saving-Plots" accesskey="p" rel="prev">Printing and Saving Plots</a>, Up: <a href="High_002dLevel-Plotting.html#High_002dLevel-Plotting" accesskey="u" rel="up">High-Level Plotting</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Interacting-with-Plots-1"></a>
<h4 class="subsection">15.2.10 Interacting with Plots</h4>
<p>The user can select points on a plot with the <code>ginput</code> function or
select the position at which to place text on the plot with the
<code>gtext</code> function using the mouse.
</p>
<a name="XREFginput"></a><dl>
<dt><a name="index-ginput"></a>: <em>[<var>x</var>, <var>y</var>, <var>buttons</var>] =</em> <strong>ginput</strong> <em>(<var>n</var>)</em></dt>
<dt><a name="index-ginput-1"></a>: <em>[<var>x</var>, <var>y</var>, <var>buttons</var>] =</em> <strong>ginput</strong> <em>()</em></dt>
<dd><p>Return the position and type of mouse button clicks and/or key strokes
in the current figure window.
</p>
<p>If <var>n</var> is defined, then capture <var>n</var> events before returning.
When <var>n</var> is not defined <code>ginput</code> will loop until the return key
<tt class="key">RET</tt> is pressed.
</p>
<p>The return values <var>x</var>, <var>y</var> are the coordinates where the mouse
was clicked in the units of the current axes. The return value <var>button</var>
is 1, 2, or 3 for the left, middle, or right button. If a key is pressed
the ASCII value is returned in <var>button</var>.
</p>
<p>Implementation Note: <code>ginput</code> is intenteded for 2-D plots. For 3-D
plots see the <var>currentpoint</var> property of the current axes which can be
transformed with knowledge of the current <code>view</code> into data units.
</p>
<p><strong>See also:</strong> <a href="#XREFgtext">gtext</a>, <a href="#XREFwaitforbuttonpress">waitforbuttonpress</a>.
</p></dd></dl>
<a name="XREFwaitforbuttonpress"></a><dl>
<dt><a name="index-waitforbuttonpress"></a>: <em></em> <strong>waitforbuttonpress</strong> <em>()</em></dt>
<dt><a name="index-waitforbuttonpress-1"></a>: <em><var>b</var> =</em> <strong>waitforbuttonpress</strong> <em>()</em></dt>
<dd><p>Wait for mouse click or key press over the current figure window.
</p>
<p>The return value of <var>b</var> is 0 if a mouse button was pressed or 1 if a
key was pressed.
</p>
<p><strong>See also:</strong> <a href="GUI-Utility-Functions.html#XREFwaitfor">waitfor</a>, <a href="#XREFginput">ginput</a>, <a href="Terminal-Input.html#XREFkbhit">kbhit</a>.
</p></dd></dl>
<a name="XREFgtext"></a><dl>
<dt><a name="index-gtext"></a>: <em></em> <strong>gtext</strong> <em>(<var>s</var>)</em></dt>
<dt><a name="index-gtext-1"></a>: <em></em> <strong>gtext</strong> <em>({<var>s1</var>, <var>s2</var>, …})</em></dt>
<dt><a name="index-gtext-2"></a>: <em></em> <strong>gtext</strong> <em>({<var>s1</var>; <var>s2</var>; …})</em></dt>
<dt><a name="index-gtext-3"></a>: <em></em> <strong>gtext</strong> <em>(…, <var>prop</var>, <var>val</var>, …)</em></dt>
<dt><a name="index-gtext-4"></a>: <em><var>h</var> =</em> <strong>gtext</strong> <em>(…)</em></dt>
<dd><p>Place text on the current figure using the mouse.
</p>
<p>The text is defined by the string <var>s</var>. If <var>s</var> is a cell string
organized as a row vector then each string of the cell array is written to a
separate line. If <var>s</var> is organized as a column vector then one string
element of the cell array is placed for every mouse click.
</p>
<p>Optional property/value pairs are passed directly to the underlying text
objects.
</p>
<p>The optional return value <var>h</var> is a graphics handle to the created
text object(s).
</p>
<p><strong>See also:</strong> <a href="#XREFginput">ginput</a>, <a href="Plot-Annotations.html#XREFtext">text</a>.
</p></dd></dl>
<p>More sophisticated user interaction mechanisms can be obtained using the
ui* family of functions, see <a href="UI-Elements.html#UI-Elements">UI Elements</a>.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Test-Plotting-Functions.html#Test-Plotting-Functions" accesskey="n" rel="next">Test Plotting Functions</a>, Previous: <a href="Printing-and-Saving-Plots.html#Printing-and-Saving-Plots" accesskey="p" rel="prev">Printing and Saving Plots</a>, Up: <a href="High_002dLevel-Plotting.html#High_002dLevel-Plotting" accesskey="u" rel="up">High-Level Plotting</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|