Mercurial > octave
view scripts/plot/util/linkaxes.m @ 22302:1c4cd12987f5
Use Octave syntax in graphics demos.
* inputdlg.m, listdlg.m, waitbar.m, autumn.m, bone.m, cool.m, copper.m,
cubehelix.m, flag.m, gray.m, hot.m, hsv.m, jet.m, lines.m, ocean.m, pink.m,
prism.m, rainbow.m, rgbplot.m, spring.m, summer.m, viridis.m, white.m,
winter.m, annotation.m, axis.m, clabel.m, daspect.m, datetick.m, grid.m,
legend.m, lighting.m, material.m, pbaspect.m, shading.m, text.m, xlim.m,
ylim.m, zlim.m, area.m, bar.m, barh.m, camlight.m, colorbar.m, comet.m,
comet3.m, contour.m, contour3.m, contourf.m, cylinder.m, ellipsoid.m,
errorbar.m, ezcontour.m, ezcontourf.m, ezmesh.m, ezmeshc.m, ezplot.m,
ezplot3.m, ezsurf.m, ezsurfc.m, feather.m, fill.m, fplot.m, isocaps.m,
isonormals.m, isosurface.m, light.m, line.m, loglog.m, loglogerr.m, mesh.m,
meshc.m, meshz.m, pareto.m, patch.m, pcolor.m, pie.m, pie3.m, plot.m, plot3.m,
plotmatrix.m, plotyy.m, polar.m, quiver.m, quiver3.m, rectangle.m, ribbon.m,
rose.m, scatter.m, scatter3.m, semilogx.m, semilogxerr.m, semilogy.m,
semilogyerr.m, shrinkfaces.m, slice.m, smooth3.m, sombrero.m, stairs.m, stem.m,
stem3.m, stemleaf.m, surf.m, surfc.m, surfl.m, surfnorm.m, tetramesh.m,
trimesh.m, triplot.m, trisurf.m, waterfall.m, copyobj.m, hold.m, linkaxes.m,
linkprop.m, printd.m, refreshdata.m, subplot.m, zoom.m, pcr.m, dump_demos.m:
Use Octave syntax in graphics demos.
author | Rik <rik@octave.org> |
---|---|
date | Mon, 15 Aug 2016 15:15:30 -0700 |
parents | 516bb87ea72e |
children | bac0d6f07a3e |
line wrap: on
line source
## Copyright (C) 2014-2015 Willem Atsma ## ## 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 {} {} linkaxes (@var{hax}) ## @deftypefnx {} {} linkaxes (@var{hax}, @var{optstr}) ## Link the axis limits of 2-D plots such that a change in one is propagated ## to the others. ## ## The axes handles to be linked are passed as the first argument @var{hax}. ## ## The optional second argument is a string which defines which axis limits ## will be linked. The possible values for @var{optstr} are: ## ## @table @asis ## @item @qcode{"x"} ## Link x-axes ## ## @item @qcode{"y"} ## Link y-axes ## ## @item @qcode{"xy"} (default) ## Link both axes ## ## @item @qcode{"off"} ## Turn off linking ## @end table ## ## If unspecified the default is to link both X and Y axes. ## ## When linking, the limits from the first axes in @var{hax} are applied to the ## other axes in the list. Subsequent changes to any one of the axes will be ## propagated to the others. ## ## @seealso{linkprop, addproperty} ## @end deftypefn ## Author: Willem Atsma willem.atsma at tanglebridge.com ## Created: 2014-03-18 function linkaxes (hax, optstr = "xy") if (nargin < 1 || nargin > 2) print_usage (); endif if (numel (hax) < 2) error ("linkaxes: HAX must contain at least 2 handles"); elseif (! all (isaxes (hax(:)))) error ("linkaxes: HAX must be a vector of axes handles"); endif ## Check if axes are linked already and clear if found. ## Otherwise, add the necessary linkaxes_data property. for i = 1:length (hax) if (isprop (hax(i), "linkaxes_data")) hld = get (hax(i), "linkaxes_data"); try rmappdata (hld, "linkprop_data"); end_try_catch else addproperty ("linkaxes_data", hax(i), "any"); endif endfor switch (optstr) case "x" hlink = linkprop (hax, "xlim"); case "y" hlink = linkprop (hax, "ylim"); case "xy" hlink = linkprop (hax, {"xlim" "ylim"}); case "off" ## do nothing - link already deleted hlink = []; otherwise error ("linkaxes: unrecognized OPTSTR '%s'", optstr); endswitch if (! isempty (hlink)) setappdata (hax(1), "linkprop_data", hlink); set (hax, "linkaxes_data", hax(1)); else set (hax, "linkaxes_data", []); endif endfunction %!demo %! clf; %! hax1 = subplot (3,1,1); %! bar (rand (4, 1), "facecolor", "r"); %! hax2 = subplot (3,1,2); %! bar (5*rand (4, 1), "facecolor", "g"); %! hax3 = subplot (3,1,3); %! bar (10*rand (4, 1), "facecolor", "b"); %! input ("Type <RETURN> to link axes"); %! linkaxes ([hax1, hax2, hax3]); %! input ("Type <RETURN> to change ylim"); %! ylim (hax3, [0 10]); %!test %! hf1 = figure ("visible", "off"); %! hax1 = axes (); %! plot (1:10); %! hf2 = figure ("visible", "off"); %! hax2 = axes (); %! plot (10:-1:1, "-*g"); %! hf3 = figure ("visible", "off"); %! hax3 = axes (); %! plot (1:10:100, "-xb"); %! unwind_protect %! linkaxes ([hax1, hax2, hax3]); %! ## Test initial values taken from first object in list %! assert (xlim (hax3), [0 10]); %! assert (ylim (hax3), [0 10]); %! ## Test linking %! xlim (hax2, [2 8]); %! assert (xlim (hax1), [2 8]); %! assert (xlim (hax3), [2 8]); %! ylim (hax3, "auto"); %! assert (ylim (hax1), [0 100]); %! assert (ylim (hax2), [0 100]); %! ## Test re-linking removes old link %! linkaxes ([hax1, hax2]); %! ylim (hax3, [0 50]); %! assert (ylim (hax1), [0 100]); %! assert (ylim (hax2), [0 100]); %! xlim (hax1, [0 4]); %! assert (xlim (hax2), [0 4]); %! ## Test linking of remaining objects after deletion of one object %! linkaxes ([hax1, hax2, hax3]); %! xlim (hax2, [0 1]); %! assert (xlim (hax1), [0 1]); %! assert (xlim (hax3), [0 1]); %! delete (hax2); %! xlim (hax3, [0 2]); %! assert (xlim (hax1), [0 2]); %! ## Test deletion of link %! linkaxes ([hax1, hax3], "off"); %! xlim (hax3, [0 3]); %! assert (xlim (hax1), [0 2]); %! unwind_protect_cleanup %! close ([hf1 hf2 hf3]); %! end_unwind_protect ## Test input validation %!error linkaxes () %!error linkaxes (1,2,3) %!error <HAX must be a vector of axes handles> linkaxes ([pi, e])