← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/oss4/oneiric-proposed

« back to all changes in this revision

Viewing changes to tutorials/sndkit/dsp/vplay/Readme

  • Committer: Bazaar Package Importer
  • Author(s): Stefano Rivera
  • Date: 2011-06-16 20:37:48 UTC
  • mfrom: (5.1.3 sid)
  • Revision ID: james.westby@ubuntu.com-20110616203748-jbrxik6ql33z54co
Tags: 4.2-build2004-1ubuntu1
https://launchpad.net/bugs/746048
https://launchpad.net/bugs/770972
* Merge from Debian unstable.
  - Supports our current kernel (LP: #746048)
  Remaining changes:
  - debian/oss4-dkms.dkms.in: s/source/build/ in Kernel headers paths.
* ld-as-needed.patch: Re-order CC arguments to enable building with ld
  --as-needed (LP: #770972)

Show diffs side-by-side

added added

removed removed

Lines of Context:
tutorials/sndkit/dsp/vplay/Readme
 
1
Digitized Audio Utility for Linux ver. 0.3
 
2
============================================
 
3
 
 
4
This directory contains vplay.c, a modified version of recplay.c.
 
5
 
 
6
vrec and vplay
 
7
--------------
 
8
 
 
9
These programs can be used for recording and playing:
 
10
  CREATIVE LABS VOICE files
 
11
  MICROSOFT WAVE file (old format only (new format is handled as raw data))
 
12
  NeXT sound files (similar to Sun's .au format)
 
13
  raw audio data. 
 
14
 
 
15
Both programs accept the same options:
 
16
 
 
17
        vrec    [-qvwrS] [-s speed] [-t seconds] -b bits [filename1 ...]
 
18
        vplay   [-qvwrS] [-s speed] [-t seconds] -b bits [filename1 ...]
 
19
 
 
20
        -S              Stereo (default is mono).
 
21
        -s speed        Sets the speed (default is 8 kHz). If the speed is
 
22
                        less than 300, it will be multiplied by 1000.
 
23
        -t seconds      Sets the recording (or playback) time in seconds.
 
24
                        (Default is no time limit).
 
25
        -t bits         Sets sample size (bits/sample). Possible values are
 
26
                        8 and 16 (default 8).
 
27
        -v              record a CREATIVE LABS VOICE file (default)
 
28
        -w              record a MICROSOFT WAVE file
 
29
        -r              record raw data without header
 
30
        -a              record a NeXT sound file
 
31
        -q              quiet mode
 
32
 
 
33
        The options for speed, time etc. take only effect if you playing
 
34
        raw data files (or recording). VOC and WAVE-files include this
 
35
        information in their headers/internal structure.
 
36
        If no filenames are given, stdout (vrec) or stdin (vplay) is used. 
 
37
        The -t parameter applies to each files. For example
 
38
 
 
39
                vrec -r -t 1 a b c
 
40
 
 
41
        records one second of audio data to each of the files a, b, and c and
 
42
 
 
43
                vplay -t 1 a b c
 
44
 
 
45
        plays the first second of each of the files a, b and c (if its
 
46
        raw audio).
 
47
 
 
48
Don't use higher recording speeds than your card supports. This error is not
 
49
always detected by the driver.
 
50
 
 
51
vplay supports:
 
52
  - the full CREATIVE LABS VOICE structure:
 
53
    Silence, Repeat loops (on seekable input), Stereo, ASCII blocks,
 
54
    blocks with different sampling rate 
 
55
  - on non-stereo cards (SB 1.0 - 2.0) 8 bit stereo files will be
 
56
    played as mono (the first channel is used)
 
57
  - on non-16-bit cards, 16 bit WAVE files will be played as 8 bit
 
58
    (you can really play on a SB 1.0 a 16 bit stereo WAVE file, or
 
59
    buy ...)
 
60
 
 
61
unsupported:
 
62
  - packed VOC files (because /dev/dsp can't it (yet ?))
 
63
  - multi block WAVE files (if there exists like VOC files, my specs
 
64
    says no but RIFF definition yes ???)
 
65
  - not PCM coded WAVE files (because I don't know other methods)
 
66
  - more channel WAVE files (somebody has a quadrophonic sample?)
 
67
  - alaw- or mulaw-encoded NeXt sound files
 
68
 
 
69
Michael Beck                    beck@informatik.hu-berlin.de