<chapter id="dcop">
<title
>Crear scripts per a &kmplot;</title>
<para
>Una nova característica en el &kde; 3.4 és que podeu escriure scripts per a &kmplot; utilitzant &DBus; al &kde; 4. Per exemple, si voleu definir una nova funció <userinput
>f(x)=2sin x+3cos x</userinput
>, primer establiu l'amplada de la línia a 20 i després la dibuixeu, escriviu en una consola:</para>
<para
><command
>qdbus org.kde.kmplot-PID /parser org.kde.kmplot.Parser.addFunction "f(x)=2sin x+3cos x" ""</command
> Com a resultat, es retornarà el nombre d'identificació de la nova funció, o -1 si la funció no s'ha pogut definir.</para>
<para
><command
>qdbus org.kde.kmplot-PID /parser org.kde.kmplot.Parser.setFunctionFLineWidth ID 20</command
> Aquesta ordre estableix l'amplada de la línia a 20, per a la funció en que el número d'identificació és ID.</para>
<para
><command
>qdbus org.kde.kmplot-PID /view org.kde.kmplot.View.drawPlot</command
> Aquesta ordre torna a dibuixar la finestra de manera que la funció sigui visible.</para>
<para
>Una llista de totes les característiques disponibles: <variablelist>
<varlistentry>
<term
>/kmplot org.kde.kmplot.KmPlot.fileOpen url </term>
<listitem>
<para
>Carrega el <parameter
>URL</parameter
> del fitxer.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.isModified </term>
<listitem>
<para
>Retorna «true» (vertader) si s'ha produït algun canvi.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.checkModified </term>
<listitem>
<para
>Si hi ha canvis sense desar, apareixerà un diàleg per desar, descartar o cancel·lar els gràfics.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.editAxes </term>
<listitem>
<para
>Obre el diàleg d'edició del sistema de coordenades.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.toggleShowSlider </term>
<listitem>
<para
>Mostra/oculta la finestra del control lliscant de paràmetres.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.slotSave </term>
<listitem>
<para
>Desa les funcions (obre el diàleg desa si es tracta d'un nou fitxer).</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.slotSaveas </term>
<listitem>
<para
>El mateix com si en el menú escollíssiu <menuchoice
><guimenu
>Fitxer</guimenu
><guimenuitem
>Desa com a</guimenuitem
></menuchoice
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.slotPrint </term>
<listitem>
<para
>Obre el diàleg d'impressió.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.slotResetView </term>
<listitem>
<para
>El mateix com si en el menú escollíssiu <menuchoice
><guimenu
>Visualitza</guimenu
><guimenuitem
>Restaura la vista</guimenuitem
></menuchoice
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.slotExport </term>
<listitem>
<para
>Obre el diàleg d'exportació.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.slotSettings </term>
<listitem>
<para
>Obre el diàleg d'arranjament.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.slotNames </term>
<listitem>
<para
>Mostra les funcions matemàtiques predefinides en el manual.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.findMinimumValue </term>
<listitem>
<para
>El mateix com si en el menú escollíssiu <menuchoice
><guimenu
>Eines</guimenu
><guimenuitem
>Valor mínim...</guimenuitem
></menuchoice
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.findMaximumValue </term>
<listitem>
<para
>El mateix com si en el menú escollíssiu <menuchoice
><guimenu
>Eines</guimenu
><guimenuitem
>Valor màxim...</guimenuitem
></menuchoice
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.graphArea </term>
<listitem>
<para
>El mateix com si en el menú escollíssiu <menuchoice
><guimenu
>Eines</guimenu
><guimenuitem
>Dibuixa una àrea</guimenuitem
></menuchoice
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/maindlg org.kde.kmplot.MainDlg.calculator </term>
<listitem>
<para
>El mateix com si en el menú escollíssiu <menuchoice
><guimenu
>Eines</guimenu
><guimenuitem
>Calculadora</guimenuitem
></menuchoice
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.addFunction f_str0 f_fstr1 </term>
<listitem>
<para
>Afegeix una nova funció amb les expressions <parameter
>f_str0</parameter
> i <parameter
>f_str1</parameter
>. Si l'expressió no conté un nom de funció, es generarà automàticament. Es retornarà el número d'identificació de la nova funció, o -1 si la funció no pot ser definida.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.removeFunction id </term>
<listitem>
<para
>Elimina la funció amb el número d'identificació <parameter
>id</parameter
>. Si la funció no pot ser eliminada, es retornarà «false» (fals), «true» (vertader) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionExpression id eq f_str </term>
<listitem>
<para
>Estableix l'expressió per a la funció amb el número d'identificació <parameter
>id</parameter
> a <parameter
>f_str</parameter
>. Retornarà «false» (fals), «true» (vertader) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.countFunctions </term>
<listitem>
<para
>Retorna el nombre de funcions (les funcions paramètriques es calculen com dos).</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
>Retorna una llista amb totes les funcions.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.fnameToID f_str </term>
<listitem>
<para
>Retorna el número d'identificació de <parameter
>f_str</parameter
> o -1 si el nom de la funció <parameter
>f_str</parameter
> no s'ha trobat.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionFVisible id </term>
<listitem>
<para
>Retorna «true» (vertader) si la funció amb l'identificador <parameter
>id</parameter
> és visible, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionF1Visible id </term>
<listitem>
<para
>Retorna «true» (vertader) si la primera derivada de la funció amb l'identificador <parameter
>id</parameter
> és visible, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionF2Visible id </term>
<listitem>
<para
>Retorna «true» (vertader) si la segona derivada de la funció amb l'identificador <parameter
>id</parameter
> és visible, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionIntVisible id </term>
<listitem>
<para
>Retorna «true» (vertader) si la integral de la funció amb l'identificador <parameter
>id</parameter
> és visible, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionFVisible id visible </term>
<listitem>
<para
>Mostra la funció amb l'identificador <parameter
>id</parameter
> si és <parameter
>visible</parameter
> és «true» (vertader). Si <parameter
>visible</parameter
> és «false» (fals), la funció restarà oculta. Es retornarà «true» (vertader) si la funció existeix, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionF1Visible id visible </term>
<listitem>
<para
>Mostra la primera derivada de la funció amb l'identificador <parameter
>id</parameter
> si <parameter
>visible</parameter
> és «true» (vertader). Si <parameter
>visible</parameter
> és «false» (fals), la funció restarà oculta. Es retornarà «true» (vertader) si la funció existeix, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionF2Visible id visible </term>
<listitem>
<para
>Mostra la segona derivada de la funció amb l'identificador <parameter
>id</parameter
> si <parameter
>visible</parameter
> és «true» (vertader). Si <parameter
>visible</parameter
> és «false» (fals), la funció restarà oculta. Es retornarà «true» (vertader) si la funció existeix, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionIntVisible id visible </term>
<listitem>
<para
>Mostra la integral de la funció amb l'identificador <parameter
>id</parameter
> si és <parameter
>visible</parameter
> és «true» (vertader). Si <parameter
>visible</parameter
> és «false» (fals), la funció restarà oculta. Es retornarà «true» (vertader) si la funció existeix, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionStr id eq </term>
<listitem>
<para
>Retorna l'expressió de la funció de la funció amb l'identificador <parameter
>id</parameter
>. Si no existeix la funció, en el seu lloc es retornarà una cadena buida.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionFLineWidth id </term>
<listitem>
<para
>Retorna l'amplada de la línia de la funció amb l'identificador <parameter
>id</parameter
>. Si no existeix la funció, es retornarà 0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionF1LineWidth id </term>
<listitem>
<para
>Retorna l'amplada de la línia de la primera derivada de la funció amb l'identificador <parameter
>id</parameter
>. Si no existeix la funció, es retornarà 0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionF2LineWidth id </term>
<listitem>
<para
>Retorna l'amplada de la línia de la segona derivada de la funció amb l'identificador <parameter
>id</parameter
>. Si no existeix la funció, es retornarà 0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionIntLineWidth id </term>
<listitem>
<para
>Retorna l'amplada de la línia de la integral de la funció amb l'identificador <parameter
>id</parameter
>. Si no existeix la funció, es retornarà 0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionFLineWidth id amplada_línia </term>
<listitem>
<para
>Estableix l'amplada de la línia de la funció amb l'identificador <parameter
>id</parameter
> a <parameter
>amplada_línia</parameter
>. Es retornarà «true» (vertader) si la funció existeix, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionF1LineWidth id amplada_línia </term>
<listitem>
<para
>Estableix l'amplada de la línia de la primera derivada de la funció amb l'identificador <parameter
>id</parameter
> a <parameter
>amplada_línia</parameter
>. Es retornarà «true» (vertader) si la funció existeix, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionF2LineWidth id amplada_línia </term>
<listitem>
<para
>Estableix l'amplada de la línia de la segona derivada de la funció amb l'identificador <parameter
>id</parameter
> a <parameter
>amplada_línia</parameter
>. Es retornarà «true» (vertader) si la funció existeix, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionIntLineWidth id amplada_línia </term>
<listitem>
<para
>Estableix l'amplada de la línia de la integral de la funció amb l'identificador <parameter
>id</parameter
> a <parameter
>amplada_línia</parameter
>. Es retornarà «true» (vertader) si la funció existeix, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionParameterList id </term>
<listitem>
<para
>Retorna una llista amb tots els valors dels paràmetres de la funció amb l'identificador <parameter
>id</parameter
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionAddParameter id paràmetre_nou </term>
<listitem>
<para
>Afegeix el valor del paràmetre <parameter
>paràmetre_nou</parameter
> a la funció amb l'identificador <parameter
>id</parameter
>. Es retornarà «true» (vertader) si la funció existeix, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionRemoveParameter id elimina_paràmetre </term>
<listitem>
<para
>Elimina el valor del paràmetre <parameter
>elimina_paràmetre</parameter
> a la funció amb l'identificador <parameter
>id</parameter
>. Es retornarà «true» (vertader) si la funció existeix, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionMinValue id </term>
<listitem>
<para
>Retorna el valor mínim d'abast del gràfic de la funció amb l'identificador <parameter
>id</parameter
>. Si la funció no existeix o si el valor mínim no està definit, es retornarà una cadena buida.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionMaxValue id </term>
<listitem>
<para
>Retorna el valor màxim d'abast del gràfic de la funció amb l'identificador <parameter
>id</parameter
>. Si la funció no existeix o si el valor màxim no està definit, es retornarà una cadena buida.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionMinValue id mín </term>
<listitem>
<para
>Estableix el valor mínim d'abast del gràfic de la funció amb l'identificador <parameter
>id</parameter
> a <parameter
>mín</parameter
>. Es retornarà «true» (vertader) si la funció existeix i l'expressió és vàlida, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionMaxValue id màx </term>
<listitem>
<para
>Estableix el valor màxim d'abast del gràfic de la funció amb l'identificador <parameter
>id</parameter
> a <parameter
>màx</parameter
>. Es retornarà «true» (vertader) si la funció existeix i l'expressió és vàlida, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionStartXValue id </term>
<listitem>
<para
>Retorna el punt x inicial per a la integral de la funció amb l'identificador <parameter
>id</parameter
>. Si la funció no existeix o si expressió-punt-x no està definida, es retornarà una cadena buida.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.functionStartYValue id </term>
<listitem>
<para
>Retorna el punt y inicial per a la integral de la funció amb l'identificador <parameter
>id</parameter
>. Si la funció no existeix o si expressió-punt-y no està definida, es retornarà una cadena buida.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/parser org.kde.kmplot.Parser.setFunctionStartValue id x y </term>
<listitem>
<para
>Estableix el punt x i y inicial per a la integral de la funció amb l'identificador <parameter
>id</parameter
> a <parameter
>x</parameter
> i <parameter
>y</parameter
>. Es retornarà «true» (vertader) si la funció existeix i l'expressió és vàlida, «false» (fals) en cas contrari.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/view org.kde.kmplot.View.stopDrawing </term>
<listitem>
<para
>Si &kmplot; actualment està dibuixant una funció, el procediment s'aturarà.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>/view org.kde.kmplot.View.drawPlot </term>
<listitem>
<para
>Torna a dibuixar totes les funcions.</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:
-->
