1AFSETVIRTUALSAMPLEFO(3)                                AFSETVIRTUALSAMPLEFO(3)
2
3
4

NAME

6       afSetVirtualByteOrder, afSetVirtualChannels, afSetVirtualPCMMapping,
7       afSetVirtualSampleFormat - set the virtual data format for a track in
8       an audio file
9

SYNOPSIS

11       #include <audiofile.h>
12
13       int afSetVirtualByteOrder (AFfilehandle file, int track, int byteOrder);
14
15       int afSetVirtualChannels (AFfilehandle file, int track, int channels);
16
17       int afSetVirtualSampleFormat (AFfilehandle file, int track,
18           int sampleFormat, int sampleWidth);
19
20       int afSetVirtualPCMMapping (AFfilehandle file, int track,
21           double slope, double intercept, double minclip, double maxclip);
22

PARAMETERS

24       •    file is an AFfilehandle which refers to an open audio file and is
25           usually created by afOpenFile.
26
27       •    track is an integer which identifies a particular track in an open
28           audio file. The only valid track is AF_DEFAULT_TRACK for all
29           currently supported file formats.
30
31       •    sampleFormat is an integer which denotes a virtual sample format.
32           Valid values are AF_SAMPFMT_TWOSCOMP, AF_SAMPFMT_UNSIGNED,
33           AF_SAMPFMT_FLOAT, and AF_SAMPFMT_DOUBLE.
34
35       •    sampleWidth is a positive integer which specifies the number of
36           bits in a sample.
37
38       •    channels is a positive integer which specifies the number of
39           interleaved audio channels in the given audio track.
40
41       •    byteOrder is an integer which specifies the virtual byte order of
42           samples in the given audio track.  byteOrder can be either
43           AF_BYTEORDER_BIGENDIAN or AF_BYTEORDER_LITTLEENDIAN.
44
45       •    slope and intercept are double-precision floating point values
46           which indicate the audio data sample slope and zero-crossing value,
47           respectively, for the given sample format.
48
49       •    minclip and maxclip are double-precision floating point values
50           which indicates the minimum or maximum sample values to be
51           returned. Any values less than minclip will be set to minclip, and
52           any values greater than maxclip will be set to maxclip.
53

RETURN VALUE

55       These functions return 0 for success and -1 for failure.
56

AUTHOR

58       Michael Pruett <michael@68k.org>
59
60
61
62Audio File Library 0.3.6          03/06/2013           AFSETVIRTUALSAMPLEFO(3)
Impressum