home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d966 / cdtv-player.lha / CDTV-Player / Docs / liesmich next >
Text File  |  1993-09-30  |  17KB  |  463 lines
  1.    ********************************
  2.    **                            **
  3.    **      CDTV-Player 2.3       **
  4.    **                            **
  5.    **    erstellt im April 1993  **
  6.    **                            **
  7.    **      von Daniel Amor       **
  8.    **                            **
  9.    ********************************
  10.  
  11.  
  12.    I. Einleitung
  13.  
  14.    Willkommen zum CDTV-Player 2.3
  15.  
  16.    Die Idee für dieses Programm kam mir, als ich vor meinem CDTV saß und 
  17.    gleichzeitig Musik hören und arbeiten wollte. Es gibt zwar die 
  18.    Möglichkeit während der Arbeit auf der Workbench die Play-Taste zu
  19.    drücken, aber die einzige Information, die man erhält ist die 
  20.    Tracknummer. Die andere Möglichkeit Audio-CDs abzuspielen war auf das
  21.    Multitasking zu verzichten und den eingebauten Player zu benutzen.
  22.    Dies fand ich ziemlich übel. In der deutschen Zeitschrift 'AMIGA-DOS'
  23.    habe ich zum Glück ein Programm von Dr. Peter Kittel (Commodore 
  24.    Deutschland) in AMIGA-BASIC gefunden. Dieses Programm sah eher aus 
  25.    wie ein C-64 Programm mit vielen PEEKS und POKES. Aus diesem Grunde
  26.    übersetzte ich es nach KICK-PASCAL (Zeilen in AmigaBasic : Zeilen in
  27.    Kick-Pascal = 200 : 15) and entwarf eine Workbench-Oberfläche 
  28.    (September 1992). Dieses Programm ist FISH-WARE. Commodore hat das Recht
  29.    dieses Programm zusammen mit dem original CDTV-Paket oder mit jedem
  30.    CD-ROM zu vertreiben. Wenn Sie das Programm professionell einsetzen,
  31.    erwähnen Sie bitte meinen Namen.
  32.  
  33.  
  34.    II. Funktionen
  35.  
  36.    CDTV-Player 2.3 besitzt eine Menge neuer Funktionen. Zuerst einmal habe
  37.    ich Preferences hinzugefügt, um das Programm benutzerfreundlicher zu
  38.    gestalten (dies wird in Zukunft ausgebaut). Dann habe ich eine Routine
  39.    programmiert, die die CDs erkennt, wenn sie sich im Archiv befinden 
  40.    (Vielen Dank an Frédéric Botton - Paris für sein Programm «Gimme_a_CD»
  41.    und der Idee). Dann habe ich noch eine SHUFFLE Funktion eingebaut und die
  42.    Option zwei Sekunden vor oder zurück zu springen (BACK und FORTH).
  43.    In früheren Versionen konnten nur Besitzer eines CD-ROM-Laufwerks das
  44.    Programm benutzen. Jetzt hat jeder AMIGA-Benutzer Zugriff auf das Archiv,
  45.    um z.B. ein Lied zu suchen oder nur um das Programm anzuschauen. Ich habe
  46.    jetzt die Funktion KARAOKE. Wenn sich die Liedtexte im Archiv können sie
  47.    auf dem Bildschirm angezeigt werden. Jetzt wurde noch ein AREXX-Port ein-
  48.    gebaut, damit man die Funktionen des CDTVs von anderen Programmen steuern
  49.    kann.
  50.    
  51.  
  52.    III. Gadgets
  53.  
  54.    Hier ist eine kurze Liste der Gadgets:
  55.  
  56.    REW     : Veringert die Titelnummer.
  57.    PLAY    : Spielt den aktuellen Titel.
  58.    FF      : Erhöht die Titelnummer.
  59.    PAUSE   : Macht eine Pause.
  60.    STOP    : Bricht den aktuellen Titel ab.
  61.    FADE    : An- und Abschwellen der Lautstärke.
  62.    LIVE    : Automatischen Anschwellen am Anfang des Liedes und automatisches
  63.              Abschwellen am Ende.
  64.    SINGLE  : Wechsel zwischen einem Lied und der ganzen CD.
  65.    REPEAT  : Wechsel zwischen einfachem und mehrfachem Abspielen.
  66.    BACK    : Springt zwei Sekunden zurück.
  67.    SCAN    : Spielt jedes Lied kurz an.
  68.    FORTH   : Springt zwei Sekunden vor.
  69.    SECRET  : Zukünftige Optionen.
  70.    KARAOKE : Echtzeit-Karaoke (Siehe V. KARAOKE)
  71.    SHUFFLE : Wechsel zwischen normaler und zufälliger Abspielreihenfolge.
  72.    PROGRAM : Programmiert Abspielreihenfolge.
  73.    PREFS   : Zugang zu den Voreinstellungen. (Siehe VII. Preferences)
  74.    EDIT    : Öffnet das Edit-Fenster. (Siehe IV. EDIT)
  75.    DISPLAY : Es gibt fünf Anzeige-Modi:
  76.              1. Die schon gespielte Titelzeit.
  77.              2. Die noch zu spielende Titelzeit.
  78.              3. Die schon gespielte Gesamtzeit.
  79.              4. Die noch zu spielende Gesamtzeit.
  80.              5. Keine Anzeige (nimmt weniger Prozessorzeit in Anspruch).
  81.              Die Modi 3&4 können nur angewählt werden, wenn SINGLE 
  82.              ausgeschaltet ist. 
  83.    INFO    : Zeigt ein Informationsfenster an.
  84.  
  85.    Es gibt ein Scroll-Gadget am rechten Rand, mit der Sie die Lautstärke
  86.    einstellen können.
  87.  
  88.  
  89.    IV. Edit
  90.  
  91.    Wenn man das EDIT-Gadget im Hauptfenster drückt, öffnet sich ein neues
  92.    Fenster und Sie bekommen Zugriff zum Archiv. In früheren Versionen
  93.    mußten Sie hier die CD auswählen, die Sie hören wollten. Dies wird nun
  94.    automatisch gemacht, so daß Sie das Archiv nur noch anschauen können.
  95.    Wenn Sie die Lieder einer CD anschauen möchten, dann klicken Sie den
  96.    entsprechenden Titel an. Wenn der CDTV-Player die CD nicht im Archiv 
  97.    findet, haben Sie die Möglichkeit diese CD zum Archiv hinzuzufügen, indem 
  98.    man das ADD CD-Gadget anklickt. Ein neues Fenster öffnet sich und man 
  99.    kann die neue CD eingeben. Wenn man eine Gruppe auswählt, so erscheint
  100.    der Gruppenname automatisch im ersten Feld.
  101.  
  102.    
  103.    V. Karaoke
  104.  
  105.    Wenn man das KARAOKE-Gadget anklickt, sucht das Program nach den 
  106.    Liedtexten des aktuellen Liedes. Wenn sie sich im Archiv befinden,
  107.    werden sie auf einem eigenem Schirm anzeigt, während das Lied abgespielt
  108.    wird. Im Augenblick gibt es keine Spezialeffekte, die werden jedoch in
  109.    naher Zukunft eingebaut (Ideen sind immer willkommen). Wenn Sie eigene
  110.    KARAOKE-Lieder entwerfen wollen, schauen Sie sich "lyrics:depeche mode.mx"
  111.    an (das einzig komplette, da ich zu faul bin alle meine CDs einzugeben).
  112.    Wenn man ein Genlock besitzt, kann man es für KARAOKE benutzen.
  113.  
  114.  
  115.    VI. Archiv
  116.  
  117.    Das Archiv ist in zwei Teile gespalten. Der erste Teil enthält die 
  118.    Gruppennamen und die CD Titel, CD Zeit, Anzahl der Lieder (z.B. Brian
  119.    Adams, Waking up the neighbours,74:54.38|15). In früheren Versionen
  120.    hatte ich auf die Hunderstelsekunden und die Anzahl der Lieder verzichtet.
  121.    Dies erwies sich aber als nicht besonders genau bei der CD-Suche, so daß
  122.    ich es hinzufügen mußte. Der zweite Teil des Archivs enthält die 
  123.    Gruppendaten mit den Liedernamen und den Texten.
  124.  
  125.    WICHTIGE BEMERKUNG:
  126.  
  127.    Obwohl es einen Standard für AUDIO-CDs gibt, kann es vorkommen, daß die
  128.    gleiche CD in verschiedenen Ländern eine unterschiedliche Spielzeit 
  129.    aufweist. Sollten Sie eine CD besitzen, die sich im Archiv befindet, jedoch
  130.    nicht erkannt wird, dann ändern Sie die Zeit, die im ADD-CD Fenster 
  131.    angezeigt wird (normalerweise handelt es sich nur um einige Sekunden). 
  132.    Ich werde wohl ein Funktion einbauen, was die Änderung der Zeit nachträglich
  133.    erlaubt.
  134.  
  135.  
  136.    VII. Preferences
  137.  
  138.    In diesem Menü können Sie einige Einstellungen ändern. Auf der linken Seite
  139.    befinden sich zwei Slider-Gadgets. Mit dem oberen kann man die Dauer für das
  140.    Ein- & Ausblenden am Anfang und am Ende des Liedes einstellen (1Sek - 10Sek).
  141.    Mit dem unteren kann man die Scan-Zeit einstellen (5Sek - 25Sek). Auf der
  142.    rechten Seite befinden sich zwei Check Boxes, die beide in Verbindung mit 
  143.    KARAOKE nützlich sind. 'Break' ermöglicht das Abbrechen des KARAOKE während 
  144.    des Spielens (es wird ein Close-Gadgets angezeigt). 'Time' erzeugt auf 
  145.    dem KARAOKE-Schirm eine Zeitanzeige. Dies wurde eingeführt, um die Eingabe
  146.    neuer KARAOKE-Titel zu vereinfachen. Beim Speichern wird ein File mit dem
  147.    Namen s:CDTV.config angelegt.
  148.  
  149.    
  150.    VIII. Die Zukunft
  151.  
  152.    Ich werde eine Funktion einbauen, die COPY heißt, die das Kopieren der 
  153.    CD's auf Kassette vereinfachen wird. Sie geben nur die Zeit an, die auf
  154.    der Kassette noch vorhanden ist und das Programm wird die Lieder 
  155.    heraussuchen, die möglichst nahe an die Vorgaben herankommen.
  156.  
  157.    Ich werde versuchen PARNET in das Programm zu integrieren, um z.B.
  158.    einen AMIGA 4000 für KARAOKE zu benutzen, während eine CD im CDTV 
  159.    abgespielt wird (d.h. es wird mehr & schnellere Effekte geben). 
  160.  
  161.    Ich werde versuchen SCSI-Drives ins Programm mit aufzunehmen (wenn
  162.    jemand Informationen über SCSI-Drives besitzt, dann her damit). 
  163.  
  164.    Wenn jemand Vorschläge, spezielle Bedürfnisse oder nützliche 
  165.    Informationen besitzt, dann setzen Sie sich mit mir in Verbindung.
  166.    Siehe XIV. Adresse.
  167.  
  168.    
  169.    IX. Source-Code & Updates
  170.  
  171.    Sie können den Source-Code kostenlos bei mir bekommen. Sie müssen mir
  172.    dazu nur schreiben und eine Diskette beilegen. Vorschläge und Ideen sind
  173.    immer willkommen. Neue Gruppen für das Archiv sind ebenfalls willkommen.
  174.    CDTV-Player wurde in KICK-PASCAL 2.12 geschrieben. 
  175.  
  176.    Updates gibt es direkt bei mir, im AMINET, im FRAS und in allen 
  177.    gutsortierten Mailboxen und natürlich auf den Fish-Disks. 
  178.  
  179.  
  180.    X. Assigns
  181.  
  182.    Gilt nur für OS 1.3!
  183.  
  184.    Zur Zeit muß man (leider!) ein ASSIGN durchführen, um das Archiv 
  185.    laden zu können. Wenn sich z.B. das Verzeichnis CDTV-Player in DF1: 
  186.    befindet, muß man ASSIGN Lyrics: DF1:CDTV-Player/Lyrics angeben. Ich 
  187.    habe für diesen Zweck ein Skript geschrieben. 
  188.    
  189.  
  190.    XI. Arexx
  191.  
  192.    Arexx wurde eingeführt, um die Kontrolle über den CDTV-Player von aussen zu 
  193.    erhalten. Schauen Sie sich die Beispiele auf der Disk an. Im Augenblick 
  194.    kann man nur ein Lied starten und stoppen. In zukünftigen Versionen
  195.    wird man alle Funktionen des CDTV-Players steuern können.
  196.  
  197.  
  198.    XII. Die Geschichte von CDTV-Player
  199.  
  200.    Version 0.8 (12.09.92)
  201.  
  202.    Übersetzung des AMIGA-BASIC-Programms von Dr. Peter Kittel nach
  203.    KICK-PASCAL. Spielt Lieder vom CLI/SHELL aus ab, ohne Workbench-Oberfläche.
  204.  
  205.    Version 0.9 (14.09.92)
  206.  
  207.    Fügte Workbench-Oberfläche hinzu, um Lieder ohne Tastatur abzuspielen.
  208.    Fügte PAUSE, SCAN, SINGLE, REPEAT, FADE, DISPLAY hinzu.
  209.  
  210.    Version 1.0ß (18.09.92) Fish-Disk 759
  211.  
  212.    Die erste Veröffentlichung - mit einer Menge Fehler (z.B. konnte es 
  213.    nicht erkennen, ob nun eine CD oder eine Disk aus einem Laufwerk genommen 
  214.    wurde). Fügte ein INFO-Fenster hinzu. Verbesserte die interne Benutzung 
  215.    des 'cdtv.device'. Dachte mir eine Funktion aus, die KARAOKE heißen soll, 
  216.    hatte aber noch keine Ahnung, wie das zu bewerkstelligen ist.
  217.  
  218.    Version 1.2 (26.10.92)
  219.  
  220.    Erneuerte die Workbench-Oberfläche und fügte das KARAOKE-Fenster hinzu. 
  221.    Dies hatte zwar im Augenblick nichts mit KARAOKE zu tun, aber man konnte 
  222.    sich den Titel der CD auswählen, der angezeigt wird, während man sie ab-
  223.    spielt. Entfernte alle Fehler, die den Disk-Wechsel betrafen.
  224.  
  225.    Version 1.3 (05.11.92)
  226.  
  227.    Fügte eine Meldung für Leute hinzu, die kein "cdtv.device" besitzen. Er-
  228.    höhte die Geschwindigkeit des Programms und verringerte die Prozessor-
  229.    belastung.
  230.  
  231.    Version 1.4 (26.11.92)
  232.  
  233.    Fügte einige Fehler ein, während ich andere entfernte. Viele interne Ver-
  234.    änderungen (Man kann der Unterschied zwischen 1.3 und 1.4 nicht sehen, aber
  235.    1.4 ist stabiler). 
  236.  
  237.    Version 1.5 (25.12.92) Fish-Disk 805
  238.  
  239.    Zweite Veröffentlichung.Erhöhte die Geschwindigkeit des KARAOKE Fensters, 
  240.    fügte einige Gadgets hinzu. Erneuerte die Dokumentation und erhöhte mal 
  241.    wieder die Geschwindigkeit. Entfernte alle störenden Fehler, die die 
  242.    KARAOKE Option betrafen.
  243.  
  244.    Version 1.5d (29.12.92)
  245.  
  246.    Entferne einen kleinen Fehler im Info-Requester, der im ungüstigen Fall 
  247.    den Absturz des Programms hervorrufen konnte. Schade, daß ich die Disk vor 
  248.    vier Tagen die Diskette weggeschickt habe.
  249.  
  250.    Version 1.6 (11.01.93)
  251.  
  252.    Änderte den Namen von KARAOKE nach EDIT, da ich im Augenblick nicht die 
  253.    Zeit habe eine richtige KARAOKE Funktion einzubauen. Erhöhte die Ausgabe-
  254.    geschwindigkeit des EDIT-Fensters, in dem ich dynamische Strukturen ver-
  255.    wendete (wenigstens etwas, daß ich von der Uni benutzen kann). Verlegte 
  256.    die Programmierarbeiten auf den AMIGA 4000 (mehr Speicher, mehr Spaß). 
  257.    Fügte SHUFFLE hinzu.
  258.  
  259.    Version 1.7f (25.01.93)
  260.  
  261.    Die dritte Veröffentlichung des CDTV-Player. Jetzt hat jeder mit einem 
  262.    CDTV-Player die Möglichkeit ins Programm zu kommmen, um einen Blick auf 
  263.    die Gadgets werfen zu können und die EDIT zu benutzen, um z.B. ein 
  264.    bestimmtes Lied zu finden. Fügte eine Suchfunktion hinzu, um die aktuelle 
  265.    CD aus dem Archiv herauszusuchen und sie automatisch zu laden. Fügte 
  266.    PREFS, BACK & FORTH hinzu.
  267.  
  268.    Version 1.7j (20.02.93)
  269.  
  270.    Fügte die Funktion PROGRAM hinzu und jetzt ist es möglich eigene CDs 
  271.    einzugeben. Entfernte eine Menge unnötigen Code. Verbesserte das Design 
  272.    von EDIT. Entfernte Fehler in SHUFFLE & PROGRAM (im Programm eigentlich 
  273.    dasselbe).
  274.  
  275.    Version 1.8 (22.02.93) Fish-Disk 849
  276.  
  277.    Vierte offizielle Veröffentlichung des CDTV-Player. Fügte KARAOKE hinzu 
  278.    (sehr populär in Japan & Italien). Jeder beliebige Text kann dazu benutzt 
  279.    werden. Fügte noch ADD CD hinzu, um selbst CDs eingeben zu können.
  280.  
  281.    Version 1.9 (23.03.93) 
  282.  
  283.    Fügte noch mehr Preferences hinzu, um KARAOKE besser handhaben zu können. 
  284.    Jetzt kann KARAOKE zu jeder Zeit gestoppt werden und es ist möglich die
  285.    Spielzeit einzublenden. Erhöhte die Ausgabegeschwindigkeit von KARAOKE
  286.    und entfernte einigen unnötigen Code.
  287.  
  288.    Version 2.0 (04.04.93) Fish-Disk 868
  289.  
  290.    Fünfte offizielle Veröffentlichung des CDTV-Players. Beinhaltet jetzt 
  291.    einen AREXX-Port. Dies versetzt Sie in die Lage den CDTV-Player von
  292.    anderen Programmen aus zu steuern.
  293.  
  294.    Version 2.01 (23.04.93)
  295.  
  296.    Aaaargh. V2.0 funktionierte nicht auf Maschinen, auf denen nicht die
  297.    arexx.library installiert war. Ich bemerkte es bisher nicht, da ich
  298.    es bei mir auf dem CDTV installiert hatte.
  299.  
  300.    Version 2.02 (13.06.93)
  301.  
  302.    AREXX unterbunden, aufgrund von timing Probleme. Verbesserte ADDCD-
  303.    Funktion.
  304.  
  305.    Version 2.03 (28.06.93)
  306.  
  307.    AREXX wieder eingebunden, da alle Probleme damit beseitigt wurden.
  308.  
  309.    Version 2.05 (13.07.93) Fish-Disk 894
  310.  
  311.    Sechste offizielle Veröffentlichung. Entfernte BUG in der ADDCD-Funktion. 
  312.    Jetzt speichert er die Einträge ohne Probleme (durch Umgehung eines 
  313.    Compiler-bugs erreicht). REW & FF sind nicht anklickbar, wenn es keine 
  314.    höhere bzw. tiefere Spur mehr gibt.
  315.  
  316.    Version 2.06 (28.08.93)
  317.  
  318.    CDTV-Player verbrauchte wegen eines kleines Fehlers die ganze Rechenzeit.
  319.    Fehler behoben. 
  320.  
  321.    Version 2.10 (29.08.93)
  322.  
  323.    Fügte neuen Info-Requester hinzu und entfernte kleinen Bug bei REW & FF.
  324.    Verbesserte ADDCD-Funktion. Trägt nun Titel der ausgewählten Gruppe ein.
  325.  
  326.    Version 2.15 (30.08.93)
  327.  
  328.    Stark verbesserte ADDCD-Funktion. Abbruch möglich.
  329.  
  330.    Version 2.18 (01.09.93)
  331.  
  332.    Speichert jetzt die PREFERENCES ab. WINDOWDEPTH bei INFO-REQUESTER 
  333.    hinzugefügt.
  334.  
  335.    Version 2.20 (02.09.93)
  336.  
  337.    Ab Workbench 2.0 ist nun kein ASSIGN mehr nötig! Update der Docs.
  338.  
  339.    Version 2.25 (05.09.93)
  340.  
  341.    Topaz 8 wird nun explizit verlangt. Ausgabegeschwindigkeit erhöht.
  342.  
  343.    Version 2.30 (23.09.93)
  344.  
  345.    Programm teilweise fontsensitiv gemacht und den Rest darauf 
  346.    vorbereitet.
  347.  
  348.  
  349.    XIII. Credits
  350.  
  351.    (In alphabetischer Reihenfolge)
  352.  
  353.    AUSTRALIEN:
  354.  
  355.    Ross Delaforce
  356.  
  357.    DEUTSCHLAND:
  358.  
  359.    Markus Bahr, Berlin
  360.    Ioannis Chatziandreou, Bochum
  361.    Hans-Christian Eckert, Berlin
  362.    Marc Eisenach, Stadtallendorf
  363.    Imke Gisch, Frankfurt
  364.    Andreas Happel, Flensburg
  365.    Peter Hellweg, Wetter
  366.    Kai Hofmann, Bremen
  367.    Dr. Peter Kittel, Frankfurt
  368.    Thorsten Kratz, Erlangen
  369.    Tom Kroener, Saarbrücken-Dudweiler
  370.    Gerhard Leibrock, Kirkel
  371.    Oliver Peiker
  372.    Alfred Prenner, Fürstenfeldbruck
  373.    Uwe Ripl
  374.    Hanns Holger Rutz, Zeven
  375.    Stefan Schmidt, Wahnebergen
  376.    Werner Völker, Ebersbach
  377.    Michael Zielinski, Hamburg
  378.  
  379.    FINNLAND:
  380.  
  381.    Tomi Blinnikka, Helsinki
  382.  
  383.    FRANKREICH:
  384.  
  385.    Frédéric Botton, Paris
  386.  
  387.    GRIECHENLAND:
  388.  
  389.    Dimitrios Charalampidis, Thessaloniki
  390.  
  391.    GROSSBRITANNIEN:
  392.  
  393.    Jason R. Hulance, Oxford
  394.    Mark A. Smith, Hastings
  395.  
  396.    IRLAND:
  397.  
  398.    Wai Hung Liu, Dublin
  399.  
  400.    ITALIEN:
  401.  
  402.    Felice Murolo, Salerno
  403.    Federico Villata, Rom
  404.  
  405.    KANADA:
  406.  
  407.    Darren Ewaniuk, Alberta
  408.    Nick MacDonald
  409.  
  410.    LETTLAND:
  411.  
  412.    Wlad Fomin, Riga
  413.    Dostick, Riga
  414.  
  415.    NEUSEELAND:
  416.  
  417.    Dave Hassall
  418.  
  419.    ÖSTERREICH:
  420.  
  421.    Peter Uitz, Wien
  422.  
  423.    SCHWEDEN:
  424.  
  425.    Thomas Bengtsson
  426.    Stefan Ohlin, Solleftea
  427.  
  428.    SLOWENIEN:
  429.  
  430.    Jure Vrhovnik, Ljubljana
  431.  
  432.    USA:
  433.  
  434.    Fred Fish, Tempe
  435.    D. Jarvis
  436.    George Knighton, Fremont
  437.    Thomas J. Moore
  438.    Arthur T. Murray, Seattle
  439.    Nhan Nguyen, Sophomore
  440.  
  441.    wird fortgesetzt...
  442.  
  443.    (Wenn Ihnen mein Programm gefällt, lassen Sie es mich wissen,
  444.    dann werden Sie hier genannt).
  445.  
  446.  
  447.    XIV. Adresse
  448.  
  449.    ***************************************************************
  450.    **                                                           **
  451.    **      Sie können mir in folgenden Sprachen schreiben:      **
  452.    **   Ceský, Deutsch, English, Français, Italiano, Russkij.   **
  453.    **                                                           **
  454.    **  Schneckenpost: Daniel Amor                               **
  455.    **                 Ludwigstr. 124                            **
  456.    **                 70197 Stuttgart                           **
  457.    **                 Germany                                   **
  458.    **                                                           **
  459.    **  E-Mail:        amor@student.uni-tuebingen.de             **
  460.    **  FidoNet:       2:246/1416 (Amiga Universe)               **
  461.    **                                                           **
  462.    ***************************************************************
  463.