 
 
 
 
 
  IB-Soft's CDPlay V1.0 
 
 
  Copyright (c) 1994 IB-Soft Ingo Bttcher 
 
 

                         Dokumentationsdatei fr
                             IB-Soft's CDPlay
                             Sharewareversion
                                   und
                               Vollversion
                               
                             Stand: Juli '94


Was wren wir heute ohne CD's? Jeder hat sie, jeder hrt sie. Und seit ein
paar Jahren sind sie auch auf dem Computermarkt etabliert.
Die CD-ROM Laufwerke werden immer preiswerter, immer mehr CD's berschwemmen
den Markt.
Viele Leute haben dann CD-ROM Laufwerk und Stereo-Anlage gekoppelt und
hren ber das CD-ROM Laufwerk auch Audio CD's. Nur ist hier meist die 
Bedienung etwas schwieriger. Die Laufwerke werden - bis auf ganz wenige 
Ausnahmen - nur ber Software gesteuert. Und die Programme, die bei den 
Laufwerken mitgeliefert werden, sind meist nicht das Gelbe vom Ei.
Eifrige Windows Benutzer werden jetzt an andere Sharewareprogramme denken
und sagen, da ein Programm wie dieses ja nicht unbedingt neu ist. Aber
ein Programm dieser Art unter DOS ist dann doch schon etwas, was es nicht
so ganz so hufig gibt. 

 Der Leistungsumfang von CDPlay:
   
     Alle Funktionen eines normalen Audio CD-Players (Play, Stop, Skip ...)
     Titel und CD Datenbank
     Repeat Funktion
     Intro Funktion
     verwaltet beliebig viele CD Datenstze
     Automatische Erkennung der gespielten CD
     Leicht bedienbar ber Tastatur und/oder Maus
     Anzeige von aktueller Titel- und CD-Zeit
     Auch von der Kommandozeile zu bedienen
     Arbeitet mit allen Laufwerken zusammen, die ber MSCDEX/NWCDEX 
      gesteuert werden

Falls Sie mit der Sharewareversion arbeiten, brauchen Sie keine 
Einschrnkungen im Funktionsumfang zu befrchten. Die Sharewareversion
unterscheidet sich von der Vollversion nur durch einen Hinweisbildschirm
am Anfang und am Ende.

 Folgende Dateien sind zum Betrieb von CDPlay ntig:
 
    CDPLAY.EXE    das Programm selbst
    CDPLAY.FNT    Font-Datei  (nur fr EGA und VGA Grafikkarten)

 Weiterhin gehren zum Programm noch folgende Dateien:
 
    CDPLAY.TXT    diese Datei
    CDPLAY.DAT    Datenbank-Demo
    WINDOWS.ZIP   Zubehr, falls CDPlay unter MS-Windows genutzt wird
    
CDPlay bentigt nur geringe Vorraussetzungen zum Betrieb. Ein Rechner mit 
286er Prozessor, eine CGA Grafikkarte (Hercules mte auch gehen), ein 
Diskettenlaufwerk oder eine Festplatte und, ganz wichtig, ein 
multisessionfhiges CD-ROM Laufwerk mit dem DOS Treiber MSCDEX V2.00 oder 
hher bzw. NWCDEX.
Eine Festplatte ist dem Diskettenlaufwerk natrlich auf jeden Fall berlegen,
wenn es um Geschwindigkeit geht. Sie sollten CDPlay aufgrund seiner geringen
Gre auf der Festplatte installieren. 

Bei Fragen zu Installation von CD-ROM Laufwerk und den Treibern schlagen Sie 
bitte in Ihrem Handbuch zum DOS oder CD-ROM nach.

Falls Sie CDPlay unter Windows nutzen wollen, sollten Sie die Archivdatei
WINDOWS.ZIP entpacken (IBUNZIP WINDOWS.ZIP) und danach die im Write-Format
vorliegende Datei CDPLAY.WRI durchlesen.


Beim Start ohne irgendwelche Parameter wird der Hauptbildschirm von CDPlay 
aufgerufen. Wird schon eine CD im Laufwerk abgespielt, werden die Laufzeiten
gleich im mittleren Fenster angezeigt.

Der folgende Screenshot zeigt den Hauptbildschirm von CDPlay, wenn eine CD
im Laufwerk liegt, aber zur Zeit nicht abgespielt wird.


 -                               CD-Play V1.0


  Ŀ
                                                                            
     CD Titel     :                                                         
     Titel Name   :                                                         
     Titel Nummer : 00/00                                                   
                                                                            
  Ŀ
      CD:                                                                 
    Zeit : 00:00.00        Rest : 00:00.00        Gesamt : 00:00.00       
      Titel:                                                              
    Zeit : 00:00.00        Rest : 00:00.00        Gesamt : 00:00.00       
  ٳ
                                                                            
  

         1 2 3 4 5 6 7 8 9 10 11 12

                                            ||         
                      
      Disk-Info        Hilfe         Repeat -       Intro -  
              
                                (c) 1994 IB-Soft


Haben Sie eine EGA oder VGA Grafikkarte, sehen einige Zeichen (berschrift,
Copyrightzeichen, etc.) nicht ganz so aus, wie in diesem Screenshot. In
den beiden Modi wird nmlich etwas mit den Ascii Zeichen rumgespielt und 
diese etwas modifiziert. Auf einer CGA Karte sieht hingegen alles so aus,
wie im Screenshot. 

Haben Sie CDPlay erfolgreich gestartet, knnen Sie mit der Maus die Buttons
anwhlen, die Ihnen z.T. vom normalen CD Player zu Hause bekannt sein 
sollten. Von links nach rechts: Titel zurck, 10 Sekunden zurck, Play, 
10 Sekunden vor, Titel vor, Stop, Pause, Auswurf. Die Auswurf-Taste 
funktioniert aber nur, falls Sie ein Laufwerk mit Motorschublade haben. 
Laufwerke, wie das sehr weit verbreitete Mitsumi LU005, die keine 
Motorschublade haben, untersttzen diese Funktion also nicht.
Mit dem Repeat Button knnen Sie einstellen, da die CD endlos abgespielt
wird, bzw. so lange, bis Sie das Abspielen unterbrechen. Klicken Sie
Repeat an oder drcken Sie F3, wird Repeat an- oder ausgeschaltet. Wenn Sie
allerdings CDPlay beenden, geht die Repeat-Einstellung verloren, und Sie
hren die CD nur bis zum Ende. Sie mssen also CDPlay laufen lassen, um 
die Repeat-Funktion zu benutzen. Gleiches gilt brigens fr die 
Intro-Funktion. Auch diese funktioniert nur, wenn CDPlay luft. Ist die
Intro-Funktion aktiv, werden von jedem Titel der eingelegten CD nur die
ersten zehn Sekunden abgespielt. Danach wird automatisch zum nchsten
Titel gesprungen. Schalten Sie die Intro-Funktion wieder ab, wird auch
die CD gestoppt. Im Intro-Modus werden bis auf F3, i, I und Stop alle 
anderen Tasten und Buttons gesperrt, da die Intro-Funktion nur luft wenn
dauernd wieder nachgeprft wird, ob schon zehn Sekunden des Titels gespielt
wurden oder nicht. 

Genauso einfach knnen Sie CDPlay mit der Tastatur bedienen.

      Enter          =            Abspielen starten
      Leertaste      =            Abspielen stoppen
      Cursor hoch    =  Laufwerk ffnen / schlieen
      Cursor links   =   10 Sekunden zurckspringen
      Cursor rechts  =      10 Sekunden vorspringen
      Cursor runter  =                        Pause
      Bild auf       =                    Titel vor
      Bild ab        =                 Titel zurck
      F1             =                        Hilfe
      F2             =                    Disk-Info
      F3 oder r/R    =              Repeat an / aus
      F4 oder i/I    =         Intro-Modus an / aus

Die untere Pausetaste hebt brigens auch die Pause Funktion wieder auf.
Soll heien: erstes Mal drcken = Pause, zweites Mal drcken = Weiterspielen.

Drcken Sie nach Stop wieder Play, wird brigens nicht beim ersten Titel
der CD neu begonnen, sondern am Anfang des zuletzt gespielten Titels.

Wenn Sie, whrend ein Titel spielt, nochmals Play drcken, wird der aktuelle
Titel neu gestartet. 


Sie knnen natrlich auch Titel direkt anspringen. Mit der Maus klicken Sie
einfach auf die Titelnummer oberhalb der Buttonzeile.
Mit der Tastatur geben Sie die Nummer ein und drcken Enter.

In den Fenstern in der Mitte des Bildschirmes werden Zeiten und eventuell 
gespeicherte Daten ber CD und Titel ausgegeben.


  Ŀ
                                                                            
     CD Titel     : Genesis - We can't dance                                
     Titel Name   : Dreaming while you sleep                                
     Titel Nummer : 06/12                                                   
                                                                            
  Ŀ
      CD:                                                                 
    Zeit : 30:36.06        Rest : 41:02.55        Gesamt : 71:38.05       
      Titel:                                                              
    Zeit : 01:37.34        Rest : 03:19.34        Gesamt : 04:00.68       
  ٳ
                                                                            
  


So wrden diese Fenster z.B. aussehen, wenn eine bereits in den Datenstzen
vorhandene CD abgespielt wird. Vllig automatisch wird beim Start in der 
Datendatei gesucht, ob die CD schon in den Datenstzen vorhanden ist.

CDPlay verwaltet Ihre CD-Daten in einer Datei, wobei keine Grenzen in der
Gre der Datenbank gesetzt werden. Nur setzt eine Datenbank mit hunderten
von CD's natrlich die Arbeitsgeschwindigkeit herab, wenn eine CD am letzten
Ende der Datei gesucht wird.

Dem Programm ist eine kleine Beispiel-Datenbank beigelegt. Da die 
Datenbankdateien von CDPlay immer im Hauptverzeichnis des Laufwerkes gesucht
werden, brauchen Sie sie also nur ins Hauptverzeichnis des aktuellen
Laufwerks zu kopieren und wenn Sie eine CD abspielen, die in der Datenbank
vorhanden ist, werden Ihnen die Daten angezeigt. Ist die CD noch nicht 
vorhanden, knnen Sie die Daten ergnzen. Drcken Sie F2 oder den Button
Disk-Info, werden alle Titel der CD untereinander aufgefhrt und Sie knnen
zu jedem einzelnen Titel einen Namen angeben. Ist die CD einmal in der
Datenbank, bringt jeder weitere Druck auf F2 eine Titelliste auf den
Bildschirm. Die beigelegte CD-Datenbank soll aber nicht als vollstndig
gelten. Sie ist vielmehr ein Beispiel fr die Speicherung der Titel.
Wenn ich mir mal ein paar neue CD's leiste oder leihe, werden die natrlich
auch in dieser Datenbank aufgenommen. Und vielleicht ist ja auch der eine
oder andere Anwender so nett und schickt mir mal seine persnliche 
CDPlay CD-Datenbank auf Disk. Als Dankeschn gibt es die neueste Vollversion!
Ist im Hauptverzeichnis des aktuellen Laufwerks schon eine Datendatei
vorhanden, werden neue Daten am Ende der Datei angehngt, andernfalls
wird die Datei neu erstellt. Fr den Aufbau der CD-Datenbank sehen Sie sich
mal die Datei CDPLAY.DAT an, hier nur noch ein Hinweis: Zwischen den 
einzelnen CD's in der Datenbank knnen problemlos Kommentare eingefgt 
werden. Diese Kommentare brauchen nicht mit einem speziellen Zeichen wie
z.B. ' oder rem) eingeleitet werden, sie sollten allerdings nicht mit einer
Zahl beginnen, die fr eine CD-Gesamtzeit gehalten werden knnte. Zwischen
einzelnen Titeln drfen Sie keine Kommentare einfgen.


                                  Disk - Info

    1. 06:40.02  No son of mine
    2. 04:16.35  Jesus he knows me
    3. 10:08.50  Driving the last spike
    4. 04:00.68  I can't dance
    5. 03:50.42  Never a time
    6. 07:16.63  Dreaming while you sleep
    7. 04:58.72  Tell me why
    8. 05:40.70  Living forever
    9. 04:37.65  Hold on my heart
   10. 05:39.15  Way of the world
   11. 04:09.53  Since I lost you
   12. 10:15.70  Fading lights


Ein Programm wie dieses wird oft in ein Verzeichnis kopiert, das in der
PATH Umgebungsvariablen aufgefhrt ist. Wenn Sie CDPlay dann starten, sollte
auch die Fontdatei gefunden werden. Starten Sie CDPlay aber nicht ber eine
Batchdatei, auer Sie verwenden nur die Kommandozeilenoptionen.

Die Angabe von Daten in der Kommandozeile ist so einfach wie die restliche
Programmbedienung.

Syntax:  CDPLAY [Titel] [+] oder CDPLAY [Befehle] [Optionen]

Geben Sie Titel an, wird nur dieser Titel gespielt. Geben Sie hinter dem
Titel ein Plus an, wird der angegebene und alle darauffolgenden Titel
gespielt. Beispiel: CDPLAY 5 + spielt ab Titel 5 alle folgenden Titel.

Befehle sind die Befehle, die auch im Hauptbildschirm zu finden sind:

  P  =    Play
  S  =    Stop
  +  =    Titel vor
  -  =    Titel zurck
  >  =    10 Sekunden vor
  <  =    10 Sekunden zurck
  E  =    CD Auswurf
  PA =    Pause
  R  =    Resume (Pause aufheben)

Optionen
  /? =    Hilfebildschirm mit Parameterbersicht
  /N =    Keine Grafikzeichen verwenden
  
Wichtig: Vom Hauptbildschirm aus knnen Sie das Laufwerk sowohl ffnen,
als auch durch erneuten Druck auf die Eject-Taste wieder schlieen. Da
bei jedem Aufruf von der Kommandozeile das Laufwerk neu initialisiert werden
mu, geht dies von der Kommandozeile aus nicht. ffnen des Laufwerkes geht
natrlich, aber auch dies nur, wenn eine CD im Laufwerk liegt. In jedem
anderen Fall wird Ihnen die Meldung 'Keine CD eingelegt.' angezeigt.

Noch etwas fr Leute, die sich nicht so gut mit Computern auskennen: CDPlay
braucht kein Byte vom Arbeitsspeicher wenn Sie es beenden, die CD im
Hintergrund aber weiterluft. Alle Kommandos werden direkt ans CD-ROM
(bzw. MSCDEX/NWCDEX) abgesetzt und Sie knnen ohne einen Leistungsabfall 
oder Speicherprobleme weiterarbeiten.

Mgliche Fehlermeldungen und eventuelle Fehlerbehebung:

Initialisierung fehlgeschlagen!
Keine CD eingelegt.

  Das Laufwerk ist geffnet, oder es ist keine CD eingelegt. 
  CDPlay kann nur gestartet werden, wenn eine CD im Laufwerk liegt und
  dieses geschlossen ist.

Initialisierung fehlgeschlagen!
Kein CD-ROM Laufwerk vorhanden.

  Diese Fehlermeldung taucht auf, wenn Sie berhaupt kein CD-ROM Laufwerk
  besitzen (was wollen Sie eigentlich mit einem CDPlayer Programm?), aber
  auch, wenn der CD-ROM Treiber bzw. MSCDEX/NWCDEX nicht geladen sind.
  Informieren Sie sich in Ihrem DOS- bzw. CD-ROM Handbuch ber die korrekte
  Installation der Treiber.

Initialisierung fehlgeschlagen!
Kein Laufwerk gefunden, das Audio Erweiterung untersttzt.

  Es wurde zwar ein CD-ROM Laufwerk gefunden, allerdings knnen auf diesem
  Laufwerk keine Audio-CD's abgespielt werden. Fr das Abspielen von 
  Audio-CD's bentigen Sie unbedingt ein multisessionfhiges CD-ROM Laufwerk,
  das mindestens dem MPC I Standard gengt.

CDPlay lief bei eigentlich allen Tests problemlos und sollte eigentlich 
auch bei Ihrem CD-ROM Laufwerk nicht versagen. Es kann jedoch immer mal 
vorkommen, da das Programm mit einem bestimmten Laufwerk nicht 
zusammenarbeiten will. Wenn dies bei Ihnen der Fall ist, sollten Sie zuerst 
versuchen, Ihr Laufwerk umzukonfigurieren (DMA, Interrupts...). Sehr 
hilfreich kann dabei ein CD-ROM Testprogramm sein. Bringt dies keine 
Besserung, knnen Sie ja mal versuchen, bei Ihrem Hndler einen neuen Treiber
zu bekommen. Und wenn das alles nicht hilft, sollten Sie sich mit mir in 
Verbindung setzen. Gemeinsam werden wir das Problemchen schon beseitigen.

Fr Datenverluste und Schden an Hard- oder Software, die durch CDPlay
entstehen knnten, lehne ich jegliche Verantwortung ab. Tut mich aber
trotzdem echt traurig, falls sowas wirklich passieren sollte. :-~(~~~~ 

Ich suche brigens noch Informationen ber die direkte Programmierung von
CD-ROM Laufwerken ohne MSCDEX. Wer mir hier Informationen beschaffen kann,
dem bin ich die nchsten Monate ewig dankbar.  :-D
Irgendwann knnte man dann ja vielleicht (wenigstens teilweise) auf
CD-ROM Extensions verzichten, und CDPlay noch ein wenig schneller gestalten.

Ich stelle mir auch fr die nchste Zeit einmal eine Version vor, die
vielleicht einen kleinen speicherresidenten Kern hat und dann auch 
auerhalb des Programmbildschirmes noch Intro und Repeat beherrscht.
Geplant ist auch noch eine Titelprogrammierung, ich wei aber leider bis
jetzt noch nicht, wie ich das mglichst benutzerfreundlich machen kann.


Dies ist die Dokumentationsdatei zu Shareware- und Vollversion. Alle
Besitzer der Vollversion drfen jetzt (mssen aber nicht!) weggucken.
Fr den Rest jetzt der zweitwichtigste Teil der Dokumentation.

BESTELLUNG DER VOLLVERSION:

Was mssen Sie tun, wenn Sie leider bis jetzt nur mit der Sharewareversion
arbeiten und die einfach gute CDPlay Vollversion haben wollen?

Bestellformular BESTELL.TXT ausfllen und an IB-Soft schicken

 und

15 DM auf das Konto 8988040 bei der Deutschen Bank Delmenhorst BLZ 290 700 52
berweisen (Stichwort: CDPLAY) und nicht vergessen: Adresse angeben!

 oder

15 DM in bar mit dem Bestellformular mitschicken (evtl. als Einschreiben)

 oder
 
einen Verrechnungsscheck ber 15 DM mit dem Bestellformular mitschicken.

Sie knnen auch alle Shareware- und PD Programme von IB-Soft auf einer Disk
bekommen (nur 8,89cm Disk (3")). Kreuzen Sie einfach auf dem 
Bestellformular den Punkt 'Sharewaredisk' an. Fr die Sharewaredisk selbst
bezahlen Sie nichts.

Zum Gesamtpreis kommen brigens noch 5 DM fr Versandkosten etc. hinzu.
Falls Sie nur die Sharewaredisk bestellen, legen Sie bitte die 5 DM in bar
oder Briefmarken bei.

Bei Bestellungen aus dem Ausland ist es wohl das Beste, Sie versuchen es
mal mit einem Scheck oder Verrechnungsscheck. Eine berweisung z.B. von
sterreich nach Deutschland kostet nmlich schon alleine 10 DM Gebhren,
von der Schweiz sogar 17 DM! Auch aus Kostengrnden wird der Versand per
Nachnahme nicht angeboten (7,90 Porto + 3 DM Zahlkartengebhr).
Aus dem europischen Ausland bitte wenn mglich in DM bezahlen, Dollar
geht auch und schis (sterreichische Schillinge) sind ebenfalls Ok, die
werden dann im nchsten Sommerurlaub wieder den Weg zurck in die Heimat
finden.

Sie knnen natrlich auch eine Diskette mit einem frankierten und 
adressierten Rckumschlag senden. Ich werde mich nicht bremsen knnen, Ihnen
die aktuellen IB-Soft Sharewareprogramme auf dieser Disk zurckzuschicken.
Aber bitte auch hier nur 3" Disketten und deutsche Briefmarken!

Normalerweise geht das mit der Post und den Banken recht vernnftig zu.
Allerdings kann es immer mal wieder zu Verzgerungen kommen. Auch stehe
ich ganz verzweifelt da, wenn ich nur die berweisung erhalte und auf
dem Beleg steht vielleicht nur "Knete fr CDPLAY Vollversion" oder hnliches.
Damit kann ich nicht gerade so besonders viel anfangen. Also lieber mal
nachfragen, falls sich nach einer angemessenen Wartezeit immer noch kein
Pckchen im Postkasten ausmachen lt.

Ich freue mich brigens immer ber Verbesserungsvorschlge und bin auch
fr konstruktive Kritik offen. Also keine falsche Scheu und auf dem 
Bestellformular gleich noch notieren, was denn am Programm verbessert 
werden sollte. Schriftliche Anfragen werden so schnell und so ausfhrlich
wie mglich beantwortet. Und falls Sie noch nicht Besitzer einer Vollversion
sind hoffe ich, da Sie sich bald zur Registrierung durchringen knnen.
Sie tragen damit wesentlich zur Verbesserung und Weiterentwicklung der
IB-Soft Programme bei. Von dem Geld mu ja schlielich ab und zu mal neue
Software (Compiler etc.) oder Hardware (ich will jetzt 'nen 486er!!) gekauft
werden, damit die Programme auf dem neuesten Stand der Technik bleiben. Mit
Turbo Pascal 3.02A kann man heute keine groen Sprnge mehr machen und mein
TP 6.01 mu auch bald mal durch BP 7 ersetzt werden. Wenn sich gengend
Leute dafr interessieren (Der Wink mit dem Zaunpfahl: registrieren lassen),
knnten dann auch mal Windows Versionen von CDPlay und anderen IB-Soft
Programmen auftauchen. Momentan verliere ich aber auch noch nicht den Boden
unter den Fen, auf einem 286er sind grundstzlich ALLE Programme von
IB-Soft prima lauffhig. So, jetzt ist diese verfluchte Dokumentation aber
schon wieder fast zu lang geworden, also sollte ich wohl mal aufhren zu
tippen. Nur noch eines: Das Programm hat keine einzige Warteschleife und
nur das schlechte Gewissen wird am Anfang und Ende etwas angeregt. Wer aber
da auch noch die Adresse raushacken will, ist ein ganz, ganz bser Fiesling!
Dessen CD-ROM Laufwerk mge ihn mit der Schublade erschlagen.


                            I B - S O F T
                            Ingo Bttcher
                            Borkumer Str. 10
                            27755 Delmenhorst
                            Tel: 04221/20858 
                            (bitte mglichst zwischen 18 und 21 Uhr anrufen!)
                            
                            
                            

 Ende dieser Dokumentationsdatei