From a2742a575bd2af56fa093fd2dec8ce30b4fe6668 Mon Sep 17 00:00:00 2001 From: "Jan Alexander Steffens (heftig)" Date: Mon, 17 Feb 2014 11:37:30 +0100 Subject: pwg: Update raw properties Using info from gst-plugins-base/docs/design . Encoded streams might make use of the raw properties, so list them all under foo/* . For foo/raw, only note which of these properties are mandatory. I didn't take a closer look at the raw formats yet. Those might still be out-of-date. https://bugzilla.gnome.org/show_bug.cgi?id=724187 --- docs/pwg/advanced-types.xml | 132 ++++++++++++++++++++++++++++++++++++-------- 1 file changed, 108 insertions(+), 24 deletions(-) (limited to 'docs') diff --git a/docs/pwg/advanced-types.xml b/docs/pwg/advanced-types.xml index 9898476d7f..d1c8b35837 100644 --- a/docs/pwg/advanced-types.xml +++ b/docs/pwg/advanced-types.xml @@ -229,8 +229,8 @@ plugin_init (GstPlugin *plugin) - audio/* - + audio/* + All audio types rate @@ -248,6 +248,34 @@ plugin_init (GstPlugin *plugin) The number of channels of audio data. + + channel-mask + bitmask + + + Channel positions present. See GstAudioChannelPosition. + 0 means unpositioned. + + + + format + string + + 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 + + + The format of the sample data. + + + + layout + string + "interleaved" or "non-interleaved" + + Layout of channels within a buffer. + + @@ -264,14 +292,11 @@ plugin_init (GstPlugin *plugin) Unstructured and uncompressed raw audio data. - format - string - - 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 - + + + - The format of the sample data. + All properties (except channel-mask, in the mono and stereo cases) are mandatory. @@ -657,8 +682,8 @@ plugin_init (GstPlugin *plugin) - video/* - + video/* + All video types width @@ -675,29 +700,67 @@ plugin_init (GstPlugin *plugin) framerate fraction - greater or equal 0 + greater or equal 0; default 0/1 The (average) framerate in frames per second. Note that this property does not guarantee in any way that it will actually come close to this value. If you need a fixed framerate, please use an element that provides that (such as - videorate). 0 means a variable framerate. + videorate). 0/1 means a variable framerate. - - - - - All raw video types. + max-framerate + fraction + greater or equal 0; default as framerate + + For variable framerates, the maximum framerate that is expected. + Only valid when framerate is 0/1. + + + + views + integer + greater than 0; default 1 + + The number of views for multiview video. Each buffer contains + multiple GstVideoMeta buffers that describe each view. Use the + frame ID to get access to the different views. + + + + interlace-mode + string + progressive, interleaved, mixed, fields; default progressive + + The interlace mode. Extra buffer flags describe the frame and fields. + + + + chroma-site + string + jpeg, mpeg2, dv; default UNKNOWN + + The chroma siting of the video frames. + + + + colorimetry + string + bt601, bt709, smpte240m; default UNKNOWN + + The colorimetry of the video frames. + + + + pixel-aspect-ratio + fraction + greater than 0; default 1/1 + + The pixel aspect ratio of the video. - - - - video/x-raw - Unstructured and uncompressed raw video data. format string @@ -707,7 +770,7 @@ plugin_init (GstPlugin *plugin) IYU1 ARGB64 AYUV64 r210 I420_10LE I420_10BE I422_10LE I422_10BE - The layout of the video. See FourCC definition site for references and definitions. YUY2, YVYU and UYVY are 4:2:2 packed-pixel, Y41P is 4:1:1 packed-pixel and IYU2 is 4:4:4 @@ -719,6 +782,27 @@ plugin_init (GstPlugin *plugin) + + + All raw video types. + + + + + + + video/x-raw + Unstructured and uncompressed raw video data. + + + + + The properties width, height and format are mandatory. + + + + + All encoded video types. -- cgit v1.2.1