<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: -->