aboutsummaryrefslogtreecommitdiff
path: root/docs/pwg
diff options
context:
space:
mode:
authorSebastian Dröge <sebastian.droege@collabora.co.uk>2012-09-14 09:01:22 +0200
committerSebastian Dröge <sebastian.droege@collabora.co.uk>2012-09-14 09:01:22 +0200
commite0655f96cc7e2ef783f3db82c6b087d34f1e2b87 (patch)
tree3fbcd63c3f1a9a3677b48fcab2275bd2e10123a0 /docs/pwg
parentd1f921cf62a353aff4ea4bbb953cd08d6bdc8fc1 (diff)
Imported Upstream version 0.11.94upstream/0.11.94
Diffstat (limited to 'docs/pwg')
-rw-r--r--docs/pwg/advanced-negotiation.xml5
-rw-r--r--docs/pwg/advanced-types.xml132
-rw-r--r--docs/pwg/building-boiler.xml6
-rw-r--r--docs/pwg/building-pads.xml4
-rw-r--r--docs/pwg/intro-basics.xml45
-rw-r--r--docs/pwg/other-ntoone.xml4
6 files changed, 29 insertions, 167 deletions
diff --git a/docs/pwg/advanced-negotiation.xml b/docs/pwg/advanced-negotiation.xml
index 8a4e90f..1bae8b2 100644
--- a/docs/pwg/advanced-negotiation.xml
+++ b/docs/pwg/advanced-negotiation.xml
@@ -97,9 +97,8 @@
</para>
<programlisting>
[..]
- caps = gst_caps_new_simple ("audio/x-raw-float",
- "width", G_TYPE_INT, 32,
- "endianness", G_TYPE_INT, G_BYTE_ORDER,
+ caps = gst_caps_new_simple ("audio/x-raw",
+ "format", G_TYPE_STRING, GST_AUDIO_NE(F32),
"buffer-frames", G_TYPE_INT, &lt;bytes-per-frame&gt;,
"rate", G_TYPE_INT, &lt;samplerate&gt;,
"channels", G_TYPE_INT, &lt;num-channels&gt;, NULL);
diff --git a/docs/pwg/advanced-types.xml b/docs/pwg/advanced-types.xml
index 810ce7a..a5b25b5 100644
--- a/docs/pwg/advanced-types.xml
+++ b/docs/pwg/advanced-types.xml
@@ -259,76 +259,18 @@ plugin_init (GstPlugin *plugin)
<!-- ############ type ############# -->
<row>
- <entry morerows="3">audio/x-raw-int</entry>
- <entry morerows="3">
- Unstructured and uncompressed raw fixed-integer audio data.
- </entry>
- <entry>endianness</entry>
- <entry>integer</entry>
- <entry>G_BIG_ENDIAN (4321) or G_LITTLE_ENDIAN (1234)</entry>
+ <entry>audio/x-raw</entry>
<entry>
- The order of bytes in a sample. The value G_LITTLE_ENDIAN (1234)
- means <quote>little-endian</quote> (byte-order is <quote>least
- significant byte first</quote>). The value G_BIG_ENDIAN (4321)
- means <quote>big-endian</quote> (byte order is <quote>most
- significant byte first</quote>).
+ Unstructured and uncompressed raw audio data.
</entry>
- </row>
- <row>
- <entry>signed</entry>
- <entry>boolean</entry>
- <entry>TRUE or FALSE</entry>
+ <entry>format</entry>
+ <entry>string</entry>
<entry>
- Whether the values of the integer samples are signed or not.
- Signed samples use one bit to indicate sign (negative or
- positive) of the value. Unsigned samples are always positive.
+ S8 U8 S16LE S16BE U16LE U16BE S24_32LE S24_32BE U24_32LE U24_32BE S32LE S32BE U32LE U32BE
+ S24LE S24BE U24LE U24BE S20LE S20BE U20LE U20BE S18LE S18BE U18LE U18BE F32LE F32BE F64LE F64BE
</entry>
- </row>
- <row>
- <entry>width</entry>
- <entry>integer</entry>
- <entry>greater than 0</entry>
<entry>
- Number of bits allocated per sample.
- </entry>
- </row>
- <row>
- <entry>depth</entry>
- <entry>integer</entry>
- <entry>greater than 0</entry>
- <entry>
- The number of bits used per sample. This must be less than or
- equal to the width: If the depth is less than the width, the
- low bits are assumed to be the ones used. For example, a width
- of 32 and a depth of 24 means that each sample is stored in a
- 32 bit word, but only the low 24 bits are actually used.
- </entry>
- </row>
-
- <!-- ############ type ############# -->
-
- <row>
- <entry morerows="1">audio/x-raw-float</entry>
- <entry>
- Unstructured and uncompressed raw floating-point audio data.
- </entry>
- <entry>endianness</entry>
- <entry>integer</entry>
- <entry>G_BIG_ENDIAN (4321) or G_LITTLE_ENDIAN (1234)</entry>
- <entry>
- The order of bytes in a sample. The value G_LITTLE_ENDIAN (1234)
- means <quote>little-endian</quote> (byte-order is <quote>least
- significant byte first</quote>). The value G_BIG_ENDIAN (4321)
- means <quote>big-endian</quote> (byte order is <quote>most
- significant byte first</quote>).
- </entry>
- </row>
- <row>
- <entry>width</entry>
- <entry>integer</entry>
- <entry>greater than 0</entry>
- <entry>
- The amount of bits used and allocated per sample.
+ The format of the sample data.
</entry>
</row>
@@ -753,13 +695,15 @@ plugin_init (GstPlugin *plugin)
<!-- ############ type ############# -->
<row>
- <entry>video/x-raw-yuv</entry>
- <entry>YUV (or Y'Cb'Cr) video format.</entry>
+ <entry>video/x-raw</entry>
+ <entry>Unstructured and uncompressed raw video data.</entry>
<entry>format</entry>
- <entry>fourcc</entry>
+ <entry>string</entry>
<entry>
- YUY2, YVYU, UYVY, Y41P, IYU2, Y42B, YV12, I420, Y41B, YUV9, YVU9,
- Y800
+ I420 YV12 YUY2 UYVY AYUV RGBx BGRx xRGB xBGR RGBA BGRA ARGB ABGR RGB BGR Y41B Y42B
+ YVYU Y444 v210 v216 NV12 NV21 GRAY8 GRAY16_BE GRAY16_LE
+ v308 RGB16 BGR16 RGB15 BGR15 UYVP A420 RGB8P YUV9 YVU9
+ IYU1 ARGB64 AYUV64 r210 I420_10LE I420_10BE I422_10LE I422_10BE
</entry>
<entry>
The layout of the video. See <ulink type="http"
@@ -772,54 +716,6 @@ plugin_init (GstPlugin *plugin)
</entry>
</row>
- <row>
- <entry morerows="3">video/x-raw-rgb</entry>
- <entry morerows="3">Red-Green-Blue (RGB) video.</entry>
- <entry>bpp</entry>
- <entry>integer</entry>
- <entry>greater than 0</entry>
- <entry>
- The number of bits allocated per pixel. This is usually 16, 24
- or 32.
- </entry>
- </row>
-
- <row>
- <entry>depth</entry>
- <entry>integer</entry>
- <entry>greater than 0</entry>
- <entry>
- The number of bits used per pixel by the R/G/B components. This
- is usually 15, 16 or 24.
- </entry>
- </row>
-
- <row>
- <entry>endianness</entry>
- <entry>integer</entry>
- <entry>G_BIG_ENDIAN (4321) or G_LITTLE_ENDIAN (1234)</entry>
- <entry>
- The order of bytes in a sample. The value G_LITTLE_ENDIAN (1234)
- means <quote>little-endian</quote> (byte-order is <quote>least
- significant byte first</quote>). The value G_BIG_ENDIAN (4321)
- means <quote>big-endian</quote> (byte order is <quote>most
- significant byte first</quote>). For 24/32bpp, this should always
- be big endian because the byte order can be given in both.
- </entry>
- </row>
-
- <row>
- <entry>red_mask, green_mask and blue_mask</entry>
- <entry>integer</entry>
- <entry>any</entry>
- <entry>
- The masks that cover all the bits used by each of the samples.
- The mask should be given in the endianness specified above. This
- means that for 24/32bpp, the masks might be opposite to host byte
- order (if you are working on little-endian computers).
- </entry>
- </row>
-
<!-- ############ subtitle ############# -->
<row>
diff --git a/docs/pwg/building-boiler.xml b/docs/pwg/building-boiler.xml
index 537723f..3476005 100644
--- a/docs/pwg/building-boiler.xml
+++ b/docs/pwg/building-boiler.xml
@@ -374,10 +374,8 @@ GST_STATIC_PAD_TEMPLATE (
GST_PAD_SINK,
GST_PAD_ALWAYS,
GST_STATIC_CAPS (
- "audio/x-raw-int, "
- "width = (int) 16, "
- "depth = (int) 16, "
- "endianness = (int) BYTE_ORDER, "
+ "audio/x-raw, "
+ "format = (string) " GST_AUDIO_NE (S16) ", "
"channels = (int) { 1, 2 }, "
"rate = (int) [ 8000, 96000 ]"
)
diff --git a/docs/pwg/building-pads.xml b/docs/pwg/building-pads.xml
index 81f9df8..06b3273 100644
--- a/docs/pwg/building-pads.xml
+++ b/docs/pwg/building-pads.xml
@@ -145,9 +145,9 @@ gst_my_filter_setcaps (GstPad *pad,
* and from that audio type, we need to get the samplerate and
* number of channels. */
mime = gst_structure_get_name (structure);
- if (strcmp (mime, "audio/x-raw-int") != 0) {
+ if (strcmp (mime, "audio/x-raw") != 0) {
GST_WARNING ("Wrong mimetype %s provided, we only support %s",
- mime, "audio/x-raw-int");
+ mime, "audio/x-raw");
return FALSE;
}
diff --git a/docs/pwg/intro-basics.xml b/docs/pwg/intro-basics.xml
index c52eee6..9b05369 100644
--- a/docs/pwg/intro-basics.xml
+++ b/docs/pwg/intro-basics.xml
@@ -322,49 +322,18 @@
<!-- ############ type ############# -->
<row>
- <entry morerows="3">audio/x-raw-int</entry>
- <entry morerows="3">
- Unstructured and uncompressed raw integer audio data.
- </entry>
- <entry>endianness</entry>
- <entry>integer</entry>
- <entry>G_BIG_ENDIAN (4321) or G_LITTLE_ENDIAN (1234)</entry>
- <entry>
- The order of bytes in a sample. The value G_LITTLE_ENDIAN (1234)
- means <quote>little-endian</quote> (byte-order is <quote>least
- significant byte first</quote>). The value G_BIG_ENDIAN (4321)
- means <quote>big-endian</quote> (byte order is <quote>most
- significant byte first</quote>).
- </entry>
- </row>
- <row>
- <entry>signed</entry>
- <entry>boolean</entry>
- <entry>TRUE or FALSE</entry>
+ <entry>audio/x-raw</entry>
<entry>
- Whether the values of the integer samples are signed or not.
- Signed samples use one bit to indicate sign (negative or
- positive) of the value. Unsigned samples are always positive.
+ Unstructured and uncompressed raw integer audio data.
</entry>
- </row>
- <row>
- <entry>width</entry>
- <entry>integer</entry>
- <entry>greater than 0</entry>
+ <entry>format</entry>
+ <entry>string</entry>
<entry>
- Number of bits allocated per sample.
+ S8 U8 S16LE S16BE U16LE U16BE S24_32LE S24_32BE U24_32LE U24_32BE S32LE S32BE U32LE U32BE
+ S24LE S24BE U24LE U24BE S20LE S20BE U20LE U20BE S18LE S18BE U18LE U18BE F32LE F32BE F64LE F64BE
</entry>
- </row>
- <row>
- <entry>depth</entry>
- <entry>integer</entry>
- <entry>greater than 0</entry>
<entry>
- The number of bits used per sample. This must be less than or
- equal to the width: If the depth is less than the width, the
- low bits are assumed to be the ones used. For example, a width
- of 32 and a depth of 24 means that each sample is stored in a
- 32 bit word, but only the low 24 bits are actually used.
+ The format of the sample data.
</entry>
</row>
diff --git a/docs/pwg/other-ntoone.xml b/docs/pwg/other-ntoone.xml
index 5cb1f35..2196b4e 100644
--- a/docs/pwg/other-ntoone.xml
+++ b/docs/pwg/other-ntoone.xml
@@ -80,7 +80,7 @@ gst_avi_mux_audio_link (GstPad *pad,
* stream structure (strh/strf). */
[..]
return GST_PAD_LINK_OK;
- } else if !strcmp (str, "audio/x-raw-int")) {
+ } else if !strcmp (str, "audio/x-raw")) {
/* See above, but now with the raw audio tag (0x0001). */
[..]
return GST_PAD_LINK_OK;
@@ -122,7 +122,7 @@ gst_avi_mux_loop (GstElement *element)
NULL);
break;
case 0x0001: /* pcm */
- caps = gst_caps_new_simple ("audio/x-raw-int",
+ caps = gst_caps_new_simple ("audio/x-raw",
[..]);
break;
[..]