1## Copyright (C) 2005, 2006, 2007, 2008 John W. Eaton
3## This file is part of Octave.
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
7## the Free Software Foundation; either version 3 of the License, or (at
8## your option) any later version.
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.
15## You should have received a copy of the GNU General Public License
16## along with Octave; see the file COPYING. If not, see
17## <http://www.gnu.org/licenses/>.
20## @deftypefn {Function File} {} axes ()
21## @deftypefnx {Function File} {} axes (@var{property}, @var{value}, @dots{})
22## @deftypefnx {Function File} {} axes (@var{h})
23## Create an axes object and return a handle to it.
28function h = axes (varargin)
30 if (nargin == 0 || nargin > 1)
31 ## make default axes object, and make it the current axes for the
33 idx = find (strcmpi (varargin(1:2:end), "parent"), 1, "first");
34 if (! isempty (idx) && length (varargin) >= 2*idx)
36 varargin([2*idx-1, 2*idx]) = [];
40 tmp = __go_axes__ (cf, varargin{:});
41 set (ancestor (cf, "figure"), "currentaxes", tmp);
43 ## arg is axes handle, make it the current axes for the current
46 if (length(tmp) == 1 && ishandle (tmp)
47 && strcmp (get (tmp, "type"), "axes"))
48 parent = ancestor (tmp, "figure");
49 set (0, "currentfigure", parent);
50 set (parent, "currentaxes", tmp);
52 error ("axes: expecting argument to be a scalar axes handle");