diff scripts/plot/backend.m @ 8060:09f32aac8fbc

Interface for backend switch/initialization
author John W. Eaton <jwe@octave.org>
date Tue, 26 Aug 2008 13:26:05 -0400
parents
children dbd0c77e575e
line wrap: on
line diff
new file mode 100644
--- /dev/null
+++ b/scripts/plot/backend.m
@@ -0,0 +1,70 @@
+## Copyright (C) 2008 Michael Goffioul
+##
+## This file is part of Octave.
+##
+## Octave is free software; you can redistribute it and/or modify it
+## under the terms of the GNU General Public License as published by
+## the Free Software Foundation; either version 3 of the License, or (at
+## your option) any later version.
+##
+## Octave is distributed in the hope that it will be useful, but
+## WITHOUT ANY WARRANTY; without even the implied warranty of
+## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+## General Public License for more details.
+##
+## You should have received a copy of the GNU General Public License
+## along with Octave; see the file COPYING.  If not, see
+## <http://www.gnu.org/licenses/>.
+
+## -*- texinfo -*-
+## @deftypefn {Function File} backend (@var{name})
+## @deftypefnx {Function File} backend (@var{hlist}, @var{name})
+## Change the default graphics backend to @var{name}. If the backend is
+## not already loaded, it is first initialized (initialization is done
+## through the execution of __init_@var{name}__).
+##
+## @var{hlist} is a list of figure handles. When given, this function
+## only switches the default backend for the corresponding figures.
+## @seealso{available_backends}
+## @end deftypefn
+
+function backend (varargin)
+
+  name = "";
+  hlist = [];
+
+  if (nargin == 1)
+    if (ischar (varargin{1}))
+      name = varargin{1};
+    else
+      error ("backend: invalid backend name");
+    endif
+  elseif (nargin == 2)
+    if (isnumeric (varargin{1}) && ischar (varargin{2}))
+      hlist = varargin{1};
+      name = varargin{2};
+    elseif (ischar (varargin{2}))
+      error ("backend: invalid handle list");
+    else
+      error ("backend: invalid backend name");
+    endif
+  else
+    print_usage ();
+  endif
+
+  if (! any (strcmp (available_backends (), name)))
+    feval (["__init_", name, "__"]);
+    if (! any (strcmp (available_backends (), name)))
+      error ("backend: backend was not correctly registered");
+    endif
+  endif
+
+  if (isempty (hlist))
+    set (0, "defaultfigure__backend__", name);
+  else
+    for h = hlist(:)'
+      set (h, "__backend__", name);
+    endfor
+  endif
+
+endfunction