<chapter id="dcop">
	<title
>Script de &kmplot;</title>
	<para
>Une nouvelle fonctionnalité est apparue avec &kde; 3.4 ; vous pouvez écrire des scripts pour &kmplot; en utilisant &DBus; de &kde; 4. Par exemple, si vous souhaitez définir une nouvelle fonction <userinput
>f(x)=2sin x+3cos x </userinput
>, fixer la largeur de la courbe à 20 et ensuite la tracer, tapez dans une console :</para>
	<para
><command
>qdbus org.kde.kmplot-PID /parser org.kde.kmplot.Parser.addFunction "f(x)=2sin x+3cos x" ""</command
> À la suite de quoi, l'identifiant de la fonction sera retourné, ou -1 si la fonction n'a pu être créée.</para>
	<para
><command
>qdbus org.kde.kmplot-PID /parser org.kde.kmplot.Parser.setFunctionFLineWidth ID 20</command
> Cette commande fixe la largeur de la courbe à 20 pour la fonction avec l'identifiant ID.</para>
	<para
><command
>qdbus org.kde.kmplot-PID /view org.kde.kmplot.View.drawPlot</command
> Cette commande repaint la fenêtre de manière à ce que la fonction soit visible.</para>
<para
>Une liste de fonctions disponibles : <variablelist>
		<varlistentry>
			<term
>/kmplot org.kde.kmplot.KmPlot.fileOpen url </term>
			<listitem>
				<para
>Charge le fichier <parameter
>url</parameter
>.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.isModified </term>
			<listitem>
				<para
>Renvoie vrai si aucun changement n'a eu lieu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.checkModified </term>
			<listitem>
				<para
>Si il y a eu des modifications, une boîte de dialogue apparaît pour enregistrer, abandonner ou annuler les tracés.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.editAxes </term>
			<listitem>
				<para
>Ouvre une boîte de dialogue pour modifier le système de coordonnées.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.toggleShowSlider </term>
			<listitem>
				<para
>Affiche/cache la fenêtre de glissière qui contrôle un paramètre.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotSave </term>
			<listitem>
				<para
>Enregistre les fonctions (ouvre la boîte de dialogue d'enregistrement si c'est un nouveau fichier).</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotSaveas </term>
			<listitem>
				<para
>La même chose que choisir <menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Enregistrer sous</guimenuitem
></menuchoice
> dans le menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotPrint </term>
			<listitem>
				<para
>Ouvre la boîte de dialogue d'impression.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotResetView </term>
			<listitem>
				<para
>La même chose que choisir <menuchoice
><guimenu
>Affichage</guimenu
><guimenuitem
>Remettre l'affichage à zéro</guimenuitem
></menuchoice
> dans le menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotExport </term>
			<listitem>
				<para
>Ouvre la boîte de dialogue d'export.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotSettings </term>
			<listitem>
				<para
>Ouvre la boîte de dialogue de configuration.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotNames </term>
			<listitem>
				<para
>Affiche les fonctions mathématiques prédéfinies du manuel.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.findMinimumValue </term>
			<listitem>
				<para
>La même chose que choisir<menuchoice
><guimenu
>Outils</guimenu
><guimenuitem
>Trouver le minimum...</guimenuitem
></menuchoice
> dans le menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.findMaximumValue </term>
			<listitem>
				<para
>La même chose que choisir<menuchoice
><guimenu
>Outils</guimenu
><guimenuitem
>Trouver le maximum...</guimenuitem
></menuchoice
> dans le menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.graphArea </term>
			<listitem>
				<para
>La même chose que choisir <menuchoice
><guimenu
>Outils</guimenu
><guimenuitem
>Zone de tracé</guimenuitem
></menuchoice
> dans le menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.calculator </term>
			<listitem>
				<para
>La même chose que choisir <menuchoice
><guimenu
>Outils</guimenu
><guimenuitem
>Calculatrice</guimenuitem
></menuchoice
> dans le menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/parser org.kde.kmplot.Parser.addFunction f_str0 f_fstr1 </term>
			<listitem>
				<para
>Ajoute une nouvelle fonction avec les expressions <parameter
>f_str0</parameter
> and <parameter
>f_str1</parameter
>. Si l'expression ne contient pas de nom de fonction, il sera généré automatiquement. L'identifiant de la nouvelle fonction est renvoyé, ou -1 si la fonction ne peut être définie.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/parser org.kde.kmplot.Parser.removeFunction id </term>
			<listitem>
				<para
>Supprime la fonction avec l'identifiant <parameter
>id</parameter
>. Si la fonction ne peut être supprimée, faux est renvoyé, sinon vrai.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/parser org.kde.kmplot.Parser.setFunctionExpression id eq f_str </term>
			<listitem>
				<para
>Fixe l'expression pour la fonction avec l'identifiant <parameter
>id</parameter
> à <parameter
>f_str</parameter
>. Renvoie vrai si ça a réussi, sinon faux.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/parser org.kde.kmplot.Parser.countFunctions </term>
			<listitem>
				<para
>Renvoie le nombre de fonctions (les fonctions paramétriques sont comptées comme deux).</para>
			</listitem>
		</varlistentry>
<!-- method double org.kde.kmplot.Parser.fkt(uint id, uint eq, double eq) what is this?-->
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.listFunctionNames </term>
		  <listitem>
		    <para
>Renvoie une liste avec toutes les fonctions.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.fnameToID f_str </term>
		  <listitem>
		    <para
>Renvoie l'identifiant de <parameter
>f_str</parameter
> ou -1 si le nom de la fonction <parameter
>f_str</parameter
> n'est pas trouvé.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionFVisible id </term>
		  <listitem>
		    <para
>Renvoie vrai si la fonction avec l'identifiant <parameter
>id</parameter
> est visible, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionF1Visible id </term>
		  <listitem>
		    <para
>Renvoie vrai si la dérivée première de la fonction avec l'identifiant <parameter
>id</parameter
> est visible, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionF2Visible id </term>
		  <listitem>
		    <para
>Renvoie vrai si la dérivée seconde de la fonction avec l'identifiant <parameter
>id</parameter
> est visible, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionIntVisible id </term>
		  <listitem>
		    <para
>Renvoie vrai si la primitive de la fonction avec l'identifiant <parameter
>id</parameter
> est visible, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionFVisible id visible </term>
		  <listitem>
		    <para
>Affiche la fonction avec l'identifiant <parameter
>id</parameter
> si <parameter
>visible</parameter
> est vrai. Si <parameter
>visible</parameter
> est faux, la fonction sera cachée. Vrai est renvoyé si la fonction existe, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionF1Visible id visible </term>
		  <listitem>
		    <para
>Affiche la dérivée première de la fonction avec l'identifiant <parameter
> id</parameter
> si <parameter
>visible</parameter
> est vrai. Si <parameter
>visible</parameter
> est faux, la fonction sera cachée. Vrai est renvoyé si la fonction existe, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionF2Visible id visible </term>
		  <listitem>
		    <para
>Affiche la dérivée seconde de la fonction avec l'identifiant <parameter
> id</parameter
> si <parameter
>visible</parameter
> est vrai. Si <parameter
>visible</parameter
> est faux, la fonction sera cachée. Vrai est renvoyé si la fonction existe, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionIntVisible id visible </term>
		  <listitem>
		    <para
>Affiche la primitive de la fonction avec l'identifiant <parameter
> id</parameter
> si <parameter
>visible</parameter
> est vrai. Si <parameter
>visible</parameter
> est faux, la fonction sera cachée. Vrai est renvoyé si la fonction existe, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionStr id eq </term>
		  <listitem>
		    <para
>Renvoie l'expression de la fonction avec l'identifiant <parameter
>id</parameter
>. Si la fonction n'existe pas, une chaîne vide est retournée à la place.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionFLineWidth id </term>
		  <listitem>
		    <para
>Renvoie la largeur de la courbe de la fonction avec l'identifiant <parameter
> id</parameter
>. Si la fonction n'existe pas, 0 est renvoyé.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionF1LineWidth id </term>
		  <listitem>
		    <para
>Renvoie la largeur de la courbe de la dérivée première des fonctions avec l'identifiant <parameter
>id</parameter
>. Si la fonction n'existe pas, 0 est renvoyé.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionF2LineWidth id </term>
		  <listitem>
		    <para
>Renvoie la largeur de la courbe de la dérivée première des fonctions avec l'identifiant <parameter
>id</parameter
>. Si la fonction n'existe pas, 0 est renvoyé.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionIntLineWidth id </term>
		  <listitem>
		    <para
>Renvoie la largeur de la courbe de la primitive des fonctions avec l'identifiant <parameter
>id</parameter
>. Si la fonction n'existe pas, 0 est renvoyé.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionFLineWidth id linewidth </term>
		  <listitem>
		    <para
>Fixe la largeur de la courbe de la fonction avec l'identifiant <parameter
>id</parameter
> à <parameter
>linewidth</parameter
>. Vrai est renvoyé si la fonction existe, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionF1LineWidth id linewidth </term>
		  <listitem>
		    <para
>Fixe la largeur de la courbe de la dérivée première de la fonction avec l'identifiant <parameter
>id</parameter
> à <parameter
>linewidth</parameter
>. Vrai est renvoyé si la fonction existe, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionF2LineWidth id linewidth </term>
		  <listitem>
		    <para
>Fixe la largeur de la courbe de la dérivée seconde de la fonction avec l'identifiant <parameter
>id</parameter
> à <parameter
>linewidth</parameter
>. Vrai est renvoyé si la fonction existe, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionIntLineWidth id linewidth </term>
		  <listitem>
		    <para
>Fixe la largeur de la courbe de la primitive de la fonction avec l'identifiant <parameter
>id</parameter
> à <parameter
>linewidth</parameter
>. Vrai est renvoyé si la fonction existe, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionParameterList id </term>
		  <listitem>
		    <para
>Renvoie une liste avec toutes les valeurs de paramètres pour la fonction avec l'identifiant <parameter
>id</parameter
>.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionAddParameter id new_parameter </term>
		  <listitem>
		    <para
>Ajoute la valeur <parameter
>new_parameter</parameter
> au paramètre de la fonction avec l'identifiant <parameter
>id</parameter
>. Vrai est renvoyé si l'opération a réussi, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionRemoveParameter id remove_parameter </term>
		  <listitem>
		    <para
>Supprime la valeur <parameter
>remove_parameter</parameter
> au paramètre de la fonction avec l'identifiant <parameter
>id</parameter
>. Vrai est renvoyé si l'opération a réussi, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionMinValue id </term>
		  <listitem>
		    <para
>Renvoie la valeur minimale de la plage de valeurs de la fonction avec l'identifiant <parameter
>id</parameter
>. Si la fonction n'existe pas ou si la valeur minimale n'est pas définie, une chaîne vide est retournée.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionMaxValue id </term>
		  <listitem>
		    <para
>Renvoie la valeur maximale de la plage de valeurs de la fonction avec l'identifiant <parameter
>id</parameter
>. Si la fonction n'existe pas ou si la valeur maximale n'est pas définie, une chaîne vide est retournée.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionMinValue id min </term>
		  <listitem>
		    <para
>Fixe la valeur minimale de la plage de valeurs de la fonction avec l'identifiant <parameter
>id</parameter
> à <parameter
>min</parameter
>. Vrai est renvoyé si la fonction existe et si l'expression est correcte, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionMaxValue id max </term>
		  <listitem>
		    <para
>Fixe la valeur maximale de la plage de valeurs de la fonction avec l'identifiant <parameter
>id</parameter
> à <parameter
>min</parameter
>. Vrai est renvoyé si la fonction existe et si l'expression est correcte, sinon faux.</para>
		  </listitem>
		</varlistentry>
		
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionStartXValue id </term>
		  <listitem>
		    <para
>Renvoie l'abscisse initial de la primitive de la fonction avec l'identifiant <parameter
>id</parameter
>. Si la fonction n'existe pas ou si l'expression de l'abscisse n'est pas définie, une chaîne vide est renvoyée.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionStartYValue id </term>
		  <listitem>
		    <para
>Renvoie l'ordonnée initiale de la primitive de la fonction avec l'identifiant <parameter
>id</parameter
>. Si la fonction n'existe pas ou si l'expression de l'ordonnée n'est pas définie, une chaîne vide est renvoyée.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionStartValue id x y </term>
		  <listitem>
		    <para
>Fixe l'abscisse et l'ordonnée initiale de la primitive de la fonction avec l'identifiant <parameter
>id</parameter
> à <parameter
>x</parameter
> et <parameter
>y</parameter
>. Vrai est renvoyé si la fonction existe et si l'expression est correcte, sinon faux.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
			<term
>/view org.kde.kmplot.View.stopDrawing </term>
			<listitem>
				<para
>Si &kmplot; est en train de tracer une fonction, la procédure s'arrête.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/view org.kde.kmplot.View.drawPlot </term>
			<listitem>
				<para
>Retrace toutes les fonctions.</para>
			</listitem>
		</varlistentry>
	</variablelist>
</para>
</chapter>

<!--
    Local Variables:
    mode: sgml
    sgml-minimize-attributes:nil
    sgml-general-insert-case:lower
    sgml-indent-step:0
    sgml-indent-data:nil
    sgml-parent-document:("index.docbook" "BOOK" "CHAPTER")
    End:
    -->
