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

This document outlines two 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, '$00 $00' 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 '$FF $FF'
and is used when a sprite must become invisible for a moment, it erases the animation
being used, but not the sprite. When the foot appears, it is 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 experiemnt.

The number USED in each patch is the sprite number plus 124 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; '$00 $00'
which means 'never change' (Used often by shot sprites.) and '$75 $30'; used by
sprites that need to stay a long time, but eventually disappear. (Lindsey, the Foot...)

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') You shouldn't have this problem.



###
#Map Keen
###

#Map Keen sprite
%patch $30410 $0000W $0000W #Uses sprites from list
%patch $3041A $0004W        #Reaction speed

#Map Keen when moving
%patch $3042E $03 $01 #Sprite up [LAST frame used]
%patch $30430 $12 $01 #Sprite ul
%patch $30432 $00 $01 #Sprite r
%patch $30434 $09 $01 #Sprite dl
%patch $30436 $06 $01 #Sprite d
%patch $30438 $0C $01 #Sprite dr
%patch $3043A $FD $00 #Sprite l
%patch $3043C $0F $01 #Sprite ur
%patch $30440 $03 $00 #Animations shown 1
%patch $30444 $03 $00 #Animations shown 2
%patch $3042E $18 $01 #Sprite up [When swimming on map]
%patch $30430 $20 $01 #Sprite ul
%patch $30432 $1A $01 #Sprite r
%patch $30434 $22 $01 #Sprite dl
%patch $30436 $1C $01 #Sprite d
%patch $30438 $24 $01 #Sprite dr
%patch $3043A $1E $00 #Sprite l
%patch $3043C $26 $01 #Sprite ur

#Bored, waves at player
%patch $3035C $0000W $0000W #Start (Don't change animation)
%patch $30366 $0168W        #Pause before waving
%patch $3037A $0116W $0116W
%patch $30384 $0014W        #Animation speed
%patch $30398 $0117W $0117W
%patch $303A2 $0014W        #Animation speed
%patch $303B6 $0116W $0116W
%patch $303C0 $0014W        #Animation speed
%patch $303D4 $0117W $0117W
%patch $303DE $0014W        #Animation speed
%patch $303F2 $0116W $0116W
%patch $303FC $0014W        #Animation speed

#Map Keen riding foot
%patch $30302 $0128W $0128W
%patch $3030C $001EW        #Animation speed
%patch $30320 $0129W $0129W
%patch $3032A $001EW        #Animation speed

%patch $3042C $A0 $15 #Map Keen moving start when standing still
%patch $3041A $04 $00 #Pause before start walking
%patch $3035A $CE $14 #Map Keen swimming start [When goes to water's edge]
%patch $30348 $06 $00 #Pause before start
%patch $30C88 $1A $1E #Keen on map, starts walking when walking 1
%patch $30C76 $2C $01 #Pause before switch
%patch $30CA6 $38 $1E #Keen on map, starts walking when walking 2
%patch $30C94 $1E $00 #Pause before switch
%patch $30CC4 $56 $1E #Keen on map, starts walking when walking 3
%patch $30CB2 $1E $00 #Pause before switch
%patch $30CE2 $74 $1E #Keen on map, starts walking when walking 4
%patch $30CD0 $2C $01 #Pause before switch
%patch $30D00 $92 $1E #Keen on map, starts walking when walking 5
%patch $30CEE $1E $00 #Pause before switch
%patch $30D1E $B0 $1E #Keen on map, starts walking when walking 6
%patch $30D0C $1E $00 #Pause before switch
%patch $30D3C $CE $1E #Keen on map, starts walking when walking 7
%patch $30D2A $1E $00 #Pause before switch
%patch $30D5A $FC $1D #Keen on map, starts walking when walking 8 [Go back to step 1]
%patch $30D48 $1E $00 #Pause before switch

#Sprite used when Keen dropped off by foot (Before he moves)
%patch $E10C $00 $01



###
#Normal Keen
###

#Keen standing
%patch $2F7FC $008AW $0082W
%patch $2F806 $0004W        #Reaction speed

#Keen looking up when bored
%patch $2F81A $0092W $0092W
%patch $2F824 $003CW        #Look up time

#Keen shrug-blinks (Bored more)
%patch $2F838 $0094W $0094W
%patch $2F842 $005AW        #Animation speed
%patch $2F856 $0093W $0093W
%patch $2F860 $000AW        #Animation speed
%patch $2F874 $0094W $0094W
%patch $2F87E $005AW        #Animation speed
%patch $2F892 $0093W $0093W
%patch $2F89C $000AW        #Animation speed
%patch $2F8B0 $0094W $0094W
%patch $2F8BA $005AW        #Animation speed
%patch $2F8CE $0095W $0095W
%patch $2F8D8 $0046W        #Animation speed

#Keen start reading book
%patch $2F946 $0096W $0096W
%patch $2F950 $0010W        #Animation speed
%patch $2F964 $0097W $0097W
%patch $2F96E $0010W        #Animation speed
%patch $2F982 $0098W $0098W
%patch $2F98C $0010W        #Animation speed
%patch $2F9A0 $0099W $0099W
%patch $2F9AA $0010W        #Animation speed

#Keen read book
%patch $2F9BE $009AW $009AW
%patch $2F9C8 $012CW        #Reading time (Before looking up at player)
%patch $2F9DC $009BW $009BW
%patch $2F9E6 $0010W        #Animation speed
%patch $2F9FA $009CW $009CW
%patch $2FA04 $0010W        #Animation speed

#Keen stops reading book
%patch $2FA18 $009DW $009DW
%patch $2FA22 $000CW        #Animation speed
%patch $2FA36 $009EW $009EW
%patch $2FA40 $000CW        #Animation speed
%patch $2FA54 $0097W $0097W
%patch $2FA5E $000CW        #Animation speed

#Keen look up
%patch $2FA72 $0092W $0092W
%patch $2FA7C $001EW        #Animation speed
%patch $2FA90 $0092W $0092W
%patch $2FA9A $0000W        #Animation speed

#Keen look down
%patch $2FAAE $00A0W $00A0W #Keen bend down
%patch $2FAB8 $0006W        #Animation speed
%patch $2FACC $00A1W $00A1W #Keen look down
%patch $2FAD6 $0018W        #Animation speed
%patch $2FAEA $00A1W $00A1W #Keen look down (Screen moves)
%patch $2FAF4 $0000W        #Wait for keypress
%patch $2FB08 $00A0W $00A0W #Keen stop looking down
%patch $2FB12 $0006W        #Wait for keypress
%patch $2FB26 $00A0W $00A0W #Keen stops looking down (Screen moves)
%patch $2FB30 $0000W        #Wait for keypress

#Keen moons
%patch $2F8EC $0207W $0207W
%patch $2F8F6 $0014W        #Animation speed
%patch $2F90A $0208W $0208W
%patch $2F914 $005AW        #Mooning time
%patch $2F928 $0207W $0207W
%patch $2F932 $0014W        #Animation speed

#Dead Keen
%patch $2FB62 $00A2W $00A2W #Sprawled
%patch $2FB6C $0064W        #Animation speed
%patch $2FB80 $00A3W $00A3W #Clutched
%patch $2FB8A $0064W        #Animation speed
%patch $2FB44 $FFFFW $FFFFW #Lose life (Remove Keen, bring up window)
%patch $2FB4E $000AW        #Animation speed

#Didn't make it past... (After death)
%patch $3033E $0000W $0000W
%patch $30348 $0006W        #Animation speed

#Dead swimming Keen
%patch $2FB9E $0139W $0139W
%patch $2FBA8 $0064W        #Animation speed
%patch $2FBBC $013AW $013AW
%patch $2FBC6 $0064W        #Animation speed

#Keen shoot l/r
%patch $2FBDA $00A7W $00ACW
%patch $2FBE4 $0009W        #Pause before shot
%patch $2FBF8 $00A7W $00ACW
%patch $2FC02 $0006W        #Pause before standing

#Shooting up
%patch $2FC16 $00ABW $00ABW
%patch $2FC20 $0009W        #Pause before shot
%patch $2FC34 $00ABW $00ABW
%patch $2FC3E $0006W        #Pause before standing

#Flicking switches
%patch $2FC52 $00C4W $00C4W
%patch $2FC5C $0008W        #Pause before flip
%patch $2FC70 $00C4W $00C4W
%patch $2FC7A $0008W        #Pause before done

#Keen places door gem
%patch $2FC8E $00C4W $00C4W
%patch $2FC98 $0006W        #Time to place gem

#Keen walks into doors 1 [Run door sequence]
%patch $2FCAC $00C4W $00C4W
%patch $2FCB6 $0000W        #Animation speed
%patch $2FCCA $00C4W $00C4W
%patch $2FCD4 $0009W        #Animation speed
%patch $2FCE8 $00C5W $00C5W
%patch $2FCF2 $0009W        #Animation speed
%patch $2FD06 $00C6W $00C6W
%patch $2FD10 $0009W        #Animation speed
%patch $2FD24 $00C7W $00C7W
%patch $2FD2E $0009W        #Animation speed
%patch $2FD42 $00C8W $00C8W
%patch $2FD4C $0009W        #Animation speed

#Keen on a pole [Stay still]
%patch $2FD60 $00BBW $00B4W
%patch $2FD6A $0000W        #Wait for key press

#Keen going up a pole
%patch $2FD7E $00BBW $00B4W
%patch $2FD88 $0008W        #Animation speed
%patch $2FD9C $00BCW $00B5W
%patch $2FDA6 $0008W        #Animation speed
%patch $2FDBA $00BDW $00B6W
%patch $2FDC4 $0008W        #Animation speed

#Keen going down a pole
%patch $2FDD8 $00B7W $00B7W
%patch $2FDE2 $0008W        #Animation speed
%patch $2FDF6 $00B8W $00B8W
%patch $2FE00 $0008W        #Animation speed
%patch $2FE14 $00B9W $00B9W
%patch $2FE1E $0008W        #Animation speed
%patch $2FE32 $00BAW $00BAW
%patch $2FE3C $0008W        #Animation speed

#Keen shooting l/r on a pole
%patch $2FE50 $00C2W $00C3W
%patch $2FE5A $0009W        #Pause before shooting
%patch $2FE6E $00C2W $00C3W
%patch $2FE78 $0006W        #Pause before going back

#Keen shoots up on pole
%patch $2FE8C $00BEW $00BFW
%patch $2FE96 $0009W        #Pause before shooting
%patch $2FEAA $00BEW $00BFW
%patch $2FEB4 $0006W        #Pause before going back

#Keen shooting down on a pole
%patch $2FEC8 $00C1W $00C0W
%patch $2FED2 $0009W        #Pause before shooting
%patch $2FEE6 $00C1W $00C0W
%patch $2FEF0 $0006W        #Pause before going back

#Keen walking
%patch $2FF04 $008BW $0083W
%patch $2FF0E $0006W        #Animation speed
%patch $2FF22 $008CW $0084W
%patch $2FF2C $0006W        #Animation speed
%patch $2FF40 $008DW $0085W
%patch $2FF4A $0006W        #Animation speed
%patch $2FF5E $008EW $0086W
%patch $2FF68 $0006W        #Animation speed

#Keen pogoing
%patch $2FF7C $00D6W $00D4W #Start pogo
%patch $2FF86 $0001W        #Quick bounce
%patch $2FF9A $00D6W $00D4W #Pogoing
%patch $2FFA4 $0000W        #Animation speed
%patch $2FFB8 $00D5W $00D3W
%patch $2FFC2 $0000W        #Animation speed

#Keen jumping\falling
%patch $2FFD6 $008FW $0087W #Jumping
%patch $2FFE0 $0000W        #Animation speed
%patch $2FFF4 $0090W $0088W
%patch $2FFFE $0000W        #Animation speed
%patch $30012 $0091W $0089W #Falling
%patch $3001C $0032W        #Animation speed
%patch $30030 $0090W $0088W
%patch $3003A $0028W        #Animation speed

#Keen shoot l/r in air
%patch $3004E $00A8W $00ADW
%patch $30058 $0009W        #Pause before shot
%patch $3006C $00A8W $00ADW
%patch $30076 $0001W        #Pause before going to falling 1
%patch $3008A $00A8W $00ADW
%patch $30094 $0006W        #Pause before going to falling 2

#Keen shooting up in air
%patch $300A8 $00AAW $00AAW
%patch $300B2 $0009W        #Pause before shot
%patch $300C6 $00AAW $00AAW
%patch $300D0 $0001W        #Pause before going to falling 2
%patch $300E4 $00AAW $00AAW
%patch $300EE $0006W        #Pause before going to falling 2

#Shoot down in air
%patch $30102 $00A9W $00A9W
%patch $3010C $0009W        #Pause before shot
%patch $30120 $00A9W $00A9W
%patch $3012A $0001W        #Pause before going to falling 1
%patch $3013E $00A9W $00A9W
%patch $30148 $0006W        #Pause before going to falling 2

#Keen gripping ledge
%patch $3015C $00C9W $00CAW #Grab ledge
%patch $30166 $000CW        #Pause before Keen can pull himself up
%patch $3017A $00C9W $00CAW #Hang from ledge
%patch $30184 $0000W        #Wait for keypress

#Keen pulls himself up
%patch $30198 $00CBW $00CFW
%patch $301A2 $000AW        #Animation speed
%patch $301B6 $00CCW $00D0W
%patch $301C0 $000AW        #Animation speed
%patch $301D4 $00CDW $00D1W
%patch $301DE $000AW        #Animation speed
%patch $301F2 $00CEW $00D2W
%patch $301FC $000AW        #Animation speed
%patch $30210 $008AW $0082W
%patch $3021A $0006W        #Animation speed

#Keen swims
%patch $3085C $0135W $0137W
%patch $30866 $0032W        #Animation speed
%patch $3087A $0136W $0138W
%patch $30884 $0032W        #Animation speed
%patch $30898 $0135W $0137W
%patch $308A2 $0032W        #Animation speed
%patch $308B6 $0136W $0138W
%patch $308C0 $0032W        #Animation speed

#Keen eaten by Dopefish
%patch $32520 $0139W $0139W
%patch $3252A $0000W        #Wait for Dopefish
%patch $3253E $FFFFW $FFFFW #Erase sprite
%patch $32548 $00B4W        #Pause before level exit box

#Keen's bullet
%patch $305A8 $00AEW $00AEW
%patch $305B2 $0006W        #Animation speed
%patch $305C6 $00AFW $00AFW
%patch $305D0 $0006W        #Animation speed
%patch $305E4 $00B0W $00B0W
%patch $305EE $0006W        #Animation speed
%patch $30602 $00B1W $00B1W
%patch $3060C $0006W        #Animation speed

#Keen's bullets zaps
%patch $30620 $00B2W $00B2W
%patch $3062A $000CW        #Animation speed
%patch $3063E $00B3W $00B3W
%patch $30648 $000CW        #Animation speed