
     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 (auf Englisch).

      /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 CD_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  CD_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
          CD_INST gendert, ist der Standardzustand: deaktiviert.

          CD-ROM Gerte mit Schlitten erlauben das automatische ffnen
          und Schlieen des Schlittens. Um Problemen zu vermeiden, die
          aus  dem  ffnen  der  Tr  zu  einem  schlechten  Zeitpunkt
          resultieren,  ist  es mglich, das ffnen zu verhindern (der
          Schlitten wird gelockt).  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   gesichert
          (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  sichern.    Nicht  alle  CD-ROM
          Laufwerke untersttzen dieses Kommando.

      u)nlock Unlock door.  Schlitten entsichern.  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, jedoch haben derzeit nur wenige CDs
          einen solchen Code.
          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  Test,  if audio is playing.  If audio is
          NOT  playing,  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.


     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 Tribername 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.

      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:


                                      -4-


     CDP (12 Feb 1996)       Command Line CD Player                     CDP


              @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.

      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-

