<chapter id="dcop">
	<title
>Script per &kmplot;</title>
	<para
>Una nuova funzionalità in KDE 3.4 è la possibilità di preparare degli script per &kmplot; con DBus per &kde; 4. Per esempio, se vuoi definire una nuova funzione <userinput
>f(x)=2sin x+3cos x</userinput
>, fissare lo spessore della linea uguale a 20 e disegnarla, puoi scrivere da console:</para>
	<para
><command
>qdbus org.kde.kmplot-PID /parser org.kde.kmplot.Parser.addFunction "f(x)=2sin x+3cos x" ""</command
>. Come risultato verrà reso il numero ID della nuova funzione o "-1", se la funzione non può essere definita.</para>
	<para
><command
>qdbus org.kde.kmplot-PID /parser org.kde.kmplot.Parser.setFunctionFLineWidth ID 20</command
>. Questo comando imposta uguale a 20 lo spessore della linea con cui verrà disegnata la funzione con numero identificativo ID.</para>
	<para
><command
>qdbus org.kde.kmplot-PID /view org.kde.kmplot.View.drawPlot</command
>. Questo comando aggiorna la finestra per rendere visibile la funzione.</para>
<para
>Un elenco di funzioni disponibili: <variablelist>
		<varlistentry>
			<term
>/kmplot org.kde.kmplot.KmPlot.fileOpen url </term>
			<listitem>
				<para
>Carica il file <parameter
>url</parameter
>.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.isModified </term>
			<listitem>
				<para
>Restituisce vero se sono stati effettuati cambiamenti.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.checkModified </term>
			<listitem>
				<para
>Se ci fossero dei cambiamenti non ancora salvati, verrebbe aperta una finestra per salvarli, scartarli o cancellare i grafici.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.editAxes </term>
			<listitem>
				<para
>Apre la finestra di dialogo per modificare le coordinate.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.toggleShowSlider </term>
			<listitem>
				<para
>Mostra/nasconde la finestra del regolatore.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotSave </term>
			<listitem>
				<para
>Salva le funzioni (apre l'apposita finestra per salvarle in un nuovo file).</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotSaveas </term>
			<listitem>
				<para
>Ha lo stesso effetto della scelta di <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Salva come</guimenuitem
></menuchoice
> nel menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotPrint </term>
			<listitem>
				<para
>Apre la finestra di dialogo per la stampa.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotResetView </term>
			<listitem>
				<para
>Ha lo stesso effetto della scelta di <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Azzera vista</guimenuitem
></menuchoice
> nel menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotExport </term>
			<listitem>
				<para
>Apre la finestra di dialogo per esportare.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotSettings </term>
			<listitem>
				<para
>Apre la finestra di dialogo per le impostazioni.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.slotNames </term>
			<listitem>
				<para
>Mostra la pagina del manuale con le funzioni matematiche predefinite.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.findMinimumValue </term>
			<listitem>
				<para
>Ha lo stesso effetto della scelta di <menuchoice
><guimenu
>Strumenti</guimenu
><guimenuitem
>Valore minimo...</guimenuitem
></menuchoice
> nel menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.findMaximumValue </term>
			<listitem>
				<para
>Ha lo stesso effetto della scelta di <menuchoice
><guimenu
>Strumenti</guimenu
><guimenuitem
>Valore massimo...</guimenuitem
></menuchoice
> nel menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.graphArea </term>
			<listitem>
				<para
>Ha lo stesso effetto della scelta di <menuchoice
><guimenu
>Strumenti</guimenu
><guimenuitem
>Area del grafico</guimenuitem
></menuchoice
> nel menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/maindlg org.kde.kmplot.MainDlg.calculator </term>
			<listitem>
				<para
>Ha lo stesso effetto della scelta di <menuchoice
><guimenu
>Strumenti</guimenu
><guimenuitem
>Calcolatrice</guimenuitem
></menuchoice
> nel menu.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/parser org.kde.kmplot.Parser.addFunction f_str0 f_fstr1 </term>
			<listitem>
				<para
>Aggiunge una nuova funzione definita da <parameter
>f_str</parameter
> e <parameter
>f_str1</parameter
>. Se l'espressione non contiene il nome della funzione, questo sarà attribuito automaticamente. Come risultato verrà reso il numero ID della nuova funzione o "-1", se la funzione non può essere definita.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/parser org.kde.kmplot.Parser.removeFunction id </term>
			<listitem>
				<para
>Rimuove la funzione identificata dal numero <parameter
>id</parameter
>. Se la funzione non può essere cancellata, viene restituito il valore "false", altrimenti "true".</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/parser org.kde.kmplot.Parser.setFunctionExpression id eq f_str </term>
			<listitem>
				<para
>Modifica in <parameter
>f_str</parameter
> l'espressione che definisce la funzione identificata dal numero <parameter
>id</parameter
>. Ritorna "true" se l'operazione riesce, "false" in caso contrario.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/parser org.kde.kmplot.Parser.countFunctions </term>
			<listitem>
				<para
>Restituisce il numero di funzioni (quelle parametriche contano per due).</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
>Restituisce un elenco di tutte le funzioni.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.fnameToID f_str </term>
		  <listitem>
		    <para
>Restituisce il numero identificativo della funzione <parameter
>f_str</parameter
> o "-1" se a quel nome non corrisponde nessuna funzione.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionFVisible id </term>
		  <listitem>
		    <para
>Restituisce "true" se la funzione con identificativo <parameter
>id</parameter
> è visibile, altrimenti restituisce "false".</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionF1Visible id </term>
		  <listitem>
		    <para
>Restituisce "true" se la derivata prima della funzione con identificativo <parameter
>id</parameter
> è visibile, altrimenti restituisce "false".</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionF2Visible id </term>
		  <listitem>
		    <para
>Restituisce "true" se la derivata seconda della funzione con identificativo <parameter
>id</parameter
> è visibile, altrimenti restituisce "false".</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionIntVisible id </term>
		  <listitem>
		    <para
>Restituisce "true" se l'integrale della funzione con identificativo <parameter
>id</parameter
> è visibile, altrimenti restituisce "false".</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionFVisible id visible </term>
		  <listitem>
		    <para
>Se <parameter
>visible</parameter
> è "true" viene mostrata la funzione con numero identificativo <parameter
>id</parameter
>. Se, invece, <parameter
>visible</parameter
> è "false", la funzione sarà nascosta. Verrà ritornato il valore "true" o "false" a seconda se la funzione esiste o no.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionF1Visible id visible </term>
		  <listitem>
		    <para
>Se <parameter
>visible</parameter
> è "true" viene mostrata la derivata prima della funzione con numero identificativo <parameter
>id</parameter
>. Se, invece, <parameter
>visible</parameter
> è "false", la funzione sarà nascosta. Verrà ritornato il valore "true" o "false" a seconda se la funzione esiste o no.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionF2Visible id visible </term>
		  <listitem>
		    <para
>Se <parameter
>visible</parameter
> è "true" viene mostrata la derivata seconda della funzione con numero identificativo <parameter
>id</parameter
>. Se, invece, <parameter
>visible</parameter
> è "false", la funzione sarà nascosta. Verrà ritornato il valore "true" o "false" a seconda se la funzione esiste o no.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionIntVisible id visible </term>
		  <listitem>
		    <para
>Se <parameter
>visible</parameter
> è "true" viene mostrato l'integrale della funzione con numero identificativo <parameter
>id</parameter
>. Se, invece, <parameter
>visible</parameter
> è "false", la funzione verrà nascosta. Verrà ritornato il valore "true" o "false" a seconda se la funzione esiste o no.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionStr id eq </term>
		  <listitem>
		    <para
>Restituisce l'espressione che definisce la funzione identificata da <parameter
>id</parameter
>. Se la funzione non esiste, verrà restituita una stringa vuota.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionFLineWidth id </term>
		  <listitem>
		    <para
>Restituisce lo spessore della linea con cui è tracciata la funzione identificata da <parameter
>id</parameter
>. Se la funzione non esiste, viene ritornato il valore 0.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionF1LineWidth id </term>
		  <listitem>
		    <para
>Restituisce lo spessore della linea con cui è tracciata la derivata prima della funzione identificata da <parameter
>id</parameter
>. Se la funzione non esiste, viene ritornato il valore 0.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionF2LineWidth id </term>
		  <listitem>
		    <para
>Restituisce lo spessore della linea con cui è tracciata la derivata prima della funzione identificata da <parameter
>id</parameter
>. Se la funzione non esiste, viene ritornato il valore 0.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionIntLineWidth id </term>
		  <listitem>
		    <para
>Restituisce lo spessore della linea con cui è tracciato l'integrale della funzione identificata da <parameter
>id</parameter
>. Se la funzione non esiste, viene ritornato il valore 0.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionFLineWidth id linewidth </term>
		  <listitem>
		    <para
>Utilizza <parameter
>linewidth</parameter
> come spessore della linea con cui viene tracciato il grafico della funzione identificata da <parameter
>id</parameter
>. Verrà ritornato il valore "true" o "false" a seconda se la funzione esiste o no.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionF1LineWidth id linewidth </term>
		  <listitem>
		    <para
>Utilizza <parameter
>linewidth</parameter
> come spessore della linea con cui viene tracciato il grafico della derivata prima della funzione identificata da <parameter
>id</parameter
>. Verrà ritornato il valore "true" o "false" a seconda se la funzione esiste o no.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionF2LineWidth id linewidth </term>
		  <listitem>
		    <para
>Utilizza <parameter
>linewidth</parameter
> come spessore della linea con cui viene tracciato il grafico della derivata seconda della funzione identificata da <parameter
>id</parameter
>. Verrà ritornato il valore "true" o "false" a seconda se la funzione esiste o no.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionIntLineWidth id linewidth </term>
		  <listitem>
		    <para
>Utilizza <parameter
>linewidth</parameter
> come spessore della linea con cui viene tracciato il grafico dell'integrale della funzione identificata da <parameter
>id</parameter
>. Verrà ritornato il valore "true" o "false" a seconda se la funzione esiste o no.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionParameterList id </term>
		  <listitem>
		    <para
>Restituisce l'elenco di tutti i valori dei parametri impostati per la funzione identificata da <parameter
>id</parameter
>.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionAddParameter id new_parameter </term>
		  <listitem>
		    <para
>Aggiunge il valore parametrico <parameter
>new_parameter</parameter
> alla funzione identificata da <parameter
>id</parameter
>. Verrà ritornato il valore "true" o "false" a seconda se l'operazione riesce o no.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionRemoveParameter id remove_parameter </term>
		  <listitem>
		    <para
>Rimuove il valore parametrico <parameter
>remove_parameter</parameter
> dalla funzione identificata da <parameter
>id</parameter
>. Verrà ritornato il valore "true" o "false" a seconda se l'operazione riesce o no.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionMinValue id </term>
		  <listitem>
		    <para
>Restituisce l'estremo inferiore dell'intervallo in cui è rappresentata la funzione individuata dall'identificativo <parameter
>id</parameter
>. Se la funzione non esiste o se il minimo non è definito, viene ritornata una stringa vuota.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionMaxValue id </term>
		  <listitem>
		    <para
>Restituisce l'estremo superiore dell'intervallo in cui è rappresentata la funzione individuata dall'identificativo <parameter
>id</parameter
>. Se la funzione non esiste o se il massimo non è definito, viene ritornata una stringa vuota.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionMinValue id min </term>
		  <listitem>
		    <para
>Imposta a <parameter
>min</parameter
> l'estremo inferiore dell'intervallo in cui è rappresentata la funzione identificata da <parameter
>id</parameter
>. Se la funzione esiste e se l'espressione è valida, verrà ritornato il valore "true". Altrimenti, "false".</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionMaxValue id max </term>
		  <listitem>
		    <para
>Imposta a <parameter
>max</parameter
> l'estremo superiore dell'intervallo in cui è rappresentata la funzione identificata da <parameter
>id</parameter
>. Se la funzione esiste e se l'espressione è valida, verrà ritornato il valore "true". Altrimenti, "false".</para>
		  </listitem>
		</varlistentry>
		
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionStartXValue id </term>
		  <listitem>
		    <para
>Restituisce il valore iniziale della x per l'integrale della funzione identificata dall'ID <parameter
>id</parameter
>. Se la funzione non esiste o se l'espressione per il punto x non è definita, viene ritornata una stringa vuota.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.functionStartYValue id </term>
		  <listitem>
		    <para
>Restituisce il valore iniziale della x per l'integrale della funzione identificata dall'ID <parameter
>id</parameter
>. Se la funzione non esiste o se l'espressione per il punto y non è definita, viene ritornata una stringa vuota.</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term
>/parser org.kde.kmplot.Parser.setFunctionStartValue id x y </term>
		  <listitem>
		    <para
>Imposta come <parameter
>x</parameter
> e <parameter
>y</parameter
> il punto e il valore iniziale per l'integrale della funzione identificata da <parameter
>id</parameter
>. Se la funzione esiste e se l'espressione è valida, viene restituito "true". Altrimenti, "false".</para>
		  </listitem>
		</varlistentry>
		<varlistentry>
			<term
>/view org.kde.kmplot.View.stopDrawing </term>
			<listitem>
				<para
>Se &kmplot; sta disegnando una funzione, il processo viene fermato.</para>
			</listitem>
		</varlistentry>
		<varlistentry>
			<term
>/view org.kde.kmplot.View.drawPlot </term>
			<listitem>
				<para
>Ridisegna tutte le funzioni.</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:
    -->
