<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>
  <TITLE>xs2eps</TITLE>
  <TYPE>Scilab Function</TYPE>
  <DATE>Mai 2005</DATE>
  <SHORT_DESCRIPTION name="xs2eps">save graphics to a Postscript file.</SHORT_DESCRIPTION>
  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>xs2eps(win_num,filen [,colored] [,orientation])</CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>
  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>win_num</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: integer scalar or vector .</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>filen</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: string, file name.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>colored</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: optional integer or boolean. 0 (%f) means black and white and 1
	    (%t) means color.
          The default value (-1) is to use a value compatible with the screen
          status.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>orientation</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: optional character, with possible values 'p' (portrait) or 'l' (landscape).
          The default value  is 'p'.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>
  <DESCRIPTION>
    <P><VERB>xs2eps</VERB> saves the recorded graphics of the window
    <VERB>win_num</VERB> to file <VERB>filen</VERB> in Postscript syntax. 
    Note that <VERB>filen</VERB> must not have extension.</P>

    <P><VERB>xs2eps</VERB> produces a complete encapsulated Postscrip file. 
    It simply  calls <VERB>xs2eps</VERB> and then <VERB>BEpsf</VERB>.</P>

    <P>This function works only if the selected driver is <VERB>"Rec"</VERB>
    in the window <VERB>win_num</VERB> or if the window is in "new style". The
    generated postscript file does not contrains the header part</P>
  </DESCRIPTION>

  <EXAMPLE><![CDATA[ 
    scf(0)
    plot2d()
    // Postscript export
    filename='foo'; // ! no extension
    xs2eps(0,filename)
  ]]></EXAMPLE>

  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>set_posfig_dim</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>printing</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>xs2ps</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>xs2fig</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>xs2gif</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>xbasimp</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>xs2ppm</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>
</MAN>
