MadSwatter have 4 main components. They are madswatter_editor, channel_wrap, word_box_wrap and elf_wrap. madswatter_editor, know as editor, initialize environment of GUI. It creates 3 channels, a start_word and event handlers for SVG objects in timeline panel. A channel is a line in timeline panel to hold words. A word is a set of actions they are performed and applied on elfs in a period of time, it is represented as a rectangle box in a channel in timeline panel. Periods of words in a channel is not overlaid in time. But, we have 3 channels. Periods of Words from different channel can be overlaid in time, that you can assign up to 3 words performing concurrently.

A word can only belong to exactly one channel, except start_word. start_word are created when a madswatter_editor object is initilaized and inserted into every channel. But, it does not showed on channel lines in timeline panel. A small red box, in timeline panel, at right side of second channel line represents it.

Internally, a madswatter_editor have 3 channel_wrap objects, one for each channel. channel_wrap objects are hold in madswatter_editor::channels. Every channel_wrap object has a list of word_box_wrap objects, they are internal representation of word. channel_wrap::words is the list of word_box_wrap objects.

channel_wrap::line is SVG DOM object of channel line in timeline panel. word_box_wrap::box is SVG DOM object of word box on the channel line in timeline panel. Objects other than madswatter_editor are not supposed to access these members.

To reduce couples and complexities, madswatter_editor responds to deal with logic among channels and words to keep consistency of states. Other objects trying to access channels and words should use interface provided by a madswatter_editor object if possible.

A word is a set of actions. word_box_wrap::activities is a list of action objects. A new action should be added to current word through madswatter_wrap::add_action() function.

A action is a object with 3 methods; start(), update, and stop(). start() of an action object is called when a playing of a program starts to perform the word where the action object is in. And stop() is called when the word is stoped. The update of an action object are invoked periodically to update status of elfs during the period of the word.

An elf is a graphic imported from a SVG file. Elfs are targets that MadSwatter actions applied on.