CS:GO Keyframe Smoothing Script

Quick smooth camera animation creation.

Installation

Manually download the repository (Code > Download ZIP), then extract and merge the /csgo/ folder with your /steamapps/common/Counter-Strike Global Offensive/csgo/ folder.

Alternatively run the installation script of your choice:

• Batch _{NOTE: curl and tar are included in Windows 10 since 17063.}

curl -s https://raw.githubusercontent.com/samisalreadytaken/keyframes/master/install.bat > install_keyframes.bat && cmd /C install_keyframes.bat && del install_keyframes.bat

• Shell

sh <(curl -s https://raw.githubusercontent.com/samisalreadytaken/keyframes/master/install.sh)

Usage

Use the console commands to load and control the script. It needs to be loaded each time the map is changed.

See the Default Key Binds section below for the keys that are available for you to use by default. These do not modify your settings. Optionally, bind other keys to improve your workflow. Suggested keybinds can be found in keyframes.cfg file.

Some features are only available via these custom binds.

Before enabling these key binds, make sure you have a backup of your own binds that would be modified. To revert any changes, you may use a different cfg file for convenience - such as keyframes_off.cfg.

Command | Description ---------------------- | ------------------- exec keyframes | Load the script --- | --- kf_add | Add new keyframe kf_remove | Remove the selected keyframe kf_removefov | Remove the FOV data from the selected keyframe kf_clear | Remove all keyframes kf_insert | Insert new keyframe before the selected keyframe kf_replace | Replace the current keyframe kf_copy | Set player pos/ang to the current keyframe kf_undo | Undo last action kf_redo | Redo last action kf_undo_history | Show action history --- | --- kf_compile | Compile the keyframe data kf_smooth_angles | Smooth compiled animation angles kf_smooth_angles_exp | Smooth compiled animation angles exponentially kf_smooth_origin | Smooth compiled animation origin kf_play | Play the compiled data kf_play_loop | Play the compiled data looped kf_preview | Play the keyframe data without compiling kf_stop | Stop playback script kf_play(name) | Play named path kf_savepath | Export the compiled data kf_savekeys | Export the keyframe data --- | --- kf_mode_angles | Cycle through angle interpolation types kf_mode_origin | Cycle through position interpolation types kf_auto_fill_boundaries| Duplicate the first and last keyframes in compilation --- | --- kf_edit | Toggle edit mode kf_manipulator | Toggle 3D manipulator kf_select | Select and hold current keyframe kf_select_path | In edit mode, select animation path kf_see | In edit mode, see the current selection. kf_next | While holding a keyframe, select the next one kf_prev | While holding a keyframe, select the previous one kf_showkeys | In edit mode, toggle showing keyframes kf_showpath | In edit mode, toggle showing the animation path --- | --- kf_guides | Toggle camera guides kf_elements | Toggle between element selection and camera animation kf_createlight | Create a light script kf_setparams({})| Set current element parameters kf_duplicate | Duplicate current element in place --- | --- script kf_fov(val) | Set FOV data on the selected keyframe script kf_roll(val) | Set camera roll on the selected keyframe script kf_frametime(val)| Sets the time it takes to travel until the next keyframe script kf_samplecount(val)| Sets how many samples to take until the next keyframe --- | --- script kf_transform()| Rotate all keyframes around key with optional translation offset (idx,offset,rotation) --- | --- kf_loadfile | Load data file script kf_trim(val) | Trim compiled animation path to specified length. Specify second param for direction kf_trim_undo | Undo last trim action --- | --- kf_observeron | Turn on observer mode kf_observeroff | Turn off observer mode script kf_setplayer(idx)| Set controller player by index --- | --- kf_help | List all commands

Default Key Binds | Command :-------------------:| ------------------------------ MOUSE1 | kf_add / kf_next MOUSE2 | kf_remove / kf_prev / Reset manipulator pivot E | kf_see W / S | Set camera FOV CTRL | Rotate around the current keyframe / Snap current translation to world / Snap pivot to world

Custom Key Binds | Command :-------------------:|--------------- Q | Set camera roll (hold and move mouse while in keyframe view) R | kf_replace / Toggle manipulator modes / Pan the camera (hold and move mouse while in keyframe view) T | kf_insert / Toggle manipulation space F | kf_select (Select element to hold) / kf_select_path (Select path slice to playback) G | kf_manipulator H | kf_undo_history Z | kf_undo X | kf_redo C | +kf_movedown (hold to move the camera downwards) V | +kf_moveup (hold to move the camera upwards)

Observer mode

This is an experimental mode that disables editing and visualises all loaded paths. User is expected to use script kf_play( "my_path" ) console command to play multiple paths without reloading anything. The second parameter can be set to 1 to enable looping playback script kf_play( "my_path", 1 ).

Make sure you are in free roam mode before playing a path. Only script kf_play() and kf_stop are tested in this mode, other features may be broken.

To be able to load multiple paths, rename the path inside your exported file, and include it in keyframes_data.nut.

Set observer player in game using script kf_setplayer(), or outside the game in keyframes_observer.cfg.

Execute keyframes_observer.cfg while in live matches, otherwise use keyframes.cfg to be able to edit.

Note that observer playback movement will be stuttery in low timescale.

File export

You can open the exported file (.log) with any text editor. You must replace L with blank, i.e. remove, for the data to work.

Once you have cleared the exported file, either copy and paste it all in the keyframes_data.nut file, or rename the file extension to .nut and add it in the data file with IncludeScript("kf_data_00000000.nut").

The data name can only contain letters and numbers, it cannot start with a number. You can store as much data as you want, and load any at any time.

You may reload the files with kf_loadfile, load named data with script kf_load().

You can convert old saved data to new version by loading and saving - script kf_load( my_saved_data ), kf_savekeys/kf_savepath.

Implementation notes

Spline interpolation requires 4 keyframes to interpolate between 2 keyframes. For this reason the very first and the very last keyframes do not have animation paths leading to and from them, but they affect the interpolation of the keyframes next to them. If desired, kf_auto_fill_boundaries can be used to toggle automatic duplication of these boundary keyframes.

FOV values are interpolated between two consecutive FOV keys, independent of the pos-ang keys. The playback starts with FOV set to data on KEY 1. If KEY 1 FOV data is omitted, it is set to 90.

Modifying any keyframe requires compilation before seeing the changes in playback (kf_play) and in export (kf_savepath). kf_preview can be used to playback these changes without compilation.

You may also select a portion of the compiled path with kf_select_path to playback while fine tuning your path. Use MOUSE1/MOUSE2 to select/cancel the selection. Use kf_play_loop to loop the playback.

All keyframes can be rotated and offset at once using kf_transform().

kf_transform( Vector offset )
kf_transform( Vector|null offset, Vector angles )
kf_transform( int pivot, Vector offset, Vector angles )

pivot is the index of a keyframe to pivot the transform. If index is -1, average position of all keyframes is used as pivot point; if index is -2, current camera position (player) is used as pivot point.

Examples:

script kf_transform( Vector(0, 0, 64) ) moves all keyframes 64 units vertically.

script kf_transform( null, Vector(0, 90, 0) ) rotates all keyframes 90 degrees around Z axis (yaw).

script kf_transform( 4, null, Vector(0, 90, 0) ) rotates all keyframes 90 degrees around Z axis (yaw) pivoted on keyframe 4.

Use the 3D manipulator (kf_manipulator) to easily modify keyframes to see their effects on the live updated path. Press R to toggle manipulation modes, press T to toggle tra