DBOX2-Modul

Aus TuxBoxWIKI
Wechseln zu: Navigation, Suche


Allgemeines

Um nicht zu viel zu sagen: Ein Plugin ist eine Erweiterung zu einem vorhandeneb Programm und hat folgende Attribute:

  • Erweiterung
  • dynamisch ladbar/entladbar
  • Plugins können/werden unabhängig vom Ladeprogramm (Hauptprogramm) produziert bzw. werden
  • Plugins sind abhängig vom Hauptprogramm
  • durch bestimmte bereitgestellte Funktionen (Schnittstellen) können Plugins untereinander kommunizieren


Plugins können durch bestimmte Mechanismen in das Programm eingebunden (verbunden) werden (auch als linken bezeichnet).


Bevor ein Plugin (wie oben schon erwähnt) eingebunden werden kann, wird durch bestimmte Mechanismen versucht alle nicht gebundenen (nicht gelinkten) Symbole zu binden.
Bei Unix-System haben Module/Plugins oftmals die Erweiterung so (shared object) und bei Windows dll. Beide Systeme können Plugins dynamisch laden und entladen. Es gibt kein einheitliches Aussehen eines Plugins, Eintrittspunkt, Funktionen die bei bestimmten Events aufgerufen werden, sind oftmals in den Programmen nicht gleich. Fehler die in Plugins vorkommen, können zu Abstürzen führen (Programm, OS)


Die Implementation eines Plugins

Die Implementation eines Plugins sollte erst nach der ausführlichen Planung kommen. Die Planung beschreibt das Aussehen des Plugins, bzw. die verwendeten Funktionen und deren späteren Programmierung. Während dieser Phase sollten alle wichtigen Eigenschaften des Hostes Hauptprogramm eingeholt bzw. berücksichtigt werden. Fehlerhafte Planungen können spätere Fehler in den Programmen bedeuten.


Interface eines Modules

Jedes Programm, das erweiterbar ist, benutzt eine andere Schnittstelle (oder mehrere), auch als Interface bezeichnet. Es gibt nur wenige Standards, z.B. VST (Musikbranche). Man sollte mit diesen Schnittstellen arbeiten, um einen Ablauf ohne Fehler zu garantieren.


Ein Plugin

(ergänzen bzw. ändern) Ein C-Programm hat einen Eintrittspunkt und zwar main. Main ist sozusagen die Hauptfunktion eines C-Programmes. Jedes mal, wenn Sie ein Programm aufrufen das in C geschrieben wurde, dann wird diese Funktion aufgerufen. Wenn Sie die Funktion beenden, wird auch das Programm beendet. Der Unterschied zu Plugins dabei ist, dass diese meistens keine Hauptfunktion haben, sondern nur Funktionen die bei bestimmten Abläufen aufgerufen werden. Stellen Sie sich das Plugin als ein Stecker vor, diesen stecken Sie in die Buchse, dabei verbinden Sie die Kontakte der Buchse mit dem Stecker und es besteht eine Verbindung, bei Plugins ist das genauso. Stecker ist das Plugin und die Buchse die Schnittstellen. Bei der DBox2 hat ein Plugin eine Methode/Funktion die vom Lader aufgerufen wird, wenn Sie es laden. Diese Funktion heißt plugin_exec. Der Funktion wird zusätzlich ein Argument übergeben und zwar eine Struktur: Sie ist vom Typ _PluginParam. Eine Struktur hat mehrere Felder, die Sie während des Programmierens/Laufzeit ansprechen können.


Die Struktur PluginParam hat folgende Elemente:

  • id:
ist ein Character-Pointer und wird verwendet, um den Wert in val zu identifizieren.
  • val:
ist ein Characterpointer. val beinhaltet den Wert. Er kann z.B. ein FD (File Descriptor, Handles) für eine Datei, z.B. lcd oder fb (frame buffer). Achtung, bevor Sie den Character-Pointer verwenden können, müssen Sie ihn in ein Integer umwandeln.
  • next:
next ist vom Typ PluginParam. Er kann weitere der oben genannten Informationen enthalten


Die DBox2 bietet folgende Interfaces

FX2

FX2 (nach dem Author) ist eine Bibliothek (Library, kurz. lib, deshalb wird diese Bibliothek auch als libfx2 genannt) mit der Sie graphische Operationen durchführen können. Ein weiteres Feature der Library sind die Remote-Control-Operationen.

Folgende graphische Operationen werden verwendet:

  • Zeichnen von horizontalen und vertikalen Linien
  • Zeichnen von Buchstaben
  • Verschieben von Bildinhalten
  • Kopieren von Bildinhalten
  • Zeichnen von ungefüllten und gefüllten Rechtecken
  • Pixel-Operationen


Enigma-Widgets


Stop hand.png An dieser Stelle muss noch Text rein.


Kernel


Stop hand.png An dieser Stelle muss noch Text rein.

Wie erstelle ich denn nun Plugins ?


Stop hand.png An dieser Stelle muss noch Text rein.

VT


Stop hand.png An dieser Stelle muss noch Text rein.

LIBFX2


Stop hand.png An dieser Stelle muss noch Text rein.
==Enigma==
Stop hand.png An dieser Stelle muss noch Text rein.

Review-KandidatDieser Artikel befindet sich derzeit im Reviewprozess. Hilf mit, ihn zu verbessern! Falls du bei weiteren Artikeln helfen willst, findest du hier eine Auswahl offener Artikel.