5
5
|_|\___/ \___/|_| |_|_|\___/ \___/| .__/
8
Toonloop is a live stop motion animation software. It aims to show the creation process to the audience as well as the result of the creation. The frame by frame animation is made by adding frames one by one to a clip made of many frames. Clips are displayed in a never ending loop. Toonloop can also grab video images continuously.
8
Toonloop is a live animation software. It aims to show the creation process to the audience as well as the result of the creation. Frame by frame animation clips can made by adding images one by one. Clips are displayed in a never ending loop. Toonloop can also grab video images continuously.
10
10
Toonloop is a great tool for teaching new medias to children. It can also be used as a professionnal software for movie creators, though it is mainly intended to be used in a live kiosk of show. In the left window, you can see what is seen by the live camera. In the right window, it is the result of the stop motion loop.
12
12
Toonloop can be controlled using MIDI input, or the Open Sound Control protocol. Images are saved to the disk in the JPEG format, and the clips are saved using the photo-JPEG video codec. (using mencoder)
14
See the RELEASE file for up-to-date information about this version of Toonloop.
14
See the RELEASE file for up-to-date information about this version of Toonloop. See the NEWS file for its history.
16
16
Most of the information on how to use it is in the toonloop(1) man page.
18
19
How to use Toonloop
19
20
-------------------
32
33
Tab : changes the playback direction
33
34
r : clear the current clip
34
35
Caps Lock : toggle video grabbing
35
a : Toggles on/off the intervalometer
36
k : increase intervalometer interval by 1 second
37
j : decrease intervalometer interval by 1 second
38
36
period : Toggles the layout
39
right : move writehead to the next image
40
left : move writehead to the previous image
41
return : move writehead to the last image
42
semicolon : move writehead to the first image
39
See the toonloop(1) man page, or press F1 for all the key controls.
44
41
Toonloop saves the clip in its project directory. The default project directory is the ~/Documents/toonloop/default/ directory, where "~" is your HOME directory.
46
Toonloop uses the common "Linux kernel" versioning system, where even-numbered minor versions are stable and odd-numbered minor versions are development snapshots.
48
The micro version indicates the origin of the release: even micro numbers are only used for released archives; odd micro numbers are only used on the Git repository.
50
A stable series means that the command-line options and the interactive keyboard controls should not change much for all tags whose version number start with the same major-minor numbers. Some new features might be developped in that branch, but each release should be backward-compatible with their ancestor. Releases from a stable series should be use for production.
52
In contrast, unstable branches consist of tags which are developer snapshots. They are not expected to be compatible with any other version. Some features might change between different stable branches.
58
Here is a list of known bugs. See also the TODO file. That is what we mainly use to manage issues, rather than a Web application. Please read and write on the mailing list if you encounter some issues with Toonloop.
60
* The portrait layout doesn't look nice: both images overlap when not in 4:3 ratio.
47
63
Basic Tools for Compiling
48
64
-------------------------
71
86
gstreamer0.10-ffmpeg,
72
87
gstreamer0.10-plugins-bad,
73
88
gstreamer0.10-plugins-base,
74
89
gstreamer0.10-plugins-good,
75
90
gstreamer0.10-plugins-ugly (>= 0.10.14),
76
gstreamer0.10-pulseaudio,
115
124
There is also the handy ./one_click_build.sh that does it in a single script. (except the `sudo make install`)
126
If you want to install the bash completion script, you should set the sysconfdir command-line option given to ./configure to "/etc". Here is an example:
128
./configure --sysconfdir=/etc
130
Be warned that the command above would overwrite the default Toonloop config files installed by your package manager, if any.
118
132
How to run Toonloop
119
133
-------------------