Erik Faye-Lund 6ec6206e9f documentation: document editor-usage
Add a very basic overview of the editor-usage, and a list of keyboard
shortcuts.
2010-04-20 20:40:43 +02:00
2010-03-19 17:41:37 +01:00
2010-03-24 21:41:35 +01:00
2010-03-19 17:41:37 +01:00
2010-03-19 17:41:34 +01:00
2010-04-20 20:40:43 +02:00
2010-03-19 17:41:34 +01:00
2010-03-19 17:41:35 +01:00

GNU Rocket
==========
GNU Rocket is an intuitive new way of... bah, whatever. It's a sync-tracker,
a tool for synchronizing music and visuals in demoscene productions. It
consists of a GUI editor that runs on Microsoft Windows, and an ANSI C
library that can either communicate with the editor over a network socket,
or play back an exported data-set.

Compile Editor
--------------
GNU Rocket compiles using Microsoft Visual Studio 2008. Open editor.sln and
select "Build" -> "Build Solution" from the menu to build the editor.

Compile Example
---------------
GNU Rocket contains an example client called example_bass. This is a simple
Direct3D 9.0 and BASS audio library application, that demonstrates how to
use the GNU Rocket API.

Before compiling the example, you need to make sure you have a recent
Microsoft DirectX and BASS SDKs. These can be downloaded from the following
web-sites:

http://msdn.microsoft.com/directx/
http://www.un4seen.com/

Once the prerequisites are installed, the example can be compiled much like
the editor; by opening examples.sln and selecting "Build" -> "Build Solution"
from the menu.

Using the editor
----------------
The GNU Rocket editor is laid out like a music-tracker; tracks (or columns)
and rows. Each track represents a separate "variable" in the demo, over the
entire time-domain of the demo. Each row represents a specific point in time.
Each row consists of a set of key-frames, which are interpolated over time
according to their interpolation modes.

Keyboard shortcuts
-------------------
Some of the GNU Rocket editor's features are available through the menu and
some keyboard shortcut. Here's a list of the supported keyboard shortcuts:

Up/Down/Left/Right        Move cursor
PgUp/PgDn                 Move cursor 16 rows up/down
Home/End                  Move cursor to begining/end
Ctrl+Left/Right           Move track
Enter                     Enter key-frame value
Del                       Delete key-frame
i                         Enumerate interpolation mode
Space                     Pause/Resume demo
Shift+Up/Down/Left/Right  Select
Ctrl+C                    Copy
Ctrl+V                    Paste
Ctrl+Z                    Undo
Shift+Ctrl+Z              Redo
Ctrl+B                    Bias keyframes
Shift+Ctrl+Up/Down        Quick-bias by +/- 0.1
Ctrl+Up/Down              Quick-bias by +/- 1
Ctrl+PgUp/PgDn            Quick-bias by +/- 10
Shift+Ctrl+PgUp/PgDn      Quick-bias by +/- 100

Bugs and feed-back
------------------
Please report bugs or other feed-back to the GNU Rocket mailing list:
rocket-users@lists.sourceforge.net

Patches or technical questions can be sent to the developer-list:
rocket-developers@lists.sourceforge.net
Description
GNU Rocket, fork of emoon's OpenGL editor
Readme 9.7 MiB
Languages
Lua 53.4%
C 33.8%
C++ 8.3%
Objective-C 2.1%
CMake 0.8%
Other 1.5%