# lib_anim function library

Dependencies: lib_2da, lib_anon, lib_array, lib_fn, lib_ini, lib_sfo, lib_sugar, lib_tools, lib_ui

## Description

Functions related to creature animations.

## Public functions

anim_collect(no_log_record:b, animation:s, resource_loc:s, ini_file:s, path:s, location:s, locbase:s, resref_original:s)=() action

Collects the resources used by an animation (i.e. the bam and wav files), according to its EE ini file. Files are saved in 'resource_loc'/'animation'.

The animation is specified by an EE-format animate.ids entry. (We check a stashed copy of animate.ids in %sfo_library_file%/resource).

You can supply a local copy of the ini file, using path/location/locbase. If ini_file is not set, we assume the one inferred from animate.ids.

You can override the ini-specified resref with 'resref_original'.

If no_log_record=1, the resources are copied over irreversibly and will not be undone if you uninstall.

anim_install(overwrite:i, resource_loc:s, animation:s)=() action

Given an animation packaged by anim_collect, install it. If overwrite=1, overwrite existing files; otherwise, don't.

collect_this_animation(animation:s, resref_orig:s, ids_file:s, deposit_base:s="MOD_FOLDER/anims")=() action