The aRts Handbook

Version 1.00.08
Last updated: 04/01/2001

Stefan Westerfeld

stefan@space.twc.de

Jeff Tranter

tranter@kde.org

Copyright © 1999-2001 by Stefan Westerfeld & Jeff Tranter

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.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

A. Installing aRts

A.1. Installing a Precompiled Binary Release
A.2. Building From Source

		Next
		Introduction