ab9a0abc1b0872ff059e103cff9deba17f61b3aa
[scilab.git] / scilab / modules / graphic_export / help / en_US / xinit.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) ENPC - Jean-Philippe Chancelier
5  * Copyright (C) 2008 - INRIA - Jean-Baptiste Silvy
6  * 
7  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at    
11  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
12  *
13  -->
14 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="xinit">
15     <refnamediv>
16         <refname>xinit</refname>
17         <refpurpose>initialization of a graphics driver</refpurpose>
18     </refnamediv>
19     <refsynopsisdiv>
20         <title>Calling Sequence</title>
21         <synopsis>
22             xinit(FileName)
23             xinit()
24         </synopsis>
25     </refsynopsisdiv>
26     <refsection>
27         <title>Arguments</title>
28         <variablelist>
29             <varlistentry>
30                 <term>FileName</term>
31                 <listitem>
32                     <para>a string: name of the export file.</para>
33                 </listitem>
34             </varlistentry>
35         </variablelist>
36     </refsection>
37     <refsection>
38         <title>Description</title>
39         <para>
40             To export to a file, <varname>FileName</varname> must be 
41             specified. It is the name of the file where all the graphics 
42             operations are recorded.
43         </para>
44         <para>
45             For screen drivers (X11 or Rec), <function>xinit</function> 
46             should be called without any argument and it will open an 
47             empty graphic window.
48         </para>
49     </refsection>
50     <refsection>
51         <title>Examples</title>
52         <programlisting role="example"><![CDATA[ 
53 current_driver = driver()
54 driver("Pos")
55 xinit(TMPDIR+"/foo.ps")
56 plot2d()
57 xend()
58 driver(current_driver)
59  ]]></programlisting>
60         <programlisting role="example"><![CDATA[ 
61 current_driver = driver()
62 driver("PNG")
63 xinit(TMPDIR+"/foo.png")
64 plot3d()
65 xend()
66 driver(current_driver)
67  ]]></programlisting>
68     </refsection>
69     <refsection role="see also">
70         <title>See Also</title>
71         <simplelist type="inline">
72             <member>
73                 <link linkend="driver">driver</link>
74             </member>
75             <member>
76                 <link linkend="xend">xend</link>
77             </member>
78             <member>
79                 <link linkend="scf">scf</link>
80             </member>
81         </simplelist>
82     </refsection>
83 </refentry>