Anleitung zu FLICTC45.PRG


Copyright:
FLICTC45.PRG ist Freeware - verteilt es an jeden, der es haben will,
dies mu allerdings komplett mit allen Dateien in einem Ordner oder
Archiv geschehen:

FLICTCxx\
         DEUTSCH\
                 CHANGES .TXT
                 FLICTC  .TXT
                 FLICTCxx.PRG
                 HYDRAMRK.TOS
                 README  .1ST
                 SPEED   .TXT
         ENGLISH\
                 FLICTCxx.PRG
                 FLIC_TCE.TXT
                 HYDRAMRK.TOS
                 README_E.1ST
                 SPEED_E .TXT


Das Copyright liegt weiterhin bei mir, Vernderungen am Programm sind nur
mit meiner schriftliche Erlaubnis gestattet. Die Aufnahme in irgendwelche
PD-Serien bedarf ebenfalls meiner schriftlichen Erlaubnis; Poolware: Anfrage
zwecklos.


Sinn und Zweck:
FLICTC45 ist ein _schneller_ Abspieler fr Animationen im .FLI- und .FLC-
Format, damit man sich die Animationen auch mal in Originalgeschwindigkeit
ansehen kann...


Garantie und Haftung: 
Fr eventuelle Schden und Datenverluste, die durch die Benutzung dieses
Programms und dieser Anleitung direkt oder indirekt entstehen, bernehme
ich keine Haftung, die Benutzung erfolgt ausschlielich auf eigene Gefahr.


Systemvoraussetzungen:
Das Programm luft in allen HiColor-Auflsungen (Atari nennt es gerne
True Color) ab 320x200 Punkten.


Vorteile:
-schnell, die meisten Animationen laufen in Originalgeschwindigkeit, d.h.
 genauso schnell wie auf einem 486er
-spielt falls notwendig auch direkt von Festplatte oder Diskette, d.h.
 die Dateigre ist nur durch die Partitionsgre begrenzt (momentan mit
 AHDI ca. 500MB)!
-kompatibel, alle getesteten Animationen laufen fehlerfrei (man glaubt
 gar nicht, was fr kuriose Sonderflle es da gibt ...)
-lt sich ber Kommandozeile steuern (Wiederholung und Synchronisation
 mit dem VBL (Vertical BLank interrupt), ...), d.h. 
-lt sich als Icon installieren, einfach Film draufziehen und ab geht's
-kann auf Wunsch die Auflsung automatisch nach HiColor umschalten (klappt
 auch bei Videoerweiterungen)
-flackerfrei durch Double-Buffering (bei dieser Darstellungstechnik wird
 das nchste Bild immer verdeckt aufgebaut)
-verwendet je nach Prozessor optimierten Code (68000/68020)
-erkennt automatisch, ob die Grafikhardware Worte im Motorola- (HighByte,
 LowByte) oder im Intelformat (LowByte, HighByte) speichert (abschaltbar)
-Freeware


Einschrnkungen:
-kein GEM-Programm
-schreibt direkt in den Bildschirmspeicher
-drfte deshalb Probleme mit MultiTOS haben
-untersttzt keine Palettenanimationen (wegen HiColor, wird aber
 auch von keinem mir bekannten .FLI/.FLC benutzt)
-Animationsgre ist durch Bildschirmgre begrenzt, notfalls reicht eine
 ausreichend hohe virtuelle Auflsung (leider kann man dann nicht alles
 sehen ...)


Bedienung:
Der Player lt sich ganz normal als Programm starten, dann erscheint
eine Dateiauswahlbox und man kann eine beliebige .FLI/.FLC-Datei auswhlen
oder man installiert FLICTC45.PRG als Icon (siehe unten).
Der Abspielvorgang lt sich jederzeit durch einen Mausklick oder am Ende
jedes Durchlaufs mit der Leertaste abbrechen (natrlich merkt sich der 
Player den Tastendruck, er stoppt halt erst am Ende ...). Ferner sind
folgende Tasten belegt:
<+> erhht die Geschwindigkeit
<-> verringert die Geschwindigkeit
<t> schaltet die Synchronisation ber den 200Hz Timer ein bzw. aus
<v> schaltet die Synchronisation mit dem Vsync ein bzw. aus
<l> Manche Animtionen ruckeln zyklisch, was hufig daran liegt, da das
    erste und letzte Bild (fast) identisch sind. Diese Option lt das
    Ruckeln verschwinden, indem sie es ermglicht die Wartezeit nach dem
    letzten Bild ein- bzw. auszuschalten, damit wird das letzte Bild
    effektiv bersprungen. 
<0> setzt alles wieder auf die Ursprungswerte zurck

Nach Beendigung erscheint eine kleine Statistik ber die erreichte Abspiel-
geschwindigkeit.


Installation:
ich empfehle FLICTC45.PRG als Icon auf's Desktop zu ziehen und im <Extras>-
Men ber <Anwendung anmelden> folgende Einstellungen zu machen (vorher
Icon selektieren (dazu einmal anklicken):
Dateityp:            FL?
Standardverzeichnis: Anwendung
Startparameter:      Voller Pfadname
Gegebenenfalls kann man noch ber <Icon anmelden> ein anderes Icon und einen
anderen Namen whlen (Vorschlag: FLIC-Player).
Nun noch einmal <Arbeit sichern>, jetzt kann man Animationen einfach anklicken
oder auf das Player-Icon ziehen...


Optionen ber Kommandozeile:
Normalerweise sollte es nicht ntig sein, diese Optionen zu ndern,
ich erwhne sie nur der Vollstndigkeit halber.
Es stehen folgende Schalter zur Verfgung:

-a=0  unterdrckt den Auflsungstest (ber LINE_A #0 (Init))
-a=1  fhrt einen Test auf korrekte Farbanzahl durch (mittels LINE_A),
      allerdings wird nur ber die Funktion #0 der LINE_A-Parameter-
      block erfragt und dort die Anzahl der Farbebenen kontrolliert,
      das funktioniert auch auf dem Falcon in jeder Auflsung (default).

-d=0  Debugmodus deaktiviert (default)
-d=1  Debugmodus aktiv (Auswirkungen ndern sich dauernd ...
      ich erwhne den Schalter nur der Vollstndigkeit halber)

-D=0  deaktiviert das Double-Buffering -> mehr Speicher frei
-D=1  schaltet das Double-Buffering IMMER ein, nicht zu empfehlen, da
      Double-Buffering sehr zeitaufwendig ist (immerhin mssen ganze
      Grafikseiten umkopiert werden) und schnelle Animationen auf diese
      Weise ausgebremst werden wrden.
-D=2  intelligentes (ein Widerspruch in sich :) ) Double-Buffering, bei
      langsamen Animationen wird das Double-Buffering aktiviert, bei
      schnellen deaktiviert, die Grenze lt sich ber den -S=<x> Schalter
      ndern, siehe auch dort. (default)

-i=0  unterdrckt die Anzeige des FLI/FLC-Headers, ist auf Dauer nicht
      sonderlich spanned. (default)
-i=1  zeigt vor dem Abspielen den FLI/FLC-Header an und wartet auf Tasten-
      druck, mal ganz interessant und recht ntzlich fr's Debugging.
      
-I=0  Motorola-Grafikmodus (Highbyte/Lowbyte)
-I=1  Intel-Grafikmodus (Lowbyte/Highbyte)
-I=2  automatische Erkennung des Grafikmodus (default)

-l=0  schaltet Endloswiederholung der Animation aus
-l=1  schaltet Endloswiederholung ein (default)

-L=0  normale Pausen zwischen allen Einzelbildern (default)
-L=1  keine Pause nach dem letzten Bild, manche Animationen ruckeln
      sonst

-m=x  weist den Player an maximal x kB RAM zu verwenden (<x> steht hierbei
      fr eine beliebige ganze Zahl), allerdings bentigt der Player immer
      eine gewisse Menge Speicher, z.B. in der Version 3.5.0 <Breite*Hhe+
      16384> Byte. Standardmig benutzt der Player den ganzen verfgbaren
      Speicher (naja, nicht ganz, maximal etwas unter 2 Gigabyte...)

-s=x  setzt die Abspielgeschwindigkeit auf <x> Bilder/Sekunde, nett um
      Animationen in Zeitlupe zu betrachten, oder mal etwas schneller ...

-S=x  setzt die Grenze fr das intelligente Double-Buffering, wobei
      <x> wieder die Geschwindigkeit in Bildern/Sekunde angibt. Fr normale
      Falcons sollte x=10..x=14 sein, fr aufgebohrte x=14-x=18
      (default: x=14)

-t=0  schaltet die Synchronisation ber den 200Hz-Timer aus, allerdings
      wird weiterhin auf den Vsync gewartet, dieser mu ggf. extra
      abgeschaltet werden, um maximale Geschwindigkeit zu erreichen
      (taugt eigentlich nur fr die Statistik oder bei extrem komplexen
      und schnelle Animationen, obwohl da ein -v=0 eigentlich reichen
      mte, man knnte sonst auch mal -v=1 -t=0 versuchen ...)
-t=1  schaltet die Synchronisation ber den 200Hz-Timer ein, der Player
      versucht dann die vorgegebene Geschwindigkeit einzuhalten,
      allerdings kann es aufgrund des 200Hz-Timers statt eines nicht
      vorhandenen 70Hz-Timers zu Abweichungen von ca. 5% kommen
      (default)

-v=0  FLICTC45.PRG wartet nicht auf den Vsync, nur bei sehr schnellen
      und komplexen Animationen sinnvoll
-v=1  es wird auf den Vsync gewartet, Animationen flackern nun weniger,
      knnen allerdings etwas langsamer werden, da das Warten auf den Vsync
      die Synchronisation mit dem 200Hz-Timer bremsen kann, vor allem wenn
      die Bildwiederholfrequenz stark von 70Hz abweicht.
      (default)
      
-z=0  der Player versucht in gar keinem Fall die Auflsung umzuschalten
      (default)
-z=1  ist im CookieJar Falcon-Videohardware eingetragen und ist ein RGB/TV
      oder VGA-Monitor angeschlossen, schaltet FLICTC45 die Auflsung direkt
      ber die Videoregister des Falcon um, das funktioniert im Gegensatz zum
      Umschalten ber das TOS auch bei eventuellen Auflsungserweiterungen.
      Damit der Player wei, ob umgeschaltet werden soll, mu natrlich der
      Auflsungstest (-a=1) aktiv sein.


Erste Hilfe bei Problemen:

Problem: Animation luft zu langsam
Abhilfe: (vergewissern, ob Prozessor mit vollem Takt luft, und ob die
         Prozessorcaches aktiv sind - sollte normalerweise der Fall 
         sein ...)
       - Als erstes sollte berprft werden, ob vielleicht das Double-
         Buffering permanent aktiv ist (-D=1), in diesem Fall auf das
         intelligente Double-Buffering wechseln (-D=2), sollte das nicht
         ausreichen, Double-Buffering deaktivieren (-D=0).
       - Auflsung auf das Ntigste reduzieren, normalerweise reichen bei
         FLIs 320x200 Pixel (andere FLIs darf es eigentlich nicht geben
         (wegen der 64kB Segmentgre gewisser intel-Prozessoren (hihihi)),
         der Player knnte sie aber trotzdem abspielen), reicht das immer
         noch nicht, sollte man ber die Kommandozeile die Synchronisation
         mit dem Vsync abschalten (-v=0), reicht das auch nicht, kann man
         die Synchronisation mit dem 200Hz-Timer abschalten (-t=0), falls
         diese Manahmen nicht reichen sollten kann man noch smtliche
         Synchronisationen abschalten (-v=0 -t=0), allerdings drfte die
         Animation jetzt wirklich zu schnell sein ...

Problem: Animation ruckelt oder luft immer noch zu langsam (siehe oben)
Abhilfe: Wenn der Player ein FLI/FLC ruckelig abspielt und die Laufwerkslampe
         fter mal aufblinkt, reicht wahrscheinlich der freie Speicher nicht
         aus und die Datei wird direkt von der Platte (oder Diskette!) ab-
         gespielt (darf der Player den verfgbaren Speicher nutzen, oder ist
         vielleicht die <-m=x>-Option aktiv?).
         Generell sollte man erstmal berlegen, ob man nicht irgendwie noch
         Speicher frei machen kann (Accessories, residente CPX-Module, ...),
         zustzlich kann es sinnvoll sein einen (Hard-)Diskcache zu be-
         nutzen, um dem TOS ein wenig auf die Sprnge zu helfen, aber
         Vorsicht, weniger ist hier oft mehr, sonst fehlt nur noch mehr
         Speicher ...

Problem: Animation ruckelt zyklisch
Abhilfe: Wahrscheinlich sind das erste und letzte Bild der Animation iden-
         tisch... einfach mal die Taste <l> drcken. Das Ruckeln sollte
         jetzt nicht mehr wahrnehmbar sein, funktioniert prinzipsbedingt
         nicht sonderlich gut mit Double-Buffering.
         
Problem: Animation luft zu schnell
Abhilfe: Warten auf Timer mittels Kommandozeilenoption -t=1 einschalten

Problem: Animation flackert
Abhilfe: Warten auf VSync einschalten mittels -v=1, flackert's nun
         immer noch, ist der Rechner zu langsam, vielleicht hilft es
         in eine kleinere Auflsung zu schalten (FLIs brauchen i.A.
         nur 320x200 Pixel), alternativ kann man auch fr langsame
         Animationen das intelligente Double-Buffering aktivieren (-D=2)
         oder im Notfall auch fr alle Animationen erzwingen(-D=1), aller-
         dings auf Kosten der Geschwindigkeit ...

Problem: Speicher voll
Abhilfe: Speicher freirumen, 200kB freier Speicher reichen fr alle FLIs
         ohne Double-Buffering, (FLCs brauchen u.Umst mehr), allerdings kann
         man dann mit der Festplatten-LED den Raum ausleuchten...

Problem: Player strzt mit Grafikmll auf dem Bildschirm ab
Abhilfe: a) mal auf einem Falcon versuchen
         b) HiColor-Modus einschalten, bzw. den Auflsungstest aktivieren
         c) Tja, da ist wohl ein .FLI/FLC kaputt! Sollte es auf einem anderen
            FLI/FLC-Player (PC, Mac, Atari, ...) laufen, bitte das .FLI/FLC
            auf Disk an mich schicken, ich versuche den Fehler im Player
            dann zu beheben, aber bitte erst auf einem anderen Player
            testen!!!
            
Problem: Animation wird in Falschfarben dargestellt
Abhilfe: Es wird der falsche Grafikmodus benutzt, d.h. Low- und Highbyte
         mssen vertauscht werden. Entweder ber <-I=2> die automatische
         Erkennung einschalten (Standardeinstellung) oder, falls das nicht
         klappt ber <-I=0> den Motorola-Modus versuchen, klappt das auch
         nicht, so lst <-I=1> das Problem (Intel-Modus).
         

Entwicklungssystem:
Falcon mit Omikron.BASIC 3.6 & Compiler 3.6, Turbo-Assembler.


Quellen:
Als Grundlage des Programms diente die Karteikarte aus c't 8/94.


Credits:
Mein Dank gebhrt
-Petra fr moralische Untersttzung
-Alexander Clauss fr seine Bug-Reports und Informationen ber das FLC-
 Format
-Lars Weinrich fr das Korrekturlesen der englischen Anleitung
-Christian "Chrisker" Krger fr die Routine zur Auflsungsumschaltung
-Daniel Hedberg fr seine Bug-Reports
-Torsten Lang fr seine konstruktiven Anregungen

Nun viel Spa mit dem Player, Kritik und Anregungen bitte an meine
Adresse ...


Sven Bruns
Metzstr. 52
24116 Kiel

email: NIP70@rz.uni-kiel.d400.de (bis 15.2.96, vielleicht lnger)

[EOF]
