The K Desktop Environment

The aRts Handbook

Version 1.00.08
Last updated: 04/01/2001

Stefan Westerfeld

stefan@space.twc.de

Jeff Tranter

tranter@kde.org

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

This handbook describes aRts, the Analog Real-time Synthesizer.


Table of Contents
1. Introduction
1.1. What is aRts?
1.2. Using This Manual
1.3. History
2. aRts Tools
2.1. KDE Control Center
2.2. artsd
2.3. artswrapper
2.4. artsshell
2.5. artsplay
2.6. artsdsp
2.7. artscat
2.8. artscontrol
2.9. artsc-config
2.10. mcopidl
3. aRts-builder
3.1. Overview
3.2. Tutorial
3.2.1. Step 1
3.2.2. Step 2
3.2.3. Step 3
3.2.4. Step 4
3.2.5. Step 5: Starting to beam data around ;)
3.2.6. Step 6: Beaming for advanced users
3.2.7. Step 7: Midi synthesis
3.2.8. Suggestions
3.3. Examples
4. aRts in Detail
4.1. Architecture
4.2. Modules & Ports
4.3. Structures
4.4. Busses
4.5. GUI Elements
5. MIDI
5.1. Overview
5.2. The Midi Manager
5.3. Using aRts & Brahms
5.4. midisend
5.5. Creating Instruments
5.6. Mapped Instruments
6. MCOP: Object Model and Streaming
6.1. Overview
6.2. Interfaces and IDL
6.3. Attribute change notifications
6.3.1. Sending change notifications
6.3.2. Applications for change notifications
7. aRts Application Programming Interfaces
7.1. Overview
7.2. knotify
7.3. kaudioplayer
7.4. libkmid
7.5. kmedia2
7.6. sound server
7.7. artsflow
7.8. C API
7.8.1. Introduction
7.8.2. Quick Walkthrough
7.8.3. Compiling and Linking: artsc-config
7.8.4. Library Reference
8. aRts modules
8.1. Introduction
8.2. Synthesis Modules Reference
8.2.1. Arithmetic + Mixing
8.2.2. Busses
8.2.3. Delays
8.2.4. Envelopes
8.2.5. Effects
8.2.6. Filters
8.2.7. Midi + Sequencing
8.2.8. Samples
8.2.9. Sound IO
8.2.10. Tests
8.2.11. Oscillation & Modulation
8.2.12. Wave Forms
8.3. Visual Modules Reference
9. Porting Applications to aRts
9.1. Using artsdsp
9.2. Adding Native aRts support
10. Contributing to aRts
10.1. How You Can Help
10.2. Mailing Lists
10.3. Coding Standards
11. Future Work
12. References
13. Questions and answers
13.1. General Questions
13.2. Non-Arts Applications
13.3. Latency
13.4. Network Transparency
13.5. Other Issues
14. aRts Copyright and Licensing
15. Introduction to Digital Audio
16. Introduction to MIDI
Glossary
A. Installing aRts
A.1. Installing a Precompiled Binary Release
A.2. Building From Source