############################################### ###### ##### #### ### ## #
# Dipesh-MP3yk
############################################### ###### ##### #### ### ## #
# Programmiert & Entwickwelt von Sebastian Sauer (Dipesh)
#   E-Mail:   mail@dipesh.de
#   Url:      http://www.dipesh.de
# or search via www.altavista.com and the words "sebastian+sauer+dipesh"
# after my new Homepage-Url.
############################################### ###### ##### #### ### ## #
# sorry, the readme.txt is only in german avaible...
#
#   I N H A L T E :
#   """""""""""""""
#   1.    Einleitung
#   2.    Der Umgang und die Benutzung von Dipesh-MP3yk
#   3.    Kommandozeilenparameter
#   4.    Die Ini-Datei DMP3yk.ini
#   5.    Die DLL-Datei MPEGDLL.DLL
#   6.    Bekannte Bugs und Fehler
#   7.    Der Delphi-Quellcode
#   8.    Externe VCL-Komponenten, -units und Toolz
#   9.    Lizenz-/Urheberrechtsbestimmungen
#
############################################### ###### ##### #### ### ## #



1. Einleitung
-------------
Sicherlich gibt es bereits sehr sehr viele Freeware MP3-Player auf dem 
Markt. Keiner jedoch hat bisher das gewnschte geboten.
Ich habe diesen Player geschrieben um die meiner Meinung nach wichtigen
Futures in einer Oberflche zu vereinen. 
Fr jeden der diese App ebenfalls gut findet, liegt auch der Delphi 3 
Quellcode bei, wodurch ein jeder seine Ideen und Wnsche miteinbringen
kann - bitte lesen Sie hierzu auch den Abschnitt "Lizenz-/Urheber-
rechtsbestimmungen".



2. Der Umgang und die Benutzung von Dipesh-MP3yk
------------------------------------------------
Eine der Leistungsstrken von DMP3yk ist die geringe CPU-Auslastung im
Vergleich zu anderen MP3-Playern. Durch ausblenden des Peaklevel-
Anzeigers und/oder der Positionsanzeige kann nochmals eine 
Performancesteigerung erzielt werden - schlielich arbeiten diese 
beiden Anzeigen ja "realtime" und nutzen somit auch stetig die CPU.

DMP3yk speichert alle seine Einstellungen in der Ini-Datei dmp3yk.ini
ab - die Registry bleibt unangetastet. 
DMP3yk kann direkt vom einem Read-Only-Datentrger (z.B. von einer 
selbstgebrannten CDR) aus gestartet/ausgefhrt werden.

Im linken Fenster knnen Playlisten eingelesen/zusammengestellt werden.
Durch einen Doppelklick auf einen Song dieser Liste wird der Song dann
in die rechte Liste bernohmen. Smtliche Songs die sich in dieser 
Liste befinden werden der Reihe nach oder aber im Random-Verfahren
abgespielt.

Der Rest drfte durch ausfhren der Exe-Datei und ausschauen/probieren
wohl selbsterklrend sein...



3. Kommandozeilenparameter
--------------------------
Optional kann Dipesh-MP3yk auch mit Kommandozeilenparametern gestartet
werden.

Die Syntax ist: DMP3YK.EXE [Dateiname der Playlistdatei]

Dabei kann als Parameter der Dateiname und das Verzeichnis einer 
Playlist (*.M3U) angegeben werden. Diese wird dann beim Start
eingelesen.
Damit DMP3yk auch auf CDRs gebrannt werden kann, ist es auch mglich
die Exe-Datei von einem ReadOnly-Medium aus zu starten. Bei der
definition von Kommandozeilenparametern muss dann nur entweder der 
Laufwerksbuchstabe einschlielich Doppelpunkt oder jedoch das 
relative Startverzeichnis aus der Verzeichnis-/Dateiangabe entfernt 
werden (WICHTIG: erstes Zeichen mu der Backsplash \ sein).
  


4. Die Ini-Datei DMP3yk.ini
---------------------------
Hier ldt und speichert Dipesh-MP3yk alle konfigurierbaren 
Einstellungen. Um Werte zu Standardwerten zurckzusetzen einfach
entspr. Eintrag aus der Ini-Datei entfernen.



5. Die DLL-Datei MPEGDLL.DLL
----------------------------
Innerhalb dieser Dynamic-Link-Library befinden sich smtliche 
Mpeg-Layer I, II und III Wiedergabe-Routinen. Sie wurden entwickelt
von der Free Software Foundation - nhere Infos finden sich im 
Verzeichnis \Source\Mpeg v1.0\ wieder.



6. Bekannte Bugs und Fehler
---------------------------
Gem. Murphies Gesetz ist es nie ausgeschlossen das sich so mancher
Bug in einem jeden Proggie befindet. Sollte euch nun ein solcher
in DMP3yk auffallen, so sendet mir bitte eine E-Mail. Aus dieser 
sollte hervorgehen wie/wodurch und wann dieser Fehler aufgetreten 
ist. Idealerweise sollte ich diesen Fehler anhand der E-Mail 
reproduzieren knnen.

Bekannte Mngel sind:
- aus z.Z. noch unbekanntem Grunde werden manchmal falsche Zeit- und
  KB/KHz-Angaben angezeigt. Dies beeintrchtigt jedoch in keiner 
  Weise irgendwelche Routinen.
- leider ist durch die Verwendung der MPEGDLL.DLL-Datei die 
  Reaktionszeit gerade bei drcken der Pausetaste sehr hoch.

Weitere Hinweise zum Stand der Release finden sich auch in der
HISTORY.TXT-Datei.



7. Der Delphi-Quellcode
-----------------------
Dipesh-MP3yk ist mit Delphi 3 ohne jegliche Anpassungen compilierbar 
(hhere Versionen wurden bisher noch nicht getestet). Bitte dran
denken, da um den Quellcode neukompilieren zu knnen, das einbinden
der Vcl-Komponenten notwendig ist (mehr hierzu weiter unten bei 
den "externen Vcl-Komponenten").
Aufgrund der geringeren Dateigre von mit D3 compilierten 
Executables hab ich Dipesh-MP3yk komplett unter Delphi 3 Object-
Pascal programmiert und compiliert.



8. Externe VCL-Komponenten, -units und Toolz
--------------------------------------------
In Dipesh-MP3yk fanden folgende Vcl-Komponenten und Units Verwendung:

Thankz to:
- TMegPlay v1.0 (by Eugene Mayevski, Eugene-Mayevski@usa.net,
  http://www.ig.com.ua/wabbit)
- Mpeg Audio Tools v1.8 (by Predrag Supurovic, 
  http://www.dv.co.yu/mpgscript/mpeghdr.htm)
- Vumeter v1.0 (by Viorel Dehelean, kick@forum96.ml.org)
- Die compilierte DMP3yk.exe-Datei wurde mittels "The Ultimate Packer 
  for eXecutables" gepackt. UPX wurde entwickelt von Markus Oberhumer
  & Laszlo Molnar (http://cdata.tvnet.hu/~ml/upx.html oder 
  http://wildsau.idv.uni-linz.ac.at/mfx/upx.html), ist Freeware und
  ein tolles Utilitiy.



9. Lizenz-/Urheberrechtsbestimmungen
------------------------------------
1. Dieses Programm ist Freeware und darf frei und ohne Entrichtung von 
   Lizenzgebhren verwendet, weitergegeben und eigenen Softwareprodukten 
   beigelegt werden.
2. Bei verffentlichen/weitergabe dieses Programms oder des Quellcodes mu
   stets das ganze Programm als solches zugnglich sein (soll heien 
   mitsammt des Quellcodes). Hierzu zhlen auch smtliche Textdateien im 
   Verzeichnis \Doc\ und insbesondere diese Readme.txt-Datei.
3. Smtliche nderungen am Quellcode mssen dem Autor ausfhrlich mitge-
   teilt werden. Dies soll gewhrleisten, da jeder etwas von den Verbes-
   serungen bzw. Erweiterungen hat. Danke im voraus...
4. Fr aus der Benutzung dieser Software resultierende Schden an Hard- 
   und/oder Software bzw. sich ergebende Lizenz- oder/und Urheberrechts-
   verletzungen bernimmt der Autor keinerlei Haftung.
5. Smtliche Urheberrechte liegen uneingeschrnkt beim Autor und ich be-
   halte mir das Recht vor jederzeit nderung an den Lizenzbestimmungen 
   vorzunehmen, insofern dies mit den Lizenzbestimmungen der externen 
   VCL-Komponenten/Units und Toolz kooperiert.
   Dock keine Angst, dieses Prog ist Freeware und wird Freeware bleiben!

