Code-Bausteine

SMath Studio bietet einen eingebauten Mechanismus, um den Funktionsumfang durch eigene Code-Bausteine zu erweitern. Solche Code-Bausteine entstehen aus gewöhnlichen Berechnungen und werden bei Bedarf in andere Berechnungen eingebettet. So können Benutzer einmal vorbereitete Logik beliebig oft wiederverwenden.

Code-Baustein erstellen

Ein Code-Baustein basiert auf einer gewöhnlichen, in SMath Studio vorbereiteten Berechnung. Um einen solchen Code-Baustein zu erstellen, gehen Sie wie folgt vor:

1. Legen Sie in SMath Studio eine neue Berechnung an.
2. Fügen Sie in der angelegten Berechnung eine eigene Funktion oder Prozedur hinzu und definieren Sie die nötigen Variablen oder Maßeinheiten, auf die Sie Zugriff geben möchten.
3. Wenn die Berechnung mit Logik gefüllt ist, legen Sie ihre Metainformationen fest. Öffnen Sie dazu den Dialog Datei > Eigenschaften....
4. Füllen Sie auf der Registerkarte Summary des Dialogs File Properties mindestens die Felder Title, Author und Description aus.
5. Legen Sie auf der Registerkarte File Settings des Dialogs File Properties das Feld Snippet Shortcut fest; damit fügen Sie den Baustein später schnell in Berechnungen ein. Wir empfehlen einen eindeutigen, kurzen Text ohne Leerzeichen und Sonderzeichen. Als Beispiel dienen die in SMath Studio eingebauten Code-Bausteine wie grads und degrees.
6. Speichern Sie die fertige Berechnung lokal und verschieben Sie sie in folgenden Ordner auf Ihrem PC: %APPDATA%\SMath\extensions\snippets

Nach diesen Schritten steht der Code-Baustein zur lokalen Nutzung bereit.

Code-Baustein verwenden

Es gibt zwei Wege, verfügbare Code-Bausteine in eine Berechnung einzufügen:

1. Über die Liste der Dynamischen Hilfe: Beginnen Sie auf dem Blatt, das Kürzel des Code-Bausteins zu schreiben, und wählen Sie den gewünschten in der Auswahlliste (die endgültige Auswahl treffen Sie mit der Maus oder anhand der Hinweise mit der Tastatur):
2. Über die in SMath Studio eingebaute Erweiterungs-Verwaltung. Wählen Sie im geöffneten Dialogfeld in der Liste links Code-Bausteine, um alle lokal verfügbaren Code-Bausteine anzuzeigen. Wählen Sie dann den gewünschten Code-Baustein und klicken Sie auf die Schaltfläche Paste.

Code-Baustein veröffentlichen

Die Veröffentlichung Ihres Code-Bausteins auf dem Root-Lizenzserver zur freien Nutzung durch Dritte ist optional.

Damit Ihr Code-Baustein Teil des Standardverfahrens zur Auslieferung an andere Benutzer wird, gehen Sie wie folgt vor:

1. Öffnen Sie den Root-Lizenzserver und vergewissern Sie sich, dass Sie mit Ihrem Konto angemeldet sind.
2. Öffnen Sie die Seite zur Registrierung von Erweiterungen.
3. Wählen Sie im Registrierungsformular unter Extension type den Wert Snippet, geben Sie den Pfad zur Datei des Code-Bausteins an und klicken Sie auf die Schaltfläche Register.