Mercurial > octave
view scripts/plot/appearance/pbaspect.m @ 28912:0de38a6ef693
maint: Use Octave convention of space after function name in scripts dir.
* cplxpair.m, gradient.m, integral.m, integral3.m, interp2.m, interpft.m,
num2str.m, pol2cart.m, quad2d.m, quadgk.m, quadl.m, repelem.m, sph2cart.m,
convhull.m, delaunay.m, delaunayn.m, movegui.m, print_usage.m,
__strip_html_tags__.m, colormap.m, gray2ind.m, imformats.m, importdata.m,
javachk.m, condest.m, isbanded.m, krylov.m, lscov.m, rref.m, inputParser.m,
publish.m, symvar.m, validateattributes.m, ode15i.m, ode15s.m, ode23.m,
ode23s.m, ode45.m, fminbnd.m, fminsearch.m, glpk.m, qp.m, get_forge_pkg.m,
installed_packages.m, annotation.m, axis.m, camorbit.m, campos.m, camva.m,
camzoom.m, daspect.m, legend.m, pbaspect.m, __gnuplot_legend__.m, light.m,
patch.m, plotyy.m, __pie__.m, reducepatch.m, ribbon.m, streamline.m, trisurf.m,
figure.m, ndgrid.m, __gnuplot_draw_axes__.m, __opengl_print__.m, padecoef.m,
polygcd.m, ppval.m, spline.m, union.m, bicg.m, bicgstab.m, cgs.m, eigs.m,
gmres.m, pcg.m, pcr.m, __alltohandles__.m, __sprand__.m, qmr.m, tfqmr.m,
betaincinv.m, cosint.m, gammainc.m, discrete_cdf.m, discrete_inv.m,
discrete_rnd.m, base2dec.m, strtok.m, compare_plot_demos.m,
html_compare_plot_demos.m, speed.m, test.m, weboptions.m, webread.m, webwrite.m:
Use Octave convention of space after function name and before '(' in scripts
directory.
author | Rik <rik@octave.org> |
---|---|
date | Tue, 13 Oct 2020 18:17:29 -0700 |
parents | 9f9ac219896d |
children | 7854d5752dd2 |
line wrap: on
line source
######################################################################## ## ## Copyright (C) 2010-2020 The Octave Project Developers ## ## See the file COPYRIGHT.md in the top-level directory of this ## distribution or <https://octave.org/copyright/>. ## ## 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 ## <https://www.gnu.org/licenses/>. ## ######################################################################## ## -*- texinfo -*- ## @deftypefn {} {@var{plot_box_aspect_ratio} =} pbaspect ( ) ## @deftypefnx {} {} pbaspect (@var{plot_box_aspect_ratio}) ## @deftypefnx {} {} pbaspect (@var{mode}) ## @deftypefnx {} {@var{plot_box_aspect_ratio_mode} =} pbaspect ("mode") ## @deftypefnx {} {} pbaspect (@var{hax}, @dots{}) ## ## Query or set the plot box aspect ratio of the current axes. ## ## The aspect ratio is a normalized 3-element vector representing the rendered ## lengths of the x, y, and z axes. ## ## @code{pbaspect(@var{mode})} ## ## Set the plot box aspect ratio mode of the current axes. @var{mode} is ## either @qcode{"auto"} or @qcode{"manual"}. ## ## @code{pbaspect ("mode")} ## ## Return the plot box aspect ratio mode of the current axes. ## ## @code{pbaspect (@var{hax}, @dots{})} ## ## Operate on the axes in handle @var{hax} instead of the current axes. ## ## @seealso{axis, daspect, xlim, ylim, zlim} ## @end deftypefn function pbratio = pbaspect (varargin) ## Grab axes handle if present if (nargin > 0) if (isscalar (varargin{1}) && isaxes (varargin{1})) hax = varargin{1}; varargin = varargin(2:end); else hax = gca (); endif else hax = gca (); endif nargin = numel (varargin); if (nargin > 1) print_usage (); endif if (nargin == 0) pbratio = get (hax, "plotboxaspectratio"); else arg = varargin{1}; if (isnumeric (arg)) if (numel (arg) == 2) set (hax, "plotboxaspectratio", [arg, 1]); elseif (numel (arg) == 3) set (hax, "plotboxaspectratio", arg); else error ("pbaspect: PLOT_BOX_ASPECT_RATIO must be a 2 or 3 element vector"); endif elseif (ischar (arg)) arg = tolower (arg); switch (arg) case "auto" set (hax, "plotboxaspectratiomode", "auto"); case "manual" set (hax, "plotboxaspectratiomode", "manual"); case "mode" pbratio = get (hax, "plotboxaspectratiomode"); otherwise error ("pbaspect: Invalid MODE <%s>", arg); endswitch else print_usage (); endif endif endfunction %!demo %! clf; %! x = 0:0.01:4; %! plot (x,cos (x), x,sin (x)); %! pbaspect ([1 1 1]); %! title ("plot box is square"); %!demo %! clf; %! x = 0:0.01:4;; %! plot (x,cos (x), x,sin (x)); %! pbaspect ([2 1 1]); %! title ("plot box aspect ratio is 2x1"); %!demo %! clf; %! x = 0:0.01:4; %! plot (x,cos (x), x,sin (x)); %! daspect ([1 1 1]); %! pbaspect ([2 1 1]); %! title ("plot box is 2x1, and axes [0 4 -1 1]");