                         *----------------*
                         | ANIPLAYER 2.05 |
                         *----------------*

                Nederlandse versie van Karel de Bruijn
                
                
Inleiding:
----------

 Deze Shareware-speler is een mediaspeler die volledig in 68000 en DSP-56001
 assembler is geschreven (alles ten behoeve van de beelddecompressie).
 Deze speler kent de volgende beeld- en geluidsformaten:
 - QuickTime Movies (MOV)
   Video Voor Windows (AVI)
   Autodesk Animator (FLI/FLC/FLH)
   MPEG (MPG).
 - Interactieve Video QuickTime VR (MOV met muis-controle).
 - Sounds Audio Visual Research (AVR)
   Microsoft RIFF-WAVE (WAV)
   Apple Interchange File Format (AIF)
   Real Audio (RA 14.4K 28.8K)
 - JPEG afbeeldingen.

 De speler is speciaal geschreven en geoptimaliseerd voor de FALCON.
 Hoewel hij net zo goed werkt op bijvoorbeeld de HADES en de MILAN.
 Bestanden kunnen rechtstreeks vanaf de harde schijf worden afgespeeld, 
 wat het geheugengebruik beperkt.
 Op de Falcon kun je in TrueColor en door gebruik te maken van de DSP 
 een vloeiende animatie met geluid verkrijgen, zonder dat daarbij beelden 
 worden overgeslagen (Om beelden direct van CD-ROM af te spelen is een
 snelle CD-ROM-drive wel een vereiste)  
 Op het ogenblik wordt de DSP nog niet ingezet voor alle decompressies.
 De belangrijkste is wel de  Cinepak (CVID). 

 Het beeld wordt getoond in een window en het is mogelijk om met gebruik van de 
 cursor-toetsen op de tape-recorder buttons de film vooruit en terug te spoelen.
 (Dit laatste geldt niet voor FLI/FLC/FLH bestanden).

 Het programma ondersteunt het VA_START protocol. Hierdoor kun je aniplayer een 
 film of geluid laten afspelen, simpelweg door op het gewenste film-bestand te 
 dubbel-klikken. Aniplayer moet dan wel als applicatie voor AVI/MOV/FLI/MPG/
 AVR/WAV/AIF/JPG) zijn aangemeld. Onder een multitasking-omgeving zal Aniplayer 
 zichzelf daarbij maar een keer laden.  
 
 AV_SENDKEY wordt eveneens ondersteund. Men kan Aniplayer ook als deskaccesoire 
 aanmelden. Hiervoor moet men het programma alleen maar renamen als aniplay.acc. 
 Het programma werkt uitstekende onder een multitasking-omgeving en ook de TTP-
 mode via command-line parameters wordt ondersteund.
 Verder ondersteund aniplayer ook het ID4-OLGA protocol. Daarmee kan men 
 aniplayer dan bv. aanmelden als plug-in voor zijn favoriete browser. 
 
 De franstalige resource is opgenomen in het programma zelf (Er is dus geen 
 aparte RSC-file). Door echter de N_FRENCH.TXT uit de gewenste taal-folder 
 (bv. DUTCH) in de folder bij  aniplayer te kopieren, werkt het programma met 
 bv. engels- of nederlands-talige menu's en meldingen.


Verwachte Configuratie:
------------------------

 - FALCON voor true-color weergave en vanwege de DSP.
 - TT met grafische kaart (minmaal 32768/65536 kleuren).
 - TOS-Machine met minstens een MC68030 en 2 Mbyte vrije ram
   (Op een ste kan men mogelijk een bus-error krijgen bij hoge decompressie).
 - HADES
 - MILAN 

 De meeste resoluties worden ondersteund:
  - Alle resoluties op de FALCON.
  - All ATARI graphicsche modes die gebruik maken van planes (VDI).
  - De grafische 24bits true-color kaarten (types 32 bits motorola
    for PowerMac, of NOVA ET4000 voor HADES).
  - De grafische kaarten (32768/65536 kleuren) type  motorola (bv. MATRIX) 
    of type intel (bv. NOVA).
  - De grafische kaarten met 256 kleuren die gebruik maken van planes (VDI).
 
 Het programma werkt ook zonder DMA-sound. In dat geval wordt direct gebruik 
 gemaakt van de  van de YAMAHA-chip (altijd in combinatie met direct van disk).
 Op de HADES wordt de PSOUND-kaart ondersteund.
 Op de MILAN kan men de Milanblaster inzetten.
 The floating point coprocessor (68882) is only required for Real Audio 28.8K.


GEM Setup: 
----------

 Om Aniplayer komfortabel te installeren, kenne we nu het programma 'GEM 
 setup'. Na het starten van SETUP.APP krijgen we dialoog, waar we 
 eenvoudig de gewenste installatie kunnen aangeven. Er is keuze uit een 
 groot aantal opties.

 - Gewenste taal waarin men Aniplayer wil gebruiken.
   Hiertoe kiest mende gewenste taal met de 'Language'-Popup. 

 - Automatisch installeren van SYNCHRO.CPX in de CPX-Folder.

   Met deze module kan men aniplayer en een tweede programma (bv. GEMJing) 
   zo aansturen, dat twee bestanden synchroon (gelijktijdig) worden af-
   gespeeld. Men moet daarbij denken aan een film zonder geluid die men 
   voorziet van een eigen geluidsfragment. Dit werkt echter alleen onder 
   Multitasking! 
 
 - Automatisch Installeren van Audio-drivers. 
   * Diegenen onder ons, die met MagiCMac werken, kunnen beter het 
     standaard geinstalleerde MacSound vervangen door MagiCSound. Deze 
     werkt beter met Aniplayer. (Is MacSound geinstalleerd, dan moet men 
     het nog wel zelf inaktiveren of verwijderen.)
   * De trotse eigenaren van de HADES 040/060 kunnen de driver voor 
     de PSound Geluidskaart (Parallelpoort) laten installeren.
   * De nog trotsere eigenaren van de Milan kunnen de Milanblaster-kaart 
     installeren. Het afspelen van geluiden hierop gaat prima. 
 
 -  Heeft men BubbleGEM van Thomas Much nog niet geinstalleerd, dan kan 
    men dit nu alsnog doen
    BubbleGEM is een Systemuitbreiding, die bij GEM de tekstballonnetjes 
    mogelijk maakt. BubbleGEM word in den START-Folder van MagiC 
    geinstalleerd. 
 
 Bediening van GEM Setup: 

 Men kan de gewenste gegevens installeren [Install] of juist weer 
 verwijderen [Remove]. Kies de gewenste Setup-Mode met de bijbehorende  
 Popup (linksboven). 
 
 Opgelet: Heeft men verwijderen [Remove] gekozen en klikt men op de Setup-
 button, gaat Aniplayer de zaak verwijderen voor de aangegeven taal. 
 Bij het installeren, kan men aangeven of een bestand moet worden 
 overschreven ja dan nee, indien het te installeren bestand (bv.BubbleGEM) 
 al is geinstalleerd 

 
 Bediening over het toetsenbord: 

 Men kan GEM Setup bijna volledig met het toetsenbord bedienen. Toetsen 
 van <ALT + de onderstreepte letter> kiest de aangegeven funktie of 
 instelling.
 CTRL-I toont het Info-venster en met de HELP-Toets word ST-GUIDE 
 opgeroepen in de aangegeven taal (Deze moet er dan natuurlijk wel zijn). 

 Algemene opmerkingen: 

 Opdat GEM Setup probleemloos werkt, moet men de bestanden SETUP.APP, 
 SETUP.RSC en SETUP.CFG in dezelfde folder hebben staan. 
 De overige Aniplayer-bestanden kunnen op elke partitie gezet worden, 
 Zolang de onderlinge folder-hierarchie maar niet verandert. Opdat 
 SETUP.APP ook weet waar de Aniplayer-bestanden zich bevinden, moet men 
 na het op opstarten aangeven waar de ANIPLAY-folder staat. 
 
 LET OP! Wijzig in geen geval de SETUP.CFG. Is deze veranderd dan kan het 
 gebeuren, dat GEM Setup Aniplayer niet juist installeerd. 
 
 Auteur van GEM Setup is Joachim Fornallaz. Opmerkingen over GEM Setup 
 kan men dan ook richten aan het volgende email-Adres: 

 jfornall@stud.ee.ethz.ch 
 
 
Algemeen Informatie: 
--------------------

 Een korte uitleg is beschikbaar onder <HELP>. Hierin wordt kort het 
 programma beschreven met de mogelijke opties. BubbleGEM kan men, indien 
 gewenst, ook aktiveren. De complete gebruikers-documentatie is te lezen 
 als hyper-tekst met ST-Guide (Frans, Engels, Duits Zweeds en nu dus ook 
 Nederlands). 
 
 Beperkingen in de afspeelsnelheid worden veroorzaakt door de 
 uitwisseling van gegevens tussen enerzijds de MC68030 en de DSP om het 
 beeldmateriaal te decompressen en anderzijds tussen de DSP en de MC68030 
 om het beeld op het scherm te zetten. (Het opbouwen van het beeld wordt 
 in de Falcon door de processor zelf verzorgt). 
 (De System-Bussnelheid in de Falcon is slechts 16MHz). 
 
 
BubbleGEM:
----------

 BubbleGEM behoort in de START-Folder van MagiC of de APPS-folder onder 
 N_AES. Het moet door hen als applicatie worden gestart. Onder Single-tos 
 kan men BubbleGEM als accesoire gebruiken. De naam wijzigen naar 
 BUBBLE.ACC op de C:\-partitie kopieren en opnieuw booten. 
 
 Komt de gebruiker met de muis boven een button of een bepaald deel van 
 het venster, dan wordt een boodschap en een tekst doorgegeven aan 
 BubbleGEM. Deze tekent dan bij de muis de bekende tekstballonnetjes 
 (eventueel in windows-look). 
 
 Men kan ook de rechter muisknop ingedrukt houden, waardoor de ballon 
 verschijnt. Knop loslaten en de ballon is weer weg. 
 
 Bij een tekstballonnetje kan men ook Control-C of Control-X toetsen. 
 Hierdoor word de tekst op het clipboard gekopiert. Bij control-X 
 verdwijnt ook gelijk de ballon. 
 
 Auteur Thomas Much, email-Adresse: 
 
 Thomas.Much@stud.uni-karlsruhe.de 
 
 
OLGA-Installatie:
-----------------
 
 Om Aniplayer als PlugIn voor bv. CAB te gebruiken, moet OLGA correct 
 geinstalleerd zijn. OLGA werkt alleen onder een multitasking-omgeving 
 (MultiTOS, N.AES, MagiC etc.). 
 
 Men moet zich vooraf bedenken of men OLGA alleen wil opstarten als het 
 nodig is of dat men het continue ter beschikking wil hebben. 
 Voor het tweede hoeven we OLGA.APP alleen maar te wijzigen in OLGA.ACC, 
 op de C:\-partitie kopieren en opnieuw te booten. 
 
 De eerste is iets meer werk, maar deze heeft het voordeel dat OLGA 
 alleen geladen wordt als het nodig is en deze wordt aangeroepen door een 
 programm dat OLGA ondersteunt. 
 
 - Kopier OLGA in een folder bv. in  C:\GEMSYS\OLGA\OLGA.APP. 
 - Breng de environment-variabele OLGAMANAGER in met een verwijzing naar 
   de plaats op de harde schijf. 
  
 Voor MultiTOS schrijft men de volgende regel in GEM.CNF: 
 
  setenv OLGAMANAGER=C:\GEMSYS\OLGA\OLGA.APP 
 
 Voor N_AES schrijft men de volgende regel in N_AES.CNF 
      (M_AES voor de milan): 
 
  setenv OLGAMANAGER=C:\GEMSYS\OLGA\OLGA.APP 
 
 MagiC verwacht in MAGX.INF folgende Zeile: 
 
  #_ENV OLGAMANAGER=C:\GEMSYS\OLGA\OLGA.APP 
 
 Start er nu een applictie die zich verstaat met OLGA, dan wordt deze 
 laatste automatisch geladen. OLGA verwijderd zichzelf weer uit het 
 systeem, zodra het laatste programma (dat OLGA nodig heeft) beeindigd is. 
  
 Hoe OLGA zich kenbaar maakt, hangt geheel af van de applicatie die om de 
 diensten van OLGA vraagt. In CAB kan men bijvoorbeeld een film, die zich 
 in een HTML-document bevindt (<EMBED ...>), afspelen met Aniplayer. 
  
 Om nu te voorkomen, dat elk programma zelf moet gaan uitzoeken welk 
 programma voor welk bestand moet worden uitgevoerd, kan men dit 
 vastleggen in het konfiguratie-bestand van OLGA (OLGA.INF). Dit bestand 
 moet zich bij OLGA.APP of bij OLGA.ACC bevinden of op de plaats aangeven 
 door de environmentvariabele $HOME. 
 Voor Aniplayer moet men dan de volgende gegevens opnemen: 
 
[Extensions]
.AVI=$ANIPLAY
.MOV=$ANIPLAY
.QT=$ANIPLAY
.FLI=$ANIPLAY
.MPG=$ANIPLAY
.AVR=$ANIPLAY
.WAV=$ANIPLAY
.AIF=$ANIPLAY
.RA=$ANIPLAY
.JPG=$ANIPLAY...

[Objects]
.AVI=Video For Windows
.MOV=QuickTime Movie MOV
.QT=QuickTime Movie QT
.FLI=Autodesk Animator Movie
.MPG=MPEG
.AVR=Audio Visual Research
.WAV=Microsoft RIFF-WAVE
.AIF=Apple Interchange File Format
.RA=Real Audio
.JPG=JPEG
  ...

[Types]
MV=$ANIPLAY
  ... 
 
[Applications] 
ANIPLAY=E:\MULMEDIA\ANIPLAY\ANIPLAY.PRG 
;(voorbeeld)
      ... 
 
 
 Auteur van OLGA: 
 
  Thomas Much, 
 
 email-Adresse: 
 
  Thomas.Much@stud.uni-karlsruhe.de 
 

Informatie:
-----------

 Snelheidsbeperkingen in het afspelen worden veroorzaakt door de uitwisseling 
 van gegevens tussen enerzijds de MC68030  en de DSP om het beeldmateriaal te 
 decompressen en anderzijds tussen de DSP en de MC68030 om het beeld op het 
 scherm te zetten. (Het opbouwen van het beeld wordt in de Falcon door de 
 processor zelf verzorgt). 

 De informatieregel in het afspeel-window toont de volgende gegevens:  
  - De verstreken tijd in seconden.
  - Het maximale CPU-verbruik in % (over de laatste 20 beelden), 
    als waarde boven de 100 % is normaal een indicatie, dat de eigenelijke 
    afspeel-snelheid in frames per seconde niet wordt bereikt.
  - In Step-mode, Wordt het nummer van het huidige beeldje getoond ipv. het 
    maximale CPU-verbruik.  
  - Aantal frames per seconde.

 Op de Falcon, maar bv. ook op de milan krijgt men de hoogste display-snelheid 
 in True-color. Bij de TT en de HADES is dit in true-color of in 32768/65536
 kleuren bij gebruik van een grafische kaart.  

 Bij een resolutie met 256 kleuren wordt een film, die normaal een hoger aantal 
 kleuren heeft, omgerekend naar 256 kleuren (dithering). Dit vertraagt de 
 display-snelheid vanwege de extra omrekeningen. Bij nog lagere resoluties 
 wordt er omgerekend naar grijswaarden of naar 16 kleuren. Ook hier is weer 
 sprake van vertraging in de display-snelheid.

 Het is mogelijk om de huidige afbeelding of een selectie van afbeeldingen te 
 saven in de bestandsformaten (X)IMG of TGA. Wel altijd in realtie tot de 
 scherm-resolutie. 
  - IMG, GEM Bit Image:
    * 256 kleuren als de scherm-resolutie <= 256 kleuren (XIMG).
    * true color 24 bits als de scherm-resolutie  >= 256 kleuren.
  - TGA, Targa Image 2.0 in true color 24 bits:
    * conversie begint bij 256 kleuren als de scherm-resolutie  <= 256 kleuren.
    * conversie begint bij 256 kleuren als de scherm-resolutie  =  256 kleuren.
    * conversie begint met 16 bit high color (65536 kleuren).
    * direct 24 bits (true color) bij een scherm-resolutie van 24 bit 
      (true color).

 Bij het saven van een selectie worden de afzonderlijke beelden oplopend 
 genummerd vanaf  een tot aan het aantal aanwezige beelden of tot aan het 
 nummer van het beeld waarop de pauze-button werd gedrukt. De tijd wordt 
 getoond indien het nummer van de eertse afbeelding of de laatste is veranderd. 
 De files worden weggeschreven onder de naam FRMxxxxx.IMG, 
 Waarbij op de plaats van xxxxx het volgnummer wordt ingevuld.
 bv. FRM00001.IMG tot FRM00123.IMG.
 Tijdens het saven van een afbeelding of een selectie wordt onderaan in het 
 window een rode button getoond. 

 Men kan ook een afbeelding kopieren naar de clipboard met control-C. 
 (GEM-file SCRAP.IMG).

 De volgende AVI/MOV formaten worden herkend:
+-----------------------+----------+-------------+--------------------+
| Naam                  | Id       | Kleuren     | Opmerkingen        |
+-----------------------+----------+-------------+--------------------+
| Microsoft Video 1 MSVC| CRAM8    | 256         | met / zonder DSP   |
|                       | CRAM16   | 32768       |                    | 
| Radius Cinepak        | CVID     | 256         |                    |
|                       | CVID     | 16 milioen  | met / zonder DSP   |
| Intel Indeo R3.1      | IV31     | 16 milioen  |                    |
| Intel Indeo R3.2      | IV32     | 16 milioen  |                    |
| JFIF JPEG             | JPEG     | 16 milioen  | met / zonder DSP   |
| Apple Uncompressed    | RAW1/2/4 | 2/4/16      | MOV RAW1/2/4       |
|                       | RAW8/16  | 256/32768   | en  RAW16/24/32    |
|                       | RAW24/32 | 16 millioen |   nog niet getest  |
| Microsoft RGB         | RGB4/8/16| 16/256/32768| AVI RGB4/16/24     |
|                       | RGB24    | 16 millioen |   nog niet getest  |
| Apple Animation RLE   | RLE1/2/4 | 2/4/16      | MOV RLE1/2/24/32   |
|                       | RLE8/16  | 256/32768   |   nog niet getest  |
|                       | RLE24/32 | 16 milioen  |                    |
| Microsoft RLE         | RLE4/8   | 16/256      | AVI RLE4           |
|                       |          |             |    nog niet getest |
| Apple Video RPZA      | RPZA     | 32768       | met / zonder DSP   |
| Apple Graphics SMC    | SMC8     | 256         | MOV                |
| Component Video YUV2  | YUV2     | 16 milioen  | MOV niet getest    |
| Intel Raw YUV9 (YVU9) | YUV9     | 16 milioen  |                    |
+-----------------------+----------+-------------+--------------------+
 De DSP-decompressies zijn mogelijk in true color op de FALCON en in alle
 lagere scherm-resoluties.

 Geluid wordt afgespeeld met de dichtsbijliggende frequentie van de machine 
 zelf. De exacte frequentie verkrijgt men door het zogenaamde 'resamplen'. 
 Meestal kan deze resampling snel worden uitgevoerd door het verwijderen of 
 toevoegen van een sample. Een andere manier is het resamplen via lineaire 
 interpolatie (Dit is iets langzamer).
 
 Men kan een geluidsbestand saven met de daadwerkelijke sample-frequentie 
 (resamplen mag dan niet afgevinkt zijn onder opties) of met de machine-
 frequentie (resamplen moet dan afgevinkt zijn onder opties).
 Saven kan in de volgende geluidsformaten:
  - AVR, Audio Visual Research (ATARI).
  - WAV, Microsoft RIFF-WAVE (PC).
  - AIF, Apple Interchange File Format (MAC).
 Tijdens het daven wordt een rode button getoond onder in het display-window.
 
 De volgend geluisformaten voor AVI/MOV/WAV worden herkend:
  - MS_ADPCM : 16 bits AVI/WAV (APCM), coding on 4 bits.
  - DVI_ADPCM: 16 bits AVI/WAV (DVI),  coding on 4 bits.
  - IMA4     : 16 bits MOV,            coding on 4 bits.
  - MULAW    : 16 bits AVI/WAV (ULAW), coding on 8 bits.
  - MAC3     : 8 bits  MOV,            coding on 1/3 bit.
  - MAC6     : 8 bits  MOV,            coding on 1/6 bit.
  - PCM      : uncompressed AVI/WAV.
  - RAW0     : uncompressed MOV.
  - RAW      : uncompressed MOV.
  - TWOS     : uncompressed signed MOV.

 Er is een single-step functie (toets + of . ) Toetst men deze:
  - Tijdens het afspelen, dan wordt de pauze geactiveerd.
  - Als de speler al op pauze staat, dan wordt de volgende afbeelding getoond.

 Met de scan (toets S) worden alle beelden tegen de hoogst mogelijke snelheid 
 getoond. Echter wel zonder geluid. Ipv. toets 'S' kan men ook dubbel-klikken 
 op de FF-button in het display-window.

 Met de dia-show kan men alle bestanden uit een en dezelfde folder de revue 
 laten passeren (in de volgorde zoals ze in de folder staan). Treed hierbij een 
 fout op, dan wordt verdergegaan met het volgende bestand uit de folder. De 
 loop-mode heeft tijdens de dia-show geen functie.

 Bij het inlezen van een bestand kan men met control-I of I informatie over het
 bestand krijgen.
  - Film informatie:
    * grootte.
    * aantal kleuren.
    * aantal filmbeelden.
    * aantal frames per seconde.
    * step key-frames.
    * speeltijd.
    * nummer van een huidige filmbeeld.
    * type van de compressie.
    * naam van de compressie (see 'Lijst met compressies').
  - Geluids-informatie:
    * kwaliteit van het geluid (8/16 bits mono/stereo).
    * sample-frequentie.
    * machine frequentie (dichtsbijzijnde).
    * tijdsduur.
    * type van de compressie.
  - Geheugen-gebruik-informatie:
    * grootte van de file-buffer in bytes.
     (gebruikt voor decompressie naar scherm of naar picture-buffer).
    * grootte van de picture buffer in bytes.
     (gebruikt voor conversie van het schermformaat).
    * grootte van de scherm-buffer in bytes 
     (wordt gebruikt voor redraws (opnieuw tekenen), wordt niet gebruikt als 
      'direct screen' is afgevinkt).
    * grootte van de geluids-buffers in bytes.

 In het andere geval (Niet tijdens het laden) kan men statistische gegevens 
 krijgen met control-I of I:
  - Werkelijke tijd in seconden.
  - Frames die getoond werden in %.
  - Het gemiddelde CPU-verbruik in %.
  - Het Minimale CPU-verbruik in %.
  - Het maximale CPU-verbruik in %.
  - Gemmiddeld aantal frames per seconde.


Lijst met compressies:
---------------------

 - AVI files (RIFF):

  * CRAM8/16           : Microsoft Video 1 (MSVC)       x
  * CVID               : Radius Cinepak                 x
  * CYUV               : Creative Video Blaster CYUV
  * IJPG               : Intergraph JPEG
  * IV31               : Intel Indeo R3.1               x
  * IV32               : Intel Indeo R3.2               x
  * IV41               : Intel Indeo R4.1
  * JPEG               : JFIF JPEG                      x
  * MJPG               : Motion JPEG
  * RGB4/8/16/24       : Microsoft RGB                  x
  * RLE4/8             : Microsoft RLE                  x
  * RPZA               : Apple Video RPZA               x
  * RT21               : Intel Indeo R2.1
  * ULTI               : IBM Ultimotion
  * VDOW               : VDO Proprietary
  * XMPG               : Editable MPEG
  * YUV9               : Intel Raw YUV9                 x
 
 - MOV files (QuickTime):

  * CVID               : Radius Cinepak                 x
  * IV31               : Intel Indeo R3.1               x
  * IV32               : Intel Indeo R3.2               x
  * IV41               : Intel Indeo R4.1                 
  * JPEG               : JFIF JPEG                      x
  * KPCD               : Kodac Photo CD
  * MSVC8/16           : Microsoft Video 1              x
  * PGVV               : Radius PGVV
  * RAW1/2/4/8/16/24/32: Apple Uncompressed             x
  * RLE1/2/4/8/16/24/32: Apple Animation RLE            x
  * RPZA               : Apple Video RPZA               x
  * RT21               : Intel Indeo R2.1                  
  * SMC                : Apple Graphics SMC             x
  * SPIG               : Radius Spigot
  * YUV2               : Component Video YUV2           x
  * YUV9               : Intel Raw YUV9 (YVU9)          x
 
 Je ziet het, Didier heeft nog heel wat werk voor de boeg.
 De compressies die al herkend worden, zijn aangekruist.


Shortcuts via het toetsenbord:
------------------------------

 <CTRL C>         : Copieer huidige afbeelding naar het GEM clipboard
 <CTRL I> or <I>  : Informatie of Statistieken
 <CTRL L>         : Open AVR/WAV/AIF/RA bestand.
 <CTRL M>         : Save de huidige afbeelding.
 <CTRL N>         : Save geluid.
 <CTRL O>         : Open AVI/MOV/QT/FL?/MPG bestand.
 <CTRL P>         : Open een JPG bestand.
 <CTRL Q>         : Einde programma.
 <CTRL S>         : Save de instellingen.
 <CTRL U>         : Stop de film en sluit het window.
 < >              : Switchen tussen Pause / Play .
 <.>              : Single step.
 <-> or          : Volume  -
 <+> or          : Volume  +
 <0>              : DSP Gebruiken.
 <1>              : Direkt naar scherm.
 <2>              : Resampling.
 <3>              : Geluid uit.
 <4>              : Alleen geluid.
 <5>              : Contr. traagheid.
 <6>              : Beelden overslaan.
 <7>              : Videorecorder look.
 <8>              : Klein windowtje (zonder tape-recorder buttons).
 <9>              : Zonder GEM.
 <A>              : Loop mode.
 <B>              : Kwaliteit.
 <C>              : Omschakelen Kleur/ZW voor CVID/JPEG/YUV/IV.
 <D>              : Zonder D2D (Direct van Disk).
 <O>              : Opties menu.
 <P>              : Play.
 <S>              : Scan.
                : +/-  1 second (niet voor FLI/FLC/FLH).
   and <SHIFT>  : +/- 10 seconds (niet voor FLI/FLC/FLH).
   and <CTRL>   : +/- 60 seconds (niet voor FLI/FLC/FLH).
 <HELP>           : Help.
 <UNDO>           : Stoppen en film beeindigen.
 <ESC> en 'stop op einde (quit at the end)' niet afgevinkt 
                  : Stoppen en film beeindigen.
 <ESC> en 'stop op einde (quit at the end)' afgevinkt 
                  : Einde programma.


Beschrijving van de Opties:
---------------------------

 De optie 'DSP Gebruiken' activeert de DSP voor verscheidene decompressies. 
 Deze optie is alleen aanwezig op machines met een DSP (FALCON).

 De optie 'Direkt naar scherm' zorgt voor een extra versnelling in de data-
 uitwisseling naar de DSP toe, maar het beeld is minder goed. Hierbij 
 zjin ook de zg. redraws van delen buiten het window niet uit te voeren.
 Deze optie is ook niet altijd beschikbaar (niet bij minder dan 256 kleuren 
 en in monochroom). In true color op de FALCON en bij direkt naar scherm,
 werkt de DSP in zg. interrupt-mode voor het uitwissellen van de gegevens
 met de MC68030. Dit maakt het mogelijk om het beeld al te decompressen tijdens
 het laden van het volgende beeld.

 De optie 'Kwaliteit' zorgt voor een versnelling van de decompressie ten
 koste van de kleur-kwaliteit (alleen bij gebruik van de DSP). In true color 
 mode op de FALCON of bij 32768/65536 kleuren, wordt de kwaliteit slechts in 
 geringe mate beinvloed bij CVID (Cinepak) compressies.
 Bij een resolutie in 256 kleuren, wordt de dithering uitgeschakeld voor films 
 met een hoger aantal kleuren.
 
 De optie 'Resampling' zorgt ervoor, dat de sample-frequentie wordt gebruikt 
 bij het afspelen (Dit kan de machine iets vertragen bij sommige frequenties).
 Op een machine zonder DMA-geluid is deze optie niet beschikbaar, omdat de
 gewenste frequentie met behulp van de YAMAHA-chip kan worden verkregen.

 De optie 'Geluid uit' schakelt het geluid uit (Dat had ik nou nooit verwacht).

 De optie 'Alleen Geluid' stlet je in staat om alleen naar het geluid te 
 luisteren om te bepalen of het afspelen van de film mischien te traag gaat. 
 
 De optie 'Contr. traagheid' geeft een foutboodschap indien de film te traag 
 wordt afgespeeld (tov. van het geluid). Deze boodschap geeft je de mogelijk-
 heid om het geluid 1 oktaaf lager te brengen of om het geluid uit te 
 schakelen en daarmee het probleem te omzeilen. 

 De optie 'Beelden overslaan' schakelt de sound repeat (geluid herhalen) uit.
 Is een film namelijk te traag, wordt het beeld bevroren tot het volgende 
 volledige beeld weer beschikbaar is. De beelden, opgeslagen in het geheugen
 worden ge-decompressed en ingevoegt tijdens de zg. vrije tijd (maximaal 32
 beelden). Wordt deze optie uitgeschakeld (geen vinkje), dan worden buffers 
 vergroot tot 32 maal de originele grootte.  

 De optie 'Videorecorder look' geeft je de gebruikelijke tape-recorder buttons
 om door een film heen te spoelen. Eventueel krijgt men een horizontale slider.
 
 De optie 'Klein venster' verwijderd de buttons en te verplaatsingsbalk van de
 window. Hierdoor kan men een film met een iets grotere afmeting afspelen. 
 
 De optie 'Zonder GEM' is de laatste mogelijkheid om de snelheid te verbeteren.
 Alleen het toetsenbord wordt nog afgetest. Met deze optie kun je een film van
 320*240 laden in een beeldscherm-resolutie van 320*240. Op de Falcon met een 
 TV-scherm of een VGA-monitor wordt het beeld aangepast aan een resolutie van
 320*240 als het originele beeld deze afmetingen niet te buiten gaat.
 De oorspronkelijke resolutie wordt hersteld bij het beeindigen van de film of
 als er een fout optreedt.
 
 De optie 'Zonder D2D' laad het film-bestand eerst volledig in het geheugen 
 (Indien er voldoende geheugen is) voordat het wordt afgespeeld. 
 
 De optie 'Loop mode' zorgt ervoor, dat de film weer van voorafaan begint
 bij het bereiken van het einde.

 De optie 'Stop op einde' (deze vind men onder help) is nuttig, als het 
 programma werd gestart door een ander programma (bijv CAB). Deze optie heeft
 verder geen effect, als de loop-mode is ingeschakeld. 
 
 The option 'pause at start' causes a pause on the first picture and
 equally on the end of file. 

 De optie 'Zonder foutmelding' onder het help-menu, onderdrukt een 
 aantal foutmeldingen. O.a. 'Einde bestand niet bereikt'.
 
 De ingestelde opties kan men saven met control-S.


Commando's voor de commando-regel:
----------------------------------

 Bevat de commandoregel minstens een van de volgende opties, dan wordt het 
 programma gestart als TTP-programma:

  +annnnnnnnnn    : adress voor controlle programma (max. 10 cijfers)
  +bnnnnn         : Het aantal planes (max. 5 cijfers)
  +d              : met DSP (-d: zonder DSP)
  +e              : toon fouten (-e: toon de fouten niet, default is +e)
  +hnnnnn         : stelt de schermhoogte in (max. 5 cijfers)
  +i              : loop-mode (-i: geen loop-mode)
  +m              : met beeld (-m: alleen geluid)
  +p              : met geluid (-p: geluid uitzetten)
  +q              : kwaliteit (-q: geen kwaliteit)
  +r              : resample geluid (-r: geen resampling)
  +s              : beelden overslaan (-s: geen beelden overslaan)
  +wnnnnn         : stelt de schermbreedte in (max. 5 cijfers)
  +xnnnnn, +ynnnnn: positioneer beedl (max 5 cijfers, default in het midden)
  +znnnnnnnnnn    : adress informatie over de film (max. 10 cijfers)

 De pathnaam en de bestandsnaam volgen op de opties. bv:
  +d +r C:\MOVIES\X.MOV   leest X.MOV met DSP en resampling van het geluid.
  -p C:\MOVIERS\*.MOV     leest alle .MOV-bestanden in de aangegeven folder
                          zonder geluid. 
  +p C:\MOVIERS\*.*       leest alle bestanden uit de aangegeven folder
                          maar met geluid aan. 
  
 De opties, die men niet kan meegeven, worden gehaald uit het .INF bestand
 (ANIPLAY.INF) voor de aniplayer. Kan dit bestand niet worden gevonden, 
 dan worden de defaults overgenomen. Dit zijn: +d +i +m +p +q +r +s.
 De opties 'Direkt naar scherm', 'Zonder GEM' en 'Stop op einde' worden in-
 geschakeld. 
 De opties 'Contr. traagheid' en 'Zonder D2D' zijn uitgeschakeld.
 
 Op de FALCON wordt de scherm-resolutie automatisch op 320*240 in true-color 
 gezet als het beeldformaat kleiner of gelijk is aan 320*240. 
 Heeft men meegegeven op welke positie de film moet worden afgespeeld (+x +y)
 dan wordt de scherm-resolutie op de Falcon niet aangepast naar true color. 
 Ook de achtergrond wordt niet eerst uitgewist.
 Bij gebruik van bit-planes wordt de x-waarde altijd geplaatst op een veelvoud 
 van 16.

 Adress (+a) wordt gebruikt voor het controle programma. Hieronder is een 
 voorbeeld gegeven tbv. de programmeurs onder ons.
 
 In C (vereenvoudigd voorbeeld):
 {
   Pexec(0,"ANIPLAY.PRG","+x100 +y100 +aadress C:\MOVIES\X.MOV",""); 
 }

 int adress()
 {
   switch(code())
   {
   case END:
     return(0x1b);   /* ESC */
   case PAUSE:
     return(' ');
   case REW:
     return(0x4B34); /* SHIFT +   (-10S) */
   case FF: 
     return(0x4D36); /* SHIFT +   (+10S) */
   }
   return(0);
 }
 
 Adress informatie (+z) speelt de film niet af, maar geeft de gegevens over de 
 film terug aan het aanroepende programma. Deze beidt de programmeurs onder 
 ons allerlei mogelijkheden.
 Deinformatie wordt teruggeleverd in een buffer van 32-byte. 
  
 struct infos
 {
   int width;
   int height;
   int planes;
   int frames_second;
   long total_frames;
   long id_picture_compression; /* cvid for example */
   int quality; /* B0: mono(0)/stereo(1)  B1: 8 bits(0)/16 bits(1) */
   unsigned int frequency_file;
   unsigned int frequency_machine;
   long total_samples;
   long id_sound_compression;  /* ima4 for example */
   int version_player;         /* version of Aniplayer */
 }


GEM messages:
-------------

 Message VA_START:

  msg[3] = Path (high)
  msg[4] = Path (low)

  A command line can be joined:

   +c: with control slowness (-c: without)
   +d: with dsp (-d: without dsp) 
   +g: with GEM (-g: without GEM)
   +i: loop (-i: without)
   +k: with keyboard (-k: without for use only AV_SENDKEY)
   +l: little window (-l: normal window)
   +m: with pictures (-m: sound only)
   +p: with sound (-p: shut-off sound)
   +q: with quality (-q: without)         
   +r: resample sound (-r: without)
   +s: pass pictures (-s: all pictures)
   +t: tape recorder look (-t: slider)
   +v: with direct screen (-v: without)   
   +xnnnnn, +ynnnnn: movie position (5 numbers max, default center)


 Message AV_SENDKEY:

  msg[4] = Pressed key (GEM format)


 Message 'AP':

  - Message for a new position in seconds:
 
    msg[3] = 1
    msg[4] = Seconds (high)
    msg[5] = Seconds (low)
 
    No answer message.


  - Message for a new position in pictures:

    msg[3] = 2
    msg[4] = Picture (high)
    msg[5] = Picture (low)
   
    No answer message.
 

  - Message for get informations:
 
    msg[3] = 0
    
    Answer message 'AP':
 
    msg[3] = Structure (high)
    msg[4] = Structure (low)

    typedef struct
    {
      int width;
      int height;
      int planes;
      int frames_second;
      long total_frames;
      long id_picture_compression;   /* cvid for example */
      int quality;         /* B0: mono(0)/stereo(1)  B1: 8 bits(0)/16 bits(1) */
      unsigned int frequency_file;
      unsigned int frequency_machine;
      long total_samples;
      long id_sound_compression;    /* ima4 for example */
      int version_player;           /* version of Aniplayer */
      long count_seconds;
      long num_frame;
      int reserve[12];
    } INFO_ANIM;
 

Vragen en antwoorden:
---------------------

 Welke opties kan ik het beste inzetten op de FALCON voor een zo snel 
 mogelijke weergave van de beelden? 
 - Schermresolutie 320*240 (of 480) in true-color op een VGA-monitor
   (25 MHZ) of 320*200 op een TV of RGB-monitor.
 - DSP gebruiken.
 - Direct naar scherm.
 - Zonder GEM. 
 - Zonder D2D. 

 Af en toe krijg ik de boodschap: 'Decompressie van het blok niet nogelijk in
 het DSP-geheugen'. Is dit normaal?
 - Het bestand is niet voldoende compressed. The beelden die moeten worden 
   ge-decompressed zijn verdeeld in blokken. De DSP gebruikt minimaal altijd
   een blok. 
   Om het probleem op te lossen moet de DSP een deel van een blok gaan 
   verwerken. Dit kan dan weer de verwerking van goede blokken vertragen.
  - Schakel het gebruik van de DSP uit.

 Hoe kan ik de diashow gebruiken op een FALCON, zonder dat ik de grooottes 
 van de filmpjes weet ?   
 - Neem een scherm-resolutie die hoger of gelijk is aan  640*480 in 256  
   kleuren.
 - DSP gebruiken.
 - Direct naar scherm.
 - Zonder GEM.
 - Kies de folder met de filmpjes voor de dia-show. 
 - Is de film kleiner of gelijk aan 320*240, dan zal de scherm-resolutie
   automatisch wijzigen in 320*240 (Dit zal bij de meeste filmpjes het geval
   zijn).
 - Is de film groter dan 320*240, dan wordt deze vertoond in de ingestelde
   resolutie.
  

Gebruikte configuratie voor het testen:
---------------------------------------

 FALCON 030 met Speed Resolution Card (68030  40 MHz, bus op 20 MHz, 
 DSP op 40 MHz) in SVGA 640 * 400 true color (clock 40 MHz).
 CD-ROM SCSI PIONEER 10X met METADOS als driver.
 ZIP drive SCSI IOMEGA 100 met AHDI 6.06 (iets trager).

 Het programma komt met een film in CVID-format in de resolutie 320*240
 met 12 frames/seconde aan de grenzen van zijn kunnen. 
 


Shareware:
----------

 Aniplayer is Shareware. Het is GEEN public domain.

 Om te registreren stuurt men:

 - US$10, CAN$15, 15DM, 7UKP of 50F naar mij op het volgende adres:

        Didier MEQUIGNON
        25, rue de l'Ascenseur 62510 ARQUES
        FRANCE


 - Vermeld daarbij de volgende informatie:

  Naam
  Adres
  Postcode en Woonplaats (noteer de postkode als NL-9999 XX)
  eventueel email-adres
  De gebruikte computer-configuratie


 Na ontvangst van het shareware-bedrag ontvang je dan een persoonlijke sleutel.
 Deze moet je dan ingeven in de registratie-dialoog. De sleutel wordt gesaved 
 in ANIPLAY.INF. Let wel! Het veranderen van aniplay.inf met bv. een tekst-
 editor kan de sleutel beschadigen. 


Mijn hartelijke dank aan de volgende personen voor hun bijdragen en ideeen:
---------------------------------------------------------------------------

 Bertrand Marne aus Rosny Sous Bois (F).
 Simon Yardley aus Ashingdon Rochford (GB).
 Christophe Ricard aus Grabels (F).
 Yu-Ou Wang aus Paris (F).
 Pascal Ricard aus Pierrevert (F).
 Bruno Levionnois (F).
 Houplon Jol aus Chaville (F).
 Philippe Conceicao aus Schiltigheim (F).
 Christophe Villeneuve aus Bourges (F).
 Guillaume Tello aus Montreuil Bellay (F).
 Bruno Bgni aus Saint-Gingolph (F).
 Denis Huguet aus Mehun sur Yvre (F).
 Jean-Jacques Ardoino (F).
 Mille Babic aus Gteborg (S).
 Rmi Vanel (F).
 Thierry Benet (F).
 Joachim Fornallaz aus Zrich (CH).
 Magnus Kollberg (S).
 Karel Post (NL).
 Francois Le Coat (F).
 Nicolas Boulesteix aus Gaillon sur Montcient (F).
 Raymond Collins (US).
 Philippe Castella (F).
 Loc Sbald aus Caveirac (F).
 Christian Marillat (F).
 Clment Benrabah (F).
 Noah Silva (US).
 Frdric Boudet aus Tonneville (F).
 Patrick Delecluse aus Bruille St Amand (F).
 Gilbert Devred aus Lille (F).
 Jo Vandeweghe aus Dottignies (B).
 Oliver Heun aus Mainz (D).
 Alexander Kartalija aus Bad Durrheinidem (D).
 The Removers (F).
 Thomas Raukamp (D).
 Alexander Clauss (D).
 Robert Bltter aus Hamburg (D).
 Karel de Bruijn aus St. Jansteen (NL).
 Guilbert Duchesne aus Lille (F).
 Alain Larrod aus Villacoublay (F). 
 Nicolas Richeton aus Poitiers (F).


Andere programma's die door mij zijn gerealiseerd:
--------------------------------------------------

 PICDESK, plaats een achtergrond (X)IMG/GEM op de GEM desktop, bevat een
 nieuwe file selector, news screen resolutions, snellere beeldopbouw en
 dode toetsen.. 
 Freeware. FALCON.

 SONDIGIT, geluids digitizer met of zonder direct to disk, speelt de formaten
 WAV/AIF/AVR/DVS. Freeware.

 
                 MEQUIGNON Didier, Dezember 1998
                 
                 
P.S.
----

 Ik ben niet in het bezit van alle mogelijke hardware en heb ook niet 
 altijd bestanden kunnen vinden in de verschillende beeld- en geluids-
 formaten. Het gevolg hiervan is, dat ik niet alles kan testen. 
 (Zie ook in het staatje met de verschillende formaten de opmerking 
  niet getest).
 Heb je problemen met aniplayer of met bv. je grafische kaart. 
 Neem vooral kontakt op met mij.   

 Informatie over niet herkende compressie-formaten, voorstellen en opmerkingen
 kan men schrijven aan het volgende adres:
 

            25, rue de l'Ascenseur 62510 ARQUES FRANCE
            
 Of via email:

              internet e-mail: didier.mequignon@wanadoo.fr
                       web: http://perso.wanadoo.fr/didierm/
                       
              minitel in France: 3615 RTEL bal DEVDSP
 
 Heb je een probleem of ben je een fout tegengekomen vermeld dan het volgende:

  - De versie van ANIPLAYER.
  - De gebruikte computer (type en de eventuele versnellerkaart en/of 
    grafische kaart).
  - De resolutie die werd gebruikt.
  - De opties de werden gebruikt. (DSP gebruiken, zonder gem etc.)
  - Het bestandsformaat.
  - Het type compressie (Dit kan men opvragen met Control-I of I).
  - Een gedetaileerde beschrijving van het probleem.

  Dit alles liefst in de franse taal. Indien dat niet lukt, mag het ook in het 
  engels. 

 Ik sta open voor alle aanbevelingen en opmerkingen die de evolutie van 
 aniplayer vooruithelpen. 


