Opentk/Source/Examples/OpenAL/1.1/Parrot.rtf
thefiddler 8dcb8601a2 Normalized line endings
Hopefully this is the first and last time we have to do this.
2013-10-11 01:58:54 +02:00

23 lines
2 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{\rtf1\ansi\ansicpg1253\deff0{\fonttbl{\f0\fnil\fcharset0 Arial;}}
{\colortbl ;\red163\green21\blue21;}
{\*\generator Msftedit 5.41.21.2509;}\viewkind4\uc1\pard\cf1\lang1033\b\fs28 Introduction\b0\fs22\par
\par
This sample implements a simple OpenAL-based audio recorder.\par
\b\fs28\par
Controls\par
\b0\fs22\par
Ensure the correct recording device is selected in the drop-down list (e.g. "Microphone"), then click on the "Start recording" and talk to the parrot. Click on "Stop recording" when done.\par
\par
Sample rate (Hz): indicates he sample rate of the recording. Typical sound cards support the following values: 8000, 16000, 22050, 32000, 44100 and 48000Hz but some sound cards may support higher values. A value of 8000Hz is considered adequate for voice reproduction, while a value of 44100Hz is considered adequate for music reproduction.\par
\par
Buffer length (ms): indicates how much data will be buffered before playback starts. Higher values may decrease CPU usage at the cost of higher latency between recording and playback. Lower values will decrease latency but may increase CPU usage and introduce noise if the CPU cannot respond fast enough. Values between 10-200ms are considered adequate for real-time audio conferencing. On the other hand, the buffer shouldn't exceed 10ms for real-time recording & playback of musical instruments.\par
\par
Playback gain (dB): specifies the amount of gain (amplification) when playing back the recorded signal. High values may introduce noise.\par
\par
\b\fs28 Implementation\par
\b0\fs22\par
The application enumerates available recording devices and awaits for the user to click on the "Start recording" button. When the button is clicked, the application constructs an AudioContext and an AudioCapture object using the parameters specified by the user.\par
\par
A timer fires periodically to check whether the capture buffer is full, in which case it copies its data to an audio buffer and enqueues it to the AudioContext for playback.\par
}