Mercurial > hg > octave-lyh
annotate scripts/plot/figure.m @ 14138:72c96de7a403 stable
maint: update copyright notices for 2012
| author | John W. Eaton <jwe@octave.org> |
|---|---|
| date | Mon, 02 Jan 2012 14:25:41 -0500 |
| parents | 09b157ab2672 |
| children | 9e6ec5f55827 |
| rev | line source |
|---|---|
|
14138
72c96de7a403
maint: update copyright notices for 2012
John W. Eaton <jwe@octave.org>
parents:
13325
diff
changeset
|
1 ## Copyright (C) 1996-2012 John W. Eaton |
| 2313 | 2 ## |
| 3 ## This file is part of Octave. | |
| 4 ## | |
| 5 ## Octave is free software; you can redistribute it and/or modify it | |
| 6 ## under the terms of the GNU General Public License as published by | |
| 7016 | 7 ## the Free Software Foundation; either version 3 of the License, or (at |
| 8 ## your option) any later version. | |
| 2313 | 9 ## |
| 10 ## Octave is distributed in the hope that it will be useful, but | |
| 11 ## WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
| 13 ## General Public License for more details. | |
| 14 ## | |
| 15 ## You should have received a copy of the GNU General Public License | |
| 7016 | 16 ## along with Octave; see the file COPYING. If not, see |
| 17 ## <http://www.gnu.org/licenses/>. | |
| 2290 | 18 |
| 3368 | 19 ## -*- texinfo -*- |
|
10793
be55736a0783
Grammarcheck the documentation from m-files.
Rik <octave@nomad.inbox5.com>
parents:
7017
diff
changeset
|
20 ## @deftypefn {Function File} {} figure (@var{n}) |
| 6895 | 21 ## @deftypefnx {Function File} {} figure (@var{n}, @var{property}, @var{value}, @dots{}) |
| 6308 | 22 ## Set the current plot window to plot window @var{n}. If no arguments are |
| 6895 | 23 ## specified, the next available window number is chosen. |
| 24 ## | |
| 25 ## Multiple property-value pairs may be specified for the figure, but they | |
| 26 ## must appear in pairs. | |
| 3368 | 27 ## @end deftypefn |
| 2290 | 28 |
| 6257 | 29 ## Author: jwe, Bill Denney |
| 2314 | 30 |
| 6257 | 31 function h = figure (varargin) |
| 3263 | 32 |
| 6257 | 33 nargs = nargin; |
| 5406 | 34 |
| 6405 | 35 f = NaN; |
| 6283 | 36 |
| 6293 | 37 init_new_figure = false; |
| 6283 | 38 if (mod (nargs, 2) == 1) |
| 6257 | 39 tmp = varargin{1}; |
| 40 if (ishandle (tmp) && strcmp (get (tmp, "type"), "figure")) | |
| 41 f = tmp; | |
| 42 varargin(1) = []; | |
| 43 nargs--; | |
|
13279
984359717d71
Use common code idiom for checking whether a double value is an integer.
Rik <octave@nomad.inbox5.com>
parents:
13204
diff
changeset
|
44 elseif (isnumeric (tmp) && tmp > 0 && tmp == fix (tmp)) |
| 6257 | 45 f = tmp; |
| 6293 | 46 init_new_figure = true; |
| 6257 | 47 varargin(1) = []; |
| 48 nargs--; | |
| 49 else | |
| 50 error ("figure: expecting figure handle or figure number"); | |
| 51 endif | |
| 3263 | 52 endif |
| 53 | |
| 6293 | 54 ## Check to see if we already have a figure on the screen. If we do, |
| 55 ## then update it if it is different from the figure we are creating | |
| 56 ## or switching to. | |
| 57 cf = get (0, "currentfigure"); | |
| 58 if (! isempty (cf) && cf != 0) | |
| 6405 | 59 if (isnan (f) || cf != f) |
| 6293 | 60 drawnow (); |
| 61 endif | |
| 62 endif | |
| 63 | |
| 6257 | 64 if (rem (nargs, 2) == 0) |
| 6405 | 65 if (isnan (f) || init_new_figure) |
| 6780 | 66 f = __go_figure__ (f, varargin{:}); |
| 67 elseif (nargs > 0) | |
| 6257 | 68 set (f, varargin{:}); |
| 2290 | 69 endif |
| 6257 | 70 set (0, "currentfigure", f); |
| 2290 | 71 else |
| 6046 | 72 print_usage (); |
| 2290 | 73 endif |
| 3263 | 74 |
|
11349
4a3258b1448f
Add default menu for fltk backend figures
Kai Habel <kai.habel@gmx.de>
parents:
10793
diff
changeset
|
75 cf = get (0, "currentfigure"); |
|
13325
09b157ab2672
Only add default menus for FLTK toolkit.
Michael Goffioul <michael.goffioul@gmail.com>
parents:
13279
diff
changeset
|
76 if (strcmp (get (cf, "__graphics_toolkit__"), "fltk")) |
|
09b157ab2672
Only add default menus for FLTK toolkit.
Michael Goffioul <michael.goffioul@gmail.com>
parents:
13279
diff
changeset
|
77 __add_default_menu__ (cf); |
|
09b157ab2672
Only add default menus for FLTK toolkit.
Michael Goffioul <michael.goffioul@gmail.com>
parents:
13279
diff
changeset
|
78 endif |
|
11349
4a3258b1448f
Add default menu for fltk backend figures
Kai Habel <kai.habel@gmx.de>
parents:
10793
diff
changeset
|
79 |
| 6283 | 80 if (nargout > 0) |
| 81 h = f; | |
| 82 endif | |
| 83 | |
| 2290 | 84 endfunction |
| 13204 | 85 |
| 86 %!test | |
| 87 %! hf = figure ("visible", "off"); | |
| 88 %! unwind_protect | |
| 89 %! assert (gcf, hf); | |
| 90 %! assert (isfigure (hf)); | |
| 91 %! unwind_protect_cleanup | |
| 92 %! close (hf); | |
|
13279
984359717d71
Use common code idiom for checking whether a double value is an integer.
Rik <octave@nomad.inbox5.com>
parents:
13204
diff
changeset
|
93 %! end_unwind_protect |