summaryrefslogtreecommitdiff
path: root/docs/design/part-mediatype-audio-raw.txt
blob: 503ef63dbae1d3d63ad2dbd40c4f9c2803985bd2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
Media Types
-----------

 audio/x-raw

  format, G_TYPE_STRING, mandatory
   The format of the audio samples, see the Formats section for a list
   of valid sample formats.

  rate, G_TYPE_INT, mandatory
   The samplerate of the audio

  channels, G_TYPE_INT, mandatory
   The number of channels

  channel-mask, GST_TYPE_BITMASK, mandatory for more than 2 channels
   Bitmask of channel positions present. May be omitted for mono and
   stereo. May be set to 0 to denote that the channels are unpositioned.

  layout, G_TYPE_STRING, mandatory
   The layout of channels within a buffer. Possible values are
   "interleaved" (for LRLRLRLR) and "non-interleaved" (LLLLRRRR)

Use GstAudioInfo and related helper API to create and parse raw audio caps.


Metadata
--------

 "GstAudioDownmixMeta"
   A matrix for downmixing multichannel audio to a lower numer of channels.
   

Formats
-------

 The following values can be used for the format string property.

  "S8" 8-bit signed PCM audio
  "U8" 8-bit unsigned PCM audio

  "S16LE" 16-bit signed PCM audio
  "S16BE" 16-bit signed PCM audio
  "U16LE" 16-bit unsigned PCM audio
  "U16BE" 16-bit unsigned PCM audio

  "S24_32LE" 24-bit signed PCM audio packed into 32-bit
  "S24_32BE" 24-bit signed PCM audio packed into 32-bit
  "U24_32LE" 24-bit unsigned PCM audio packed into 32-bit
  "U24_32BE" 24-bit unsigned PCM audio packed into 32-bit

  "S32LE" 32-bit signed PCM audio
  "S32BE" 32-bit signed PCM audio
  "U32LE" 32-bit unsigned PCM audio
  "U32BE" 32-bit unsigned PCM audio

  "S24LE" 24-bit signed PCM audio
  "S24BE" 24-bit signed PCM audio
  "U24LE" 24-bit unsigned PCM audio
  "U24BE" 24-bit unsigned PCM audio

  "S20LE" 20-bit signed PCM audio
  "S20BE" 20-bit signed PCM audio
  "U20LE" 20-bit unsigned PCM audio
  "U20BE" 20-bit unsigned PCM audio

  "S18LE" 18-bit signed PCM audio
  "S18BE" 18-bit signed PCM audio
  "U18LE" 18-bit unsigned PCM audio
  "U18BE" 18-bit unsigned PCM audio

  "F32LE" 32-bit floating-point audio
  "F32BE" 32-bit floating-point audio
  "F64LE" 64-bit floating-point audio
  "F64BE" 64-bit floating-point audio