-=*=- -=*=- -=*=- -=*=- -=*=- -=*=- -=*=- -=*=- -=*=- -=*=- -= MandAnim v 1.1 =-. GebruiksAanwijzing. INHOUD: *********************************** -. Toestemming. -. Dankwoord. 0. Algemeen. 1. Quick Start. 2. MENU. 3. NO-ACTION. 4. MAKE BASE-PICTURE. 5. COLOR. 6. NEW ANIM. 7. KEYS. 8. POSITIES. 9. Bugs. 10. Post. -. Reklame. *********************************** _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ -. Toestemming. MandAnim v 1.0 is speciaal geschreven om te worden toegevoegd aan de Public Domain serie van Fred Fish. Iedereen heeft de uitdrukkelijke toestemming van de auteur om dit programma te: - Gebruiken,. - Copieren (samen met deze gebruiksaanwijzing),. - Aan te bevelen bij anderen (geef ze gelijk een kopie !). Het is -natuurlijk- niet toegestaan om dit programma (anders dan als Fish-Disk) te koop aan te bieden,en ook het maken en /of verkopen van programma's die van de "MAND" (IFF-) chunk of de 'AnimFile' gebruik maken is -zonder schriftelijke toe- stemming- verboden. Ekke Veheul,. 25-05-'90. Rotterdam. _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ -. Dankwoord. Mijn dank gaat uit naar de schrijvers van ARP ; MandAnim maakt dankbaar gebruik van de FileRequester van versie 39.1. Die versie van arp.library moet daarom op de bootdisk aanwe- zig zijn (!). Dit programma zou de beginfase nooit zijn doorgekomen zonder de hulp van Arnout Grootveld; hij schreef de assembler-routi- ne die de kleur van een pixel bepaalt. Die routine bepaalt in grote mate de (hoge) snelheid ; iets wat in 'C' een tergend langzaam proces zou zijn geweest gebeurt nu in enkele secon- den. Bedankt Arnout ! Versie 1.0 werd ter beoordeling voorgelegd aan de Amiga-club van Erwin Fasel en het zijn vooral zijn suggesties die hebben geleid tot een (nog) eenvoudiger bediening in versie 1.1. Be- dankt Erwin ! Mijn grote vriend Ruud de Greef bedacht ooit dat een frac- tel-animatie programma wel leuk zou kunnen zijn. Hij had niet gedacht dat ik zo gek zou zijn om er vier maanden lang al mijn vrije tijd aan te besteden , en eerlijk gezegd... ik ook niet. Ruud, je word bedankt! _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 0. Algemeen. MandAnim is een programma, bedoeld voor het maken van series fractals die,geladen in bv DPaint,tesamen een fraaie animatie vormen; om uuuren naar te kijken... en om te dienen als bewe- gende achtergrond van zelfgetekende animaties. Het programma is daarnaast goed te gebruiken om enkele plaatjes te maken . De basis van MandAnim is de (beroemde) functie van Mandelbrot (het appelmannetje) en de default posities zijn zo ingesteld dat de hele figuur te zien is . Maak dat plaatje en save het als MA-BASE zodat het programma het automatisch kan inladen bij het opstarten (zie Quick Start). Elk plaatje dat door MandAnim gemaakt is kan echter als basis worden gebruikt. In de IFF-structuur van zo'n plaatje zitten de posities en instellingen opgeslagen zodat, nadat het gela- den is, er direkt weer op kan worden ingezoomd. Een plaatje dat langere tijd als basis gebruikt moet worden kan dus als MA-BASE worden gesaved. De gebruikte resolutie is LOWRES, 16 kleuren. Hierdoor is een animatie op redelijke snelheid af te spelen. Twee opeenvol- gende frames hebben over het algemeen geen overeenkomsten welke het afspelen zouden kunnen versnellen. Voor het aanmaken van de animatie-plaatjes is een standaard AMIGA-500 voldoende.Voor het afspelen van de animaties heb je echter aan 2 MB geheugen al snel tekort (DPaint wil met 1 MB. maar 10-14 frames binnenhalen) Een HardDisk is altijd prach- tig: een diskette is met +/- 35 plaatjes echt wel vol, en het loont dan niet echt om de AMIGA 's-nachts te laten rekenen. Maar het programma is geheel 'multitasking' en er kan - zij het iets trager - tijdens het rekenen met een ander programma worden doorgewerkt (Amiga-N). Het programma is geschreven op een AMIGA-500 (1.2) met 1 MB, zonder harddisk, dat kan dus. Het programma is ook uitgeprobeerd op: een 500 WB 1.3 512 Kb een 2000 WB 1.3 met 3 Meg en 1 Mb CHIP (Agnus de Dikke) een 2000 met 40 MHz turbokaart en 32-bits ram (oei,wat snel) een 3000 WB 1.3 en... 2.0 (kort) Alles werkte dacht ik naar wens, maar gebruik geen programma's (multitasking) die de werking van de muis veranderen;dat geeft soms problemen in MandAnim zelf. Gelieve ernstiger bugs te melden (zie onder). MandAnim v1.1 is (bijna) helemaal in `C' geschreven. De enige uitzondering is de functie van Arnout Grootveld , die is ge- scheven in assembler. _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 1. Quick start. Opstarten kan via WorkBench of CLI . De eerste 'fout'melding betreft het niet kunnen vinden van MA-BASE, geen paniek, die gaan we eerst maken . Alle meldingen van MandAnim wachten op de linkermuisknop dus klik eenmaal, en het eerste gadgetveld komt omhoog. Links staat 'Base Picture' en daaronder 'Load', 'Make' en 'Save'.Selecteer het 'Make'-gadget en het volgende gadgetveld verschijnt . Negeer al die gadgets even en klik alleen op 'RENDER'. Na +/- 50 seconden is het appelmanne- tje klaar en het is handig om deze te 'SAVE'en als MA-BASE in dezelfde directory als waarin MandAnim staat . Ga daartoe terug naar het `Menu' en selecteer `Save'. Typ `MA-BASE' in achter `File' (na de juiste directory gevonden te hebben) en klik op `OK' (en daarna nog een keer, ergens). Nu kunnen we beginnen met het maken van een animatie . Klik op `New Anim' om in het desbetreffende gadgetveld te komen en onderneem het volgende: 1. Klik op het 'muis'-gadget : de gadgets zakken naar beneden en de pointer verandert in een teller.Teken nu met de muis twee rechthoeken door van linksboven (linkermuisknop in) naar rechtsonder (muisknop los) te bewegen en druk op de rechtermuisknop op aan te geven dat je klaar bent. Het gadgetveld komt dan weer om- hoog en de pointer herstelt zich. 2. Activeer het 'FRAMES:'-stringgadget door op de '0' te klikken en maak daar (b.v.) 20 van (RETURN!). 3. Selecteer 'PREVIEW' om te kijken of dit ongeveer de be- doeling was en ,zo ja,: 4. Druk op 'RENDER': Nu komt eerst de FileRequester omhoog zodat we het pad en de naam van de animatie-plaatjes kunnen aangeven. Als dat is gebeurd moeten we nog een keer klikken en vervolgens wat (veel) geduld hebben. Na een klein (?) half uurtje is MandAnim klaar en komt het gadget-veld weer omhoog . Verlaat dan het programma ( MENU - EXIT ) en start DPaintIII op . Laad dan de plaatjes in door de eerste te selecteren ( naam.000 ) en het aantal frames in te stellen. Zie verder de gebruiksaanwijzing van DPaintIII. _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 2. MENU. Hier bevinden zich 7 gadgets , die we hier even snel behande- len: Base Picture: - Load : Laat de FileRequester komen met de bedoeling dat de gebruiker een (MandAnim-) plaatje selecteert met de intentie deze als achtergrond (als `BasePicture') te installeren. - Make : zie MAKE BASE-PICTURE. - Save : Alweer de FileRequester,maar nu kan het achtergrond- plaatje naar disk worden gesaved. Anim Series : - New Anim : zie NEW ANIM. - Old : Andermaal de FileRequester met de vraag een `Mand- AnimFile' te selecteren. De bedoeling hiervan is een onderbroken animatie-serie af te maken OF een plaat- je dat verloren gegaan is overnieuw te berekenen. In het laatste geval kan na het laden van de "naam.maf" -file met behulp van de HELP-toets het juiste frame- nummer worden ingetypt. System : - Sleep: Een -tijdelijke- uitweg als er even iets anders ge- beuren moet en daar alle systeemtijd voor nodig is. Al het CHIP-geheugen wordt in principe vrijgegeven en zolang in FAST bewaard. Als er genoeg Fast geheu- gen aanwezig is komt het achtergrond-plaatje daar -gecompressed- ook terecht. Vergeet niet dat `Amiga-N' in veel gevallen voldoen- de is. - Exit : Pas Op ! Er komt geen requester om te vragen of je wel HEEL ZEKER weet dat je het programma uit wilt. Voor mensen met snelle toets-vingertjes (Arnout?) zijn er hiernaast ook nog toetsen voor alles. Zie afdeling KEYS. Er is geen gadget om in `NO-ACTION' te komen ; klik daartoe met de RECHTER-muisknop BOVEN het gadget-veld. Die truuk lukt ook in MAKE, ANIM en COLOR. _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 3. NO-ACTION. Het doel van dit programma is te kunnen genieten van een Mandelbrot-animatie , maar ook enkele plaatjes kunnen het be- kijken waard zijn . Daarvoor is deze `aktie'. Ter verhoging van de feestvreugde kan er op de TAB worden gedrukt om een eenvoudige colorcycling te aktiveren. Hier kan de snelheid niet van worden geregeld , maar wel de richting. Probeer de rechter- en linker- pijltoetsen. Om weer terug te komen kan de rechtermuisknop uitkomst geven, maar de toetsen doen het natuurlijk ook (zie KEYS). _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 4. MAKE BASE-PICTURE. En hop, wel 18 gadgets. Van links naar rechts: StringGadgets (4): - Hierin kunnen de posities worden ingetypt van de grenzen van het te maken plaatje . Let er op dat er binnen de -3.0 en 3.0 gebleven wordt en dat links en onder kleiner is dan rechts en boven. En anders... MuisGadget: - Ook hiermee kun je -veel makkelijker- de posities van het te maken plaatje aangeven . Er wordt echter aleen maar in- gezoomd; je kan geen rechthoek buiten het plaatje tekenen. Lees vooral `POSITIES'. Render: - Als alle instellingen gemaakt zijn, klik je hierop en moet je even geduld hebben. Menu/Color (2): - Terug naar MENU of de kleuren regelen in COLOR ; kan ook met de toetsen, maar ik had wat ruimte over... Speed: - Drie mogelijkheden : Normal (100%) , Pass-X (+/- 56%) en Pass-XY (+/- 38%) . Geen mens zal -wellicht na proberen- ooit iets anders gebruiken dan Pass-XY maar `Normal' zet toch hier en daar een pixeltje anders... Het zijn eigenlijk cheat-opties die gebaseerd zijn op de (foute) veronderstelling dat tussen twee pixels met de- zelfde kleur geen anders-gekleurde zal zitten. Iterations: - Je bepaalt het maximale aantal berekeningen per pixel hiermee . Dat beinvloed niet alleen het uiteindelijke plaatje ( een zwart gat wordt kleiner als je de iteratie verhoogt) maar vooral ook de tijd die het programma er over doet . Vergelijk binnen 1 plaatje de iteraties door het programma af en toe te onderbreken (rechtermuisknop) de iteratie te veranderen en weer te starten (RENDER). Als je de goede gevonden hebt kun je door een string-gad- get te selecteren ( return ! ) de berekening opnieuw laten starten. IT->C (8): - Uit de zoveel miljoen mogelijkheden om de iteraties naar kleur om te zetten heb ik er 8 uitgezocht die welliswaar niet getuigen van een overvloed aan fantasie maar wel bruikbaar zijn . Om achter het werkelijke effect te komen kun je ze het best gewoon proberen. Het getal tussen de haakjes bepaalt de stap waarmee `Iteraties:' kan worden verhoogd/verlaagd en daarachter staat een rest die nodig was om een zwart gat in kleur `0' te krijgen en om geen verdubbeling van een kleur te krijgen bij de laatste drie. Snap je? Oh. _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 5. COLOR. De gebruikte kleuren kunnen allemaal worden veranderd.We doen hier niet aan 'cycling' -alleen in NoAction- maar de bekende opties 'spread','copy' en 'exchange' zijn er natuurlijk wel. - 'Load Palette' stelt je in staat de kleuren van een (elk) ander IFF-plaatje (met tenminste 16 kleuren) te copieren. - 'Ready' brengt je terug naar waar je vandaan kwam. Mocht je daar niet willen zijn; gebruik dan de `KEYS'. _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 6. NEW ANIM. Weer een heel veld vol met gadgets , maar de meeste staan ook in `MAKE' zodat we ons kunnen consentreren op: - Path: Dat staat er niet bij (geen plaats) maar dat is wel de functie van dit gadget. Er zijn hier (maar) drie mogelijk- heden: PingPong Chain , Straight Chain en Single Pictures. Het betreft de manier waarop een pad tussen twee posities wordt berekend. `Single Pictures' berekent helemaal niets; het aantal frames is dan gelijk aan het aantal posities. `Straight Chain' verdeelt de ruimte tussen twee posities in gelijke stappen en `PingPong Chain' remt af en versnelt voor en na de tweede en eerste positie. Het was de bedoeling later wat functies hieraan toe te voegen; als je daar ideeen over hebt -met de benodigde berekeningen- stuur het me dan vooral toe. - Frames: Gewoon het aantal frames voor de animatie, of het aantal te berekenen plaatjes, dus. Intypen voor er op RENDER of PREVIEW wordt geklikt (return!). Als er van meer dan twee posities gebruik wordt gemaakt moet je niet schrikken als dat aantal iets wordt vermindert; het aantal moet namelijk voldoen aan: ? * posities + 1 . Het maximale aantal is overigens 8191, mocht iemand dat aantal te weinig vinden dan hoor ik dat wel... (-: - Preview: Het verdient aanbeveling een gemaakt pad te bekijken voor het wordt geRENDERt, maar het is niet verplicht. Verkijk je overigen niet op de snelheid, die heeft niets te maken met de snelheid van de uiteindelijke animatie. - MuisGadget: Staat ook op `MAKE' maar wacht met teruggaan op de rech- terMuisKnop; er kunnen (moeten) meerdere posities worden getekend. Lees toch vooral `POSITIES'. - Render: Hoewel deze ook op `MAKE' staat werkt het hier heel an- ders. Bij MAKE wordt er gewoon 1 plaatje gemaakt, bij ANIM dus meer, en die worden automatisch naar disk ge- schreven. Er moet dus een Pad (Amiga-Dos) en een Naam worden opgegeven. Dat gaat met behulp van de FileReques- ter, simpel dus. Daarna schrijft MandAnim een "Naam.maf" File naar deze directory waarin alle plaatjes worden be- schreven, en wordt bijgehouden welk plaatje aan de beurt is (was). Deze file moet worden ingeladen als het bere- kenen werd onderbroken (RechterMuisKnop) en moet worden hervat (zie `Old', in MENU). DISK FULL (!): - Bij een DOS-melding betreffende een volle disk select dan ALTIJD -> CANCEL <- !!!! Klik MandAnim dan weer naar voor (de requester komt in de WorkBench vanwege ons palette) en kijk of MandAnim een oplossing weet... - Mocht u naar diskette schrijven dan is het vervolgens voldoende de disk te vervangen voor een (liefst) lege geformatteerde disk (maak een voorraadje!) en ergens te klikken. Dan gaat ie gewoon verder. P.S. DPaint wil geen animatie maken van plaatjes die over meerdere disks verspreid zijn: maak van elke disk een kleine animatie en plak die later in de juiste volgorde aan elkaar, dat lukt wel. _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 7. KEYS. In MENU,NO-ACTION,MAKE,ANIM en COLOR zijn de volgende toets- en aktief: ***************************************** L -> Load BasePicture. M -> Make BasePicture. S -> Save BasePicture. A / N -> New Anim. O / R -> (Render) Old. Esc -> Sleep. Arrow Down -> NoAction. C / P -> Color. HELP -> Menu. ***************************************** _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 8. POSITIES. `MUIS'-gadget is in MAKE en ANIM bijna geheel gelijk ,behal- ve dat in MAKE eerst alle bestaande borders worden gewist, en er wordt teruggesprongen naar MAKE na het tekenen van een ( 1 ) border. Bij ANIM wordt niets gewist (moet je zelf doen) en er wordt pas teruggesprongen naar ANIM als je aangeeft dat je klaar bent (RETURN of RechterMuis), of het maximaal aantal posities (999) bereikt is (-: Bij het tekenen van de posities zijn enkele hulpmiddelen : Allereerst de HELP-toets . Er komt een window-tje linksboven met de tekst : "W/H:" .Tegelijk worden de eerste twee kleuren even aangepast zodat dat window in alle gevallen zichtbaar is.Het doel hiervan wordt duidelijk wanneer er een vierkantje wordt getekend door de linker muisknop in te drukken en naar rechts-onder te bewegen. Achter de W/H: komt een getal wat de werkelijke(!) verhouding tussen de breedte en de hoogte weer- geeft. Dit is handig als je die verhouding overal gelijk (1) wilt houden, of juist gelijkmatig wilt veranderen. De HELP- toets kan op elk moment -ook tijdens het tekenen- worden ge- bruikt om dat windowtje te laten komen of gaan. Erg handig zijn de PIJL-toetsen . Tijdens het tekenen van een border komt het ( bij mij ) vaak voor dat het vinden van de juiste W/H-verhouding en het centreren van het te vergroten object slecht samengaan. Op zo'n moment is het prettig te we- ten dat de begin-positie (de linkerboven hoek) te verplaatsen is door op de pijl-toetsen te drukken. Proberen !! Zou wel iets zijn voor in DPaint, volgens Erwin. Tenslotte zijn er de BACKSPACE '<-' of 'Del' om de laatste border te wissen en de 'C' (clear) om ALLE borders te wissen, maar PAS OP ! er is hier geen 'undo' mogelijk. _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 9. Bugs. Ik ben lang bezig geweest met zoeken naar bugs , en ik heb de meeste wel gevonden en opgelost, geloof ik. Een echte GURU is dacht ik niet meer te veroorzaken , ook een 'vastzitten' van het programma heb ik lang niet meer meegemaakt , maar je weet nooit... Mocht je iets vinden wat duidelijk niet zo hoort, probeer dat dan goed te beschrijven en laat het me AUB weten. _ _ _ _ _ _ _ _ _ _ _ _ \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ / \ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \_/ \ 10. Post. Informatie over de asm-routine of andere ( vele, was mijn er- varing ) vragen over de Amiga kun je stellen aan: Arnout Grootveld Hoekblok 36 2291 XW Wateringen. tel: 01742-4421 of ( ?? )-3117424421 Electronic mail heeft echter de voorkeur: FidoNet: 2:281/600.2 UseNet: ...!hp4nl!neabbs!amg Ikzelf krijg liever gewoon post , dus als je iets wilt weten of melden of ons (Digital Pro Motions) een opdracht wilt aan- bieden of informatie wilt over andere PROgramma's (vooral TV- Tools, zie 'Reklame'), stuur die dan naar: Ekke Verheul Stroveer 120 3032 GA Rotterdam Nederland Bellen kan ook, Binnen Nederland: 010-4660503. Elders: ( ?? )-31104660503 Voor iedereen die tot hier gekomen is met lezen, veel plezier met MandAnim, en alvast bedankt voor je reactie. Ekke.