<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>

  <TITLE>replot</TITLE>

  <TYPE>Scilab Function</TYPE>

  <DATE>April 1993</DATE>

  <SHORT_DESCRIPTION name="replot">redraw the current graphics window with new
  boundaries</SHORT_DESCRIPTION>

  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>replot(rect,[handle])</CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>

  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>rect</PARAM_NAME>

        <PARAM_DESCRIPTION>
          <SP>: row vector of size 4.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>

      <PARAM_ITEM>
        <PARAM_NAME>handle</PARAM_NAME>

        <PARAM_DESCRIPTION>
          <SP>: optional argument. Graphics handle(s) of type Axes to select
          one or several given Axes. Only available in new graphics mode.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>

  <DESCRIPTION>
    <P><VERB>replot</VERB> is used to redraw the content of the current
    graphics window with new boundaries defined by
    <VERB>rect=[xmin,ymin,xmax,ymax]</VERB>. Under old graphics syntax, it
    works only with the driver <VERB>"Rec"</VERB>.</P>

    <P>Under new graphics mode, this transformation can be applied to specific
    axes given by Axes graphics handles via the handle argument. If handle is
    not specified, the new boundaries are applied to the current axes of the
    current figure. The transformation changes the <VERB>data_bounds</VERB>
    value of those axes. Note that the axes property <VERB>tight_limits</VERB>
    must also be set to "on" to strictly select those bounds (see
    <LINK>axes_properties</LINK>).<VERB> </VERB></P>
  </DESCRIPTION>

  <EXAMPLE><![CDATA[backupstyle='?'
if (get('old_style')=='off') then
  set('old_style','on');
  backupstyle='off'
end

// under old graphics mode
x=[0:0.1:2*%pi]';
plot2d(x,sin(x)) 
replot([-1,-1,10,2]) 

// under new graphics mode
set old_style off
xdel(winsid());
plot() // plot demo
f=gcf();
replot([-1,-1,10,2],f.children(1)) // specify axes handle's value
replot([-3,-2,8,4],f.children(2)) 
if (backupstyle =='off') then set('old_style',backupstyle);end;
 
  ]]></EXAMPLE>

  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>xbasr</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>xbasc</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>clf</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>

  <AUTHOR>J.Ph.C.</AUTHOR>
</MAN>