New Features:

- new animation type ch (chair)

animations that are called while sitting in a chair.

The custom animations will work almost exactly as the vanilla animations that you
can activate with
sae ChairEatingStart
and stop it with
sae IdleStop
An eating start animation is played which loads the AnimObject(s). After the start
animation, the other 3 animations (base, var1, var2) play randomly, but only once
each. Except when the AnimEvent IdleTalkAndUseItem is received. Then the base
animation is played a random number of times (between 2 and 5). As it looks like
such animations will never start or stop for the player unless a mod sends the
appropriate AEs. For NPCs I assume it is part of some sandbox packages, but I
didn't check for that.

In an FNIS animation list ch animations are defined like:

ch -o FNISeatFlute FNISeatingidlestart.hkx AnimObjectFlute AnimObjectIronDagger
+ FNISeatFlute_1 FNISeatingidlebase.hkx
+ FNISeatFlute_2 FNISeatingidlevar1.hkx
+ FNISeatFlute_3 FNISeatingidlevar2.hkx

Some remarks:
This syntax is fix. 4 animations are needed, and all options except -o (and the
arbitrary number of AnimObjects) are ignored.

The AnimEvents _1 to _3 are dummies (due to the usual FNIS syntax). The animation
sequence is started with the 1st AnimEvent (e.g. "sae FNISeatFlute"), and stopped
with "sae IdleStop". No way to use these animevents to change the logic.

The AnimObject(s) appear(s) after one sec into the start animation.

Headtracking is switched off 1 sec into the var1 and var2 animations, and switched
on again 1 sec before the end of the respective animation.

There is no Exit animation (like in the vanilla eating). With a short 0.2 sec
transition the actor looses the animaObject and goes into default seating. Not very
nice, but standard (although I could change on request).

- file pre-cache

Skyrim pre-caches it's animation files in order to have them ready in heavy load
situations. Without pre-caching you can see sporadic t-pose
situations when using mods/files like Gender, PCEA, FNIS Sexy Move, FNIS Flyer,
Flying Mod. For that purpose Skyrim has numerous lists
in animationsetdatasinglefile.txt which define the animations that are pre-cached
whenever the player, and probably NPC as well, equips (selects)
a different weapon or spell. Unselecting everything means h2h. Idle animations
(including furniture animations) seemingly are not cached.
That could be the reason for reports where unexplainably NPCs or creatures get
stuck in t-poses. Even without FNIS :)

Apparently there is one list for each weapon combination. Therefore the 1hm
animations appear in 15 different lists. To pre-cache custom 1hm
animations they have to be added to each of these 15 lists. The lists are extremely
hard to comprehend, since all file names are crc hashed into
3 numbers.

FNIS file pre-chaching adds the necessary data into the

animationsetdatasinglefile.tx lists. The inclusion of Gender and PCEA animation is
hard-coded. For all other supported mods the necessary information is included in
the file CustomPreCacheFiles.txt.

If you want to add other custom files you can modify the file appropriately. The
file has sufficient comments to understand what is hidden
behind the crc values. There are numerous online tools on the net to convert to
crc32. But make sure by comparing with existing values that the
tool uses the same parameters as the engine for crc ecomputation.

Structur for CustomPreCacheFiles.txt:

(the optional <appearance1/2> parameters are only necessary, if the inclusion of
the custom files is only needed for nth appearance of the
reference file. Usually one for defaultfemale and defaultmale each.

<Modname>
'comments and empty lines are possible
<reference path crc>
<reference file crc>[/<appearance1>,<appearance2>]
<custom path crc>
<no of custom animations to be added to the reference>
<custom file crc 1>
.......
<custom file crc n>
'