DBOX2-Modul - Versionsgeschichte

WikiBot: Bot: Fixing redirects

2011-08-24T09:00:17Z

Bot: Fixing redirects

Neue Seite

[[Category:Register]]
__TOC__

{{DoppelterArtikel|Plugins:Tutorial}}

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

* Erweiterung
* dynamisch ladbar/entladbar
* Plugins können/werden unabhängig vom Ladeprogramm (Hauptprogramm) produziert
* 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.<br>
Bei [[Unix]]-System haben Module/Plugins oftmals die Erweiterung '''so''' (shared object) und bei Windows '''dll''' (dynamic linked library).
Beide Systeme können Plugins dynamisch laden und entladen. Es gibt kein einheitliches Aussehen eines Plugins. Eintrittspunkte, 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 Implementierung eines Plugins=
Die Implementierung eines Plugins sollte erst nach einer 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 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 man ein Programm aufrufen, das in C geschrieben wurde, dann wird diese Funktion aufgerufen. Wenn man 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 Events gerufen werden. Stellt man sich das Plugin als einen Stecker vor, den man in eine Buchse steckt, dann verbindet man dabei die Kontakte der Buchse mit dem Stecker und es besteht eine Verbindung. Bei Plugins ist das genauso, der Stecker ist dabei sozusagen das Plugin und die Buchse die Schnittstelle.
Bei der [[Hardware:dbox2|DBox2]] hat ein Plugin eine Methode/Funktion die vom Lader aufgerufen wird, wenn man es lädt. 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 man während des Programmierens/Laufzeit ansprechen kann.

Die Struktur PluginParam hat folgende Elemente:
*id:
:ist ein Character-Pointer und wird verwendet, um den Wert in val zu identifizieren.

*val:
:ist ein Character-Pointer. val beinhaltet den Wert. Er kann z.B. ein FD (File Descriptor, Handles) für eine Datei, z.B. lcd oder fb (frame buffer) sein. Achtung, bevor man den Character-Pointer verwenden kann, muss man 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 man graphische Operationen durchführen können. Ein weiteres Feature der
Library sind 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==
Enigma bietet [[Widget|Widgets]] für Programme an.

{{missingText}}

==Kernel==
Module können genauso auf Schnittstellen zugreifen, wie andere Programme.
Sie sind also nicht auf die bereitgestellten Funktionen des Hauptprogrammes eingeschränkt.

=Wie erstellt man denn nun Plugins ? (Aufbauhase)=
''Der Absatz befindet sich noch im Aufbau, bitte verwenden Sie [[Plugins:Tutorial]], statt diesem Abschnitt.''

Voraussetzung für dieses Tutorial sollten Kentnisse in C/C++ sein. Ein CDK, welches funktioniert, ist klar.

==VT==
Als erstes fangen wir mit den Grundlagen an. Der nachfolgende Code gibt lediglich eine Hallo-Welt! Message aus.

=== Der Quelltext===
#include <stdio.h>
#include <plugin.h>

plugin_exec (PluginParam * strc)
{
printf ("Hallo-Welt!");
return 0;
}

===Aufbau des Quelltextes ===
In Zeile 4 implementieren wir die Funktion plugin_exec.
In dieser Funktion wird mittels printf ein String "Hallo-Welt!" ausgegeben. In Zeile 6 wird die Funktion beendet und das Plugin wird entladen.

{{missingText}}

TODO: Erstellung einer Makefile.am, Modifizieren der Makefile.am bzw. configure.ac.

TODO: Testen

== LIBFX2 ==
Als nächstes widmen wir uns der LIBFX2. Mit ihr wollen wir ein Beispielprogramm erzeugen, das lediglich eine horizontale Linie
mit einem Rechteck darunter und einer vertikalen Line daneben (mittels FB) ausgibt.

{{missingText}}

==Enigma==
{{missingText}}

{{review}}

{{body}}

Mash4077: Typos

2005-06-30T16:26:27Z

Typos

← Nächstältere Version		Version vom 30. Juni 2005, 18:26 Uhr
Zeile 34:		Zeile 34:
	=Ein Plugin=		=Ein Plugin=
	'''(ergänzen bzw. ändern)'''		'''(ergänzen bzw. ändern)'''
	Ein C-Programm hat einen Eintrittspunkt und zwar main. Main ist sozusagen die Hauptfunktion eines C-Programmes. Jedes mal wenn man ein Programm aufrufen, das in C geschrieben wurde, dann wird diese Funktion aufgerufen. Wenn man 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 Events gerufen werden. Stellt man sich das Plugin als einen Stecker vor, den man in eine Buchse steckt, dann verbindet man dabei die Kontakte der Buchse mit dem Stecker und es besteht eine Verbindung~~, bei~~ Plugins ist das genauso~~. Der~~ Stecker ist dabei sozusagen das Plugin und die Buchse die Schnittstelle.		Ein C-Programm hat einen Eintrittspunkt und zwar main. Main ist sozusagen die Hauptfunktion eines C-Programmes. Jedes mal wenn man ein Programm aufrufen, das in C geschrieben wurde, dann wird diese Funktion aufgerufen. Wenn man 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 Events gerufen werden. Stellt man sich das Plugin als einen Stecker vor, den man in eine Buchse steckt, dann verbindet man dabei die Kontakte der Buchse mit dem Stecker und es besteht eine Verbindung. Bei Plugins ist das genauso, der Stecker ist dabei sozusagen das Plugin und die Buchse die Schnittstelle.
	Bei der [[DBox2]] hat ein Plugin eine Methode/Funktion die vom Lader aufgerufen wird, wenn man es lädt. Diese Funktion heißt plugin_exec.		Bei der [[DBox2]] hat ein Plugin eine Methode/Funktion die vom Lader aufgerufen wird, wenn man es lädt. Diese Funktion heißt plugin_exec.
	Der Funktion wird zusätzlich ein Argument übergeben, und zwar eine Struktur: Sie ist vom Typ _PluginParam.		Der Funktion wird zusätzlich ein Argument übergeben, und zwar eine Struktur: Sie ist vom Typ _PluginParam.
Zeile 112:		Zeile 112:

	== LIBFX2 ==		== LIBFX2 ==
	Als nächstes widmen wir uns der LIBFX2. Mit ihr wollen wir ein Beispielprogramm erzeugen, das lediglich eine horizontale ~~Line~~		Als nächstes widmen wir uns der LIBFX2. Mit ihr wollen wir ein Beispielprogramm erzeugen, das lediglich eine horizontale Linie
	mit einem Rechteck darunter und einer vertikalen Line daneben (mittels FB) ausgibt.		mit einem Rechteck darunter und einer vertikalen Line daneben (mittels FB) ausgibt.

Mash4077: Typos, Links, Konventionen

2005-06-30T16:23:07Z

Typos, Links, Konventionen

Neue Seite

[[Category:Register]]
__TOC__

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

* Erweiterung
* dynamisch ladbar/entladbar
* Plugins können/werden unabhängig vom Ladeprogramm (Hauptprogramm) produziert
* 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.<br>
Bei [[Unix]]-System haben Module/Plugins oftmals die Erweiterung '''so''' (shared object) und bei Windows '''dll''' (dynamic linked library).
Beide Systeme können Plugins dynamisch laden und entladen. Es gibt kein einheitliches Aussehen eines Plugins. Eintrittspunkte, 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 Implementierung eines Plugins=
Die Implementierung eines Plugins sollte erst nach einer 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 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 man ein Programm aufrufen, das in C geschrieben wurde, dann wird diese Funktion aufgerufen. Wenn man 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 Events gerufen werden. Stellt man sich das Plugin als einen Stecker vor, den man in eine Buchse steckt, dann verbindet man dabei die Kontakte der Buchse mit dem Stecker und es besteht eine Verbindung, bei Plugins ist das genauso. Der Stecker ist dabei sozusagen das Plugin und die Buchse die Schnittstelle.
Bei der [[DBox2]] hat ein Plugin eine Methode/Funktion die vom Lader aufgerufen wird, wenn man es lädt. 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 man während des Programmierens/Laufzeit ansprechen kann.

Die Struktur PluginParam hat folgende Elemente:
*id:
:ist ein Character-Pointer und wird verwendet, um den Wert in val zu identifizieren.

*val:
:ist ein Character-Pointer. val beinhaltet den Wert. Er kann z.B. ein FD (File Descriptor, Handles) für eine Datei, z.B. lcd oder fb (frame buffer) sein. Achtung, bevor man den Character-Pointer verwenden kann, muss man 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 man graphische Operationen durchführen können. Ein weiteres Feature der
Library sind 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==
Enigma bietet Widgets für Programme an. Das ist der Unterschied zu anderen GUI, wie z.B. Neutrino/LCARS.
Widgets:

* Listbox
* Button

{{missingText}}

==Kernel==
Module können genauso auf Schnittstellen zugreifen, wie andere Programme.
Sie sind also nicht auf die bereitgestellten Funktionen des Hauptprogrammes eingeschränkt.

=Wie erstellt man denn nun Plugins ?=
Voraussetzung für dieses Tutorial sollten Kentnisse in C/C++ sein. Ein CDK, welches funktioniert, ist klar.

==VT==
Als erstes fangen wir mit den Grundlagen an. Der nachfolgende Code gibt lediglich eine Hallo-Welt! Message aus.

=== Der Quelltext===
#include <stdio.h>
#include <plugin.h>

plugin_exec (PluginParam * strc)
{
printf ("Hallo-Welt!");
return 0;
}

===Aufbau des Quelltextes ===
In Zeile 4 implementieren wir die Funktion plugin_exec.
In dieser Funktion wird mittels printf ein String "Hallo-Welt!" ausgegeben. In Zeile 6 wird die Funktion beendet und das Plugin wird entladen.

{{missingText}}

TODO: Erstellung einer Makefile.am, Modifizieren der Makefile.am bzw. configure.ac.

TODO: Testen

== LIBFX2 ==
Als nächstes widmen wir uns der LIBFX2. Mit ihr wollen wir ein Beispielprogramm erzeugen, das lediglich eine horizontale Line
mit einem Rechteck darunter und einer vertikalen Line daneben (mittels FB) ausgibt.

{{missingText}}

==Enigma==
{{missingText}}

{{review}}

{{body}}

Sat Man am 30. Juni 2005 um 12:58 Uhr

2005-06-30T12:58:35Z

← Nächstältere Version		Version vom 30. Juni 2005, 14:58 Uhr
Zeile 5:		Zeile 5:
	=Allgemeines=		=Allgemeines=
	Um nicht zu viel zu sagen: Ein Plugin ist eine Erweiterung zu einem		Um nicht zu viel zu sagen: Ein Plugin ist eine Erweiterung zu einem
	~~vorhandeneb~~ Programm und hat folgende Attribute:		vorhandenen Programm und hat folgende Attribute:

	* Erweiterung		* Erweiterung
Zeile 72:		Zeile 72:
	{{missingText}}		{{missingText}}

	=Wie erstelle ich denn nun Plugins ?=		=Wie erstelle ich denn nun Plugins?=
	{{missingText}}		{{missingText}}

	==VT==		==VT==
	{{missingText}}		{{missingText}}

	==LIBFX2==		==LIBFX2==
	{{missingText}}		{{missingText}}
	==Enigma=={{missingText}}
			==Enigma==
			{{missingText}}



	{{review}}		{{review}}

	{{body}}		{{body}}

Sat Man: viele typo fixes

2005-06-30T12:57:02Z

viele typo fixes

Neue Seite

[[Category:Register]]
__TOC__

=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.<br>
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==
{{missingText}}

==Kernel==
{{missingText}}

=Wie erstelle ich denn nun Plugins ?=
{{missingText}}
==VT==
{{missingText}}
==LIBFX2==
{{missingText}}
==Enigma=={{missingText}}
{{review}}

{{body}}