RoarAudio/Programmieren/VS - Versionsgeschichte

Ph3-der-loewe: /* Verwendung von VS Verbindungs-Objekts mit nachträglicher Stream Erzeugung */ text...

2010-10-05T02:26:44Z

Verwendung von VS Verbindungs-Objekts mit nachträglicher Stream Erzeugung: text...

@@ Zeile 287: / Zeile 287: @@
 === Verwendung von VS Verbindungs-Objekts mit nachträglicher Stream Erzeugung ===
-...
+Ein VS Verbindungs-Objekt muss nicht von Anfang an mit einem Stream verbunden sein. Dies kann als Beispiel dann interessant sein sollte man mittels Haupt API weitere Parameter mit dem Server ab prüfen wollen bevor man den Stream erzeugt. Auch kann man so einen zweiten Versuch starten einen Stream zu öffnen (mit anderen Parametern) sollte der Server den Stream mit den gewünschten Parametern nicht annehmen ohne neu Verbinden zu müssen.
 == Siehe Auch ==

Ph3-der-loewe: /* Verwenden einer bereits offenen Verbindung zu einem Server */ text...

2010-10-05T02:11:59Z

Verwenden einer bereits offenen Verbindung zu einem Server: text...

@@ Zeile 271: / Zeile 271: @@
 === Verwenden einer bereits offenen Verbindung zu einem Server ===
-...
+Sollte bereits eine Verbindung bestehen kann das vorhandene Connection-Objekt verwendet werden um VS Verbindungs-Objekte davon zu erzeugen. Wichtig hierbei ist das bei trennen der Verbindung zu erst alle VS Verbindungs-Objekte getrennt werden müssen und danach erst das Connection-Objekt.
 === Verwendung von VS Verbindungs-Objekts mit nachträglicher Stream Erzeugung ===

Ph3-der-loewe: /* Interaktion mit der Haupt API */ bissel text, mehr TOC

2010-10-05T01:55:22Z

Interaktion mit der Haupt API: bissel text, mehr TOC

← Nächstältere Version		Version vom 5. Oktober 2010, 01:55 Uhr
Zeile 256:		Zeile 256:

	== Interaktion mit der Haupt API ==		== Interaktion mit der Haupt API ==
			Dieser Teil soll nur die Grundlagen der Interaktion mit der Haupt API erläutern. Die Verwendung dieser soll hier nicht beschreiben werden da dies viel zu umfangreich für dieses Dokument währe.

			=== Zugriff auf das Connection-, das Stream- und das VIO-Objekt ===
			Wie auch unter Verwendung der Haupt API befindet sich im inneren des VS Verbindungs-Objekts eine Connection-, ein Stream- und ein VIO-Objekt. Auf diese kann man wie im folgenden Beispiel gezeigt mittels der Funktionen ''roar_vs_connection_obj()'', ''roar_vs_stream_obj()'' und ''roar_vs_vio_obj()'' zugreifen.

			==== Beispiele ====
			struct roar_connection * con;
			struct roar_stream * stream;
			struct roar_vio_calls * vio;

			con = roar_vs_connection_obj(vss, &err);
			stream = roar_vs_stream_obj(vss, &err);
			vio = roar_vs_vio_obj(vss, &err);

			=== Verwenden einer bereits offenen Verbindung zu einem Server ===
			...

			=== Verwendung von VS Verbindungs-Objekts mit nachträglicher Stream Erzeugung ===
	...		...

Ph3-der-loewe: /* Blocking */ text...

2010-10-05T01:30:04Z

Blocking: text...

← Nächstältere Version		Version vom 5. Oktober 2010, 01:30 Uhr
Zeile 121:		Zeile 121:

	=== Blocking ===		=== Blocking ===
	...		Die normale Betriebsart für das Schreiben und Lesen von Streams ist ''Blocking''. Das heißt, dass wenn man zu schnell schreibt oder liest der Schreib- oder Lesebefehl ''blockiert'' bis wieder genug Puffer oder Daten verfügbar ist. Dies dient dazu eine einfache Flusskontrolle zu haben. Für viele einfache Applikationen ist dies ausreichend. Mansche Applikationen benötigen es aber dass sie nicht an solchen Operationen Zwangs-Pausiert werden. Um dies zu unterbinden kann man in den so genannten ''Non-Blocking'' Modus gehen. In diesem Fall kehren die Ein-/Ausgabefunktionen unmittelbar zurück, auch wenn kein Puffer oder keine Daten verfügbar sind.

			Die Funktion ''roar_vs_blocking()'' Kann verwendet werden um den Modus zu setzen. Die Funktion erwartet, neben Verbindungs-Objekt und Fehlercode Pointer, einen Wahrheitswert der den neuen Zustand angibt. Dieser kann entweder ROAR_VS_TRUE, ROAR_VS_FALSE, ROAR_VS_TOGGLE oder ROAR_VS_ASK sein.

			Als Rückgabewert erhält man den alten Modus (ROAR_VS_TRUE für Blockend, ROAR_VS_FALSE für nicht blockend) oder -1 im Fehlerfall zurück.

			==== Beispiel ====
			int old;

			old = roar_vs_blocking(vss, ROAR_VS_FALSE, &err);

	=== Position und Latenz ===		=== Position und Latenz ===

Ph3-der-loewe: /* Beispiele */ paar einfache beispiele

2010-10-04T16:42:59Z

Beispiele: paar einfache beispiele

← Nächstältere Version		Version vom 4. Oktober 2010, 16:42 Uhr
Zeile 173:		Zeile 173:

	==== Beispiele ====		==== Beispiele ====
	...		float c, l, r;
			int ret;

			c = 0.5;
			ret = roar_vs_volume_mono(vss, c, &err);

			l = 0.8;
			r = 0.2;
			ret = roar_vs_volume_stereo(vss, l, r, &err);

			ret = roar_vs_volume_get(vss, &l, &r, &err);
			c = (l + r)/2;

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

Ph3-der-loewe: /* Lautstärke */ text...

2010-10-04T16:33:31Z

Lautstärke: text...

← Nächstältere Version		Version vom 4. Oktober 2010, 16:33 Uhr
Zeile 159:		Zeile 159:

	=== Lautstärke ===		=== Lautstärke ===
			Die Lautstärke des Streams kann sowohl gelesen als auch gesetzt werden. Hier soll beides Behandelt werden.

			die VS API verwendet native floats zur darstellung der Lautstärke. Der Wertebereich ist 0 (Signal wird komplett ausgeblendet. Sollte jedoch nicht verwendet werden um eine Mute Funktion zu implementieren) bis 1 (Volle Signalstärke).

			Gesetzt werden kann die Lautstärke entweder als Einkanal Wert oder als Stereo Wert. Die Funktion ''roar_vs_volume_mono()'' kann verwendet werden um sie als Einkanal Wert zu setzen. Diese Funktion erwartet neben dem Verbindungs-Objekt und dem Fehlerocode Pointer nur noch die neue Lautstärke.

			Die Funktion ''roar_vs_volume_stereo()'' kann dazu verwendet werden den Wert als Stereo Wert zu setzen. Sie verwendet zwei Lautstärke Parameter. Einen für den linken und einen für den rechten Kanal.

			Zum lesen kommt die Funktion ''roar_vs_volume_get()'' zum Einsatz. Diese erwartet, neben Verbindungs-Objekt und Fehlerocode Pointer, zwei Pointer, einen für den linken und einen für den rechten Kanal.

			Möchte man nur eine Einkanal Information über die Lautstärke erfahren so kann man folgende Formel benutzen:
			<math>c = \frac{l + r}{2}</math>

			==== Beispiele ====
	...		...

Ph3-der-loewe: /* Mute */ text...

2010-10-04T15:36:49Z

Mute: text...

← Nächstältere Version		Version vom 4. Oktober 2010, 15:36 Uhr
Zeile 151:		Zeile 151:

	=== Mute ===		=== Mute ===
	...		Bei RoarAudio gibt es neben der Lautstärkeregelung ein getrenntes Mute Flag. Dies kann mit der Funktion ''roar_vs_mute()'' Beeinflusst werden. Die Funktion ''roar_vs_mute()'' funktioniert exakt wie die Funktion ''roar_vs_pause()'' mit der Ausnahme das sie auf dem Mute Flag operiert.

			==== Beispiel ====
			int old;

			old = roar_vs_mute(vss, ROAR_VS_TOGGLE, &err);

	=== Lautstärke ===		=== Lautstärke ===

Ph3-der-loewe: /* Pause */ text...

2010-10-04T15:27:42Z

Pause: text...

@@ Zeile 127: / Zeile 127: @@
 === Pause ===
-...
+Mit der Funktion ''roar_vs_pause()'' Kann man den Pause Status des Streams ändern. Diese Funktion erwartet folgende Parameter:
 === Mute ===

Ph3-der-loewe: /* Liste möglicher Rollen */ + beschreibungen

2010-10-04T14:39:04Z

Liste möglicher Rollen: + beschreibungen

← Nächstältere Version		Version vom 4. Oktober 2010, 14:39 Uhr
Zeile 159:		Zeile 159:
	==== Liste möglicher Rollen ====		==== Liste möglicher Rollen ====
	; ROAR_ROLE_UNKNOWN		; ROAR_ROLE_UNKNOWN
			: Die Funktion des Streams ist unbekannt. Dies ist der default.
	; ROAR_ROLE_NONE		; ROAR_ROLE_NONE
			: (Sollte nicht verwendet werden)
	; ROAR_ROLE_MUSIC		; ROAR_ROLE_MUSIC
			: Es handelt sich um Musik
	; ROAR_ROLE_VIDEO		; ROAR_ROLE_VIDEO
			: Es handelt sich um die Audio Spur zu einem Video
	; ROAR_ROLE_GAME		; ROAR_ROLE_GAME
			: Es Handelt sich um die Audio Spur eines Spiels
	; ROAR_ROLE_EVENT		; ROAR_ROLE_EVENT
			: Es handelt sich um ein Geräusch das zum Beispiel durch eine Fehler- oder Warnmeldung erzeugt wird.
	; ROAR_ROLE_BEEP		; ROAR_ROLE_BEEP
			: Es Handelt sich um ein Notify Beep (Sollte ehr nicht verwendet werden).
	; ROAR_ROLE_PHONE		; ROAR_ROLE_PHONE
			: Es Handelt sich um eine Echtzeit Sparchübertragung wie etwa einem Telephon.
	; ROAR_ROLE_BACKGROUND_MUSIC		; ROAR_ROLE_BACKGROUND_MUSIC
			: Es Handelt sich um Hintergrund Musik. Man denke etwa an Kaufhäuser in denen leise Radio läuft.
	; ROAR_ROLE_VOICE		; ROAR_ROLE_VOICE
			: Es handelt sich um eine Sprach Spur. Zum Beispiel eine Ansage oder ein Sänger.
	; ROAR_ROLE_INSTRUMENT		; ROAR_ROLE_INSTRUMENT
			: Es Handelt sich um ein Instrument.
	; ROAR_ROLE_RHYTHM		; ROAR_ROLE_RHYTHM
			: Es Handelt sich um ein Rhythmus-Instrument.
	; ROAR_ROLE_CLICK		; ROAR_ROLE_CLICK
			: Es handelt sich um einen ''Click-Track''.
	; ROAR_ROLE_MIXED		; ROAR_ROLE_MIXED
			: Es Handelt sich um bereits aus mehren Quellen vorgemischtes. (Dies wird in aller Regel nur verwendet wenn mehre Sound System mit einander Verbunden werden).

	=== Noop ===		=== Noop ===

Ph3-der-loewe: /* Stream Rolle */ text... liste braucht noch beschreibungen

2010-10-04T14:31:42Z

Stream Rolle: text... liste braucht noch beschreibungen

@@ Zeile 150: / Zeile 150: @@
 === Stream Rolle ===
-...
+Die Stream Rolle ist eine logische Gruppierung von Streams die einen bestimmten Zweck erfüllen. Sie wird mittels ''roar_vs_role()'' gesetzt.
 === Noop ===