Differences

This shows you the differences between two versions of the page.

--- apps:all:saugns [2022/02/24 00:55] – [Documentation] v0.3.10b joelkp
+++ apps:all:saugns [2025/02/16 14:48] (current) – [saugns] conciser joelkp
@@ Line 2: / Line 2: @@
 {{metacard>}}
-saugns implements the SAU (Scriptable AUdio) language, and is a command-line parser, player, and WAV file writer for SAU scripts. It makes it easy to write files which play sounds when ran.
+saugns implements the SAU (Scriptable AUdio) language, and is a command-line parser, player, and WAV file writer for SAU scripts. It makes it easy to write script files which play sounds when ran. It's also possible to pipe audio data from it over stdout.
-Currently most useful for generating tones, modulation sounds (FM and PM, AM and RM), and simple timed sequences of such. Future goals include a more expressive language suitable for music composition.
+Currently most useful for generating tones, sounds, soundscapes, and simple timed sequences. Can be used tersely and simply for that, but the language still lacks features for music composition without duplicating lots of script content.
+Audio generation can use the following types of audio generators and ways of configuring them:
+  * ''A'' – Amplitude generator, produces amplitude offsets i.e. DC offsets
+  * ''N'' – Noise generator, various noise colors and distributions; maximum rate, no frequency control
+  * ''R'' – Rumble oscillator (a.k.a. random line segments oscillator), various modes and line types; this allows smooth noise, and modulation both of and by noisy signals
+  * ''W'' – Wave oscillator, various wave types
+  * Parameter sweeps, ADSR envelopes, and modulation by connecting objects – for AM/RM, FM/PM, and more
+  * Options for variations on phase distortion synthesis, and pulsar synthesis
+  * An arbitrary number of generators can be used, and changes to their parameters laid out in time
-The SAU language currently only provides wave oscillators. These can be used and combined in any number.
 ===== Documentation =====
-* {{https://saugns.github.io/usage.html|Command-line usage examples}}
+  * {{https://sau.frama.io/usage.html|Command-line usage}}
+  * {{https://sau.frama.io/language.html|SAU language overview web page}}
-* {{https://saugns.github.io/language.html|Guide to using the SAU language}}
+  * {{https://codeberg.org/sau/saugns/src/stable/sau/doc/README.SAU|SAU language reference (README.SAU)}}
+  * {{https://sau.frama.io/examples.html|Example SAU scripts with audio online}}
-* {{https://github.com/saugns/saugns/blob/stable/doc/README.SAU|SAU language reference (README.SAU)}}
 {{tag>synthesis_and_composition_packages signal_generators oss alsa sndio}}
@@ Line 18: / Line 25: @@
 ~~META:desc=Scriptable AUdio (SAU) Generation System. Command-line parser, player, and format converter for SAU scripts. Supports ALSA, OSS, and (on OpenBSD) sndio.~~
 ~~META:logo=https://saugns.github.io/images/sau-logo88x50.png~~
-~~META:link=https://saugns.github.io~~
+~~META:link=https://sau.frama.io~~
 ~~META:screenshot=~~
 ~~META:banner=~~
@@ Line 24: / Line 31: @@
 ~~META:download=~~
 ~~META:manual=~~
-~~META:version=v0.3.10b~~
+~~META:version=v0.5.1~~
-~~META:releasedate=2022-02-23~~
+~~META:releasedate=2025-02-16~~