Introduction

Hi,

I'm glad that you're interested in sawteeth and I hope you understand that it's work in progress. If you find any error in any program or the manual please let me know, I even care about faulty grammar/spelling (I don't speak native English)

Thanks

Some parts of the editor are developed by Arvid Norberg. So some credit goes to him.
[[ steffo mfl. ]]

Updates

when sawteeth is in a releasable state it will pe put at:
http://www.acc.umu.se/~bedev/software/sawteeth/
and most probably on bebits too.

mail to: c97jng@cs.umu.se


Quasi Manual

Hexadecimal and Decimal are used where seen fit, witch you easily could be tricked by.

I hope that most menu-items, buttons and textfields are self-explaining or explained in the GUI.

Sequencer

Not very intuitive controls I'm afraid. Not too much mouse support
Click a part to make it 'active'.

0-9Enter partnumber. (decimal)
arrowsNavigate.
ctrl-arrows (up-down)Transpose.
ctrl-arrows (left-right)Change part.
shift-arrowsMark.
cmd-xcut.
cmd-ccopy.
cmd-vpaste.

Part editor

This is similar to old-skool trackers in some ways. F-keys sets octave. NoiseTracker (all trackers) style keyboard.

Fields are:

00|b-6 2  0
01|--- 0  0
02|c-7 2  0
03|b-6 0 97
   |   | +- effect and argument (see below)
   |   +--- instrumentnumber (hex)
   +------- note and octave

Effects

Maybe more effects will be added in the future, please only use documented effects.

0 no effect
1 x glide pitch up
2 x glide pitch down
-
7 x glide filter open
8 x glide filter closed
9 x set filter
a x glide amp down
b x glide amp up
c x set amp

Instrument editor

[[about env-editors]]

Fields are:

00|c-1 @ 2
01|--- @ 0
   |   | +-- waveform (see below)
   |   +---- relative (bit)
   +-------- note and octave

Waveforms

0 Hold
1 Saw
2 Square
3 Triangle
4 Noise

Filter

The filtermodes called old are of different type than the others, they use slightly less CPU and sound better (I think). To save CPU, use no filter when you don't need to.

Clipping

Only one kind of clipping is implemented, plain clipping. In future versions more kinds of clipping will be available. (give me suggestions)

Tips n' tricks


Geektalk

Additional tools

As you might see the folder this file resides in has got some subfolders. They contain the following:
lib Here's the 'heart' of sawteeth, the soundgenerating library. This lib is used by all other programs.
stFilePlay A program that generates an AIFF file from a sawteeth songfile.
stSoundPlay A program that play a sawteeth songfile.
stPack Loads a sawteeth songfile, removes unused instruments and parts then saves the same file in bin-mode (sawteeth-files comes in two flavours, ASCII or bin). (pretty untested)
songs A folder for songs, i've put a textfile with only instruments too. (cut and paste in a texteditor)
Source The source for stGUI, the editor.

stlib

Dont expect too much comments, documentation or nice classdesign. I will probably add some example source how to include stlib in your project, in the meantime look at "\n", even though it is an older version of sawteeth. (unreleased)
wave.cpp Generates raw waveforms.
insply.cpp Controls the wave and does filtering and clipping.
player.cpp Plays parts, switches instruments.
song.cpp Does most stuff: load, save, play and more.

Jonas Norberg.