
     CDP (12 Feb 1996)       Command Line CD Player                     CDP



     NAME:

          CDP - Kommandozeilen Audio-CD Player

     SYNOPSIS:

          cdp [{option | kommando}]


     DESCRIPTION:

          cdp  ist  ein  kommandozeilenorientierter  Audio-CD Spieler,
          welcher auf die Dienste  von  MSCDEX  verzichtet  und  nicht
          resident im Speicher verbleibt (kein TSR).

          MSCDEX  nicht  zu bercksichtigen spart circa 16KB Speicher,
          erfordert  aber  auch  etwas  mehr  Untersttzung  bei   der
          Installation  durch den Nutzer. Auch bedeutet das, da jetzt
          zwar Audiospuren abgespielt werden knnen, jedoch nicht  auf
          die Datenspuren   zugegriffen   werden  kann.    Ist  MSCDEX
          geladen, funktioniert cdp trotzdem.

          cdp verbleibt nach Programmende nicht im Speicher. Das spart
          Speicher  und  Rechenzeit,  doch   konnten   Funktion   wie:
          zuflliges  Abspielen  und  endloses Abspielen deshalb nicht
          implementiert werden.

          Alle Optionen und Kommandos werden  von  links  nach  rechts
          abgearbeitet.  Vergleiche hierzu die Sektion EXAMPLES.

          Falls  kein  Kommando  angegeben wurde, wird in Abhngigkeit
          vom Dateinamen ein Standardkommando ausgefhrt.   Vergleiche
          hierzu Sektion DEFAULT ACTION.

          Bevor  ein Kommandozeilenargument ausgewertet wird, wird der
          Inhalt der Umgebungsvariablen  "SKAUS18A"  gelesen.    Deren
          Inhalt  wird  genauso  interpretiert,  als  wre er Teil der
          Kommandozeile, auer da alle Argumente, welche keine Option
          darstellen, ignoriert  werden.    Wurde  zum  Beispiel   die
          Umgebungsvariable durch "SET SKAUS18A= /D:NECD001 /U:2 play"
          gesetzt,  verhalten  sich  alle weiteren Aufrufe von cdp so,
          als ob "/D:NECD001" und "/U:2" als die ersten zwei Argumente
          angegeben wren.    Das  Kommando  "play"  wird   ignoriert.
          Unbekannte Optionen lsen einen Fehler aus.


     OPTIONS:


      /? and /h Ausgabe eines Hilfebildschirms.

      /D:name Device  name.   Verwendung von name als Treibernamen, um
          mit dem CD-ROM Treiber zu kommunizieren.  Dies  ist  in  den
          meisten  Fllen  derselbe  Name,  wie  in  der gleichnamigen
          Option Ihres CD-ROM Treibers bzw.  von MSCDEX.  Falls  nicht
          durch   den   Aufruf   von   CDP_INST   gendert,   ist  der
          Standardname: MSCD001.


                                      -1-


     CDP (12 Feb 1996)       Command Line CD Player                     CDP



      /D Setzt den Treibernamen auf den Standardnamen zurck.

      /U:# Unit number.  Verwendung der  Einheit  #  als  Subunit  des
          CD-ROM Gertes.    Falls nicht durch den Aufruf von CDP_INST
          gendert, ist der Standardwert: 0.

      /U Setzt die Einheitennummer wieder auf den Standard zurck.

      /[+-]A Auto-Unlock. Falls das '+' Zeichen  angegeben  ist,  wird
          Auto-Unlock aktiviert.  Falls das '-' Zeichen angegeben ist,
          wird Auto-Unlock  deaktiviert.   Ansonsten wird der aktuelle
          Zustand umgeschalten.  Falls  nicht  durch  den  Aufruf  von
          CDP_INST gendert, ist der Standardzustand: deaktiviert.

          CD-ROM Gerte mit Schlitten erlauben das automatische ffnen
          und  Schlieen des Schlittens. Um Probleme zu vermeiden, die
          aus dem  ffnen  der  Tr  zu  einem  ungnstigen  Zeitpunkt
          resultieren,  ist  es mglich, das ffnen zu verhindern (der
          Schlitten wird gelockt/verriegelt).  Ist Auto-Unlock  aktiv,
          wird  dieser  Schutz  automatisch  zurckgesetzt,  wenn  der
          Schlitten  geffnet  werden  soll,  anderenfalls  wird  eine
          Fehlermeldung ausgegeben.

      /V Anzeige der Versionsinformation, dann Programm beenden.


     COMMANDS:


          Jedes  Kommando  kann  bis  zu  den  Zeichen  links  von der
          schlieenden Klammer   abgekrzt   werden.      Gro-    und
          Kleinschreibung wird ignoriert.

          Falls   ein   Kommando   eine  geschlossene  Tr  zu  seiner
          Ausfhrung erwartet, ist der Schlitten  jedoch  offen,  wird
          automatisch ein "close" Komamndo ausgefhrt.

      e)ject  ffnet  den  Schlitten.  Ist  der  Schlitten  verriegelt
          (gelockt), und ist Auto-Unlock deaktiviert, wird ein  Fehler
          ausgelst.   Nicht alle CD-ROM Laufwerke untersttzen dieses
          Kommando.

      c)lose Schliessen des Schlittens und Initialisierung des  CD-ROM
          Treibers.     Diese    Prozedur    stoppt    ebenfalls   die
          Audiowidergabe. Nicht  alle  CD-ROM  Laufwerke  untersttzen
          dieses Kommando.

      s)tatus  Anzeige  des Status des CD-ROM Treibers. Hierbei werden
          mehr oder weniger ntzliche Informationen ausgegeben.

      sto)p Dieses Kommando ist identisch zu close.

      l)ock Lock door.   Schlitten  verriegeln.    Nicht  alle  CD-ROM
          Laufwerke untersttzen dieses Kommando.

      u)nlock Unlock door.    Schlitten entriegeln.  Nicht alle CD-ROM
          Laufwerke untersttzen dieses Kommando.


                                      -2-


     CDP (12 Feb 1996)       Command Line CD Player                     CDP



      t)racks Anzeige der bersicht aller Spuren der CD. Die folgenden
          Informationen werden angezeigt:

             Tracks: 1 - 17
             Size: 55 min 34 sec 15 frames
             UPC/EAN: ??????????????

               Trk    start    length   track  Cpy Aud Pre
               N   Mn Sc Fm  Mn Sc Fm  type   Pro Chn Emp
               001  00 02 00  14 36 55  data   yes  2  no
               002  14 38 55  03 36 16  audio  yes  2  no

          Zeile 1 zeigt die Anzahl der Spuren auf der CD an.
          Zeile 2 gibt die Gesamtgre der CD an.
          Zeile 3 stellt den UPC/EAN code dar.  Dieser Code soll  eine
          CD  Reihe  identifizieren,  nur  wenige  ltere CDs besitzen
          einen solchen Code, neuere CDs, besonders  Audio-CDs,  haben
          einen solchen.
          Zeilen  4  und 5 beinhalten den Kopf und ab Zeile 6 wird der
          Tabellenkrper angezeigt.   Jeder  Spur  wird  hierbei  eine
          Zeile  zugeordnet  und  folgende  Information angezeigt (von
          links nach rechts):
              1) Spurnummer,
              2) Spurstart Minute, Sekunde, Frame,
              3) Spurlnge Minute, Sekunde, Frame,
              4) Daten- oder Audiospur,
              5) kopiergeschtzt ja/nein,
              6) Anzahl von Audiokanlen, und
              7) Preemphasis ja/nein.

          Achtung: cdp hat keinen eingebauten Pager, so da bei groen
          CDs Zeilen aus dem Bildschirm geschoben werden.   Durch  die
          Eingabeumlenkung  in  das  Programm  more  kann  das behoben
          werden, zum Beispiel: "cdp tracks | more".

      p)lay Play audio  tracks.      Audiospuren   abspielen.      Ein
          zustzliches  Argument teilt cdp mit, welche Spuren gespielt
          werden sollen:
             # nur Spur Nummer # spielen.
             #- alle Spuren, beginnend mit Nummer #, spielen
             #-# die Spuren von # bis # abspielen.
          Ohne  dieses  Argument  wird  "1-"  angenommen,  was   einem
          Abspielen der   gesamten   CD  gleichkommt.    Zwischen  dem
          Bindestrich und der Nummer sind keine Leerzeichen erlaubt!

          Falls  eine  Spurnummer  eine  Datenspur  oder  eine   nicht
          existente  Spur  angibt,  wird diese Spur bersprungen, ohne
          da eine  Fehlermeldung  ausgegeben  wird.     Nachdem   die
          Audiowidergabe  gestartet  wurde, wird mit der Meldung "CDP:
          Playing  tracks  #-#."  darber  informiert,  welche  Spuren
          tatschlich gespielt werden.

      i)splaying  Test,  ob  zur  Zeit  die  Audiowidergabe aktiv ist.
          Falls NICHT, wird  cdp  mit  der  Fehlernummer  (Exit  code,
          errorlevel) 100 beendet.  Ansonsten wird ganz normal mit dem
          nchsten Kommando   fortgesetzt.      Dieses  Kommando  kann
          eingesetzt   werden,    um    herauszubekommen,    ob    die


                                      -3-


     CDP (12 Feb 1996)       Command Line CD Player                     CDP


          Audiowidergabe gerade aktiv ist oder nicht.

      n)otplaying Das  ist  das  Gegenstck  zu isplaying.  Es beendet
          cdp, FALLS die Audiowidergabe aktiv ist.

      dooro)pened Test, ob der Schlitten offen ist.   Falls  JA,  wird
          mit  dem  nchsten  Kommando  fortgesetzt, ansonsten mit der
          Fehlernummer (Exit code, errorlevel) 101 geendet.

      doorc)losed Das ist das Gegenstck  zu  dooropened.    cdp  wird
          beendet, FALLS der Schlitten offen ist.


     DEFAULT ACTION:


          Ist  kein Kommando auf der Kommandozeile angegeben, wird ein
          Standardkommando ausgefhrt.  Dieses  hngt  vom  Namen  der
          gestarteten Datei ab.  Beginnt der Name mit:
             EJECT
             CLOSE
          wird   das   gleichnamige   Kommando  ausgefhrt,  ansonsten
          "PLAY".


     KNOWN BUGS:

      o Die Fehlerbehandlung ist rudimentr.  Eine Meldung wie  "Error
          10"  deutet  darauf  hin, da der CD-ROM Treiber eine Aktion
          nicht ausfhren  konnte,  obwohl  sie  zu  diesem  Zeitpunkt
          ausfhrbar sein  mu.   Das kann verschiedene Ursachen habe,
          zum Beispiel:
              a) der  CD-ROM  Treibername  oder  die  Unitnummer  sind
              falsch (vergleiche die Optionen /D: und /U:),
              b) die CD-ROM wird gerade als Daten-CD genutzt, oder
              c)  das  CD-ROM  Laufwerk  ist gerade mit der Ausfhrung
              eines Kommandos beschftigt, ohne den Treiber  davon  in
              Kenntnis  zu  setzen, zum Beispiel whrend des manuellen
              ffnens und Schlieens des Schlittens.


     EXAMPLES:


      cdp
          Startet die Audiowidergabe der gesamten CD. Alle Datenspuren
          werden ignoriert, der Schlitten wird bei Bedarf  automatisch
          geschlossen.

      ejectcd
          ffnen des Schlittens. Das setzt voraus, da die ausfhrbare
          Datei  in  "EJECTCD.COM"  umbenannt  oder kopiert wurde, zum
          Beispiel mit "REN CDP.COM EJECTCD.COM"  oder  "COPY  CDP.COM
          EJECTCD.COM".

      ejectcd 10-
          Spielt alle Audiospuren, beginnend mit der Spur 10, ab.



                                      -4-


     CDP (12 Feb 1996)       Command Line CD Player                     CDP


      cdp /d:opt /u:3 e /d 4
          ffnet den Schlitten des Gerts Nummer 3 des Treibers "OPT",
          danach  Starten  der  Audiowidergabe  der  Spur 4 des Gerts
          Nummer 3 des Standardtreibers.

      cdp isplaying
          Die Batchdatei:
              @echo off
              cdp i
              if not errorlevel 1 goto isPlaying
              if errorlevel 100 if not errorlevel 101 goto notPlaying
              echo Ein Fehler ist aufgetreten.
              goto end
              :notPlaying
              echo Audiowidergabe nicht aktiv.
              goto end
              :isPlaying
              echo Audiowidergabe aktiv.
              :end
          stellt fest, ab gerade die Audiowidergabe  aktiv  ist,  oder
          nicht, und gibt eine dementsprechende Meldung aus.

      cdp isplaying stop
          Falls  die  Audiowidergabe  aktiv  ist, wird diese gestoppt.
          Ansonsten werden keine nderungen vorgenommen.    Wrde  das
          Kommando  "stop"  allein angegeben, wrde auf jeden Fall der
          Schlitten geschlossen  und  das  Treiber  neu  initialisiert
          werden.


     ERRORLEVELS:


          Die  folgenden  Fehlernummern  (Exit Code, Errorlevel) haben
          eine spezielle Bedeutung:

      0 Kein Fehler.

      127 Hilfebildschirm angezeigt.

      100  Die  Kommandos  "isplaying"  und  "notplaying"  habe  einen
          gegenstzlichen Zustand vorgefunden.

      101  Die  Kommandos  "dooropened"  und  "doorclosed"  habe einen
          gegenstzlichen Zustand vorgefunden.

      ansonsten Ein Fehler ist aufgetreten.


     CONTRIBUTERS:

                            Steffen Kaiser
                       Ernst-Thlmann-Strae 2
                             D-39606 Iden
                        Deutschland - Germany

          e-mail: Steffen.Kaiser@Informatik.TU-Chemnitz.DE



                                      -5-


     CDP (12 Feb 1996)       Command Line CD Player                     CDP



          Groen  Dank  an  Dave  Dunfield,  welcher  diesen  herrlich
          kleinen Compiler "Micro-C" als Freeware verfgbar machte.

























































                                      -6-

