ecawave user's guide


Kai Vehmanen

27012000

Table of Contents

1: What is ecawave?

2: Ecawave interface

2.1: Session management

2.1.1: New session <alt-n>
2.1.2: New file <alt-f>
2.1.3: Open <alt-o>
2.1.4: Close <alt-c>
2.1.5: Save <alt-v>
2.1.6: Save as <alt-a>
2.1.7: Quit <alt-q>

2.2: Processing

2.2.1: Start <alt-t>
2.2.2: Stop <alt-s>
2.2.3: Effect <alt-e>

2.3: Waveform view

2.3.1: Zoom in <alt-z>
2.3.2: Zoom out <alt-m>
2.3.3: Unmark <alt-u>

3: Configuration

4: Ecawave internals



1: What is ecawave?

Ecawave is a simple graphical audio file editor. The user-interface is based on Qt libraries, while almost all audio functionality is taken directly from ecasound libraries. As ecawave is designed for editing large audio files, all processing is done direct-to-disk. Simple waveform caching is used to speed-up file operations. Ecawave supports all audio file formats and effect algorithms provided by ecasound libraries. This includes ALSA and OSS soundcard support and common file formats like wav, cdr, raw, aiff, mp3, etc.

2: Ecawave interface

Ecawave's user-interface is designed to be intuitive to use. There are no menubars and no hidden functionality. I guess you could call this WYSIWYCD - what you see is what you can do. You should able to do most tasks using shortcut keys (ALT + key combinations).

2.1: Session management

2.1.1: New session <alt-n>

Opens a new session window.

2.1.2: New file <alt-f>

Creates an empty file for editing. **not implemented**

2.1.3: Open <alt-o>

Opens a new file replacing currently edited file. Ecawave handles files in the same way as ecasound. File type/format is determined from file name extension. This may seem a bit clumsy, but it is simple and it works. As an added bonus, support for new file formats can be added seamlessly to ecasound library.

So most of the time, ecawave doesn't care about file types. As an exception, only RIFF wave files (.wav) and raw files (.raw) can be used in direct-mode, in which all processing and editing is done without temporary files.

Ecawave also recognizes some formats (like for example raw audio files) that require additional audio format info. When you select these files, audio format input fields are enabled.

When opening files, you can also specify whether to use waveform cache and whether to do a forced cache-refresh. Cache data is stored in separate files - filename + ".ews".

2.1.4: Close <alt-c>

Close currently edited file.

2.1.5: Save <alt-v>

Saves the currently edited file. Only needed when file has been modified (marked by * in the statusbar).

2.1.6: Save as <alt-a>

Save the currently edited file to another file.

2.1.7: Quit <alt-q>

Quit ecawave. All temporary files will be deleted.

2.2: Processing

2.2.1: Start <alt-t>

Starts processing from current position. If there is a marked area, processing will only affect it.

2.2.2: Stop <alt-s>

Stop processing. Current position is resetted to begin.

2.2.3: Effect <alt-e>

Process marked area with ecasound effects. It's also possible to preview effects before processing.

2.3: Waveform view

2.3.1: Zoom in <alt-z>

Zoom to marked area.

2.3.2: Zoom out <alt-m>

Zoom out so that the whole file is visible.

2.3.3: Unmark <alt-u>

Unmark currently marked area.

3: Configuration

The most important configuration files are ~/.ecawaverc and ~/.ecasouncrc.

Currently following ~/.ecawaverc variables are used:

default-output
Output device to use. Defaults to /dev/dsp.

~/.ecawaverc uses the same format as ~/.ecasoundrc. One line consists of a configuration variable and its value. Variable and value are separated with either '=' or ' '. Lines beginning with a "#" are ignored (comment lines).

Also take a look at, ecasoundrc(5) manual page.

4: Ecawave internals

Under the hood, ecawave is just another ecasound user-interface. Based on what user wants to do, ecawave creates a suitable chainsetup and passes it to ecasound.