home *** CD-ROM | disk | FTP | other *** search
/ ST-Computer Leser-CD 1999 January / STC_CD_01_1999.iso / musik / cadance / cadance.txt < prev   
Text File  |  2000-01-08  |  18KB  |  408 lines
  1.                                CaDance
  2.  
  3.                     Dokumentation zur Version 1.00
  4.                               20.09.1998
  5.  
  6.                                  von
  7.  
  8.                            Christian Krüger
  9.                            Im Erpelgrund 16
  10.                              13503 Berlin
  11.  
  12.                        Internet: chris@pace.de
  13.  
  14.  
  15.  
  16. Inhaltsverzeichnis
  17. ==================
  18.  
  19.  1  Rechtliches / Copyright
  20.     1.1  Haftungsausschlu₧
  21.     1.2  Warenzeichen
  22.     1.3  Spenden
  23.  
  24.  2  Motivation
  25.  
  26.  3  Installation
  27.  
  28.  4  Die Bedienung
  29.  
  30.  5  Fragen & Antworten
  31.  
  32.  6  Ausblick
  33.  
  34.  7  Changes
  35.  
  36.  8  Kontaktadresse
  37.  
  38.  
  39.  
  40. 1  Rechtliches / Copyright
  41. **************************
  42.  
  43. Das Copyright  an CaDance und dieser Dokumentation liegt bei Christian
  44. Krüger, Berlin. Die Weitergabe des Programms  ist  grundsätzlich  frei
  45. (Stichwort FREEWARE). Folgende Hinweise sind jedoch zu beachten:
  46.  
  47.    ∙ Das  Programm  darf  generell nur kostenlos weitergegeben werden.
  48.      Der Upload in gebührenfreie Mailboxen und  auf  nichtkommerzielle
  49.      FTP-Server ist erlaubt und erwünscht.
  50.  
  51.    ∙ Das  Archiv  mu₧  komplett verbreitet werden (mit Dokumentation).
  52.      Au₧erdem  dürfen  keine  weiteren  Dateien  hinzugefügt   werden,
  53.      insbesondere  keine  Mailboxwerbung  und  keine  Werbung  für PD-
  54.      Serien.  Die  Umbenennung  oder  das  Umpacken  des  Archivs  ist
  55.      unerwünscht.
  56.  
  57.    ∙ Das  Programm darf anderen Programme beigelegt werden - unter der
  58.      Voraussetzung,   da₧   ich   *vor   der   Veröffentlichung* darüber
  59.      informiert   werde   und   ein   eindeutiger   Hinweis   auf  die
  60.      Urheberschafft erfolgt (z.B. hervorgehoben im 'README').
  61.      Auch hier gilt obiges 'Vollständigkeitsprinzip'!
  62.  
  63.    ∙ Für die Weitergabe auf Disketten im Rahmen  einer  Public-Domain-
  64.      Serie dürfen keine Gebühren verlangt werden, die einen Betrag von
  65.      5 DM (exklusive Versandkosten) überschreiten.
  66.  
  67.    ∙ Die  Weitergabe  via  CD-ROM  darf  nur  dann  ohne  schriftliche
  68.      Genehmigung  erfolgen,  wenn  der  Preis  der  CD  pro bespieltem
  69.      MegaByte 0.1 DM nicht übersteigt!
  70.  
  71.  
  72. 1.1  Haftungsausschlu₧
  73. ======================
  74.  
  75. Trotz sorgfältiger Entwicklung  und  umfangreichen  Tests  kann  keine
  76. Gewährleistung  für  die  Richtigkeit des Inhalts dieser Dokumentation
  77. und die einwandfreie Funktion von "CaDance" übernommen werden.
  78.  
  79. Der Autor kann keine Haftung für irgendwelche direkten oder indirekten
  80. Schäden  -  einschlie₧lich  aber  nicht beschränkt auf materielle oder
  81. finanzielle - übernehmen, die durch die Benutzung von  "CaDance"  oder
  82. dessen Untauglichkeit für einen bestimmten Zweck entstehen.
  83.  
  84.  
  85. 1.2  Warenzeichen
  86. =================
  87.  
  88. Innerhalb dieser  Dokumentation  kann  auf Warenzeichen Bezug genommen
  89. werden, die nicht explizit als solche ausgewiesen sind. Aus dem Fehlen
  90. einer  Kennzeichnung  kann nicht geschlossen werden, da₧ ein Name frei
  91. von den Rechten Dritter ist.
  92.  
  93.  
  94. 1.3  Spenden
  95. ============
  96.  
  97. Wie schon  erwähnt  ist  CaDance  Freeware.  Ich  habe  aber   selbst-
  98. verständlich  nichts gegen TOS-Programmentwicklungsstützungskäufe ;-).
  99. Wer mir also eine motivationssteigernde Spende zukommen lassen möchte,
  100. kann  das  über  die Kontaktadresse tun. Meine Bankverbindung entnimmt
  101. man der Freedom2-Dokumentation
  102.  
  103.  
  104.  
  105. 2  Motivation
  106. *************
  107.  
  108. Schon wieder ein CD-Player werden vielleicht einige  bei  dem  Anblick
  109. dieser  ECPX  sagen.  Ja - schon wieder einer, obwohl es auf dem Atari
  110. eine reichliche Auswahl von CD-Playern existiert. Warum also habe  ich
  111. dieses Programm geschaffen?
  112.  
  113. Ich höre  sehr  gerne  Musik  von 'Mike Oldfield' und bin auch Klassik
  114. nicht abgeneigt. In diesem Zusammenhang  haben  alle  Player  die  mir
  115. bisher untergekommen sind ein ganz grosses Manko: Sie orientieren sich
  116. an  der  Bedienung  der   'echten'   CD-Player,   obwohl   diese   aus
  117. Kostengründen eher spartanische Bedienungsmöglichkeiten anbieten.
  118. So  wird  es bei oben genannten CDs sehr schwierig 'mal eben' zu einer
  119. 'schönen Stelle' zu springen, obwohl man ungefähr wei₧, wo diese  sich
  120. befindet.  Das  ständige Betätigen der 'Vorlauftaste' (nötig bei allen
  121. Playern die ich kenne) wird schlicht und einfach bei  längeren  Tracks
  122. zu  einer  nervigen  Angelegenheit ('AMAROK' von Mike Oldfield enthält
  123. einen einzigen  Track  von  über  60  Minuten  -  wer  will  da  schon
  124. freiwillig mal eben in die 32 Minute 'reinhören'?).
  125. Lange  Rede,  kurzer  Sinn:  CaDance  ermöglicht auf recht komfortable
  126. Weise das Ansteuern solcher Positionen.
  127.  
  128. Damit aber  noch  nicht  genug:  CaDance  ist  der   kompakteste   und
  129. wahrscheinlich  'speicherfreundlichste'  Player  der Ihnen unterkommen
  130. wird: Nur ca. 15k müssen Sie für CaDance  'abzweigen'.  Andere  Player
  131. verbrauchen  locker das Doppelte! Dafür müssen Sie allerdings auch auf
  132. 'Schnick-Schnack' verzichen: Au₧er  der  reinen  Abspielfunktionalität
  133. bietet CaDance nichts Besonderes.
  134. /Das  CaDance so kompakt ist, liegt natürlich an der gut ausgestatteten
  135. Funktionsschnittstelle von Freedom2, über die CaDance vieles erledigt./
  136.  
  137. Ein weiterer (indirekter) Vorteil von CaDance ist vielleicht,  da₧  es
  138. die  Funktionsuntüchtigkeit der 'Mucke-CPX' (ein CD-Player von Steffen
  139. Engel) unter Freedom2 (hoffentlich)  verschmerzbar  macht.  Ich  weise
  140. hiermit  nocheinmal  ausdrücklich darauf hin, da₧ der Fehler nicht bei
  141. Freedom2 liegt!
  142.  
  143.  
  144.  
  145. 3  Installation
  146. ***************
  147.  
  148. Zum Betrieb    von    CaDance    benötigt    man    das    alternative
  149. Kontrollfeld/Dateiselektor   Freedom2.   In  welchem  Verzeichnis  man
  150. CaDance ablegt ist egal, es kann 'überall' von Freedom2 aus  gestartet
  151. werden.  Ich  empfehle  (wegen des einfacheren Zugriffs) den Standard-
  152. CPX-Pfad (z.B. C:\CPX).
  153.  
  154. Weiterhin verlangt  CaDance  zwingend  nach  'MetaDOS'  (oder   hierzu
  155. kompatiblen  Treiber  (z.B.  'BetaDOS')) und einem 'FCntl' fähigem CD-
  156. Treiber. Die aktuelle Version der CD-Tools unterstützen auf jeden Fall
  157. diese   Art  des  Zugriffs.  Aber  auch  bei  anderen  über  'MetaDOS'
  158. einbindbare Treibern werden die 'FCntl'-Aufrufe unterstützt.  So  z.B.
  159. auch  von  den  SoundPool  CD-Recorder Treibern. Mit 'SPIN' von Julian
  160. Reschke sollte CaDance auch problemlos laufen.
  161. Im Zweifelsfall probiert man einfach CaDance aus und lauscht der Dinge
  162. die da hoffentlich kommen mögen...
  163.  
  164.  
  165.  
  166. 4  Die Bedienung
  167. ****************
  168.  
  169. Die Bedienung  orientiert sich wie schon Eingangs erwähnt *nicht* an der
  170. üblichen Bedienung von CD-Playern. Stattdessen habe ich den  (wie  ich
  171. finde erfolgreichen) Versuch unternommen, gebräuchliche Bedienelemente
  172. von Software zu verwenden.
  173.  
  174. /Damit man dennoch nicht auf  das  'Stereo-Anlagen-Feeling'  verzichten
  175. mu₧, ist die Oberfläche im edelen 'Schwarz-Gold-Look' gehalten (soweit
  176. dieses die Grafikhardware zulässt):/
  177.  
  178. Beim Start von  CaDance  wird  man  aber  eventuell  *nicht* mit  dieser
  179. Oberfläche 'konfrontiert'. Das kann drei Gründe haben:
  180.  
  181.    ∙ CaDance beanstandet das Fehlen eines passenden CD-Treibers
  182.  
  183.    ∙ es  ist  keine  CD im Laufwerk. CaDance verdeutlicht dieses durch
  184.      ein durchgestrichenes, blinkendes CD Symbol. Falls der CD-Treiber
  185.      das  'Laden'  von  CDs  unterstützt (siehe auch Kapitel 'Fragen &
  186.      Antworten'), kann man durch Klicken  auf  das  CD-Symbol  in  der
  187.      'nicht   durchgestrichenen   Blinkphase'   eine   CD   bzw.   den
  188.      Laufwerksschlitten  'einziehen'.  Wenn  die  CD  erfolgreich  als
  189.      Audio-CD erkannt wurde, nimmt CaDance obiges Aussehen an.
  190.  
  191.    ∙ der  CD-Player  befindet  sich im 'Pausen'-Modus. Das hei₧t, eine
  192.      Audio-CD  befindet  sich  im  Laufwerk  und  die  Wiedergabe  der
  193.      eingelegten  CD  wurde  durch die Betätigung des 'Pausen-Knopfes'
  194.      unterbrochen. In diesem Fall sind nicht alle Elemente von CaDance
  195.      verfügbar.  Dieser Modus ist auch daran erkennbar, da₧ ein Pausen
  196.      Symbol (zwei senkrechte Balken) erscheint und blinkt.
  197.      Durch Betätigung des 'Wiedergabe/Pausen-Knopfes'  (14)  wird  die
  198.      Wiedergabe   fortgesetzt  und  alle  Bedienelemente  sind  wieder
  199.      verfügbar.
  200.  
  201. Die Bedienelemente im einzelnen:
  202.  
  203.  *(1) Die Laufwerksauswahl* bestimmt das anzusprechende CD-Laufwerk.
  204.      Der stolze Besitzer von mehreren CD-Laufwerken kann hier folglich
  205.      das  aktive Laufwerk bestimmen. Die Laufwerkskennung bezieht sich
  206.      dabei *nicht* auf den 'GEMDOS'-Laufwerksbuchstaben, sondern ist die
  207.      Kennung  des  Laufwerkes,  wie sie der 'MetaDOS'-Anmeldung in der
  208.      'CONFIG.SYS' angegeben wurde. Das zuletzt  aktive  Laufwerk  wird
  209.      beim  Verlassen  der  ECPX  gesichert  und ist bei einem erneuten
  210.      Start von CaDance wieder das aktuelle.
  211.  
  212.  *(2),(3) Der Lautstärkeschieberegler* bestimmt  (soweit   vom   Treiber
  213.      unterstützt) die Ausgabelautstärke des CD-Laufwerkes.
  214.      Mit  Hilfe  des  'Schiebers'  lä₧t sich die Lautstärke analog der
  215.      Regler-Position beeinflussen. Wird der Bereich neben  dem  Regler
  216.      'angeklickt' so erhöht/vermindert sich die Lautstärke um den Wert
  217.      10.
  218.      Wie auch alle anderen Slider in CaDance, lä₧t sich der Regler auf
  219.      zweierlei Arten manipulieren:
  220.  
  221.         ∙ Der   Schieberegler   wird   angewählt  und  mit  gedrückter
  222.           Maustaste verschoben. Ein Loslassen  der  Maustaste  beendet
  223.           die Aktion.
  224.  
  225.         ∙ Der  Regler  wird  kurz  angeklickt.  Von nun an 'klebt' der
  226.           Regler am Mauszeiger und lä₧t sich verschieben. Ein weiterer
  227.           kurzer Klick löst die Verbindung.
  228.  
  229.  *(4),(5),(6),(7) Der 'Titelwähler'* wählt (Überraschung) den aktuell zu
  230.      spielenden Titel aus, bzw. zeigt ihn an.
  231.      Im Regler wird der aktuelle  Titel  neben  der  Gesamtanzahl  der
  232.      Titel  der  CD  angezeigt.  Der  zu spielende Titel kann entweder
  233.      direkt über den Regler (4) oder über die Richtungs-Pfeile (5) und
  234.      (6)  beeinflu₧t  werden.  Die Anwahl eines Richtungspfeils erhöht
  235.      (6) bzw. erniedrigt (5) den zu  spielenden  Titel  um  eins.  Das
  236.      gleiche  gilt  für einen 'Klick' neben den Regler im Bereich (7).
  237.      Ein Doppelklick auf die Richtungspfeile setzt  die  Titelposition
  238.      auf  den  Anfang  bzw.  das  Ende  der CD. Ein Doppelklick in den
  239.      Bereich (7) versetzt den Regler (4) direkt an  die  Position  des
  240.      Doppelklicks.  Die Titel-CD-Position kann selbstverständlich auch
  241.      während des Abspielens verändert werden.
  242.  
  243.  *(8),(9),(10),(11) Der Titelpositionsregler* dient der Manipulation der
  244.      Wiedergabeposition im aktuellen Titel.
  245.      Neben der aktuellen Titelposition im Format 'Minute:Sekunde' wird
  246.      die Gesamtzeit des Titels angezeigt. Für die  Bedinelemente  gilt
  247.      das  gleiche Prinzip wie beim Titelwähler. Der Richtungspfeil (9)
  248.      vermindert die Wiedergabeposition um eine Sekunde, der Pfeil nach
  249.      rechts  (10)  erhöht die Position um eine Sekunde. Die Anwahl des
  250.      Bereiches (11) neben dem Regler (8) erhöht  bzw.  erniedrigt  die
  251.      Wiedergabeposition  um  10 Sekunden. Der Doppelklick auf letztere
  252.      Elemente versetzt den Regler ebenfalls an den  Anfang,  das  Ende
  253.      oder  die direkte 'Klick'-Position. Auch dieses Steuerungselement
  254.      ist während der Wiedergabe aktiv.
  255.  
  256.  *(12) Der Auswurfknopf* wirft (wenn vom CD-Treiber unterstützt) die  CD
  257.      aus dem Laufwerk aus.
  258.  
  259.  *(13) Die Stop-Taste* stopt die Wiedergabe.
  260.      Dabei  wird aber *nicht* die CD/Titelposition zurückgesetzt, so da₧
  261.      die Wiedergabe  später  an  (fast)  gleicher  Stelle  fortgesetzt
  262.      werden kann (siehe auch 'Fragen & Antworten').
  263.  
  264.  *(14) Das Wiedergabe/Pausen-Feld* startet   die   Wiedergabe   an   der
  265.      eingestellten CD/Titelposition bzw. unterbricht diese.
  266.      Letzteres versetzt den CD-Player in  den  'Pausen-Zustand',  d.h.
  267.      fast  alle  anderen Bedienelemente werden blockiert (siehe oben).
  268.      Eine  nochmalige  Anwahl  des  Wiedergabe-'Knopfes'   setzt   das
  269.      Abspielen der CD fort und hebt die Blockierung auf.
  270.  
  271.  *(15) Der 'Ok'-Knopf oder 'Closer'* sichert  das  aktuell  eingestellte
  272.      Laufwerk (1) und schlie₧t  den  Dialog  ohne  die  Wiedergabe  zu
  273.      stoppen.
  274.  
  275.  
  276.  
  277. 5  Fragen & Antworten
  278. *********************
  279.  
  280.  Frage:    Warum  kann  CaDance  nicht die CD auswerfen/einziehen oder
  281.            die Lautstärke bei meinem Laufwerk  regeln,  obwohl  dieses
  282.            mit 'Mucke', XYZ etc. geht?
  283.  
  284.  Antwort:  CaDance  greift  über Ihren CD-Treiber auf das Laufwerk zu.
  285.            Wenn dieser Treiber die Kommandos für obige  Befehle  nicht
  286.            unterstützt,  so  kann CaDance Ihnen diese Fähigkeiten auch
  287.            nicht zur Verfügung stellen.  Andere  CD-Player  (wie  z.B.
  288.            'Mucke')  setzen direkt SCSI-Befehle an das Laufwerk ab und
  289.            benutzen dabei nicht einen  möglicherweise  einschränkenden
  290.            'FCntl'-Treiber. Beide Verfahren haben Vor- und Nachteile.
  291.  
  292.  
  293.  
  294.  Frage:    Warum  'zappelt'  der  Titelwähler  beim Start eines Titels
  295.            manchmal hin und her und springt an das Ende des vorherigen
  296.            Titels?
  297.  
  298.  Antwort:  Ein  kleines  Ärgernis  -  ich  wei₧.  Aber  die angezeigte
  299.            Titelposition ist bei einigen  CDs/Titeln  nicht  identisch
  300.            mit  der  Wiedergabeposition.  Das  liegt  *nicht* an CaDance
  301.            sondern  an  den  CDs.  Andere   Player   (auch   die   von
  302.            Stereoanlangen!)  zeigen  z.T. dann negative Zeiten vor dem
  303.            Titelstart an, oder  verharren  mehrere  Sekunden  auf  der
  304.            Position  '00:00'  bis  zum tatsächlichen Begin des Titels.
  305.            Beide 'Lösungen' sind für CaDance  aber  nicht  praktikabel
  306.            und brächten 'Ungereimtheiten' bei der Bedienung.
  307.  
  308.  
  309.  
  310.  Frage:    Das  'Vor-  oder  Zurückspulen'  eines Titels 'ruckelt' und
  311.            'hakt' manchmal etwas. Wie kommt das?
  312.  
  313.  Antwort:  CaDance liest jede Sekunde einmal  die  aktuellen  CD-Daten
  314.            des  Laufwerkes  aus.  Dieses  Auslesen  kann  das 'Spulen'
  315.            kurzzeitig unterbrechen und es kommt zu obigem Effekt. Eine
  316.            Änderung  bzw.  Optimierung dieses Verhaltens brächte einen
  317.            nicht vertretbaren Aufwand mit  sich  und  ein  'flüssiges'
  318.            Scannen  eines  Titels so wie beim Stereo-Anlagen-CD-Player
  319.            ist mit CD-ROM Laufwerken ohnehin nicht möglich.
  320.  
  321.  
  322.  
  323.  Frage:    Mir gefällt CaDance sehr gut.  Was  kann  ich  tun,  um  in
  324.            Zukunft  weitere, qualitativ hochwertige ECPXs für Freedom2
  325.            zu erhalten?
  326.  
  327.  Antwort:  Meine  Motivation  etwas   für   die   TOS-Kompatiblen   zu
  328.            programmieren  ist  direkt  von  Kontoeingängen für bereits
  329.            veröffentliche Werke abhängig ;-).  Das  klingt  vielleicht
  330.            lustiger  als  es  ist, enthält aber viel Wahrheit. CaDance
  331.            habe ich in erster Linie 'für mich' geschrieben und so  ist
  332.            es  wohl  nicht  verwunderlich  wenn  ich  gestehe, da₧ ich
  333.            dieses Programm schon seit ca. einem halben  Jahr  bei  mir
  334.            auf der Platte habe.
  335.            Eine  Veröffentlichung  kostet  viel Arbeit. Für mich hätte
  336.            ich  keine  Anleitung  schreiben  müssen,   und   mit   der
  337.            Herausgabe des Programms riskiere ich natürlich auch wieder
  338.            Fehlermeldungen  und  Verbesserungswünsche   von   Dritten,
  339.            obwohl das Programm /meine/ Wünsche voll und ganz befriedigt.
  340.            Aus Erfahrung wei₧ ich, da₧ es sinnlos ist ein Programm auf
  341.            'Freeware-Basis'   zu  veröffentlichen  um  damit  Support-
  342.            Wünschen von Benutzern zu entgehen - selbst wenn direkt auf
  343.            diesen Zusammenhang hingewiesen wird.
  344.            Daher meine Bitte: Wer in Zukunft noch Programme für 'sein'
  345.            Betriebssystem  veröffentlicht  sehen  will,  sollte   auch
  346.            direkt  zur  Unterstützung  der Programmierer beitragen. Es
  347.            wäre schön wenn ich  in  irgendeiner  Form  'Resonanz'  auf
  348.            dieses  Programm  bekommen  könnte,  um auch in Zunkunft zu
  349.            wissen,  ob  sich  der   Aufwand   einer   Veröffentlichung
  350.            überhaupt noch lohnt!
  351.            Besonders  freue ich mich natürlich über kleine finanzielle
  352.            Aufmerksamkeiten, die mir die Weiterentwicklung  (auch  von
  353.            Freedom2)  versü₧en.  Im  Gegensatz  zu grö₧eren 'Software-
  354.            Buden' kann ich nämlich nicht  die  gro₧e  kostenpflichtige
  355.            Update/Upgrade-Aktion starten...
  356.            Natürlich  auch noch einmal die (Auf-)Forderung an die noch
  357.            unregistrierten  Freedom2-Benutzer:  Registriert  euch  und
  358.            bezahlt  das  Programm!  Es  kann durchaus sein, da₧ ich in
  359.            absehbarer Zeit Neuerungen nur noch registrierten Benutzern
  360.            zugänglich mache...
  361.  
  362.  
  363.  
  364. 6  Ausblick
  365. ***********
  366.  
  367. Ich sehe  vorerst  keinen Bedarf dem Programm etwas hinzuzufügen. Wenn
  368. ich irgendwann mal zuviel Zeit haben sollte, baue ich vielleicht  noch
  369. eine   CD-Titel-Internet-Datenbank-Unterstützung  ein.  Für  zufällige
  370. Wiedergabe, Titelvorwahl, Anspielen und  Export  von  Titeln  gibt  es
  371. genug  gute  Alternativen,  so  da₧  ich  nicht  denke  hier  das  Rad
  372. nocheinmal 'erfinden' zu müssen.
  373.  
  374.  
  375.  
  376. 7  Changes
  377. **********
  378.  
  379. *Version 1.00*
  380. Erste öffentliche Version.
  381.  
  382. ...to be continued
  383.  
  384.  
  385.  
  386. 8  Kontaktadresse
  387. *****************
  388.  
  389. Falls Sie irgendwelche Fragen, Probleme oder Wünsche bezüglich CaDance
  390. haben sollten, können Sie mich unter folgender Adresse erreichen:
  391.  
  392. Christian Krüger
  393. Im Erpelgrund 16
  394. 13503 Berlin
  395.  
  396. Internet email: chris@pace.de
  397.  
  398. *Wichtig:* Wer  Kontakt  via  Sackpost zu mir aufnehmen will, der sollte
  399. (wenn er  eine  Antwort  erwartet)  einen  an  sich  adressierten  und
  400. ausreichend frankierten Rückumschlag beifügen!
  401. Von  privaten  Besuchen  bitte  ich abzusehen, die Erfolgschancen mich
  402. anzutreffen sind ohnehin ziemlich gering.
  403.  
  404. /Rächtzszeibunsfälör by Zeitmangel und Portfolio-Tastatur!/
  405.  
  406.  
  407.  
  408.