RoarAudio/Vortrag/Programmieren mit RoarAudio VS - Versionsgeschichte

Ph3-der-loewe: /* Warten auf Stream Ende */ +Inhalt

2011-04-07T14:43:49Z

Warten auf Stream Ende: +Inhalt

← Nächstältere Version		Version vom 7. April 2011, 14:43 Uhr
Zeile 185:		Zeile 185:

	=== Warten auf Stream Ende ===		=== Warten auf Stream Ende ===
	...		Mit der Funktion roar_vs_sync() kann man auf das Ende des Streams warten.

			Beispiel:
			<nowiki>ret = roar_vs_write(vss, buf, len, &err); // letzter Schreibzugriff
			ret = roar_vs_sync(vss, ROAR_VS_WAIT, &err);
			// am Stream-Ende
			ret = roar_vs_close(vss, ROAR_VS_FALSE, &err);</nowiki>

			Es sollte nach dem Aufruf von roar_vs_sync() entweder direkt der Stream geschlossen werden oder erneut geschrieben. In letzterem Fall wird ein Knacken oder ähnliches zu hören sein durch die Unterlaufs bedingte Unterbrechung (engl. "underrun").

	=== Interface zur Haupt API ===		=== Interface zur Haupt API ===

Ph3-der-loewe: /* Non-Blocking */ +Inhalt

2011-04-07T14:38:18Z

Non-Blocking: +Inhalt

← Nächstältere Version		Version vom 7. April 2011, 14:38 Uhr
Zeile 176:		Zeile 176:

	== Optionales ==		== Optionales ==
	=== ~~Non-Blocking~~ ===		=== Nicht Blockender Zugriffsmodus ===
	...		Wie auf normalen Filehandles in der UNIX Welt kann auch auf VS Objekten ein Nicht-Blockender Modus verwendet werden. Das heißt das Lese- und Schreibbefehle nicht blockieren sondern nur im internen Puffer operieren und somit schneller zurückkehren. Der Nachteil ist das dabei so genannte "short reads" beziehungsweise "short writes" häufiger passieren.

			Der Nicht Blockierende Modus kann mittels der Funktion roar_vs_blocking() verwendet werden wie im folgenden Beispiel gezeigt:
			<nowiki>ret = roar_vs_blocking(vss, ROAR_VS_TRUE, &err);</nowiki>

			Der zweite Parameter gibt dabei an ob der Modus gesetzt werden soll (ROAR_VS_TRUE) oder zurückgesetzt (ROAR_VS_FALSE). Natürlich kann er auch gekippt (ROAR_VS_TOGGLE) oder Abgefragt werden (ROAR_VS_ASK).

	=== Warten auf Stream Ende ===		=== Warten auf Stream Ende ===

Ph3-der-loewe: /* Optionales */ + nen paar kapittel

2011-04-07T14:02:55Z

Optionales: + nen paar kapittel

← Nächstältere Version		Version vom 7. April 2011, 14:02 Uhr
Zeile 176:		Zeile 176:

	== Optionales ==		== Optionales ==
			=== Non-Blocking ===
			...

			=== Warten auf Stream Ende ===
			...

	=== Interface zur Haupt API ===		=== Interface zur Haupt API ===
	...		...

Ph3-der-loewe: /* Gepufferter Modus */ +Absichtlicher Stub

2011-04-07T13:55:05Z

Gepufferter Modus: +Absichtlicher Stub

← Nächstältere Version		Version vom 7. April 2011, 13:55 Uhr
Zeile 108:		Zeile 108:

	=== Gepufferter Modus ===		=== Gepufferter Modus ===
	...		Viele Applikationen erwarten einen Gepufferten Modus vor zu finden in dem sie einen Ring Puffer mit sehr definiertem zustand vor finden in den sie Arbeiten können. Dieses Vorgehen ist nur mit einem Lokalen Ringpuffer möglich der recht groß ist und viele Nachteile in sich birgt. Aus diesem Grunde wird dieser Modus nicht Empfohlen.

			An dieser Stelle soll auch nur Kurz erwähnt sein das dieser Existiert und mit der Funktion roar_vs_buffer() zu steuern ist. Weitere Informationen finden sich in der Dokumentation.

			Um nicht weiter zu Verwirren direkt zum Nächsten Kapitel...

	=== Meta Daten ===		=== Meta Daten ===

Ph3-der-loewe: /* Was ist die VS API? */

2011-04-07T13:45:39Z

Was ist die VS API?

← Nächstältere Version		Version vom 7. April 2011, 13:45 Uhr
Zeile 21:		Zeile 21:
	== Vortrag ==		== Vortrag ==
	=== Was ist die VS API? ===		=== Was ist die VS API? ===
	...		Die VS API (von engl. "'''V'''ery '''S'''imple '''API'''") ist eine Schnittstelle auf hoher Ebene welche durch libroar angeboten wird. Sie ist stark an OpenBSD's sndio, aRtsc (KDE 2.x und 3.x) und pulsesimple angelehnt. Sie ist entwikelt worden um neuen Entwicklern und Entwicklern die mit den anderen Systemen zu tun hatten den Umstieg zu erleichtern.

			Die VS API bedient nur einen sehr kleinen Bereich von RoarAudios Fähigkeiten. Sie ist auch nur für das Abspielen und Aufnehmen von Streams geeignet und hat keine allgemeinen Steuer Funktionen. Sie kann aber, anders als bei ähnlichen ähnlichen Implementierungen der anderen Sound Systeme, beliebig mit der Haupt API kombiniert werden.

	=== Theorie ===		=== Theorie ===

Ph3-der-loewe: /* Streaming Modus */ +Inhalt

2011-04-07T13:37:17Z

Streaming Modus: +Inhalt

@@ Zeile 31: / Zeile 31: @@
 === Streaming Modus ===
-...
+Der Streaming Mode ist der '''native''' Modus. Hier wird das VS Objeckt (VSS) geöffnet und dann mittels Schreibe- und Lese-Befehlen die Audio Daten zum Server geschickt beziehungsweise von dort abgeholt. Ist man Fertig so wird das VS Objekt wieder geschlossen.
 === Fehler Behandlung ===

Ph3-der-loewe: /* Vortrag / + / Was ist die VS API? */

2011-04-07T11:32:26Z

Vortrag: + Was ist die VS API?

← Nächstältere Version		Version vom 7. April 2011, 11:32 Uhr
Zeile 20:		Zeile 20:

	== Vortrag ==		== Vortrag ==
			=== Was ist die VS API? ===
			...

	=== Theorie ===		=== Theorie ===
	==== Schichten ====		==== Schichten ====

Ph3-der-loewe: /* Schichten */ bissel text

2011-04-07T11:28:17Z

Schichten: bissel text

← Nächstältere Version		Version vom 7. April 2011, 11:28 Uhr
Zeile 22:		Zeile 22:
	=== Theorie ===		=== Theorie ===
	==== Schichten ====		==== Schichten ====
	...		Die VS API ist die im Moment höchste Schicht in libroar. Sie Abstrahiert mehre darunter liegenden Schichten wie die Simple API und VIO/DSTR.

	==== OOP ====		==== OOP ====

Ph3-der-loewe: /* OOP */ bissel text

2011-04-07T11:11:18Z

OOP: bissel text

← Nächstältere Version		Version vom 7. April 2011, 11:11 Uhr
Zeile 25:		Zeile 25:

	==== OOP ====		==== OOP ====
	...		Die VS API ist wie fast alles rund um RoarAudio Objekt Orientiert. Sie verwendet primär das so genannte VSS (von engl. "VS State") Objekt das sowohl Steuer-, Daten-, Datei-Verbindung Objekte sowie alle Puffer und Speicher Objekte die intern verwendet werden enthält.

	=== Streaming Modus ===		=== Streaming Modus ===

Ph3-der-loewe: /* Datei Modus */ +Inhalt

2011-04-07T11:01:25Z

Datei Modus: +Inhalt

@@ Zeile 44: / Zeile 44: @@
 === Datei Modus ===
-...
+Die VS API besitzt einen Datei Modus (engl. "file mode") in dem sie direkt Dateien aber auch Streams abspielen kann. Dazu wird die Verbindung mittels roar_vs_new_from_file() geöffnet. Anschließend wird mittels roar_vs_run() oder roar_vs_iterate() der Datenstrom zum Server geschrieben. Am Schluss wird das Objekt normal mittels roar_vs_close() geschlossen.
 === Gepufferter Modus ===