Chapitre 7. Faire des scripts de KmPlot

Une nouvelle fonctionnalité apparue dans KDE 4.3 vous permet d'écrire des scripts pour KmPlot en utilisant D-Bus dans KDE 4. Par exemple, si vous souhaitez définir une nouvelle fonction f(x)=2sin x+3cos x, régler son épaisseur de ligne à 20 et le tracer, vous écrivez dans une console :

qdbus org.kde.kmplot-PID /parser org.kde.kmplot.Parser.addFunction "f(x)=2sin x+3cos x" "" En conséquence, le numéro ID de la nouvelle fonction sera retournée ou alors -1 s'il est impossible de définir la fonction.

qdbus org.kde.kmplot-PID /parser org.kde.kmplot.Parser.setFunctionFLineWidth ID 20 Cette commande définit la fonction avec le numéro ID de l'épaisseur de ligne à 20.

qdbus org.kde.kmplot-PID /view org.kde.kmplot.View.drawPlot Cette commande repeint la fenêtre de sorte que la fonction soit visible.

Une liste des fonctions disponibles :

/kmplot org.kde.kmplot.KmPlot.fileOpen url

Charge le fichier url.

/maindlg org.kde.kmplot.MainDlg.isModified

Renvoie vrai si aucun changement n'a eu lieu.

/maindlg org.kde.kmplot.MainDlg.checkModified

S'il y a des modifications non enregistrées, une boîte de dialogue apparaît pour enregistrer, abandonner ou annuler les tracés.

/maindlg org.kde.kmplot.MainDlg.editAxes

Ouvre la boîte de dialogue qui permet de modifier le système de coordonnées.

/maindlg org.kde.kmplot.MainDlg.toggleShowSlider

Affiche/cache la fenêtre de paramètre du curseur.

/maindlg org.kde.kmplot.MainDlg.slotSave

Enregistre les fonctions (ouvre la boîte de dialogue d'enregistrement si c'est un nouveau fichier).

/maindlg org.kde.kmplot.MainDlg.slotSaveas

Identique à FichierEnregistrer sous... du menu.

/maindlg org.kde.kmplot.MainDlg.slotPrint

Ouvre la boîte de dialogue d'impression.

/maindlg org.kde.kmplot.MainDlg.slotResetView

Identique à AffichageRemettre l'affichage à zéro du menu.

/maindlg org.kde.kmplot.MainDlg.slotExport

Ouvre la boîte dialogue d'export.

/maindlg org.kde.kmplot.MainDlg.slotSettings

Ouvre la boîte de dialogue des paramètres.

/maindlg org.kde.kmplot.MainDlg.slotNames

Affiche les fonctions mathématiques prédéfinies dans le manuel.

/maindlg org.kde.kmplot.MainDlg.findMinimumValue

Identique à OutilsValeur minimale... du menu.

/maindlg org.kde.kmplot.MainDlg.findMaximumValue

Identique à OutilsValeur maximale... du menu.

/maindlg org.kde.kmplot.MainDlg.graphArea

Identique à OutilsTracer l'aire du menu.

/maindlg org.kde.kmplot.MainDlg.calculator

Identique à OutilsCalculatrice du menu.

/parser org.kde.kmplot.Parser.addFunction f_str0 f_fstr1

Ajoute une nouvelle fonction avec les expressions f_str0 et f_str1. Si l'expression ne contient pas de nom de fonction, on lui en donnera un automatiquement. Le numéro ID de la nouvelle fonction sera renvoyé, ou -1 s'il est impossible de définir la fonction.

/parser org.kde.kmplot.Parser.removeFunction id

Supprime la fonction avec le numéro ID id. Si la fonction ne peut être supprimée, faux est renvoyé, sinon vrai.

/parser org.kde.kmplot.Parser.setFunctionExpression id eq f_str

Définit l'expression pour la fonction avec le numéro ID id comme f_str. Renvoie vrai si c'est réussi, sinon faux.

/parser org.kde.kmplot.Parser.countFunctions

Renvoie le nombre de fonctions (les fonctions paramétriques comptent pour deux).

/parser org.kde.kmplot.Parser.listFunctionNames

Renvoie une liste de toutes les fonctions.

/parser org.kde.kmplot.Parser.fnameToID f_str

Renvoie le numéro ID de f_str ou -1 s'il est impossible de trouver le nom de la fonction f_str.

/parser org.kde.kmplot.Parser.functionFVisible id

Renvoie vrai si la fonction avec l'ID id est visible, sinon faux.

/parser org.kde.kmplot.Parser.functionF1Visible id

Renvoie vrai si la dérivée de la fonction avec l'ID id est visible, sinon faux.

/parser org.kde.kmplot.Parser.functionF2Visible id

Renvoie vrai si la dérivée seconde de la fonction avec l'ID id est visible, sinon faux.

/parser org.kde.kmplot.Parser.functionIntVisible id

Renvoie vrai si la primitive de la fonction avec l'ID id est visible, sinon faux.

/parser org.kde.kmplot.Parser.setFunctionFVisible id visible

Affiche la fonction avec l'ID id si visible est vrai. Si visible est faux, la fonction sera cachée. Vrai est renvoyé si la fonction existe, sinon faux.

/parser org.kde.kmplot.Parser.setFunctionF1Visible id visible

Affiche la dérivée de la fonction avec l'ID id si visible est vrai. Si visible est faux, la fonction sera cachée. Vrai est renvoyé si la fonction existe, sinon faux.

/parser org.kde.kmplot.Parser.setFunctionF2Visible id visible

Affiche la dérivée seconde de la fonction avec l'ID id si visible est vrai. Si visible est faux, la fonction sera cachée. Vrai est renvoyé si la fonction existe, sinon faux.

/parser org.kde.kmplot.Parser.setFunctionIntVisible id visible

Affiche la primitive de la fonction avec l'ID id si visible est vrai. Si visible est faux, la fonction sera cachée. Vrai est renvoyé si la fonction existe, sinon faux.

/parser org.kde.kmplot.Parser.functionStr id eq

Renvoie l'expression de la fonction pour la fonction avec l'ID id. Si la fonction n'existe pas, une chaîne vide est alors renvoyée.

/parser org.kde.kmplot.Parser.functionFLineWidth id

Renvoie une épaisseur de ligne pour la fonction avec l'iD id . Si la fonction n'existe pas, 0 est renvoyé.

/parser org.kde.kmplot.Parser.functionF1LineWidth id

Renvoie l'épaisseur de ligne de la dérivée de la fonction avec l'ID id. Si la fonction n'existe pas, 0 est renvoyé.

/parser org.kde.kmplot.Parser.functionF2LineWidth id

Renvoie l'épaisseur de ligne de la dérivée seconde de la fonction avec l'ID id. Si la fonction n'existe pas, 0 est renvoyé.

/parser org.kde.kmplot.Parser.functionIntLineWidth id

Renvoie l'épaisseur de ligne de la primitive de la fonction avec l'ID id. Si la fonction n'existe pas, 0 est renvoyé.

/parser org.kde.kmplot.Parser.setFunctionFLineWidth id linewidth

Définit l'épaisseur de ligne de la fonction avec l'ID id comme linewidth. Vrai est renvoyé si la fonction existe, sinon faux.

/parser org.kde.kmplot.Parser.setFunctionF1LineWidth id linewidth

Définit l'épaisseur de ligne de la dérivée de la fonction avec l'ID id comme linewidth. Vrai est renvoyé si la fonction existe, sinon faux.

/parser org.kde.kmplot.Parser.setFunctionF2LineWidth id linewidth

Définit l'épaisseur de ligne de la dérivée seconde de la fonction avec l'ID id comme linewidth. Vrai est renvoyé si la fonction existe, sinon faux.

/parser org.kde.kmplot.Parser.setFunctionIntLineWidth id linewidth

Définit l'épaisseur de ligne de la primitive de la fonction avec l'ID id comme linewidth. Vrai est renvoyé si la fonction existe, sinon faux.

/parser org.kde.kmplot.Parser.functionParameterList id

Renvoie une liste avec toutes les valeurs des paramètres pour la fonction avec l'ID id.

/parser org.kde.kmplot.Parser.functionAddParameter id new_parameter

Ajoute la valeur de paramètre new_parameter à la fonction avec l'ID id. Vrai est renvoyé si l'opération a réussi, sinon faux.

/parser org.kde.kmplot.Parser.functionRemoveParameter id remove_parameter

Supprime la valeur de paramètre remove_parameter de la fonction avec l'ID id. Vrai est renvoyé si l'opération a réussi, sinon faux.

/parser org.kde.kmplot.Parser.functionMinValue id

Renvoie la valeur de la plage minimale de valeurs de la fonction avec l'ID id. Si la fonction n'existe pas ou si la valeur minimale n'est pas définie, une chaîne vide est renvoyée.

/parser org.kde.kmplot.Parser.functionMaxValue id

Renvoie la valeur de la plage maximale de valeurs de la fonction avec l'ID id. Si la fonction n'existe pas ou si la valeur maximale n'est pas définie, une chaîne vide est renvoyée.

/parser org.kde.kmplot.Parser.setFunctionMinValue id min

Définit la valeur de la plage minimale de valeurs de la fonction avec l'ID id à min. Vrai est renvoyé si la fonction existe et si l'expression est correct, sinon faux.

/parser org.kde.kmplot.Parser.setFunctionMaxValue id max

Définit la valeur de la plage maximale de valeurs de la fonction avec l'ID id à max. Vrai est renvoyé si la fonction existe et si l'expression est correcte, sinon faux.

/parser org.kde.kmplot.Parser.functionStartXValue id

Renvoie le premier point x pour la primitive de la fonction avec l'ID id. Si la fonction n'existe pas ou si l'expression x-point n'est pas définie, une chaîne vide est renvoyée.

/parser org.kde.kmplot.Parser.functionStartYValue id

Renvoie le premier point y pour la primitive de la fonction avec l'ID id. Si la fonction n'existe pas ou si l'expression y-point n'est pas définie, une chaîne vide est renvoyée.

/parser org.kde.kmplot.Parser.setFunctionStartValue id x y

Définit les points initiaux x et y pour la primitive de la fonction avec l'ID id comme x et y. Vrai est renvoyé si la fonction existe et si l'expression est correcte, sinon faux.

/view org.kde.kmplot.View.stopDrawing

Si KmPlot trace actuellement une fonction, la procédure s'arrêtera.

/view org.kde.kmplot.View.drawPlot

Retrace toutes les fonctions.