**********
ANIMATIONS AND ANIMATION SPEED [KEEN]
**********

This document outlines several animation related properties of Keen. They are:

1.) Left/right sprites used: This is simply the animation used by the sprite when
it is facing left or right. ALL sprites have these two values, even if both are
the same. (Sometimes it depends whether the sprite is left or right of Keen say.)
There are two 'special' values; the first, '$0000W' is used when the animation
is not meant to change the sprite's animation; items for example use this; their
animations are preprogrammed and don't need to be changed. The second is '$FFFFW'
and is used when a sprite must become invisible for a moment, it erases the animation
being used, but not the sprite. When the Ceilicks disappear, they are invisible for
a while.

The sprite used when going left is listed first, then the one for going right. In some
cases these are the same, in others, different. Feel free to experiment. (Remember, left
sprite is on the left, right sprite is on the right.) Both values are as 'words';
$3C $00 = $003CW, but you can write them however you like.

The number USED in each patch is the sprite number plus 46, in hex. This can get a
bit confusing when you want to change them, but you'll soon get the hang of it, or
learn to do it by trial and error.

2.) Animation speed: Simply enough, this is how long a sprite takes to animate 1-FRAME
it is how long an animation is held for. There are two special values; '$0000W'
which means 'never change' (Used often by shot sprites.) and '$3075W'; used by
sprites that need to stay a long time, but eventually disappear.

There is also a list of sprite caches; never make a sprite use a sprite frame not cached by
itself or another sprite in the level! (See '7.) Cache') Keen's aniamtions, for conveience
are stored in the next section.



###
#Map Keen, See also, Flag
###

#Map Keen moving
%patch $320F8 $0004W        #Animation speed
%patch $3211E $0003W        #Number of sprite frames used 1
%patch $32122 $0003W        #Number of sprite frames used 2
%patch $3210C $00BDW        #Up map sprite [All sprites used +1]
%patch $3210E $00CCW        #Up right map sprite
%patch $32120 $00BAW        #Right map sprite
%patch $32112 $00C3W        #Down right map sprite
%patch $32114 $00C0W        #Down map sprite
%patch $32116 $00C6W        #Down left map sprite
%patch $32118 $00B7W        #Left map sprite
%patch $3211A $00C9W        #Up left map sprite


%patch $3202A $0000W $0000W  #Map Keen bored [Don't change sprite yet]
%patch $32034 $0168W #Pause needed before waves
%patch $32048 $00D0W $00D0W #Map Keen waves 1
%patch $32052 $0014W        #Animation speed
%patch $32066 $00D1W $00D1W #Map Keen waves 2
%patch $32070 $0014W        #Animation speed
%patch $32084 $00D0W $00D0W #Map Keen waves 3
%patch $3208E $0014W        #Animation speed
%patch $320A2 $00D1W $00D1W #Map Keen waves 4
%patch $320AC $0014W        #Animation speed
%patch $320C0 $00D0W $00D0W #Map Keen waves 5 [Go back to standing on map]
%patch $320CA $0014W        #Animation speed


%patch $328CE $00DDW $00DDW #Keen throws grapnel 1
%patch $328D8 $000AW        #Animation speed
%patch $328EC $00DEW $00DEW #Keen throws grapnel 2 [Go back to standing on map]
%patch $328F6 $0008W        #Animation speed


%patch $3290A $00DFW $00DFW #Map Keen climbing rope 1
%patch $32914 $0004W        #Animation speed
%patch $32928 $00E0W $00E0W #Map Keen climbing rope 2
%patch $32932 $0004W        #Animation speed


%patch $32946 $00E2W $00E2W #Rope and hook [Do nothing]
%patch $32950 $0000W        #Animation speed
%patch $32964 $00E1W $00E1W #Rope being thrown [Not used]
%patch $3296E $000AW        #Animation speed


%patch $329A0 $00E3W $00E3W #Map Keen hanging from satelite [Wait until lands]
%patch $329AA $0000W        #Animation speed


###
#Keen
###


%patch $31560 $003CW $0034W #Unknown Keen standing
%patch $3156A $0000W        #Wait for keypress


%patch $3157E $0042W $003AW #Unknown Keen falling
%patch $31588 $0000W        #Wait for keypress


%patch $3159C $0087W $0085W #Unknown Keen pogo
%patch $315A6 $0000W        #Animation speed


%patch $315BA $006DW $0066W #Unknown Keen on a pole
%patch $315C4 $0000W        #Animation speed


%patch $315D8 $0034W $003CW #Keen standing still [Keep standing]
%patch $315E2 $0004W        #Pause before moving when keys pressed


%patch $31C4A $003DW $0035W #Keen walking 1
%patch $31C54 $0006W        #Animation speed

%patch $31C68 $003EW $0036W #Keen walking 2
%patch $31C72 $0006W        #Animation speed

%patch $31C86 $003FW $0037W #Keen walking 3
%patch $31C90 $0006W        #Animation speed

%patch $31CA4 $0040W $0038W #Keen walking 4 [Go to 1]
%patch $31CAE $0006W        #Animation speed


%patch $315F6 $0044W $0044W #Keen bored [Looks up, go back to standing]
%patch $31600 $003CW        #How long Keen must be bored to do this


%patch $31614 $0046W $0046W #Keen bored [Hands on hips, looks at player]
%patch $3161E $005AW        #Animation speed

%patch $31632 $0045W $0045W #Keen bored 2 [Blinks]
%patch $3163C $000AW        #Animation speed

%patch $31650 $0046W $0046W #Keen bored 3 [Hands on hips]
%patch $3165A $005AW        #Animation speed

%patch $3166E $0045W $0045W #Keen bored 4 [Blink 2]
%patch $31678 $000AW        #Animation speed

%patch $3168C $0046W $0046W #Keen bored 5 [Hands on hips again]
%patch $31696 $005AW        #Animation speed

%patch $316AA $0047W $0047W #Keen bored 6 [Shrugs, goes back to standing]
%patch $316B4 $0046W        #Animation speed


%patch $316C8 $0048W $0048W #Keen bored 1 [Reads book]
%patch $316D2 $0010W        #Animation speed

%patch $316E6 $0049W $0049W #Keen bored 2
%patch $316F0 $0010W        #Animation speed

%patch $31704 $004AW $004AW #Keen bored 3
%patch $3170E $0010W        #Animation speed

%patch $31722 $004BW $004BW #Keen bored 4
%patch $3172C $0010W        #Animation speed

%patch $31740 $004CW $004CW #Keen bored 5 [Reading book]
%patch $3174A $012CW        #Animation speed

%patch $3175E $004DW $004DW #Keen bored 6 [Look up from book]
%patch $31768 $0010W        #Animation speed

%patch $3177C $004EW $004EW #Keen bored 7 [Go back to reading]
%patch $31786 $0010W        #Animation speed


%patch $3179A $004FW $004FW #Keen stops reading book 1
%patch $317A4 $000CW        #Animation speed

%patch $317B8 $0050W $0050W #Keen stops reading book 2
%patch $317C2 $000CW        #Animation speed

%patch $317D6 $0049W $0049W #Keen stops reading book 3 [Go back to standing]
%patch $317E0 $000CW        #Animation speed


%patch $317F4 $0044W $0044W #Keen look up
%patch $317FE $001EW        #Delay before screen moves

%patch $31812 $0044W $0044W #Keen keep looking up [After $1E]
%patch $3181C $0000W        #Wait for keypress


%patch $31830 $0051W $0051W #Keen looking down
%patch $3183A $0006W        #Animation speed

%patch $3184E $0052W $0052W #Keen looks down
%patch $31858 $0018W        #Animation speed

%patch $3186C $0052W $0052W #Keen keeps looking down
%patch $31876 $0000W        #Wait for keypress

%patch $3188A $0051W $0051W #Keen stops looking down
%patch $31894 $0006W        #Delay before going to standing


%patch $318A8 $0051W $0051W #Keen jump down blocking-top-only tiles
%patch $318B2 $0000W        #Delay (Instant)


%patch $318C6 $FFFFW $FFFFW #Unknown Keen disappear
%patch $318D0 $000AW        #Animation speed


%patch $318E4 $0053W $0053W #Keen dies sprawled [Go to Keen clutched]
%patch $318EE $0064W        #Animation speed

%patch $31902 $0054W $0054W #Keen dies clutched [Go to Keen sprawled]
%patch $3190C $0064W        #Animation speed


%patch $31D1C $0041W $0039W #Keen falling 1
%patch $31D26 $0000W        #Wait until hits ground

%patch $31D3A $0042W $003AW #Keen falling 2
%patch $31D44 $0000W        #Animation speed

%patch $31D58 $0043W $003BW #Keen falling 3
%patch $31D62 $0032W        #Animation speed [speed/3 = speed for each frame]

%patch $31D76 $0042W $003AW #Keen falls off edge
%patch $31D80 $0028W        #Animation speed


%patch $31920 $0059W $005EW #Keen shoots l/r
%patch $3192A $0009W        #Animation speed

%patch $3193E $0059W $005EW #Keen shoots l/r [Make bullet, go to standing]
%patch $31948 $0006W        #Animation speed


%patch $3195C $005DW $005DW #Keen shoots up
%patch $31966 $0009W        #Animation speed

%patch $3197A $005DW $005DW #Keen shoots up [Make bullet, go to looking up]
%patch $31984 $0006W        #Animation speed


%patch $31D94 $005AW $005FW #Keen shoots l/r in air
%patch $31D9E $0009W        #Animation speed

%patch $31DB2 $005AW $005FW #Keen shoots l/r in air [Make bullet]
%patch $31DBC $0001W        #Animation speed

%patch $31DD0 $005AW $005FW #Keen shoots l/r in air [Goes to falling]
%patch $31DDA $0006W        #Animation speed


%patch $31DEE $005CW $005CW #Keen shoots up in air
%patch $31DF8 $0009W        #Animation speed

%patch $31E0C $005CW $005CW #Keen shoots up in air [Make bullet]
%patch $31E16 $0001W        #Animation speed

%patch $31E2A $005CW $005CW #Keen shoots up in air [Go to falling]
%patch $31E34 $0006W        #Animation speed


%patch $31E48 $005BW $005BW #Keen shoots down in air
%patch $31E52 $0009W        #Animation speed

%patch $31E66 $005BW $005BW #Keen shoots down in air [Make bullets]
%patch $31E70 $0001W        #Animation speed

%patch $31E84 $005BW $005BW #Keen shoots down in air [Go back to falling]
%patch $31E8E $0006W        #Animation speed


%patch $31998 $0076W $0076W #Keen places gems 1
%patch $319A2 $0008W        #Animation speed

%patch $319B6 $0076W $0076W #Go back to standing
%patch $319C0 $0008W        #Animation speed

%patch $319D4 $0076W $0076W #Keen places gem 2 [Go back to standing]
%patch $319DE $0006W        #Animation speed

%patch $319F2 $0076W $0076W #Keen places gem [While door opens]
%patch $319FC $0008W        #Animation speed


%patch $31A10 $0076W $0076W #Keen walks into doors 1
%patch $31A1A $0009W        #Animation speed

%patch $31A2E $0077W $0077W #Keen walks into doors 2
%patch $31A38 $0009W        #Animation speed

%patch $31A4C $0078W $0078W #Keen walks into doors 3
%patch $31A56 $0009W        #Animation speed

%patch $31A6A $0079W $0079W #Keen walks into doors 4
%patch $31A74 $0009W        #Animation speed

%patch $31A88 $007AW $007AW #Keen walks into doors 5 [Appear standing at door exit]
%patch $31A92 $0009W        #Animation speed


%patch $32598 $0055W $0055W #Keen stunned [Go back to walking]
%patch $325A2 $003CW        #Stun time


%patch $31AA6 $006DW $0066W #Keen on a pole
%patch $31AB0 $0000W        #Do nothing until keypress


%patch $31AC4 $006DW $0066W #Keen moving up a pole 1
%patch $31ACE $0008W        #Animation speed

%patch $31AE2 $006EW $0067W #Keen moving up a pole 2
%patch $31AEC $0008W        #Animation speed

%patch $31B00 $006FW $0068W #Keen moving up a pole 3 [Go to 1]
%patch $31B0A $0008W        #Animation speed


%patch $31B1E $0069W $0069W #Keen moving down a pole 1
%patch $31B28 $0008W        #Animation speed

%patch $31B3C $006AW $006AW #Keen moving down a pole 2
%patch $31B46 $0008W        #Animation speed

%patch $31B5A $006BW $006BW #Keen moving down a pole 3
%patch $31B64 $0008W        #Animation speed

%patch $31B78 $00C$W $006CW #Keen moving down a pole 4 [Go to 1]
%patch $31B82 $0008W        #Animation speed


%patch $31B96 $0074W $0075W #Keen shoot l/r on a pole
%patch $31BA0 $0009W        #Animation speed

%patch $31BB4 $0074W $0075W #Keen shoot l/r on a pole [Make bullet, go to Keen on pole]
%patch $31BBE $0006W        #Animation speed


%patch $31BD2 $0070W $0071W #Keen shoot up on a pole
%patch $31BDC $0009W        #Animation speed

%patch $31BF0 $0070W $0071W #Keen shoot up on a pole [Make bullet, go back to Keen on pole]
%patch $31BFA $0006W        #Animation speed


%patch $31C0E $0073W $0072W #Keen shoot down on a pole
%patch $31C18 $0009W        #Animation speed

%patch $31C2C $0073W $0072W #Keen shoot down on a pole [Make bullet, go back to Keen on pole]
%patch $31C36 $0006W        #Animation speed


%patch $31CC2 $0088W $0086W #Keen starts pogoing
%patch $31CCC $0001W        #Animation speed

%patch $31CE0 $0088W $0086W #Keen keeps pogoing [Wait until hits ground]
%patch $31CEA $0000W #Wait until hits ground

%patch $31CFE $0087W $0085W #Keen pogoing lands [Keep pogoing]
%patch $31D08 $0000W        #Animation speed


%patch $31EA2 $007BW $007CW #Keen gripping ledge start
%patch $31EAC $000CW        #Animation speed

%patch $31EC0 $007BW $007CW #Keen gripping ledge
%patch $31ECA $0000W        #Wait for keypress


%patch $31EDE $007DW $0081W #Keen pulls himself up from ledges 1
%patch $31EE8 $000AW        #Animation speed

%patch $31EFC $007EW $0082W #Keen pulls himself up from ledges 2
%patch $31F06 $000AW        #Animation speed

%patch $31F1A $007FW $0083W #Keen pulls himself up from ledges 3
%patch $31F24 $000AW        #Animation speed

%patch $31F38 $0080W $0084W #Keen pulls himself up from ledges 4 [Go to standing]
%patch $31F42 $000AW        #Animation speed


%patch $3225E $0060W $0060W #Keen's shot 1
%patch $32268 $0006W        #Animation speed

%patch $3227C $0061W $0061W #Keen's shot 2
%patch $32286 $0006W        #Animation speed

%patch $3229A $0062W $0062W  #Keen's shot 3
%patch $322A4 $0006W        #Animation speed

%patch $322B8 $0063W $0063W #Keen's shot 4 [Go back to 1]
%patch $322C2 $0006W        #Animation speed


%patch $322D6 $0064W $0064W #Keen's shot hits 1
%patch $322E0 $000CW        #Animation speed

%patch $322F4 $0065W $0065W #Keen's shot hits 2 [Disappear]
%patch $322FE $000CW        #Animation speed