Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.3.1 - English

Change language to:
Français - 日本語 - Português

Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function

Scilab help >> Graphics Library > axes_operations > zoom_rect

zoom_rect

zoom a selection of the current graphic figure

Calling Sequence

zoom_rect()
zoom_rect(rect)
zooom_rect(h)
zoom_rect(h,rect)

Arguments

rect

Vector of size 4 [xmin,ymin,xmax,ymax] give the rectangle to be zoomed.

h

Graphic handle of type Figure or Axes. Specify on which Axes the zoom will apply.

Description

zoom_rect funtion is used to perform a zoom inside a set of Axes Objects.

The h input argument specifies on which Axes the zoom will apply. If h is a Figure handle then the zoom will apply on its Axes children. If h is a Axes handle then the zoom will only apply to this handle. If h is not specified, then the zoom is performed on the current Figure.

If rect input argument is specified then the zoomed Axes zoom_box property is modified by the argument (see axes_properties). Its bounds along X and Y axis are replaced by rect. If rect is not specified zoom_rect is an interactive zoom. User is required to select a rectangle using the mouse. The new zoom_box property of zoomed axes are then computed by finding the intersections of the rectangle with their axes boxe.

Examples

clf()
x=0:0.01:6*%pi;
plot2d(x,sin(x^2))
zoom_rect([16,-1,18,1])
//more zoom
zoom_rect([16,0,16.2,1])
//back to the original
unzoom()
// zooming using axes_properties
a=gca();
a.zoom_box=[16,0,16.2,1];
a.zoom_box=[];

//zooming subplots accordingly
clf()
x=0:0.01:6*%pi;
subplot(211)
plot2d(x,cos(x))
subplot(212)
plot2d(x,cos(2*x))
rect=[3 -2 7 10]; //a rectangle specified in the current axes (last one) coordinates
zoom_rect(rect) 
unzoom()
//set the global underlying axes as current
f=gcf();set('current_axes',f.children($)) 
rect=[0.4 0 0.6 1] //a rectangle specified in ratio of the window size
zoom_rect(rect) 
rect=[0.4 0.2 0.6 0.8]; //a rectangle specified in ratio of the window size
zoom_rect(rect)

// interactive zoom on current figure
zoom_rect();
// or
zoom_rect(gcf());

See Also

Authors

Serge Steer INRIA

Jean-Baptiste Silvy INRIA

<< unzoom axes_operations axis >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Mar 03 10:59:45 CET 2011