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
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Octave: Interacting with Plots</title>
<meta name="description" content="GNU Octave: Interacting with Plots">
<meta name="keywords" content="GNU Octave: Interacting with Plots">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<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.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
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.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<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.9 Interacting with Plots</h4>
<p>The user can select points on a plot with the <code>ginput</code> function or
selection the position at which to place text on the plot with the
<code>gtext</code> function using the mouse. Menus may also be created
and populated with specific user commands via the <code>uimenu</code> function.
</p>
<a name="XREFginput"></a><dl>
<dt><a name="index-ginput"></a>Function File: <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>Function File: <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><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>Function File: <em></em> <strong>waitforbuttonpress</strong> <em>()</em></dt>
<dt><a name="index-waitforbuttonpress-1"></a>Function File: <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>Function File: <em></em> <strong>gtext</strong> <em>(<var>s</var>)</em></dt>
<dt><a name="index-gtext-1"></a>Function File: <em></em> <strong>gtext</strong> <em>({<var>s1</var>, <var>s2</var>, …})</em></dt>
<dt><a name="index-gtext-2"></a>Function File: <em></em> <strong>gtext</strong> <em>({<var>s1</var>; <var>s2</var>; …})</em></dt>
<dt><a name="index-gtext-3"></a>Function File: <em></em> <strong>gtext</strong> <em>(…, <var>prop</var>, <var>val</var>, …)</em></dt>
<dt><a name="index-gtext-4"></a>Function File: <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>
<a name="XREFuimenu"></a><dl>
<dt><a name="index-uimenu"></a>Function File: <em></em> <strong>uimenu</strong> <em>(<var>property</var>, <var>value</var>, …)</em></dt>
<dt><a name="index-uimenu-1"></a>Function File: <em></em> <strong>uimenu</strong> <em>(<var>h</var>, <var>property</var>, <var>value</var>, …)</em></dt>
<dd><p>Create a uimenu object and return a handle to it. If <var>h</var> is omitted
then a top-level menu for the current figure is created. If <var>h</var>
is given then a submenu relative to <var>h</var> is created.
</p>
<p>uimenu objects have the following specific properties:
</p>
<dl compact="compact">
<dt><code>"accelerator"</code></dt>
<dd><p>A string containing the key combination together with CTRL to execute this
menu entry (e.g., <code>"x"</code> for CTRL+x).
</p>
</dd>
<dt><code>"callback"</code></dt>
<dd><p>Is the function called when this menu entry is executed. It can be either a
function string (e.g., <code>"myfun"</code>), 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}).
</p>
</dd>
<dt><code>"checked"</code></dt>
<dd><p>Can be set <code>"on"</code> or <code>"off"</code>. Sets a mark at this menu entry.
</p>
</dd>
<dt><code>"enable"</code></dt>
<dd><p>Can be set <code>"on"</code> or <code>"off"</code>. If disabled the menu entry
cannot be selected and it is grayed out.
</p>
</dd>
<dt><code>"foregroundcolor"</code></dt>
<dd><p>A color value setting the text color for this menu entry.
</p>
</dd>
<dt><code>"label"</code></dt>
<dd><p>A string containing the label for this menu entry. A <code>"&"</code>-symbol
can be used to mark the <code>"accelerator"</code> character (e.g.,
<code>"E&xit"</code>)
</p>
</dd>
<dt><code>"position"</code></dt>
<dd><p>An scalar value containing the relative menu position. The entry with the
lowest value is at the first position starting from left or top.
</p>
</dd>
<dt><code>"separator"</code></dt>
<dd><p>Can be set <code>"on"</code> or <code>"off"</code>. If enabled it draws a separator
line above the current position. It is ignored for top level entries.
</p>
</dd>
</dl>
<p>Examples:
</p>
<div class="example">
<pre class="example">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)");
</pre></div>
<p><strong>See also:</strong> <a href="Multiple-Plot-Windows.html#XREFfigure">figure</a>.
</p></dd></dl>
<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>
|
