
			 ______________________________________
			|_X_|         ______________________ |_|
			|       <>   |                      |  |
			|  /\   <>   | Car Radio by Clayman |  |
			|  \/   <>   |______________________|  |
			|       <>    |_|_|_|_|_|_|_|_|_|__|   |
			|______________________________________|


******************************


Titel: 	   ArmAII Car Radio

Author:    Clayman	<worldofclay@gmx.de>

Version:   2.3.1

Datum: 	   26.01.2011

Benötigt:  ArmA2 V1.05 oder höher UND Operation Arrowhead


******************************


Features:
 * Vollsträndig funktionierendes Autoradio für alle PKW und LKW in ArmA2
 * Alle ArmA2 Musikstücke bereits enthalten
 * Beliebig viele eigene Musikstücke können hinzu gefügt werden
 * Filteroption zwischen InGame / eigener Musik
 * Repeat Funtkion
 * Zufallswiedergabe
 * 12-Farben Display
 * Bedienelemente in 7 Farben
 * Zwei Designs
 * Output Level abhängig von deiner Soundkarte / deinen Lautsprechern ;-)

Neu in V2.1:
 * Einbinden eigener Musik ist nun möglich
 * Zusätzliche Fahrzeugtypen, für die das Radio verfügbar ist
 * Playlist Editor
 * Haupt-Funktionen können direkt über die Tastatur bedient werden

Neu in V2.2:
 * Drag & Drop Funktion für Playlist Editor
 * Eigene Playlist kann vor-eingestellt werden (in userconfig .hpp)
 * Zusätzliche Variablen müssen nicht mehr definiert werden, wenn nicht benötigt
 * Einzele Fahrzeugtypen, für die das Radio nicht verfügbar ist, können definiert werden
 * Optionale Tooltips für einige Bedienelemente

Neu in V2.3
 * Alle Musikstücke aus Operation Arrowhead in eigener Playlist hinzu gefügt
 * Fehlende Musikstücke aus Patch 1.05 (Eagle Wing) hinzu gefügt
 * Fehler behoben, dass einige Bedienelemente nach verlassen des Playlist Editors über den Cancel Button nicht mehr funktionierten
 * Das Car Radio findet sich jetzt unter Module (F7) und hat ein eigenes Icon


******************************


Installation:
Die beiden enthaltenen Ordner '@CLAY_CarRadio' und 'userconfig' in deinen ArmAII Ordner entpacken.
In deiner ArmAII Verknüpfung den Startparameter '-mod=@CLAY_CarRadio' hinzufügen.


******************************


Benutzung:
Um das Radio in deiner Mission verfügbar zu machen, einfach das 'Car Radio' Modul (zu finden unter Modulee > Car Radio) irgendwo auf der Map platzieren.
Das war's schon. 
Das Radio steht nun in jedem Auto (class "Car") zur Verfügung. Einfach einsteigen und im Aktionsmenü "Car Radio" auswählen.


******************************


Bedienung:
Einige Bedienelemente dürften Selbsterklärend sein, andere vielleicht nicht. Hier eine kurze Auflistung:

 > - Startet die Wiedergabe (wechselt bei der Widergabe zu || )

 || - Beendet die Widergabe (wechselt zurück zu > )

 + - Lautstärke erhöhen

 - - Lautstärke verringern

 >> - Nächster Titel

 << - Vorheriger Titel

 /\ - Filter aufsteigend durchschalten (ArmA2 Music > User Music > All Music > Custom)

 \/ - Filter absteigend durchschalten (ArmA2 Music > Custom > All Music > User Music)

 OFF - Beendet den Dialog (Musik läuft weiter!)

 Playlist - Öffnet den Playlist Editor

 Repeat - Sind alle Titel abgespielt, fängt die Widergabe von vorne an (ein / aus)('Repeat' erschein im Display)

 Random - Zufallswidergabe (ein / aus)('Random' erscheint im Display)

 Key Col - Schaltet die ("Beleuchtungs")Farben der Tasten durch

 Dspl Col - Schaltet die Farben des Displays durch oder schaltet auf automatischer Farbwechsel ('Col. Change' erscheint im Display)

 Design - Schaltet das Design um (Schwarz / "Silber")


******************************


Playlist Editor:
Mit dem Playlist Editor kannst du dir deine eigene Playliste zusammen stellen.
In der rechten Spalte findest du alle verfügbaren Tracks. Die linke Spalte stellt deine Playlist dar.

 < - Fügt den rechts ausgewählten Track der Playlist (an letzter Stelle) hinzu

 > - Entfernt den link ausgewählten Track aus der Playlist

 << - Fügt sämtliche Tracks aus der rechten Spalte der Playlist hinzu

 >> - Entfernt alle Tracks aus der Playlist

 Restore - Stellt die (in der userconfig) vor-definierte Playlist wieder her (falls vorhanden)(Die manuell im Playlist Editor erstellte Playlist geht dabei verloren!)

 OK - Schließt den Playlist Editor und kehrt zum Radio zurück, welches deine zuvor erstellte Playlist wiedergibt

 Cancel - Schließt den Playlist Editor ohne die erstellte Playlist zu übernehmen, und kehrt zum Radio zurück


******************************


Tooltips anzeigen:
Es ist möglich, dass über einigen der Bedienelemente des Radios Tooltips angezeigt werden, welche die Funktion des entsprechenden Elements erklärt.
Um diese Tooltips zu aktiviernen, schreibe den folgenden Code in die init.sqf oder die Init-Zeile einer beliebigen Einheit:


	CLAY_RadioShowTooltips = true;


******************************


Eigene Musik einbinden:
Um deine Eigene Musik im Radio verfügbar zu machen, musst due diese zunächst in der description.ext deiner Mission definieren.
Nun kannst du über die Variable 'CLAY_RadioAddMusic' (z.B. in der init.sqf oder der Init-Zeile einer beliebigen Einheit) die Music in das Radio einbinden:


	CLAY_RadioAddMusic = [ [<Track | String>, <Title | String>, <Time | Number>] ];


Track = Der Classname deiner Musik wie du sie in der description.ext angegeben hast.

Title = Der Titel, so wie er im Radio angezeigt wird.

Time = Die Länge des Tracks in Sekunden.


Fertig sieht das ganze dann in etwa so aus:


	CLAY_RadioAddMusic = [ ["MeinSong01", "Mein Song 1", 123], ["MeinSong02", "Mein Song 2", 456] ];


******************************


Vor-Definierte Playlist:
Du kannst deine eigene Playlist erstellen, die von Missionsstart an im Radio verfügbar ist (Playlist: Custom).
Öffne dazu die Datei '\userconfig\CLAY_CarRadio\CLAY_CarRadio.hpp'. In das Array hinter _userPlaylist kannst du nun deine gewünschten Titel eintragen. Das Format dabei ist das selbe wie beim einfügen eigener Musik:


	_userPlaylist = [ ["Track08_Harvest_Red", "Harvest Red", 78], ["Track26_Organ_Works", "Organ Works", 69], ["MeinSong01", "Mein Song 1", 123] ];




******************************


Zusätzliche Fahrzeugtypen:
Du kannst zusätzliche Fahrzeugtypen definieren, in denen das Radio zur Verfügung stehen soll. Dazu musst du die Bezeichnungen der Fahrzeuge in der Variablen 'CLAY_RadioAddVehicles' eintragen.


	CLAY_RadioAddVehicles = ["M1A1", "AH1Z", "PBX"];


******************************


Fahrzeugtypen, die kein Radio haben sollen:
Ebenso wie du neue Fahrzeugtypen hinzu fügen kannst, kannst du auch einzelne Typen angeben, für die das Radio nicht zur Verfügung stehen soll. Dazu wird die Variable 'CLAY_RadioNoVehicles' verwendet.


	CLAY_RadioNoVehicles = ["SkodaRed", "HMMWV", "TowingTractor"];


******************************


Tastaturbedienung:
Die Hauptfunktionen des Radios können direkt per Tastendruck bedient werden. Die Tasten für jeden Funktion können frei gewählt werden.

Standard Belegung:

 PAUSE - Play / Pause

 PFEIL RECHTS - Nächster Track

 PFEIL LINKS - Vorheriger Track

 PFEIL HOCH - Lautstärke erhöhen

 PFEIL RUNTER - Lautstärke vermindern


Um diese Belegung zu ändern, öffne die Datei '\userconfig\CLAY_CarRadio\CLAY_CarRadio.hpp'.
Hinter die Variablen _keyPlay, _keyNext, _keyPre, _keyVolUp und _keyVolDown kannst du die entsprechende Tastennummer eintragen.


******************************


Bekannte Bugs:
 * Sehr schnelles Klicken auf die Vor- (>>) bzw. Zurück- (<<) Taste kann dazu führen, dass die Zeitanzeige nicht mehr richtig funktioniert
 * Drag & Drop im Playlist Editor funktioniert nur, um Titel zu der Playlist hinzu zu fügen. Entfernen von Titeln oder nachträgliches Sortieren ist so nicht möglich.


******************************


Weitere Informationen, Hilfe sowie eine Beispielmission, welche das einfügen eigener Musik und einbinden weiterer Fahrzeugtypen veranschaulicht, findest du unter folgenden Links:

	http://assaultmissionstudio.de/forum/viewthread.php?thread_id=297
	http://forums.bistudio.com/showthread.php?t=82665



Danke an:
BI für ArmAII
Vektorbosen für sein (OFP) Dialog Tutorial
T_D für die Hilfe beim Display-Farbwechsel Script
kju für die Unterstützung & ein paar sehr schöne Ideen
Srgt_Foxhound, der mich "genötigt" hat dieses Update zu erstellen ;-)


Disclaimer:
Benutze dieses Addon auf eigene Gefahr! Ich bin nicht verantworlich für sämtliche (un)möglichen Schäden, die dieses bei dir und/oder deinem Rechner / deiner Gesundheit / deiner Beziehung / deinem Leben anrichtet.


******************************


Change Log:

V2.3.1
 * 'nil' Fehler beseitigt

V2.3
 * Operation Arrowhead Tracks hinzu gefügt
 * Tracks aus der Eagle Wing Kampagne (ArmA2 Patch 1.05) hinzu gefügt
 * Bug bem verlassen des Playlist Editors über den Cancel Button beseitigt
 * Car Radio unter Module (F7)
 * Eigenes Icon

V2.2
 * Alle Bugs aus Version 2.1 beseitigt
 * Drag & Drop Funktion für Playlist Editor
 * Radio kann an beliebige Position auf dem Bildschirm verschoben werden
 * Eigene Playlist kann vordefiniert werden
 * Zusätzliche Variablen müssen nicht mehr definiert werden, wenn nicht benötigt
 * Einzele Fahrzeugtypen, für die das Radio nicht verfügbar ist
 * Tooltips für einige Bedienelemente
 * Keine Verzögerung mehr beim klicken auf << oder >>
 * Fehler beim Display-Farbwechsel beseitigt
 * Einige kleinere Schönheitskorrekturen

V2.1.2
 * Musik spielt nach verlassen eines Fahrzeugs nun nicht mehr weiter

V2.1.1
 * Fehler beseitigt, der verhinderte, dass andere Musik abgespielt werden konnte

V2.1
 * Einbinden eigener Musik ist nun möglich
 * Zusätzliche Fahrzeugklassen, für die das Radio verfügbar ist, können definiert werden
 * Playlist Editor hinzu gefügt
 * Haupt-Funktionen können direkt über die Tastatur bedient werden

V2.0
 * Portierung nach ArmAII
 * Alle Scripte neu aufgesetzt
 * Neues, deutlich verbessertes Design
 * Es können beliebig viele Musikstücke hinzu gefügt werden
 * Verschiedene Playlisten
 * Zufallswiedergabe Funktion
 * Automatischer Farbwechsel des Displays (fließender Übergang)
 * Bedienelemente in 7 Farben


	(OFP Version)
V1.6:
 * 2 zwei verschiedene Farbdesigns
 * Einige kleine Bugs beseitigt

V1.5:
 * 12-farbiges Display
 * 3-farbige Bedienelemente

V1.4:
 * 5-farbiges Display
 * Alle globalen Variablen haben jetzt einen RADIO_ Tag

V1.3:
 * Hauptscript stark überarbeitet
 * Eigene Musik kann nun hinzu gefügt werden (bis zu 10 Tracks)
 * "Leuchtendes" Display

V1.2:
 * Zeit wird nun in Minuten und Sekunden angezeigt
 * Ein paar kleine Bugs beseitigt

V1.1:
 * Zeit und Lautstärke werden beim erneuten öffnen nun korrekt angezeigt
 * Bug beseitigt, der dazu führte, dass das Radio sich manchmal sofort nach dem öffnen wieder von selbst schloss

V1.0:
 * Bug beseitigt, der beim wechsel vom letzten Track in der Playlist zum ersten und anders herum auftrat
 * Alle Scripte in einen gesonderten Ordner verschoben

V0.99:
 * Erste BETA
 * Track Titel eird nach dem erneuten öffnen des Dialogs im Display angezeigt

V0.95:
 * Optimiertes Design
 * Musik spielt nun weiter, wenn der Dialog neu geöffnet wird

V0.9:
 * Erste Version
