diff options
Diffstat (limited to 'girs/GstVideo-1.0.gir')
| -rw-r--r-- | girs/GstVideo-1.0.gir | 1649 |
1 files changed, 931 insertions, 718 deletions
diff --git a/girs/GstVideo-1.0.gir b/girs/GstVideo-1.0.gir index bc0825f..3373b95 100644 --- a/girs/GstVideo-1.0.gir +++ b/girs/GstVideo-1.0.gir @@ -2615,14 +2615,14 @@ by any element in the pipeline (Since: 1.6)</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="629">Generic caps string for video, for use in pad templates.</doc> + line="648">Generic caps string for video, for use in pad templates.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="616"/> + line="635"/> <parameters> <parameter name="format"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="631">string format that describes the pixel layout, as string + line="650">string format that describes the pixel layout, as string (e.g. "I420", "RGB", "YV12", "YUY2", "AYUV", etc.)</doc> </parameter> </parameters> @@ -2633,20 +2633,20 @@ by any element in the pipeline (Since: 1.6)</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="643">Generic caps string for video, for use in pad templates.</doc> + line="662">Generic caps string for video, for use in pad templates.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="634"/> + line="653"/> <parameters> <parameter name="features"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="647">Requires caps features as a string, e.g. + line="666">Requires caps features as a string, e.g. "memory:SystemMemory".</doc> </parameter> <parameter name="format"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="645">string format that describes the pixel layout, as string + line="664">string format that describes the pixel layout, as string (e.g. "I420", "RGB", "YV12", "YUY2", "AYUV", etc.)</doc> </parameter> </parameters> @@ -2896,96 +2896,96 @@ detect such a synchronization point.</doc> <constant name="VIDEO_COLORIMETRY_BT2020" value="bt2020" c:type="GST_VIDEO_COLORIMETRY_BT2020"> - <source-position filename="gst-libs/gst/video/video-color.h" line="220"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="244"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_BT2020_10" value="bt2020-10" c:type="GST_VIDEO_COLORIMETRY_BT2020_10"> - <source-position filename="gst-libs/gst/video/video-color.h" line="221"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="245"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_BT2100_HLG" value="bt2100-hlg" c:type="GST_VIDEO_COLORIMETRY_BT2100_HLG"> - <source-position filename="gst-libs/gst/video/video-color.h" line="223"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="247"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_BT2100_PQ" value="bt2100-pq" c:type="GST_VIDEO_COLORIMETRY_BT2100_PQ"> - <source-position filename="gst-libs/gst/video/video-color.h" line="222"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="246"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_BT601" value="bt601" c:type="GST_VIDEO_COLORIMETRY_BT601"> - <source-position filename="gst-libs/gst/video/video-color.h" line="216"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="240"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_BT709" value="bt709" c:type="GST_VIDEO_COLORIMETRY_BT709"> - <source-position filename="gst-libs/gst/video/video-color.h" line="217"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="241"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_SMPTE240M" value="smpte240m" c:type="GST_VIDEO_COLORIMETRY_SMPTE240M"> - <source-position filename="gst-libs/gst/video/video-color.h" line="218"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="242"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COLORIMETRY_SRGB" value="sRGB" c:type="GST_VIDEO_COLORIMETRY_SRGB"> - <source-position filename="gst-libs/gst/video/video-color.h" line="219"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="243"/> <type name="utf8" c:type="gchar*"/> </constant> <constant name="VIDEO_COMP_A" value="3" c:type="GST_VIDEO_COMP_A"> <source-position filename="gst-libs/gst/video/video-format.h" - line="290"/> + line="309"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_B" value="2" c:type="GST_VIDEO_COMP_B"> <source-position filename="gst-libs/gst/video/video-format.h" - line="287"/> + line="306"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_G" value="1" c:type="GST_VIDEO_COMP_G"> <source-position filename="gst-libs/gst/video/video-format.h" - line="286"/> + line="305"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_INDEX" value="0" c:type="GST_VIDEO_COMP_INDEX"> <source-position filename="gst-libs/gst/video/video-format.h" - line="293"/> + line="312"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_PALETTE" value="1" c:type="GST_VIDEO_COMP_PALETTE"> <source-position filename="gst-libs/gst/video/video-format.h" - line="294"/> + line="313"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_R" value="0" c:type="GST_VIDEO_COMP_R"> <source-position filename="gst-libs/gst/video/video-format.h" - line="285"/> + line="304"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_U" value="1" c:type="GST_VIDEO_COMP_U"> <source-position filename="gst-libs/gst/video/video-format.h" - line="281"/> + line="300"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_V" value="2" c:type="GST_VIDEO_COMP_V"> <source-position filename="gst-libs/gst/video/video-format.h" - line="282"/> + line="301"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_COMP_Y" value="0" c:type="GST_VIDEO_COMP_Y"> <source-position filename="gst-libs/gst/video/video-format.h" - line="280"/> + line="299"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_CONVERTER_OPT_ALPHA_MODE" @@ -3678,11 +3678,11 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK).</do </parameters> </function-macro> <constant name="VIDEO_FORMATS_ALL" - value="{ AYUV64, ARGB64, GBRA_12BE, GBRA_12LE, Y412_BE, Y412_LE, A444_10BE, GBRA_10BE, A444_10LE, GBRA_10LE, A422_10BE, A422_10LE, A420_10BE, A420_10LE, Y410, RGB10A2_LE, BGR10A2_LE, GBRA, ABGR, VUYA, BGRA, AYUV, ARGB, RGBA, A420, Y444_16BE, Y444_16LE, v216, P016_BE, P016_LE, Y444_12BE, GBR_12BE, Y444_12LE, GBR_12LE, I422_12BE, I422_12LE, Y212_BE, Y212_LE, I420_12BE, I420_12LE, P012_BE, P012_LE, Y444_10BE, GBR_10BE, Y444_10LE, GBR_10LE, r210, I422_10BE, I422_10LE, NV16_10LE32, Y210, v210, UYVP, I420_10BE, I420_10LE, P010_10BE, P010_10LE, NV12_10LE32, NV12_10LE40, Y444, GBR, NV24, xBGR, BGRx, xRGB, RGBx, BGR, IYU2, v308, RGB, Y42B, NV61, NV16, VYUY, UYVY, YVYU, YUY2, I420, YV12, NV21, NV12, NV12_64Z32, Y41B, IYU1, YVU9, YUV9, RGB16, BGR16, RGB15, BGR15, RGB8P, GRAY16_BE, GRAY16_LE, GRAY10_LE32, GRAY8 }" + value="{ AYUV64, ARGB64, GBRA_12BE, GBRA_12LE, Y412_BE, Y412_LE, A444_10BE, GBRA_10BE, A444_10LE, GBRA_10LE, A422_10BE, A422_10LE, A420_10BE, A420_10LE, Y410, RGB10A2_LE, BGR10A2_LE, GBRA, ABGR, VUYA, BGRA, AYUV, ARGB, RGBA, A420, Y444_16BE, Y444_16LE, v216, P016_BE, P016_LE, Y444_12BE, GBR_12BE, Y444_12LE, GBR_12LE, I422_12BE, I422_12LE, Y212_BE, Y212_LE, I420_12BE, I420_12LE, P012_BE, P012_LE, Y444_10BE, GBR_10BE, Y444_10LE, GBR_10LE, r210, I422_10BE, I422_10LE, NV16_10LE32, Y210, v210, UYVP, I420_10BE, I420_10LE, P010_10BE, P010_10LE, NV12_10LE32, NV12_10LE40, Y444, GBR, NV24, xBGR, BGRx, xRGB, RGBx, BGR, IYU2, v308, RGB, Y42B, NV61, NV16, VYUY, UYVY, YVYU, YUY2, I420, YV12, NV21, NV12, NV12_64Z32, NV12_4L4, NV12_32L32, Y41B, IYU1, YVU9, YUV9, RGB16, BGR16, RGB15, BGR15, RGB8P, GRAY16_BE, GRAY16_LE, GRAY10_LE32, GRAY8 }" c:type="GST_VIDEO_FORMATS_ALL"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="581">List of all video formats, for use in template caps strings. + line="600">List of all video formats, for use in template caps strings. Formats are sorted by decreasing "quality", using these criteria by priority: - number of components @@ -3698,14 +3698,14 @@ Formats are sorted by decreasing "quality", using these criteria by priority: - prefer I420 over YV12 - format name</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="601"/> + line="620"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="VIDEO_FORMAT_INFO_BITS" c:identifier="GST_VIDEO_FORMAT_INFO_BITS" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="469"/> + line="488"/> <parameters> <parameter name="info"> </parameter> @@ -3715,7 +3715,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_DATA" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="520"/> + line="539"/> <parameters> <parameter name="info"> </parameter> @@ -3729,7 +3729,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_DEPTH" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="472"/> + line="491"/> <parameters> <parameter name="info"> </parameter> @@ -3741,7 +3741,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_FLAGS" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="458"/> + line="477"/> <parameters> <parameter name="info"> </parameter> @@ -3751,7 +3751,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_FORMAT" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="456"/> + line="475"/> <parameters> <parameter name="info"> </parameter> @@ -3761,7 +3761,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_HAS_ALPHA" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="463"/> + line="482"/> <parameters> <parameter name="info"> </parameter> @@ -3771,7 +3771,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_HAS_PALETTE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="465"/> + line="484"/> <parameters> <parameter name="info"> </parameter> @@ -3781,7 +3781,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_H_SUB" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="512"/> + line="531"/> <parameters> <parameter name="info"> </parameter> @@ -3793,7 +3793,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_COMPLEX" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="466"/> + line="485"/> <parameters> <parameter name="info"> </parameter> @@ -3803,7 +3803,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_GRAY" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="462"/> + line="481"/> <parameters> <parameter name="info"> </parameter> @@ -3813,7 +3813,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_LE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="464"/> + line="483"/> <parameters> <parameter name="info"> </parameter> @@ -3823,7 +3823,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_RGB" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="461"/> + line="480"/> <parameters> <parameter name="info"> </parameter> @@ -3833,7 +3833,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_TILED" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="467"/> + line="486"/> <parameters> <parameter name="info"> </parameter> @@ -3843,7 +3843,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_IS_YUV" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="460"/> + line="479"/> <parameters> <parameter name="info"> </parameter> @@ -3853,7 +3853,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_NAME" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="457"/> + line="476"/> <parameters> <parameter name="info"> </parameter> @@ -3863,7 +3863,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: c:identifier="GST_VIDEO_FORMAT_INFO_N_COMPONENTS" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="470"/> + line="489"/> <parameters> <parameter name="info"> </parameter> @@ -3874,7 +3874,7 @@ Formats are sorted by decreasing "quality", using these criteria by priority: introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="488">Number of planes. This is the number of planes the pixel layout is + line="507">Number of planes. This is the number of planes the pixel layout is organized in in memory. The number of planes can be less than the number of components (e.g. Y,U,V,A or R, G, B, A) when multiple components are packed into one plane. @@ -3882,12 +3882,12 @@ components are packed into one plane. Examples: RGB/RGBx/RGBA: 1 plane, 3/3/4 components; I420: 3 planes, 3 components; NV21/NV12: 2 planes, 3 components.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="500"/> + line="519"/> <parameters> <parameter name="info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="490">a #GstVideoFormatInfo</doc> + line="509">a #GstVideoFormatInfo</doc> </parameter> </parameters> </function-macro> @@ -3895,7 +3895,7 @@ I420: 3 planes, 3 components; NV21/NV12: 2 planes, 3 components.</doc> c:identifier="GST_VIDEO_FORMAT_INFO_OFFSET" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="534"/> + line="553"/> <parameters> <parameter name="info"> </parameter> @@ -3910,20 +3910,20 @@ I420: 3 planes, 3 components; NV21/NV12: 2 planes, 3 components.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="501">Plane number where the given component can be found. A plane may + line="520">Plane number where the given component can be found. A plane may contain data for multiple components.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="509"/> + line="528"/> <parameters> <parameter name="info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="503">a #GstVideoFormatInfo</doc> + line="522">a #GstVideoFormatInfo</doc> </parameter> <parameter name="c"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="504">the component index</doc> + line="523">the component index</doc> </parameter> </parameters> </function-macro> @@ -3931,7 +3931,7 @@ contain data for multiple components.</doc> c:identifier="GST_VIDEO_FORMAT_INFO_POFFSET" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="510"/> + line="529"/> <parameters> <parameter name="info"> </parameter> @@ -3944,7 +3944,7 @@ contain data for multiple components.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="473">pixel stride for the given component. This is the amount of bytes to the + line="492">pixel stride for the given component. This is the amount of bytes to the pixel immediately to the right, so basically bytes from one pixel to the next. When bits < 8, the stride is expressed in bits. @@ -3953,17 +3953,17 @@ would be 4 bytes for RGBx or ARGB, and 8 bytes for ARGB64 or AYUV64. For planar formats such as I420 the pixel stride is usually 1. For YUY2 it would be 2 bytes.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="487"/> + line="506"/> <parameters> <parameter name="info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="475">a #GstVideoFormatInfo</doc> + line="494">a #GstVideoFormatInfo</doc> </parameter> <parameter name="c"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="476">the component index</doc> + line="495">the component index</doc> </parameter> </parameters> </function-macro> @@ -3971,7 +3971,7 @@ YUY2 it would be 2 bytes.</doc> c:identifier="GST_VIDEO_FORMAT_INFO_SCALE_HEIGHT" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="518"/> + line="537"/> <parameters> <parameter name="info"> </parameter> @@ -3985,7 +3985,7 @@ YUY2 it would be 2 bytes.</doc> c:identifier="GST_VIDEO_FORMAT_INFO_SCALE_WIDTH" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="517"/> + line="536"/> <parameters> <parameter name="info"> </parameter> @@ -3999,7 +3999,7 @@ YUY2 it would be 2 bytes.</doc> c:identifier="GST_VIDEO_FORMAT_INFO_SHIFT" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="471"/> + line="490"/> <parameters> <parameter name="info"> </parameter> @@ -4012,27 +4012,27 @@ YUY2 it would be 2 bytes.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="522">Row stride in bytes, that is number of bytes from the first pixel component + line="541">Row stride in bytes, that is number of bytes from the first pixel component of a row to the first pixel component in the next row. This might include some row padding (memory not actually used for anything, to make sure the beginning of the next row is aligned in a particular way).</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="533"/> + line="552"/> <parameters> <parameter name="info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="524">a #GstVideoFormatInfo</doc> + line="543">a #GstVideoFormatInfo</doc> </parameter> <parameter name="strides"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="525">an array of strides</doc> + line="544">an array of strides</doc> </parameter> <parameter name="comp"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="526">the component index</doc> + line="545">the component index</doc> </parameter> </parameters> </function-macro> @@ -4040,7 +4040,7 @@ beginning of the next row is aligned in a particular way).</doc> c:identifier="GST_VIDEO_FORMAT_INFO_TILE_HS" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="539"/> + line="558"/> <parameters> <parameter name="info"> </parameter> @@ -4050,7 +4050,7 @@ beginning of the next row is aligned in a particular way).</doc> c:identifier="GST_VIDEO_FORMAT_INFO_TILE_MODE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="537"/> + line="556"/> <parameters> <parameter name="info"> </parameter> @@ -4060,7 +4060,7 @@ beginning of the next row is aligned in a particular way).</doc> c:identifier="GST_VIDEO_FORMAT_INFO_TILE_WS" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="538"/> + line="557"/> <parameters> <parameter name="info"> </parameter> @@ -4070,7 +4070,7 @@ beginning of the next row is aligned in a particular way).</doc> c:identifier="GST_VIDEO_FORMAT_INFO_W_SUB" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="511"/> + line="530"/> <parameters> <parameter name="info"> </parameter> @@ -4082,7 +4082,7 @@ beginning of the next row is aligned in a particular way).</doc> value="(fraction) [ 0, max ]" c:type="GST_VIDEO_FPS_RANGE"> <source-position filename="gst-libs/gst/video/video-format.h" - line="571"/> + line="590"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="VIDEO_FRAME_COMP_DATA" @@ -4768,12 +4768,12 @@ It is not valid to use this macro with a TILED format.</doc> value="4" c:type="GST_VIDEO_MAX_COMPONENTS"> <source-position filename="gst-libs/gst/video/video-format.h" - line="239"/> + line="258"/> <type name="gint" c:type="gint"/> </constant> <constant name="VIDEO_MAX_PLANES" value="4" c:type="GST_VIDEO_MAX_PLANES"> <source-position filename="gst-libs/gst/video/video-format.h" - line="238"/> + line="257"/> <type name="gint" c:type="gint"/> </constant> <function-macro name="VIDEO_META_TRANSFORM_IS_SCALE" @@ -4790,7 +4790,7 @@ It is not valid to use this macro with a TILED format.</doc> c:identifier="GST_VIDEO_NE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="574"/> + line="593"/> <parameters> <parameter name="s"> </parameter> @@ -4800,7 +4800,7 @@ It is not valid to use this macro with a TILED format.</doc> c:identifier="GST_VIDEO_OE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="575"/> + line="594"/> <parameters> <parameter name="s"> </parameter> @@ -5058,14 +5058,14 @@ quatization errors.</doc> value="(int) [ 1, max ]" c:type="GST_VIDEO_SIZE_RANGE"> <source-position filename="gst-libs/gst/video/video-format.h" - line="570"/> + line="589"/> <type name="utf8" c:type="gchar*"/> </constant> <function-macro name="VIDEO_SUB_SCALE" c:identifier="GST_VIDEO_SUB_SCALE" introspectable="0"> <source-position filename="gst-libs/gst/video/video-format.h" - line="515"/> + line="534"/> <parameters> <parameter name="scale"> </parameter> @@ -5751,7 +5751,7 @@ See #GstVideoAggregator for more details.</doc> c:identifier="gst_video_aggregator_convert_pad_update_conversion_info"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="667">Requests the pad to check and update the converter before the next usage to + line="686">Requests the pad to check and update the converter before the next usage to update for any changes that have happened.</doc> <source-position filename="gst-libs/gst/video/gstvideoaggregator.h" line="168"/> @@ -5762,7 +5762,7 @@ update for any changes that have happened.</doc> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="669">a #GstVideoAggregatorPad</doc> + line="688">a #GstVideoAggregatorPad</doc> <type name="VideoAggregatorConvertPad" c:type="GstVideoAggregatorConvertPad*"/> </instance-parameter> @@ -5892,7 +5892,7 @@ update for any changes that have happened.</doc> c:identifier="gst_video_aggregator_pad_get_current_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="303">Returns the currently queued buffer that is going to be used + line="321">Returns the currently queued buffer that is going to be used for the current output frame. This must only be called from the #GstVideoAggregatorClass::aggregate_frames virtual method, @@ -5905,14 +5905,14 @@ returns.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="316">The currently queued buffer</doc> + line="334">The currently queued buffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="305">a #GstVideoAggregatorPad</doc> + line="323">a #GstVideoAggregatorPad</doc> <type name="VideoAggregatorPad" c:type="GstVideoAggregatorPad*"/> </instance-parameter> </parameters> @@ -5921,7 +5921,7 @@ returns.</doc> c:identifier="gst_video_aggregator_pad_get_prepared_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="326">Returns the currently prepared video frame that has to be aggregated into + line="344">Returns the currently prepared video frame that has to be aggregated into the current output frame. This must only be called from the #GstVideoAggregatorClass::aggregate_frames virtual method, @@ -5934,14 +5934,14 @@ returns.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="339">The currently prepared video frame</doc> + line="357">The currently prepared video frame</doc> <type name="VideoFrame" c:type="GstVideoFrame*"/> </return-value> <parameters> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="328">a #GstVideoAggregatorPad</doc> + line="346">a #GstVideoAggregatorPad</doc> <type name="VideoAggregatorPad" c:type="GstVideoAggregatorPad*"/> </instance-parameter> </parameters> @@ -5950,7 +5950,7 @@ returns.</doc> c:identifier="gst_video_aggregator_pad_has_current_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="283">Checks if the pad currently has a buffer queued that is going to be used + line="301">Checks if the pad currently has a buffer queued that is going to be used for the current output frame. This must only be called from the #GstVideoAggregatorClass::aggregate_frames virtual method, @@ -5960,14 +5960,14 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="293">%TRUE if the pad has currently a buffer queued</doc> + line="311">%TRUE if the pad has currently a buffer queued</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="285">a #GstVideoAggregatorPad</doc> + line="303">a #GstVideoAggregatorPad</doc> <type name="VideoAggregatorPad" c:type="GstVideoAggregatorPad*"/> </instance-parameter> </parameters> @@ -5976,7 +5976,7 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg c:identifier="gst_video_aggregator_pad_set_needs_alpha"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="349">Allows selecting that this pad requires an output format with alpha</doc> + line="367">Allows selecting that this pad requires an output format with alpha</doc> <source-position filename="gst-libs/gst/video/gstvideoaggregator.h" line="113"/> <return-value transfer-ownership="none"> @@ -5986,13 +5986,13 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg <instance-parameter name="pad" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="351">a #GstVideoAggregatorPad</doc> + line="369">a #GstVideoAggregatorPad</doc> <type name="VideoAggregatorPad" c:type="GstVideoAggregatorPad*"/> </instance-parameter> <parameter name="needs_alpha" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoaggregator.c" - line="352">%TRUE if this pad requires alpha output</doc> + line="370">%TRUE if this pad requires alpha output</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -6352,7 +6352,7 @@ the parity check bits).</doc> <record name="VideoBarMeta" c:type="GstVideoBarMeta" version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="270">Bar data should be included in video user data + line="268">Bar data should be included in video user data whenever the rectangular picture area containing useful information does not extend to the full height or width of the coded frame and AFD alone is insufficient to describe the extent of the image. @@ -6364,29 +6364,29 @@ For more details, see: https://www.atsc.org/wp-content/uploads/2015/03/a_53-Part-4-2009.pdf and SMPTE ST2016-1</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="306"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="304"/> <field name="meta" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="272">parent #GstMeta</doc> + line="270">parent #GstMeta</doc> <type name="Gst.Meta" c:type="GstMeta"/> </field> <field name="field" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="273">0 for progressive or field 1 and 1 for field 2</doc> + line="271">0 for progressive or field 1 and 1 for field 2</doc> <type name="guint8" c:type="guint8"/> </field> <field name="is_letterbox" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="274">if true then bar data specifies letterbox, otherwise pillarbox</doc> + line="272">if true then bar data specifies letterbox, otherwise pillarbox</doc> <type name="gboolean" c:type="gboolean"/> </field> <field name="bar_data1" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="275">If @is_letterbox is true, then the value specifies the + line="273">If @is_letterbox is true, then the value specifies the last line of a horizontal letterbox bar area at top of reconstructed frame. Otherwise, it specifies the last horizontal luminance sample of a vertical pillarbox bar area at the left side of the reconstructed frame</doc> @@ -6395,14 +6395,14 @@ and SMPTE ST2016-1</doc> <field name="bar_data2" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="279">If @is_letterbox is true, then the value specifies the + line="277">If @is_letterbox is true, then the value specifies the first line of a horizontal letterbox bar area at bottom of reconstructed frame. Otherwise, it specifies the first horizontal luminance sample of a vertical pillarbox bar area at the right side of the reconstructed frame.</doc> <type name="guint" c:type="guint"/> </field> <function name="get_info" c:identifier="gst_video_bar_meta_get_info"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="311"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="309"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -6580,24 +6580,24 @@ supports all the video bufferpool options.</doc> version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="387">Extra buffer metadata providing Closed Caption.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="404"/> + line="375">Extra buffer metadata providing Closed Caption.</doc> + <source-position filename="gst-libs/gst/video/video-anc.h" line="392"/> <field name="meta" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="389">parent #GstMeta</doc> + line="377">parent #GstMeta</doc> <type name="Gst.Meta" c:type="GstMeta"/> </field> <field name="caption_type" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="390">The type of Closed Caption contained in the meta.</doc> + line="378">The type of Closed Caption contained in the meta.</doc> <type name="VideoCaptionType" c:type="GstVideoCaptionType"/> </field> <field name="data" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="391">The Closed Caption data.</doc> + line="379">The Closed Caption data.</doc> <array length="3" zero-terminated="0" c:type="guint8*"> <type name="guint8" c:type="guint8"/> </array> @@ -6605,11 +6605,11 @@ supports all the video bufferpool options.</doc> <field name="size" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="392">The size in bytes of @data</doc> + line="380">The size in bytes of @data</doc> <type name="gsize" c:type="gsize"/> </field> <function name="get_info" c:identifier="gst_video_caption_meta_get_info"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="411"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="399"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -6622,14 +6622,14 @@ supports all the video bufferpool options.</doc> c:type="GstVideoCaptionType"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="342">The various known types of Closed Caption (CC).</doc> + line="330">The various known types of Closed Caption (CC).</doc> <member name="unknown" value="0" c:identifier="GST_VIDEO_CAPTION_TYPE_UNKNOWN" glib:nick="unknown"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="344">Unknown type of CC</doc> + line="332">Unknown type of CC</doc> </member> <member name="cea608_raw" value="1" @@ -6637,7 +6637,7 @@ supports all the video bufferpool options.</doc> glib:nick="cea608-raw"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="345">CEA-608 as byte pairs. Note that + line="333">CEA-608 as byte pairs. Note that this format is not recommended since is does not specify to which field the caption comes from and therefore assumes it comes from the first field (and that there is no information @@ -6651,7 +6651,7 @@ supports all the video bufferpool options.</doc> glib:nick="cea608-s334-1a"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="352">CEA-608 as byte triplets as defined + line="340">CEA-608 as byte triplets as defined in SMPTE S334-1 Annex A. The second and third byte of the byte triplet is the raw CEA608 data, the first byte is a bitfield: The top/7th bit is 0 for the second field, 1 for the first field, bit 6 and 5 are 0 and @@ -6666,7 +6666,7 @@ supports all the video bufferpool options.</doc> glib:nick="cea708-raw"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="360">CEA-708 as cc_data byte triplets. They + line="348">CEA-708 as cc_data byte triplets. They can also contain 608-in-708 and the first byte of each triplet has to be inspected for detecting the type.</doc> </member> @@ -6676,7 +6676,7 @@ supports all the video bufferpool options.</doc> glib:nick="cea708-cdp"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="363">CEA-708 (and optionally CEA-608) in + line="351">CEA-708 (and optionally CEA-608) in a CDP (Caption Distribution Packet) defined by SMPTE S-334-2. Contains the whole CDP (starting with 0x9669).</doc> </member> @@ -6687,7 +6687,7 @@ supports all the video bufferpool options.</doc> filename="gst-libs/gst/video/video-anc.c" line="1051">Parses fixed Closed Caption #GstCaps and returns the corresponding caption type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="381"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="369"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -6709,7 +6709,7 @@ type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN.</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="1091">Creates new caps corresponding to @type.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="385"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="373"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -7412,7 +7412,8 @@ non-linear RGB (R'G'B')</doc> glib:nick="rgb"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="48">identity matrix</doc> + line="48">identity matrix. Order of coefficients is +actually GBR, also IEC 61966-2-1 (sRGB)</doc> </member> <member name="fcc" value="2" @@ -7420,7 +7421,7 @@ non-linear RGB (R'G'B')</doc> glib:nick="fcc"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="49">FCC color matrix</doc> + line="50">FCC Title 47 Code of Federal Regulations 73.682 (a)(20)</doc> </member> <member name="bt709" value="3" @@ -7428,7 +7429,8 @@ non-linear RGB (R'G'B')</doc> glib:nick="bt709"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="50">ITU-R BT.709 color matrix</doc> + line="51">ITU-R BT.709 color matrix, also ITU-R BT1361 +/ IEC 61966-2-4 xvYCC709 / SMPTE RP177 Annex B</doc> </member> <member name="bt601" value="4" @@ -7436,7 +7438,7 @@ non-linear RGB (R'G'B')</doc> glib:nick="bt601"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="51">ITU-R BT.601 color matrix</doc> + line="53">ITU-R BT.601 color matrix, also SMPTE170M / ITU-R BT1358 525 / ITU-R BT1700 NTSC</doc> </member> <member name="smpte240m" value="5" @@ -7444,7 +7446,7 @@ non-linear RGB (R'G'B')</doc> glib:nick="smpte240m"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="52">SMPTE 240M color matrix</doc> + line="54">SMPTE 240M color matrix</doc> </member> <member name="bt2020" value="6" @@ -7452,31 +7454,31 @@ non-linear RGB (R'G'B')</doc> glib:nick="bt2020"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="53">ITU-R BT.2020 color matrix. Since: 1.6</doc> + line="55">ITU-R BT.2020 color matrix. Since: 1.6</doc> </member> <function name="from_iso" c:identifier="gst_video_color_matrix_from_iso" version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="765">Converts the @value to the #GstVideoColorMatrix + line="769">Converts the @value to the #GstVideoColorMatrix The matrix coefficients (MatrixCoefficients) value is defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="260"/> + line="284"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="775">the matched #GstVideoColorMatrix</doc> + line="779">the matched #GstVideoColorMatrix</doc> <type name="VideoColorMatrix" c:type="GstVideoColorMatrix"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="767">a ITU-T H.273 matrix coefficients value</doc> + line="771">a ITU-T H.273 matrix coefficients value</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -7511,7 +7513,7 @@ and the other way around: B' = Y' + Cb*2*(1-Kb) ]|</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="69"/> + line="71"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -7551,23 +7553,23 @@ and the other way around: version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="634">Converts #GstVideoColorMatrix to the "matrix coefficients" + line="636">Converts #GstVideoColorMatrix to the "matrix coefficients" (MatrixCoefficients) value defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="251"/> + line="275"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="643">The value of ISO/IEC 23001-8 matrix coefficients.</doc> + line="645">The value of ISO/IEC 23001-8 matrix coefficients.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <parameter name="matrix" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="636">a #GstVideoColorMatrix</doc> + line="638">a #GstVideoColorMatrix</doc> <type name="VideoColorMatrix" c:type="GstVideoColorMatrix"/> </parameter> </parameters> @@ -7579,7 +7581,7 @@ and "ITU-T H.273 Table 4". c:type="GstVideoColorPrimaries"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="132">The color primaries define the how to transform linear RGB values to and from + line="147">The color primaries define the how to transform linear RGB values to and from the CIE XYZ colorspace.</doc> <member name="unknown" value="0" @@ -7587,7 +7589,7 @@ the CIE XYZ colorspace.</doc> glib:nick="unknown"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="134">unknown color primaries</doc> + line="149">unknown color primaries</doc> </member> <member name="bt709" value="1" @@ -7595,7 +7597,8 @@ the CIE XYZ colorspace.</doc> glib:nick="bt709"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="135">BT709 primaries</doc> + line="150">BT709 primaries, also ITU-R BT1361 / IEC +61966-2-4 / SMPTE RP177 Annex B</doc> </member> <member name="bt470m" value="2" @@ -7603,7 +7606,8 @@ the CIE XYZ colorspace.</doc> glib:nick="bt470m"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="136">BT470M primaries</doc> + line="152">BT470M primaries, also FCC Title 47 Code +of Federal Regulations 73.682 (a)(20)</doc> </member> <member name="bt470bg" value="3" @@ -7611,7 +7615,8 @@ the CIE XYZ colorspace.</doc> glib:nick="bt470bg"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="137">BT470BG primaries</doc> + line="154">BT470BG primaries, also ITU-R BT601-6 +625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM</doc> </member> <member name="smpte170m" value="4" @@ -7619,7 +7624,8 @@ the CIE XYZ colorspace.</doc> glib:nick="smpte170m"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="138">SMPTE170M primaries</doc> + line="156">SMPTE170M primaries, also ITU-R +BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC</doc> </member> <member name="smpte240m" value="5" @@ -7627,7 +7633,7 @@ the CIE XYZ colorspace.</doc> glib:nick="smpte240m"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="139">SMPTE240M primaries</doc> + line="158">SMPTE240M primaries</doc> </member> <member name="film" value="6" @@ -7635,7 +7641,8 @@ the CIE XYZ colorspace.</doc> glib:nick="film"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="140">Generic film</doc> + line="159">Generic film (colour filters using +Illuminant C)</doc> </member> <member name="bt2020" value="7" @@ -7643,7 +7650,7 @@ the CIE XYZ colorspace.</doc> glib:nick="bt2020"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="141">BT2020 primaries. Since: 1.6</doc> + line="161">ITU-R BT2020 primaries. Since: 1.6</doc> </member> <member name="adobergb" value="8" @@ -7651,7 +7658,7 @@ the CIE XYZ colorspace.</doc> glib:nick="adobergb"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="142">Adobe RGB primaries. Since: 1.8</doc> + line="162">Adobe RGB primaries. Since: 1.8</doc> </member> <member name="smptest428" value="9" @@ -7659,7 +7666,8 @@ the CIE XYZ colorspace.</doc> glib:nick="smptest428"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="143">SMPTE ST 428 primaries. Since: 1.16</doc> + line="163">SMPTE ST 428 primaries (CIE 1931 +XYZ). Since: 1.16</doc> </member> <member name="smpterp431" value="10" @@ -7667,7 +7675,8 @@ the CIE XYZ colorspace.</doc> glib:nick="smpterp431"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="144">SMPTE RP 431 primaries. Since: 1.16</doc> + line="165">SMPTE RP 431 primaries (ST 431-2 +(2011) / DCI P3). Since: 1.16</doc> </member> <member name="smpteeg432" value="11" @@ -7675,7 +7684,8 @@ the CIE XYZ colorspace.</doc> glib:nick="smpteeg432"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="145">SMPTE EG 432 primaries. Since: 1.16</doc> + line="167">SMPTE EG 432 primaries (ST 432-1 +(2010) / P3 D65). Since: 1.16</doc> </member> <member name="ebu3213" value="12" @@ -7683,30 +7693,31 @@ the CIE XYZ colorspace.</doc> glib:nick="ebu3213"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="146">EBU 3213 primaries. Since: 1.16</doc> + line="169">EBU 3213 primaries (JEDEC P22 +phosphors). Since: 1.16</doc> </member> <function name="from_iso" c:identifier="gst_video_color_primaries_from_iso" version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="851">Converts the @value to the #GstVideoColorPrimaries + line="856">Converts the @value to the #GstVideoColorPrimaries The colour primaries (ColourPrimaries) value is defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="266"/> + line="290"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="860">the matched #GstVideoColorPrimaries</doc> + line="865">the matched #GstVideoColorPrimaries</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="853">a ITU-T H.273 colour primaries value</doc> + line="858">a ITU-T H.273 colour primaries value</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -7718,7 +7729,7 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". filename="gst-libs/gst/video/video-color.c" line="303">Get information about the chromaticity coordinates of @primaries.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="195"/> + line="219"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -7740,23 +7751,23 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="719">Converts #GstVideoColorPrimaries to the "colour primaries" (ColourPrimaries) + line="723">Converts #GstVideoColorPrimaries to the "colour primaries" (ColourPrimaries) value defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="257"/> + line="281"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="728">The value of ISO/IEC 23001-8 colour primaries.</doc> + line="732">The value of ISO/IEC 23001-8 colour primaries.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <parameter name="primaries" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="721">a #GstVideoColorPrimaries</doc> + line="725">a #GstVideoColorPrimaries</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </parameter> </parameters> @@ -7767,62 +7778,62 @@ and "ITU-T H.273 Table 2". version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="167">Structure describing the chromaticity coordinates of an RGB system. These + line="191">Structure describing the chromaticity coordinates of an RGB system. These values can be used to construct a matrix to transform RGB to and from the XYZ colorspace.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="191"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="215"/> <field name="primaries" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="169">a #GstVideoColorPrimaries</doc> + line="193">a #GstVideoColorPrimaries</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </field> <field name="Wx" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="170">reference white x coordinate</doc> + line="194">reference white x coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Wy" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="171">reference white y coordinate</doc> + line="195">reference white y coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Rx" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="172">red x coordinate</doc> + line="196">red x coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Ry" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="173">red y coordinate</doc> + line="197">red y coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Gx" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="174">green x coordinate</doc> + line="198">green x coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Gy" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="175">green y coordinate</doc> + line="199">green y coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="Bx" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="176">blue x coordinate</doc> + line="200">blue x coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> <field name="By" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="177">blue y coordinate</doc> + line="201">blue y coordinate</doc> <type name="gdouble" c:type="gdouble"/> </field> </record> @@ -7870,7 +7881,7 @@ The reverse operation (c[i] * scale[i]) + offset[i] can be used to convert the component values in range [0.0 .. 1.0] back to their representation in @info and @range.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="240"/> + line="264"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -7915,32 +7926,32 @@ the component values in range [0.0 .. 1.0] back to their representation in <record name="VideoColorimetry" c:type="GstVideoColorimetry"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="197">Structure describing the color info.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="213"/> + line="221">Structure describing the color info.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" line="237"/> <field name="range" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="199">the color range. This is the valid range for the samples. + line="223">the color range. This is the valid range for the samples. It is used to convert the samples to Y'PbPr values.</doc> <type name="VideoColorRange" c:type="GstVideoColorRange"/> </field> <field name="matrix" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="201">the color matrix. Used to convert between Y'PbPr and + line="225">the color matrix. Used to convert between Y'PbPr and non-linear RGB (R'G'B')</doc> <type name="VideoColorMatrix" c:type="GstVideoColorMatrix"/> </field> <field name="transfer" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="203">the transfer function. used to convert between R'G'B' and RGB</doc> + line="227">the transfer function. used to convert between R'G'B' and RGB</doc> <type name="VideoTransferFunction" c:type="GstVideoTransferFunction"/> </field> <field name="primaries" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="204">color primaries. used to convert between R'G'B' and CIE XYZ</doc> + line="228">color primaries. used to convert between R'G'B' and CIE XYZ</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </field> <method name="from_string" @@ -7950,7 +7961,7 @@ the component values in range [0.0 .. 1.0] back to their representation in line="102">Parse the colorimetry string and update @cinfo with the parsed values.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="229"/> + line="253"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -7979,7 +7990,7 @@ values.</doc> filename="gst-libs/gst/video/video-color.c" line="251">Compare the 2 colorimetry sets for equality</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="235"/> + line="259"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -8007,7 +8018,7 @@ values.</doc> line="165">Check if the colorimetry information in @info matches that of the string @color.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="226"/> + line="250"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -8035,7 +8046,7 @@ information in @info.</doc> filename="gst-libs/gst/video/video-color.c" line="139">Make a string representation of @cinfo.</doc> <source-position filename="gst-libs/gst/video/video-color.h" - line="232"/> + line="256"/> <return-value transfer-ownership="full" nullable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -8639,7 +8650,7 @@ The bare minimum that a functional subclass needs to implement is: <virtual-method name="negotiate" invoker="negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4041">Negotiate with downstream elements to currently configured #GstVideoCodecState. + line="4100">Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -8647,14 +8658,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4049">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="4108">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4043">a #GstVideoDecoder</doc> + line="4102">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -8843,7 +8854,7 @@ negotiate fails.</doc> c:identifier="gst_video_decoder_add_to_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3322">Removes next @n_bytes of input data and adds it to currently parsed frame.</doc> + line="3364">Removes next @n_bytes of input data and adds it to currently parsed frame.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="410"/> <return-value transfer-ownership="none"> @@ -8853,13 +8864,13 @@ negotiate fails.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3324">a #GstVideoDecoder</doc> + line="3366">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="n_bytes" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3325">the number of bytes to add</doc> + line="3367">the number of bytes to add</doc> <type name="gint" c:type="int"/> </parameter> </parameters> @@ -8868,7 +8879,7 @@ negotiate fails.</doc> c:identifier="gst_video_decoder_allocate_output_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4073">Helper function that allocates a buffer to hold a video frame for @decoder's + line="4132">Helper function that allocates a buffer to hold a video frame for @decoder's current #GstVideoCodecState. You should use gst_video_decoder_allocate_output_frame() instead of this @@ -8878,7 +8889,7 @@ function, if possible at all.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4083">allocated buffer, or NULL if no buffer could be + line="4142">allocated buffer, or NULL if no buffer could be allocated (e.g. when downstream is flushing or shutting down)</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> @@ -8886,7 +8897,7 @@ function, if possible at all.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4075">a #GstVideoDecoder</doc> + line="4134">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -8895,7 +8906,7 @@ function, if possible at all.</doc> c:identifier="gst_video_decoder_allocate_output_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4139">Helper function that allocates a buffer to hold a video frame for @decoder's + line="4198">Helper function that allocates a buffer to hold a video frame for @decoder's current #GstVideoCodecState. Subclass should already have configured video state and set src pad caps. @@ -8906,20 +8917,20 @@ keep references to the frame, not the buffer.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4151">%GST_FLOW_OK if an output buffer could be allocated</doc> + line="4210">%GST_FLOW_OK if an output buffer could be allocated</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4141">a #GstVideoDecoder</doc> + line="4200">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4142">a #GstVideoCodecFrame</doc> + line="4201">a #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -8929,33 +8940,33 @@ keep references to the frame, not the buffer.</doc> version="1.12"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4161">Same as #gst_video_decoder_allocate_output_frame except it allows passing + line="4220">Same as #gst_video_decoder_allocate_output_frame except it allows passing #GstBufferPoolAcquireParams to the sub call gst_buffer_pool_acquire_buffer.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="423"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4170">%GST_FLOW_OK if an output buffer could be allocated</doc> + line="4229">%GST_FLOW_OK if an output buffer could be allocated</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4163">a #GstVideoDecoder</doc> + line="4222">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4164">a #GstVideoCodecFrame</doc> + line="4223">a #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> <parameter name="params" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4165">a #GstBufferPoolAcquireParams</doc> + line="4224">a #GstBufferPoolAcquireParams</doc> <type name="Gst.BufferPoolAcquireParams" c:type="GstBufferPoolAcquireParams*"/> </parameter> @@ -8964,7 +8975,7 @@ keep references to the frame, not the buffer.</doc> <method name="drop_frame" c:identifier="gst_video_decoder_drop_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2966">Similar to gst_video_decoder_finish_frame(), but drops @frame in any + line="2998">Similar to gst_video_decoder_finish_frame(), but drops @frame in any case and posts a QoS message with the frame's details on the bus. In any case, the frame is considered finished and released.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -8972,20 +8983,20 @@ In any case, the frame is considered finished and released.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2975">a #GstFlowReturn, usually GST_FLOW_OK.</doc> + line="3007">a #GstFlowReturn, usually GST_FLOW_OK.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2968">a #GstVideoDecoder</doc> + line="3000">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2969">the #GstVideoCodecFrame to drop</doc> + line="3001">the #GstVideoCodecFrame to drop</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -8994,7 +9005,7 @@ In any case, the frame is considered finished and released.</doc> c:identifier="gst_video_decoder_finish_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3055">@frame should have a valid decoded data buffer, whose metadata fields + line="3097">@frame should have a valid decoded data buffer, whose metadata fields are then appropriately set according to frame data and pushed downstream. If no output data is provided, @frame is considered skipped. In any case, the frame is considered finished and released. @@ -9007,20 +9018,20 @@ of the buffer.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3069">a #GstFlowReturn resulting from sending data downstream</doc> + line="3111">a #GstFlowReturn resulting from sending data downstream</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3057">a #GstVideoDecoder</doc> + line="3099">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3058">a decoded #GstVideoCodecFrame</doc> + line="3100">a decoded #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -9029,7 +9040,7 @@ of the buffer.</doc> c:identifier="gst_video_decoder_get_allocator"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4550">Lets #GstVideoDecoder sub-classes to know the memory @allocator + line="4609">Lets #GstVideoDecoder sub-classes to know the memory @allocator used by the base class and its @params. Unref the @allocator after use it.</doc> @@ -9042,7 +9053,7 @@ Unref the @allocator after use it.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4552">a #GstVideoDecoder</doc> + line="4611">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="allocator" @@ -9053,7 +9064,7 @@ Unref the @allocator after use it.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4553">the #GstAllocator + line="4612">the #GstAllocator used</doc> <type name="Gst.Allocator" c:type="GstAllocator**"/> </parameter> @@ -9065,7 +9076,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4555">the + line="4614">the #GstAllocationParams of @allocator</doc> <type name="Gst.AllocationParams" c:type="GstAllocationParams*"/> </parameter> @@ -9078,7 +9089,7 @@ used</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4536">the instance of the #GstBufferPool used + line="4595">the instance of the #GstBufferPool used by the decoder; free it after use it</doc> <type name="Gst.BufferPool" c:type="GstBufferPool*"/> </return-value> @@ -9086,7 +9097,7 @@ by the decoder; free it after use it</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4534">a #GstVideoDecoder</doc> + line="4593">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9098,14 +9109,14 @@ by the decoder; free it after use it</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4431">currently configured byte to time conversion setting</doc> + line="4490">currently configured byte to time conversion setting</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4429">a #GstVideoDecoder</doc> + line="4488">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9113,26 +9124,26 @@ by the decoder; free it after use it</doc> <method name="get_frame" c:identifier="gst_video_decoder_get_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3667">Get a pending unfinished #GstVideoCodecFrame</doc> + line="3726">Get a pending unfinished #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="398"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3674">pending unfinished #GstVideoCodecFrame identified by @frame_number.</doc> + line="3733">pending unfinished #GstVideoCodecFrame identified by @frame_number.</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3669">a #GstVideoDecoder</doc> + line="3728">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame_number" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3670">system_frame_number of a frame</doc> + line="3729">system_frame_number of a frame</doc> <type name="gint" c:type="int"/> </parameter> </parameters> @@ -9140,13 +9151,13 @@ by the decoder; free it after use it</doc> <method name="get_frames" c:identifier="gst_video_decoder_get_frames"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3698">Get all pending unfinished #GstVideoCodecFrame</doc> + line="3757">Get all pending unfinished #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="405"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3704">pending unfinished #GstVideoCodecFrame.</doc> + line="3763">pending unfinished #GstVideoCodecFrame.</doc> <type name="GLib.List" c:type="GList*"> <type name="VideoCodecFrame"/> </type> @@ -9155,7 +9166,7 @@ by the decoder; free it after use it</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3700">a #GstVideoDecoder</doc> + line="3759">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9163,7 +9174,7 @@ by the decoder; free it after use it</doc> <method name="get_latency" c:identifier="gst_video_decoder_get_latency"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4467">Query the configured decoder latency. Results will be returned via + line="4526">Query the configured decoder latency. Results will be returned via @min_latency and @max_latency.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="383"/> @@ -9174,7 +9185,7 @@ by the decoder; free it after use it</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4469">a #GstVideoDecoder</doc> + line="4528">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="min_latency" @@ -9185,7 +9196,7 @@ by the decoder; free it after use it</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4470">address of variable in which to store the + line="4529">address of variable in which to store the configured minimum latency, or %NULL</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> @@ -9197,7 +9208,7 @@ by the decoder; free it after use it</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4472">address of variable in which to store the + line="4531">address of variable in which to store the configured mximum latency, or %NULL</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> @@ -9207,7 +9218,7 @@ by the decoder; free it after use it</doc> c:identifier="gst_video_decoder_get_max_decode_time"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4221">Determines maximum possible decoding time for @frame that will + line="4280">Determines maximum possible decoding time for @frame that will allow it to decode and arrive in time (as determined by QoS events). In particular, a negative result means decoding in time is no longer possible and should therefore occur as soon/skippy as possible.</doc> @@ -9216,20 +9227,20 @@ and should therefore occur as soon/skippy as possible.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4231">max decoding time.</doc> + line="4290">max decoding time.</doc> <type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4223">a #GstVideoDecoder</doc> + line="4282">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4224">a #GstVideoCodecFrame</doc> + line="4283">a #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -9241,14 +9252,14 @@ and should therefore occur as soon/skippy as possible.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4328">currently configured decoder tolerated error count.</doc> + line="4387">currently configured decoder tolerated error count.</doc> <type name="gint" c:type="gint"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4326">a #GstVideoDecoder</doc> + line="4385">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9258,20 +9269,20 @@ and should therefore occur as soon/skippy as possible.</doc> version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4360">Queries decoder required format handling.</doc> + line="4419">Queries decoder required format handling.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="375"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4366">%TRUE if required format handling is enabled.</doc> + line="4425">%TRUE if required format handling is enabled.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4362">a #GstVideoDecoder</doc> + line="4421">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9280,20 +9291,20 @@ and should therefore occur as soon/skippy as possible.</doc> c:identifier="gst_video_decoder_get_oldest_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3646">Get the oldest pending unfinished #GstVideoCodecFrame</doc> + line="3705">Get the oldest pending unfinished #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="402"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3652">oldest pending unfinished #GstVideoCodecFrame.</doc> + line="3711">oldest pending unfinished #GstVideoCodecFrame.</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3648">a #GstVideoDecoder</doc> + line="3707">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9302,20 +9313,20 @@ and should therefore occur as soon/skippy as possible.</doc> c:identifier="gst_video_decoder_get_output_state"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3535">Get the #GstVideoCodecState currently describing the output stream.</doc> + line="3577">Get the #GstVideoCodecState currently describing the output stream.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="442"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3541">#GstVideoCodecState describing format of video data.</doc> + line="3583">#GstVideoCodecState describing format of video data.</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3537">a #GstVideoDecoder</doc> + line="3579">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9324,21 +9335,21 @@ and should therefore occur as soon/skippy as possible.</doc> c:identifier="gst_video_decoder_get_packetized"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4397">Queries whether input data is considered packetized or not by the + line="4456">Queries whether input data is considered packetized or not by the base class.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="354"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4404">TRUE if input data is considered packetized.</doc> + line="4463">TRUE if input data is considered packetized.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4399">a #GstVideoDecoder</doc> + line="4458">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9348,21 +9359,21 @@ base class.</doc> version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3351">Returns the number of bytes previously added to the current frame + line="3393">Returns the number of bytes previously added to the current frame by calling gst_video_decoder_add_to_frame().</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="417"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3358">The number of bytes pending for the current frame</doc> + line="3400">The number of bytes pending for the current frame</doc> <type name="gsize" c:type="gsize"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3353">a #GstVideoDecoder</doc> + line="3395">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9375,14 +9386,14 @@ by calling gst_video_decoder_add_to_frame().</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4263">The current QoS proportion.</doc> + line="4322">The current QoS proportion.</doc> <type name="gdouble" c:type="gdouble"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4260">a #GstVideoDecoder + line="4319">a #GstVideoDecoder current QoS proportion, or %NULL</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> @@ -9391,21 +9402,21 @@ by calling gst_video_decoder_add_to_frame().</doc> <method name="have_frame" c:identifier="gst_video_decoder_have_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3401">Gathers all data collected for currently parsed frame, gathers corresponding + line="3443">Gathers all data collected for currently parsed frame, gathers corresponding metadata and passes it along for further processing, i.e. @handle_frame.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="414"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3408">a #GstFlowReturn</doc> + line="3450">a #GstFlowReturn</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3403">a #GstVideoDecoder</doc> + line="3445">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9413,7 +9424,7 @@ metadata and passes it along for further processing, i.e. @handle_frame.</doc> <method name="merge_tags" c:identifier="gst_video_decoder_merge_tags"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4490">Sets the audio decoder tags and how they should be merged with any + line="4549">Sets the audio decoder tags and how they should be merged with any upstream stream tags. This will override any tags previously-set with gst_audio_decoder_merge_tags(). @@ -9430,7 +9441,7 @@ MT safe.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4492">a #GstVideoDecoder</doc> + line="4551">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="tags" @@ -9439,14 +9450,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4493">a #GstTagList to merge, or NULL to unset + line="4552">a #GstTagList to merge, or NULL to unset previously-set tags</doc> <type name="Gst.TagList" c:type="const GstTagList*"/> </parameter> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4495">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> + line="4554">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> <type name="Gst.TagMergeMode" c:type="GstTagMergeMode"/> </parameter> </parameters> @@ -9454,7 +9465,7 @@ MT safe.</doc> <method name="negotiate" c:identifier="gst_video_decoder_negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4041">Negotiate with downstream elements to currently configured #GstVideoCodecState. + line="4100">Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -9462,14 +9473,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4049">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="4108">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4043">a #GstVideoDecoder</doc> + line="4102">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> </parameters> @@ -9479,7 +9490,7 @@ negotiate fails.</doc> version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="1817">Returns caps that express @caps (or sink template caps if @caps == NULL) + line="1849">Returns caps that express @caps (or sink template caps if @caps == NULL) restricted to resolution/format/... combinations supported by downstream elements.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -9487,14 +9498,14 @@ elements.</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="1827">a #GstCaps owned by caller</doc> + line="1859">a #GstCaps owned by caller</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="1819">a #GstVideoDecoder</doc> + line="1851">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="caps" @@ -9503,7 +9514,7 @@ elements.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="1820">initial caps</doc> + line="1852">initial caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="filter" @@ -9512,7 +9523,7 @@ elements.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="1821">filter caps</doc> + line="1853">filter caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -9522,7 +9533,7 @@ elements.</doc> version="1.2.2"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2899">Similar to gst_video_decoder_drop_frame(), but simply releases @frame + line="2931">Similar to gst_video_decoder_drop_frame(), but simply releases @frame without any processing other than removing it from list of pending frames, after which it is considered finished and released.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -9534,13 +9545,13 @@ after which it is considered finished and released.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2901">a #GstVideoDecoder</doc> + line="2933">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="2902">the #GstVideoCodecFrame to release</doc> + line="2934">the #GstVideoCodecFrame to release</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -9549,7 +9560,7 @@ after which it is considered finished and released.</doc> c:identifier="gst_video_decoder_set_estimate_rate"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4412">Allows baseclass to perform byte to time estimated conversion.</doc> + line="4471">Allows baseclass to perform byte to time estimated conversion.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="357"/> <return-value transfer-ownership="none"> @@ -9559,13 +9570,13 @@ after which it is considered finished and released.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4414">a #GstVideoDecoder</doc> + line="4473">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4415">whether to enable byte to time conversion</doc> + line="4474">whether to enable byte to time conversion</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -9575,45 +9586,42 @@ after which it is considered finished and released.</doc> version="1.16."> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3590">Same as #gst_video_decoder_set_output_state() but also allows you to also set + line="3679">Same as #gst_video_decoder_set_output_state() but also allows you to also set the interlacing mode.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="437"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3602">the newly configured output state.</doc> + line="3691">the newly configured output state.</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3592">a #GstVideoDecoder</doc> + line="3681">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="fmt" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3593">a #GstVideoFormat</doc> + line="3682">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> <parameter name="mode" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/gstvideodecoder.c" - line="3596">A #GstVideoInterlaceMode</doc> <type name="VideoInterlaceMode" c:type="GstVideoInterlaceMode"/> </parameter> <parameter name="width" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3594">The width in pixels</doc> + line="3683">The width in pixels</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="height" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3595">The height in pixels</doc> + line="3684">The height in pixels</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="reference" @@ -9622,7 +9630,7 @@ the interlacing mode.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3597">An optional reference #GstVideoCodecState</doc> + line="3686">An optional reference #GstVideoCodecState</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </parameter> </parameters> @@ -9630,7 +9638,7 @@ the interlacing mode.</doc> <method name="set_latency" c:identifier="gst_video_decoder_set_latency"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4441">Lets #GstVideoDecoder sub-classes tell the baseclass what the decoder + line="4500">Lets #GstVideoDecoder sub-classes tell the baseclass what the decoder latency is. Will also post a LATENCY message on the bus so the pipeline can reconfigure its global latency.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" @@ -9642,19 +9650,19 @@ can reconfigure its global latency.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4443">a #GstVideoDecoder</doc> + line="4502">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="min_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4444">minimum latency</doc> + line="4503">minimum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="max_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4445">maximum latency</doc> + line="4504">maximum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -9663,7 +9671,7 @@ can reconfigure its global latency.</doc> c:identifier="gst_video_decoder_set_max_errors"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4304">Sets numbers of tolerated decoder errors, where a tolerated one is then only + line="4363">Sets numbers of tolerated decoder errors, where a tolerated one is then only warned about, but more than tolerated will lead to fatal error. You can set -1 for never returning fatal errors. Default is set to GST_VIDEO_DECODER_MAX_ERRORS. @@ -9678,13 +9686,13 @@ The '-1' option was added in 1.4</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4306">a #GstVideoDecoder</doc> + line="4365">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="num" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4307">max tolerated errors</doc> + line="4366">max tolerated errors</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -9694,7 +9702,7 @@ The '-1' option was added in 1.4</doc> version="1.4"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4338">Configures decoder format needs. If enabled, subclass needs to be + line="4397">Configures decoder format needs. If enabled, subclass needs to be negotiated with format caps before it can process any data. It will then never be handed any data before it has been configured. Otherwise, it might be handed data without having been configured and @@ -9709,13 +9717,13 @@ or based on the input data.</doc> <instance-parameter name="dec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4340">a #GstVideoDecoder</doc> + line="4399">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4341">new state</doc> + line="4400">new state</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -9724,7 +9732,7 @@ or based on the input data.</doc> c:identifier="gst_video_decoder_set_output_state"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3556">Creates a new #GstVideoCodecState with the specified @fmt, @width and @height + line="3645">Creates a new #GstVideoCodecState with the specified @fmt, @width and @height as the output state for the decoder. Any previously set output state on @decoder will be replaced by the newly created one. @@ -9743,32 +9751,32 @@ from the next call to #gst_video_decoder_finish_frame().</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3579">the newly configured output state.</doc> + line="3668">the newly configured output state.</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </return-value> <parameters> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3558">a #GstVideoDecoder</doc> + line="3647">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="fmt" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3559">a #GstVideoFormat</doc> + line="3648">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> <parameter name="width" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3560">The width in pixels</doc> + line="3649">The width in pixels</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="height" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3561">The height in pixels</doc> + line="3650">The height in pixels</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="reference" @@ -9777,7 +9785,7 @@ from the next call to #gst_video_decoder_finish_frame().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="3562">An optional reference #GstVideoCodecState</doc> + line="3651">An optional reference #GstVideoCodecState</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </parameter> </parameters> @@ -9786,7 +9794,7 @@ from the next call to #gst_video_decoder_finish_frame().</doc> c:identifier="gst_video_decoder_set_packetized"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4382">Allows baseclass to consider input data as packetized or not. If the + line="4441">Allows baseclass to consider input data as packetized or not. If the input is packetized, then the @parse method will not be called.</doc> <source-position filename="gst-libs/gst/video/gstvideodecoder.h" line="350"/> @@ -9797,13 +9805,13 @@ input is packetized, then the @parse method will not be called.</doc> <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4384">a #GstVideoDecoder</doc> + line="4443">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="packetized" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4385">whether the input data should be considered as packetized.</doc> + line="4444">whether the input data should be considered as packetized.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -9813,7 +9821,7 @@ input is packetized, then the @parse method will not be called.</doc> version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4577">Lets #GstVideoDecoder sub-classes decide if they want the sink pad + line="4636">Lets #GstVideoDecoder sub-classes decide if they want the sink pad to use the default pad query handler to reply to accept-caps queries. By setting this to true it is possible to further customize the default @@ -9828,24 +9836,34 @@ handler with %GST_PAD_SET_ACCEPT_INTERSECT and <instance-parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4579">a #GstVideoDecoder</doc> + line="4638">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </instance-parameter> <parameter name="use" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4580">if the default pad accept-caps query handling should be used</doc> + line="4639">if the default pad accept-caps query handling should be used</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> </method> + <property name="max-errors" + version="1.18" + writable="1" + transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/gstvideodecoder.c" + line="583">Maximum number of tolerated consecutive decode errors. See +gst_video_decoder_set_max_errors() for more details.</doc> + <type name="gint" c:type="gint"/> + </property> <property name="qos" version="1.18" writable="1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="562">If set to %TRUE the decoder will handle QoS events received + line="568">If set to %TRUE the decoder will handle QoS events received from downstream elements. This includes dropping output frames which are detected as late using the metrics reported by those events.</doc> @@ -10077,14 +10095,14 @@ and likely as well. If non-packetized input is supported or expected, <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4049">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="4108">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="decoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideodecoder.c" - line="4043">a #GstVideoDecoder</doc> + line="4102">a #GstVideoDecoder</doc> <type name="VideoDecoder" c:type="GstVideoDecoder*"/> </parameter> </parameters> @@ -10631,7 +10649,7 @@ pipeline to catch up.</doc> <virtual-method name="negotiate" invoker="negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1986">Negotiate with downstream elements to currently configured #GstVideoCodecState. + line="1992">Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" @@ -10639,14 +10657,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1994">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="2000">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1988">a #GstVideoEncoder</doc> + line="1994">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -10829,27 +10847,27 @@ negotiate fails.</doc> c:identifier="gst_video_encoder_allocate_output_buffer"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2019">Helper function that allocates a buffer to hold an encoded video frame + line="2025">Helper function that allocates a buffer to hold an encoded video frame for @encoder's current #GstVideoCodecState.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="327"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2027">allocated buffer</doc> + line="2033">allocated buffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2021">a #GstVideoEncoder</doc> + line="2027">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2022">size of the buffer</doc> + line="2028">size of the buffer</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -10858,7 +10876,7 @@ for @encoder's current #GstVideoCodecState.</doc> c:identifier="gst_video_encoder_allocate_output_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2070">Helper function that allocates a buffer to hold an encoded video frame for @encoder's + line="2076">Helper function that allocates a buffer to hold an encoded video frame for @encoder's current #GstVideoCodecState. Subclass should already have configured video state and set src pad caps. @@ -10869,26 +10887,26 @@ keep references to the frame, not the buffer.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2083">%GST_FLOW_OK if an output buffer could be allocated</doc> + line="2089">%GST_FLOW_OK if an output buffer could be allocated</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2072">a #GstVideoEncoder</doc> + line="2078">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2073">a #GstVideoCodecFrame</doc> + line="2079">a #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> <parameter name="size" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2074">size of the buffer</doc> + line="2080">size of the buffer</doc> <type name="gsize" c:type="gsize"/> </parameter> </parameters> @@ -10897,7 +10915,7 @@ keep references to the frame, not the buffer.</doc> c:identifier="gst_video_encoder_finish_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2459">@frame must have a valid encoded data buffer, whose metadata fields + line="2475">@frame must have a valid encoded data buffer, whose metadata fields are then appropriately set according to frame data or no buffer at all if the frame should be dropped. It is subsequently pushed downstream or provided to @pre_push. @@ -10911,20 +10929,20 @@ of the buffer.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2474">a #GstFlowReturn resulting from sending data downstream</doc> + line="2490">a #GstFlowReturn resulting from sending data downstream</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2461">a #GstVideoEncoder</doc> + line="2477">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2462">an encoded #GstVideoCodecFrame</doc> + line="2478">an encoded #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -10934,7 +10952,7 @@ of the buffer.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2611">If multiple subframes are produced for one input frame then use this method + line="2627">If multiple subframes are produced for one input frame then use this method for each subframe, except for the last one. Before calling this function, you need to fill frame->output_buffer with the encoded buffer to push. @@ -10948,20 +10966,20 @@ will be pushed downstream.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2626">a #GstFlowReturn resulting from pushing the buffer downstream.</doc> + line="2642">a #GstFlowReturn resulting from pushing the buffer downstream.</doc> <type name="Gst.FlowReturn" c:type="GstFlowReturn"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2613">a #GstVideoEncoder</doc> + line="2629">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2614">a #GstVideoCodecFrame being encoded</doc> + line="2630">a #GstVideoCodecFrame being encoded</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -10970,7 +10988,7 @@ will be pushed downstream.</doc> c:identifier="gst_video_encoder_get_allocator"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2980">Lets #GstVideoEncoder sub-classes to know the memory @allocator + line="2996">Lets #GstVideoEncoder sub-classes to know the memory @allocator used by the base class and its @params. Unref the @allocator after use it.</doc> @@ -10983,7 +11001,7 @@ Unref the @allocator after use it.</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2982">a #GstVideoEncoder</doc> + line="2998">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="allocator" @@ -10994,7 +11012,7 @@ Unref the @allocator after use it.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2983">the #GstAllocator + line="2999">the #GstAllocator used</doc> <type name="Gst.Allocator" c:type="GstAllocator**"/> </parameter> @@ -11006,7 +11024,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2985">the + line="3001">the #GstAllocationParams of @allocator</doc> <type name="Gst.AllocationParams" c:type="GstAllocationParams*"/> </parameter> @@ -11015,26 +11033,26 @@ used</doc> <method name="get_frame" c:identifier="gst_video_encoder_get_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2884">Get a pending unfinished #GstVideoCodecFrame</doc> + line="2900">Get a pending unfinished #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="317"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2891">pending unfinished #GstVideoCodecFrame identified by @frame_number.</doc> + line="2907">pending unfinished #GstVideoCodecFrame identified by @frame_number.</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2886">a #GstVideoEncoder</doc> + line="2902">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="frame_number" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2887">system_frame_number of a frame</doc> + line="2903">system_frame_number of a frame</doc> <type name="gint" c:type="int"/> </parameter> </parameters> @@ -11042,13 +11060,13 @@ used</doc> <method name="get_frames" c:identifier="gst_video_encoder_get_frames"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2915">Get all pending unfinished #GstVideoCodecFrame</doc> + line="2931">Get all pending unfinished #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="324"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2921">pending unfinished #GstVideoCodecFrame.</doc> + line="2937">pending unfinished #GstVideoCodecFrame.</doc> <type name="GLib.List" c:type="GList*"> <type name="VideoCodecFrame"/> </type> @@ -11057,7 +11075,7 @@ used</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2917">a #GstVideoEncoder</doc> + line="2933">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11065,7 +11083,7 @@ used</doc> <method name="get_latency" c:identifier="gst_video_encoder_get_latency"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2840">Query the configured encoding latency. Results will be returned via + line="2856">Query the configured encoding latency. Results will be returned via @min_latency and @max_latency.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="354"/> @@ -11076,7 +11094,7 @@ used</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2842">a #GstVideoEncoder</doc> + line="2858">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="min_latency" @@ -11087,7 +11105,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2843">address of variable in which to store the + line="2859">address of variable in which to store the configured minimum latency, or %NULL</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> @@ -11099,7 +11117,7 @@ used</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2845">address of variable in which to store the + line="2861">address of variable in which to store the configured maximum latency, or %NULL</doc> <type name="Gst.ClockTime" c:type="GstClockTime*"/> </parameter> @@ -11110,7 +11128,7 @@ used</doc> version="1.14"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3027">Determines maximum possible encoding time for @frame that will + line="3043">Determines maximum possible encoding time for @frame that will allow it to encode and arrive in time (as determined by QoS events). In particular, a negative result means encoding in time is no longer possible and should therefore occur as soon/skippy as possible. @@ -11122,20 +11140,20 @@ If no QoS events have been received from downstream, or if <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3040">max decoding time.</doc> + line="3056">max decoding time.</doc> <type name="Gst.ClockTimeDiff" c:type="GstClockTimeDiff"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3029">a #GstVideoEncoder</doc> + line="3045">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="frame" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3030">a #GstVideoCodecFrame</doc> + line="3046">a #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </parameter> </parameters> @@ -11145,21 +11163,21 @@ If no QoS events have been received from downstream, or if version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3131">Returns the minimum force-keyunit interval, see gst_video_encoder_set_min_force_key_unit_interval() + line="3147">Returns the minimum force-keyunit interval, see gst_video_encoder_set_min_force_key_unit_interval() for more details.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="388"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3138">the minimum force-keyunit interval</doc> + line="3154">the minimum force-keyunit interval</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3133">the encoder</doc> + line="3149">the encoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11168,20 +11186,20 @@ for more details.</doc> c:identifier="gst_video_encoder_get_oldest_frame"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2863">Get the oldest unfinished pending #GstVideoCodecFrame</doc> + line="2879">Get the oldest unfinished pending #GstVideoCodecFrame</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="321"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2869">oldest unfinished pending #GstVideoCodecFrame</doc> + line="2885">oldest unfinished pending #GstVideoCodecFrame</doc> <type name="VideoCodecFrame" c:type="GstVideoCodecFrame*"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2865">a #GstVideoEncoder</doc> + line="2881">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11190,20 +11208,20 @@ for more details.</doc> c:identifier="gst_video_encoder_get_output_state"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2737">Get the current #GstVideoCodecState</doc> + line="2753">Get the current #GstVideoCodecState</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="306"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2743">#GstVideoCodecState describing format of video data.</doc> + line="2759">#GstVideoCodecState describing format of video data.</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2739">a #GstVideoEncoder</doc> + line="2755">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11213,21 +11231,21 @@ for more details.</doc> version="1.14"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3087">Checks if @encoder is currently configured to handle Quality-of-Service + line="3103">Checks if @encoder is currently configured to handle Quality-of-Service events from downstream.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="379"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3094">%TRUE if the encoder is configured to perform Quality-of-Service.</doc> + line="3110">%TRUE if the encoder is configured to perform Quality-of-Service.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3089">the encoder</doc> + line="3105">the encoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11235,7 +11253,7 @@ events from downstream.</doc> <method name="merge_tags" c:identifier="gst_video_encoder_merge_tags"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2937">Sets the video encoder tags and how they should be merged with any + line="2953">Sets the video encoder tags and how they should be merged with any upstream stream tags. This will override any tags previously-set with gst_video_encoder_merge_tags(). @@ -11252,7 +11270,7 @@ MT safe.</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2939">a #GstVideoEncoder</doc> + line="2955">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="tags" @@ -11261,14 +11279,14 @@ MT safe.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2940">a #GstTagList to merge, or NULL to unset + line="2956">a #GstTagList to merge, or NULL to unset previously-set tags</doc> <type name="Gst.TagList" c:type="const GstTagList*"/> </parameter> <parameter name="mode" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2942">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> + line="2958">the #GstTagMergeMode to use, usually #GST_TAG_MERGE_REPLACE</doc> <type name="Gst.TagMergeMode" c:type="GstTagMergeMode"/> </parameter> </parameters> @@ -11276,7 +11294,7 @@ MT safe.</doc> <method name="negotiate" c:identifier="gst_video_encoder_negotiate"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1986">Negotiate with downstream elements to currently configured #GstVideoCodecState. + line="1992">Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" @@ -11284,14 +11302,14 @@ negotiate fails.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1994">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="2000">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1988">a #GstVideoEncoder</doc> + line="1994">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> </parameters> @@ -11300,7 +11318,7 @@ negotiate fails.</doc> c:identifier="gst_video_encoder_proxy_getcaps"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="769">Returns caps that express @caps (or sink template caps if @caps == NULL) + line="775">Returns caps that express @caps (or sink template caps if @caps == NULL) restricted to resolution/format/... combinations supported by downstream elements (e.g. muxers).</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" @@ -11308,14 +11326,14 @@ elements (e.g. muxers).</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="779">a #GstCaps owned by caller</doc> + line="785">a #GstCaps owned by caller</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> <instance-parameter name="enc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="771">a #GstVideoEncoder</doc> + line="777">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="caps" @@ -11324,7 +11342,7 @@ elements (e.g. muxers).</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="772">initial caps</doc> + line="778">initial caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="filter" @@ -11333,7 +11351,7 @@ elements (e.g. muxers).</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="773">filter caps</doc> + line="779">filter caps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> </parameters> @@ -11341,7 +11359,7 @@ elements (e.g. muxers).</doc> <method name="set_headers" c:identifier="gst_video_encoder_set_headers"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="609">Set the codec headers to be sent downstream whenever requested.</doc> + line="615">Set the codec headers to be sent downstream whenever requested.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="359"/> <return-value transfer-ownership="none"> @@ -11351,13 +11369,13 @@ elements (e.g. muxers).</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="611">a #GstVideoEncoder</doc> + line="617">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="headers" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="612">a list of #GstBuffer containing the codec header</doc> + line="618">a list of #GstBuffer containing the codec header</doc> <type name="GLib.List" c:type="GList*"> <type name="Gst.Buffer"/> </type> @@ -11367,7 +11385,7 @@ elements (e.g. muxers).</doc> <method name="set_latency" c:identifier="gst_video_encoder_set_latency"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2816">Informs baseclass of encoding latency.</doc> + line="2832">Informs baseclass of encoding latency.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="349"/> <return-value transfer-ownership="none"> @@ -11377,19 +11395,19 @@ elements (e.g. muxers).</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2818">a #GstVideoEncoder</doc> + line="2834">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="min_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2819">minimum latency</doc> + line="2835">minimum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> <parameter name="max_latency" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2820">maximum latency</doc> + line="2836">maximum latency</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -11399,7 +11417,7 @@ elements (e.g. muxers).</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3109">Sets the minimum interval for requesting keyframes based on force-keyunit + line="3125">Sets the minimum interval for requesting keyframes based on force-keyunit events. Setting this to 0 will allow to handle every event, setting this to %GST_CLOCK_TIME_NONE causes force-keyunit events to be ignored.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" @@ -11411,13 +11429,13 @@ events. Setting this to 0 will allow to handle every event, setting this to <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3111">the encoder</doc> + line="3127">the encoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="interval" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3112">minimum interval</doc> + line="3128">minimum interval</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -11427,7 +11445,7 @@ events. Setting this to 0 will allow to handle every event, setting this to version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3007">Request minimal value for PTS passed to handle_frame. + line="3023">Request minimal value for PTS passed to handle_frame. For streams with reordered frames this can be used to ensure that there is enough time to accommodate first DTS, which may be less than first PTS</doc> @@ -11440,13 +11458,13 @@ is enough time to accommodate first DTS, which may be less than first PTS</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3009">a #GstVideoEncoder</doc> + line="3025">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="min_pts" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3010">minimal PTS that will be passed to handle_frame</doc> + line="3026">minimal PTS that will be passed to handle_frame</doc> <type name="Gst.ClockTime" c:type="GstClockTime"/> </parameter> </parameters> @@ -11455,7 +11473,7 @@ is enough time to accommodate first DTS, which may be less than first PTS</doc> c:identifier="gst_video_encoder_set_output_state"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2757">Creates a new #GstVideoCodecState with the specified caps as the output state + line="2773">Creates a new #GstVideoCodecState with the specified caps as the output state for the encoder. Any previously set output state on @encoder will be replaced by the newly created one. @@ -11478,20 +11496,20 @@ from the next call to #gst_video_encoder_finish_frame().</doc> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2782">the newly configured output state.</doc> + line="2798">the newly configured output state.</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </return-value> <parameters> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2759">a #GstVideoEncoder</doc> + line="2775">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="caps" transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2760">the #GstCaps to use for the output</doc> + line="2776">the #GstCaps to use for the output</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </parameter> <parameter name="reference" @@ -11500,7 +11518,7 @@ from the next call to #gst_video_encoder_finish_frame().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="2761">An optional reference @GstVideoCodecState</doc> + line="2777">An optional reference @GstVideoCodecState</doc> <type name="VideoCodecState" c:type="GstVideoCodecState*"/> </parameter> </parameters> @@ -11510,7 +11528,7 @@ from the next call to #gst_video_encoder_finish_frame().</doc> version="1.14"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3071">Configures @encoder to handle Quality-of-Service events from downstream.</doc> + line="3087">Configures @encoder to handle Quality-of-Service events from downstream.</doc> <source-position filename="gst-libs/gst/video/gstvideoencoder.h" line="376"/> <return-value transfer-ownership="none"> @@ -11520,13 +11538,13 @@ from the next call to #gst_video_encoder_finish_frame().</doc> <instance-parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3073">the encoder</doc> + line="3089">the encoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </instance-parameter> <parameter name="enabled" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="3074">the new qos value.</doc> + line="3090">the new qos value.</doc> <type name="gboolean" c:type="gboolean"/> </parameter> </parameters> @@ -11537,7 +11555,7 @@ from the next call to #gst_video_encoder_finish_frame().</doc> transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="406">Minimum interval between force-keyunit requests in nanoseconds. See + line="410">Minimum interval between force-keyunit requests in nanoseconds. See gst_video_encoder_set_min_force_key_unit_interval() for more details.</doc> <type name="guint64" c:type="guint64"/> </property> @@ -11780,14 +11798,14 @@ and @get_caps are likely needed as well.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1994">%TRUE if the negotiation succeeded, else %FALSE.</doc> + line="2000">%TRUE if the negotiation succeeded, else %FALSE.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <parameter name="encoder" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideoencoder.c" - line="1988">a #GstVideoEncoder</doc> + line="1994">a #GstVideoEncoder</doc> <type name="VideoEncoder" c:type="GstVideoEncoder*"/> </parameter> </parameters> @@ -12990,25 +13008,41 @@ for details about the layout and packing of these formats in memory.</doc> filename="gst-libs/gst/video/video-format.h" line="131">packed 4:4:4:4 YUV, 12 bits per channel(U-Y-V-A...) (Since: 1.18)</doc> </member> + <member name="nv12_4l4" + value="97" + c:identifier="GST_VIDEO_FORMAT_NV12_4L4" + glib:nick="nv12-4l4"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-format.h" + line="132">NV12 with 4x4 tiles in linear order (Since: 1.18)</doc> + </member> + <member name="nv12_32l32" + value="98" + c:identifier="GST_VIDEO_FORMAT_NV12_32L32" + glib:nick="nv12-32l32"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-format.h" + line="133">NV12 with 32x32 tiles in linear order (Since: 1.18)</doc> + </member> <function name="from_fourcc" c:identifier="gst_video_format_from_fourcc"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6804">Converts a FOURCC value into the corresponding #GstVideoFormat. + line="6815">Converts a FOURCC value into the corresponding #GstVideoFormat. If the FOURCC cannot be represented by #GstVideoFormat, #GST_VIDEO_FORMAT_UNKNOWN is returned.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="552"/> + line="571"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6812">the #GstVideoFormat describing the FOURCC value</doc> + line="6823">the #GstVideoFormat describing the FOURCC value</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> <parameters> <parameter name="fourcc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6806">a FOURCC value representing raw YUV video</doc> + line="6817">a FOURCC value representing raw YUV video</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -13016,13 +13050,13 @@ If the FOURCC cannot be represented by #GstVideoFormat, <function name="from_masks" c:identifier="gst_video_format_from_masks"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6730">Find the #GstVideoFormat for the given parameters.</doc> + line="6741">Find the #GstVideoFormat for the given parameters.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="547"/> + line="566"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6743">a #GstVideoFormat or GST_VIDEO_FORMAT_UNKNOWN when the parameters to + line="6754">a #GstVideoFormat or GST_VIDEO_FORMAT_UNKNOWN when the parameters to not specify a known format.</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> @@ -13030,44 +13064,44 @@ not specify a known format.</doc> <parameter name="depth" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6732">the amount of bits used for a pixel</doc> + line="6743">the amount of bits used for a pixel</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="bpp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6733">the amount of bits used to store a pixel. This value is bigger than + line="6744">the amount of bits used to store a pixel. This value is bigger than @depth</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="endianness" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6735">the endianness of the masks, #G_LITTLE_ENDIAN or #G_BIG_ENDIAN</doc> + line="6746">the endianness of the masks, #G_LITTLE_ENDIAN or #G_BIG_ENDIAN</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="red_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6736">the red mask</doc> + line="6747">the red mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="green_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6737">the green mask</doc> + line="6748">the green mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="blue_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6738">the blue mask</doc> + line="6749">the blue mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="alpha_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6739">the alpha mask, or 0 if no alpha mask</doc> + line="6750">the alpha mask, or 0 if no alpha mask</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -13075,13 +13109,13 @@ not specify a known format.</doc> <function name="from_string" c:identifier="gst_video_format_from_string"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6896">Convert the @format string to its #GstVideoFormat.</doc> + line="6907">Convert the @format string to its #GstVideoFormat.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="555"/> + line="574"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6902">the #GstVideoFormat for @format or GST_VIDEO_FORMAT_UNKNOWN when the + line="6913">the #GstVideoFormat for @format or GST_VIDEO_FORMAT_UNKNOWN when the string is not a known format.</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> @@ -13089,7 +13123,7 @@ string is not a known format.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6898">a format string</doc> + line="6909">a format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -13097,20 +13131,20 @@ string is not a known format.</doc> <function name="get_info" c:identifier="gst_video_format_get_info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6961">Get the #GstVideoFormatInfo for @format</doc> + line="6972">Get the #GstVideoFormatInfo for @format</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="565"/> + line="584"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6967">The #GstVideoFormatInfo for @format.</doc> + line="6978">The #GstVideoFormatInfo for @format.</doc> <type name="VideoFormatInfo" c:type="const GstVideoFormatInfo*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6963">a #GstVideoFormat</doc> + line="6974">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -13120,14 +13154,14 @@ string is not a known format.</doc> version="1.2"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6977">Get the default palette of @format. This the palette used in the pack + line="6988">Get the default palette of @format. This the palette used in the pack function for paletted formats.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="568"/> + line="587"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6985">the default palette of @format or %NULL when + line="6996">the default palette of @format or %NULL when @format does not have a palette.</doc> <type name="gpointer" c:type="gconstpointer"/> </return-value> @@ -13135,7 +13169,7 @@ function for paletted formats.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6979">a #GstVideoFormat</doc> + line="6990">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> <parameter name="size" @@ -13144,7 +13178,7 @@ function for paletted formats.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6980">size of the palette in bytes</doc> + line="6991">size of the palette in bytes</doc> <type name="gsize" c:type="gsize*"/> </parameter> </parameters> @@ -13152,22 +13186,22 @@ function for paletted formats.</doc> <function name="to_fourcc" c:identifier="gst_video_format_to_fourcc"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6920">Converts a #GstVideoFormat value into the corresponding FOURCC. Only + line="6931">Converts a #GstVideoFormat value into the corresponding FOURCC. Only a few YUV formats have corresponding FOURCC values. If @format has no corresponding FOURCC value, 0 is returned.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="558"/> + line="577"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6928">the FOURCC corresponding to @format</doc> + line="6939">the FOURCC corresponding to @format</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6922">a #GstVideoFormat video format</doc> + line="6933">a #GstVideoFormat video format</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -13175,21 +13209,21 @@ no corresponding FOURCC value, 0 is returned.</doc> <function name="to_string" c:identifier="gst_video_format_to_string"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6941">Returns a string containing a descriptive name for + line="6952">Returns a string containing a descriptive name for the #GstVideoFormat if there is one, or NULL otherwise.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="561"/> + line="580"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6948">the name corresponding to @format</doc> + line="6959">the name corresponding to @format</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6943">a #GstVideoFormat video format</doc> + line="6954">a #GstVideoFormat video format</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -13201,14 +13235,14 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> c:type="GstVideoFormatFlags"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="243">The different video flags that a format info can have.</doc> + line="262">The different video flags that a format info can have.</doc> <member name="yuv" value="1" c:identifier="GST_VIDEO_FORMAT_FLAG_YUV" glib:nick="yuv"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="245">The video format is YUV, components are numbered + line="264">The video format is YUV, components are numbered 0=Y, 1=U, 2=V.</doc> </member> <member name="rgb" @@ -13217,7 +13251,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="rgb"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="247">The video format is RGB, components are numbered + line="266">The video format is RGB, components are numbered 0=R, 1=G, 2=B.</doc> </member> <member name="gray" @@ -13226,7 +13260,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="gray"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="249">The video is gray, there is one gray component + line="268">The video is gray, there is one gray component with index 0.</doc> </member> <member name="alpha" @@ -13235,7 +13269,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="alpha"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="251">The video format has an alpha components with + line="270">The video format has an alpha components with the number 3.</doc> </member> <member name="le" @@ -13244,7 +13278,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="le"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="253">The video format has data stored in little + line="272">The video format has data stored in little endianness.</doc> </member> <member name="palette" @@ -13253,7 +13287,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="palette"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="255">The video format has a palette. The palette + line="274">The video format has a palette. The palette is stored in the second plane and indexes are stored in the first plane.</doc> </member> <member name="complex" @@ -13262,7 +13296,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="complex"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="257">The video format has a complex layout that + line="276">The video format has a complex layout that can't be described with the usual information in the #GstVideoFormatInfo.</doc> </member> <member name="unpack" @@ -13271,7 +13305,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="unpack"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="259">This format can be used in a + line="278">This format can be used in a #GstVideoFormatUnpack and #GstVideoFormatPack function.</doc> </member> <member name="tiled" @@ -13280,44 +13314,44 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> glib:nick="tiled"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="261">The format is tiled, there is tiling information + line="280">The format is tiled, there is tiling information in the last plane.</doc> </member> </bitfield> <record name="VideoFormatInfo" c:type="GstVideoFormatInfo"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="389">Information for a video format.</doc> + line="408">Information for a video format.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="454"/> + line="473"/> <field name="format" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="391">#GstVideoFormat</doc> + line="410">#GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </field> <field name="name" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="392">string representation of the format</doc> + line="411">string representation of the format</doc> <type name="utf8" c:type="const gchar*"/> </field> <field name="description" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="393">use readable description of the format</doc> + line="412">use readable description of the format</doc> <type name="utf8" c:type="const gchar*"/> </field> <field name="flags" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="394">#GstVideoFormatFlags</doc> + line="413">#GstVideoFormatFlags</doc> <type name="VideoFormatFlags" c:type="GstVideoFormatFlags"/> </field> <field name="bits" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="395">The number of bits used to pack data items. This can be less than 8 + line="414">The number of bits used to pack data items. This can be less than 8 when multiple pixels are stored in a byte. for values > 8 multiple bytes should be read according to the endianness flag before applying the shift and mask.</doc> @@ -13326,13 +13360,13 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="n_components" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="399">the number of components in the video format.</doc> + line="418">the number of components in the video format.</doc> <type name="guint" c:type="guint"/> </field> <field name="shift" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="400">the number of bits to shift away to get the component data</doc> + line="419">the number of bits to shift away to get the component data</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> </array> @@ -13340,7 +13374,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="depth" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="401">the depth in bits for each component</doc> + line="420">the depth in bits for each component</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> </array> @@ -13348,7 +13382,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="pixel_stride" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="402">the pixel stride of each component. This is the amount of + line="421">the pixel stride of each component. This is the amount of bytes to the pixel immediately to the right. When bits < 8, the stride is expressed in bits. For 24-bit RGB, this would be 3 bytes, for example, while it would be 4 bytes for RGBx or ARGB.</doc> @@ -13359,7 +13393,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="n_planes" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="406">the number of planes for this format. The number of planes can be + line="425">the number of planes for this format. The number of planes can be less than the amount of components when multiple components are packed into one plane.</doc> <type name="guint" c:type="guint"/> @@ -13367,7 +13401,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="plane" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="409">the plane number where a component can be found</doc> + line="428">the plane number where a component can be found</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> </array> @@ -13375,7 +13409,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="poffset" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="410">the offset in the plane where the first pixel of the components + line="429">the offset in the plane where the first pixel of the components can be found.</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> @@ -13384,7 +13418,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="w_sub" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="412">subsampling factor of the width for the component. Use + line="431">subsampling factor of the width for the component. Use GST_VIDEO_SUB_SCALE to scale a width.</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> @@ -13393,7 +13427,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="h_sub" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="414">subsampling factor of the height for the component. Use + line="433">subsampling factor of the height for the component. Use GST_VIDEO_SUB_SCALE to scale a height.</doc> <array zero-terminated="0" fixed-size="4"> <type name="guint" c:type="guint"/> @@ -13402,44 +13436,44 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> <field name="unpack_format" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="416">the format of the unpacked pixels. This format must have the + line="435">the format of the unpacked pixels. This format must have the #GST_VIDEO_FORMAT_FLAG_UNPACK flag set.</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </field> <field name="unpack_func" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="418">an unpack function for this format</doc> + line="437">an unpack function for this format</doc> <type name="VideoFormatUnpack" c:type="GstVideoFormatUnpack"/> </field> <field name="pack_lines" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="419">the amount of lines that will be packed</doc> + line="438">the amount of lines that will be packed</doc> <type name="gint" c:type="gint"/> </field> <field name="pack_func" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="420">an pack function for this format</doc> + line="439">an pack function for this format</doc> <type name="VideoFormatPack" c:type="GstVideoFormatPack"/> </field> <field name="tile_mode" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="421">The tiling mode</doc> + line="440">The tiling mode</doc> <type name="VideoTileMode" c:type="GstVideoTileMode"/> </field> <field name="tile_ws" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="422">The width of a tile, in bytes, represented as a shift</doc> + line="441">The width of a tile, in bytes, represented as a shift</doc> <type name="guint" c:type="guint"/> </field> <field name="tile_hs" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="423">The height of a tile, in bytes, represented as a shift</doc> + line="442">The height of a tile, in bytes, represented as a shift</doc> <type name="guint" c:type="guint"/> </field> <field name="_gst_reserved" readable="0" private="1"> @@ -13452,11 +13486,11 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7005">Fill @components with the number of all the components packed in plane @p + line="7016">Fill @components with the number of all the components packed in plane @p for the format @info. A value of -1 in @components indicates that no more components are packed in the plane.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="542"/> + line="561"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -13464,13 +13498,13 @@ components are packed in the plane.</doc> <instance-parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7007">#GstVideoFormatInfo</doc> + line="7018">#GstVideoFormatInfo</doc> <type name="VideoFormatInfo" c:type="const GstVideoFormatInfo*"/> </instance-parameter> <parameter name="plane" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7008">a plane number</doc> + line="7019">a plane number</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="components" @@ -13479,7 +13513,7 @@ components are packed in the plane.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7009">array used to store component numbers</doc> + line="7020">array used to store component numbers</doc> <type name="gint" c:type="gint*"/> </parameter> </parameters> @@ -13488,7 +13522,7 @@ components are packed in the plane.</doc> <callback name="VideoFormatPack" c:type="GstVideoFormatPack"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="349">Packs @width pixels from @src to the given planes and strides in the + line="368">Packs @width pixels from @src to the given planes and strides in the format @info. The pixels from source have each component interleaved and will be packed into the planes in @data. @@ -13505,7 +13539,7 @@ pack pixels starting from an unaligned position. For tiled images this means that packing should start from a tile coordinate. For subsampled formats this means that a complete pixel needs to be packed.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="381"/> + line="400"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -13513,13 +13547,13 @@ formats this means that a complete pixel needs to be packed.</doc> <parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="351">a #GstVideoFormatInfo</doc> + line="370">a #GstVideoFormatInfo</doc> <type name="VideoFormatInfo" c:type="const GstVideoFormatInfo*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="352">flags to control the packing</doc> + line="371">flags to control the packing</doc> <type name="VideoPackFlags" c:type="GstVideoPackFlags"/> </parameter> <parameter name="src" @@ -13528,13 +13562,13 @@ formats this means that a complete pixel needs to be packed.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="353">a source array</doc> + line="372">a source array</doc> <type name="gpointer" c:type="const gpointer"/> </parameter> <parameter name="sstride" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="354">the source array stride</doc> + line="373">the source array stride</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="data" @@ -13543,31 +13577,31 @@ formats this means that a complete pixel needs to be packed.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="355">pointers to the destination data planes</doc> + line="374">pointers to the destination data planes</doc> <type name="gpointer" c:type="gpointer*"/> </parameter> <parameter name="stride" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="356">strides of the destination planes</doc> + line="375">strides of the destination planes</doc> <type name="gint" c:type="const gint*"/> </parameter> <parameter name="chroma_site" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="357">the chroma siting of the target when subsampled (not used)</doc> + line="376">the chroma siting of the target when subsampled (not used)</doc> <type name="VideoChromaSite" c:type="GstVideoChromaSite"/> </parameter> <parameter name="y" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="358">the y position in the image to pack to</doc> + line="377">the y position in the image to pack to</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="width" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="359">the amount of pixels to pack.</doc> + line="378">the amount of pixels to pack.</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -13575,7 +13609,7 @@ formats this means that a complete pixel needs to be packed.</doc> <callback name="VideoFormatUnpack" c:type="GstVideoFormatUnpack"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="319">Unpacks @width pixels from the given planes and strides containing data of + line="338">Unpacks @width pixels from the given planes and strides containing data of format @info. The pixels will be unpacked into @dest with each component interleaved as per @info's unpack_format, which will usually be one of #GST_VIDEO_FORMAT_ARGB, #GST_VIDEO_FORMAT_AYUV, #GST_VIDEO_FORMAT_ARGB64 or @@ -13589,7 +13623,7 @@ For subsampled formats, the components will be duplicated in the destination array. Reconstruction of the missing components can be performed in a separate step after unpacking.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="344"/> + line="363"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -13597,13 +13631,13 @@ separate step after unpacking.</doc> <parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="321">a #GstVideoFormatInfo</doc> + line="340">a #GstVideoFormatInfo</doc> <type name="VideoFormatInfo" c:type="const GstVideoFormatInfo*"/> </parameter> <parameter name="flags" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="322">flags to control the unpacking</doc> + line="341">flags to control the unpacking</doc> <type name="VideoPackFlags" c:type="GstVideoPackFlags"/> </parameter> <parameter name="dest" @@ -13612,7 +13646,7 @@ separate step after unpacking.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="323">a destination array</doc> + line="342">a destination array</doc> <type name="gpointer" c:type="gpointer"/> </parameter> <parameter name="data" @@ -13621,31 +13655,31 @@ separate step after unpacking.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="324">pointers to the data planes</doc> + line="343">pointers to the data planes</doc> <type name="gpointer" c:type="const gpointer*"/> </parameter> <parameter name="stride" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="325">strides of the planes</doc> + line="344">strides of the planes</doc> <type name="gint" c:type="const gint*"/> </parameter> <parameter name="x" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="326">the x position in the image to start from</doc> + line="345">the x position in the image to start from</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="y" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="327">the y position in the image to start from</doc> + line="346">the y position in the image to start from</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="width" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="328">the amount of pixels to unpack.</doc> + line="347">the amount of pixels to unpack.</doc> <type name="gint" c:type="gint"/> </parameter> </parameters> @@ -13710,13 +13744,16 @@ separate step after unpacking.</doc> <method name="copy" c:identifier="gst_video_frame_copy"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-frame.c" - line="394">Copy the contents from @src to @dest.</doc> + line="394">Copy the contents from @src to @dest. + +Note: Since: 1.18, @dest dimensions are allowed to be +smaller than @src dimensions.</doc> <source-position filename="gst-libs/gst/video/video-frame.h" line="108"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-frame.c" - line="401">TRUE if the contents could be copied.</doc> + line="404">TRUE if the contents could be copied.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> @@ -14410,7 +14447,7 @@ gst_video_info_init().</doc> <method name="align" c:identifier="gst_video_info_align"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1413">Adjust the offset and stride fields in @info so that the padding and + line="1432">Adjust the offset and stride fields in @info so that the padding and stride alignment in @align is respected. Extra padding will be added to the right side when stride alignment padding @@ -14420,7 +14457,7 @@ is required and @align will be updated with the new padding values.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1424">%FALSE if alignment could not be applied, e.g. because the + line="1443">%FALSE if alignment could not be applied, e.g. because the size of a frame can't be represented as a 32 bit integer (Since: 1.12)</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -14428,13 +14465,13 @@ is required and @align will be updated with the new padding values.</doc> <instance-parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1415">a #GstVideoInfo</doc> + line="1434">a #GstVideoInfo</doc> <type name="VideoInfo" c:type="GstVideoInfo*"/> </instance-parameter> <parameter name="align" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1416">alignment parameters</doc> + line="1435">alignment parameters</doc> <type name="VideoAlignment" c:type="GstVideoAlignment*"/> </parameter> </parameters> @@ -14444,7 +14481,7 @@ is required and @align will be updated with the new padding values.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1293">This variant of gst_video_info_align() provides the updated size, in bytes, + line="1312">This variant of gst_video_info_align() provides the updated size, in bytes, of each video plane after the alignment, including all horizontal and vertical paddings. @@ -14455,7 +14492,7 @@ ones used to hold a single field, not the full frame.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1306">%FALSE if alignment could not be applied, e.g. because the + line="1325">%FALSE if alignment could not be applied, e.g. because the size of a frame can't be represented as a 32 bit integer</doc> <type name="gboolean" c:type="gboolean"/> </return-value> @@ -14463,13 +14500,13 @@ ones used to hold a single field, not the full frame.</doc> <instance-parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1295">a #GstVideoInfo</doc> + line="1314">a #GstVideoInfo</doc> <type name="VideoInfo" c:type="GstVideoInfo*"/> </instance-parameter> <parameter name="align" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1296">alignment parameters</doc> + line="1315">alignment parameters</doc> <type name="VideoAlignment" c:type="GstVideoAlignment*"/> </parameter> <parameter name="plane_size" @@ -14480,7 +14517,7 @@ ones used to hold a single field, not the full frame.</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1297">array used to store the plane sizes</doc> + line="1316">array used to store the plane sizes</doc> <type name="gsize" c:type="gsize*"/> </parameter> </parameters> @@ -14488,7 +14525,7 @@ ones used to hold a single field, not the full frame.</doc> <method name="convert" c:identifier="gst_video_info_convert"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1167">Converts among various #GstFormat types. This function handles + line="1186">Converts among various #GstFormat types. This function handles GST_FORMAT_BYTES, GST_FORMAT_TIME, and GST_FORMAT_DEFAULT. For raw video, GST_FORMAT_DEFAULT corresponds to video frames. This function can be used to handle pad queries of the type GST_QUERY_CONVERT.</doc> @@ -14497,32 +14534,32 @@ function can be used to handle pad queries of the type GST_QUERY_CONVERT.</doc> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1180">TRUE if the conversion was successful.</doc> + line="1199">TRUE if the conversion was successful.</doc> <type name="gboolean" c:type="gboolean"/> </return-value> <parameters> <instance-parameter name="info" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1169">a #GstVideoInfo</doc> + line="1188">a #GstVideoInfo</doc> <type name="VideoInfo" c:type="GstVideoInfo*"/> </instance-parameter> <parameter name="src_format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1170">#GstFormat of the @src_value</doc> + line="1189">#GstFormat of the @src_value</doc> <type name="Gst.Format" c:type="GstFormat"/> </parameter> <parameter name="src_value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1171">value to convert</doc> + line="1190">value to convert</doc> <type name="gint64" c:type="gint64"/> </parameter> <parameter name="dest_format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1172">#GstFormat of the @dest_value</doc> + line="1191">#GstFormat of the @dest_value</doc> <type name="Gst.Format" c:type="GstFormat"/> </parameter> <parameter name="dest_value" @@ -14531,7 +14568,7 @@ function can be used to handle pad queries of the type GST_QUERY_CONVERT.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-info.c" - line="1173">pointer to destination value</doc> + line="1192">pointer to destination value</doc> <type name="gint64" c:type="gint64*"/> </parameter> </parameters> @@ -14820,7 +14857,7 @@ mode of the stream.</doc> line="68">1 field is stored in one buffer, @GST_VIDEO_BUFFER_FLAG_TF or @GST_VIDEO_BUFFER_FLAG_BF indicates if the buffer is carrying the top or bottom field, respectively. The top and - bottom buffers are expected to alternate in the pipeline, with this mode + bottom buffers must alternate in the pipeline, with this mode (Since: 1.16).</doc> </member> <function name="from_string" @@ -18341,14 +18378,14 @@ gst_video_overlay_composition_copy().</doc> c:type="GstVideoPackFlags"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="298">The different flags that can be used when packing and unpacking.</doc> + line="317">The different flags that can be used when packing and unpacking.</doc> <member name="none" value="0" c:identifier="GST_VIDEO_PACK_FLAG_NONE" glib:nick="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="300">No flag</doc> + line="319">No flag</doc> </member> <member name="truncate_range" value="1" @@ -18356,7 +18393,7 @@ gst_video_overlay_composition_copy().</doc> glib:nick="truncate-range"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="301">When the source has a smaller depth + line="320">When the source has a smaller depth than the target format, set the least significant bits of the target to 0. This is likely slightly faster but less accurate. When this flag is not specified, the most significant bits of the source are duplicated @@ -18368,7 +18405,7 @@ gst_video_overlay_composition_copy().</doc> glib:nick="interlaced"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.h" - line="306">The source is interlaced. The unpacked + line="325">The source is interlaced. The unpacked format will be interlaced as well with each line containing information from alternating fields. (Since: 1.2)</doc> </member> @@ -18443,7 +18480,7 @@ gst_video_overlay_composition_copy().</doc> filename="gst-libs/gst/video/gstvideometa.h" line="304">Extra buffer metadata describing an image region of interest</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="331"/> + line="332"/> <field name="meta" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.h" @@ -18495,7 +18532,8 @@ gst_video_overlay_composition_copy().</doc> <field name="params" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.h" - line="314">list of #GstStructure containing element-specific params for downstream, see gst_video_region_of_interest_meta_add_params(). (Since: 1.14)</doc> + line="314">list of #GstStructure containing element-specific params for downstream, + see gst_video_region_of_interest_meta_add_param(). (Since: 1.14)</doc> <type name="GLib.List" c:type="GList*"> <type name="gpointer" c:type="gpointer"/> </type> @@ -18515,7 +18553,7 @@ QP offsets this encoder should use when encoding the region described in @meta. Multiple parameters can be defined for the same meta so different encoders can be supported by cross platform applications).</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="362"/> + line="363"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -18545,7 +18583,7 @@ or %NULL if there is none.</doc> <doc-version xml:space="preserve"> See also: gst_video_region_of_interest_meta_add_param()</doc-version> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="366"/> + line="367"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -18571,7 +18609,7 @@ See also: gst_video_region_of_interest_meta_add_param()</doc-version> <function name="get_info" c:identifier="gst_video_region_of_interest_meta_get_info"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="337"/> + line="338"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -19362,6 +19400,14 @@ frames will only be rendered in PLAYING state.</doc> in memory in Z or flipped Z order. In case of odd rows, the last row of blocks is arranged in linear order.</doc> </member> + <member name="linear" + value="131072" + c:identifier="GST_VIDEO_TILE_MODE_LINEAR" + glib:nick="linear"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-tile.h" + line="115">Tiles are in row order. (Since: 1.18)</doc> + </member> </enumeration> <enumeration name="VideoTileType" glib:type-name="GstVideoTileType" @@ -20413,28 +20459,28 @@ Will not necessarily correspond to a real timecode (e.g. 00:00:10;00)</doc> version="1.10"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.h" - line="369">Extra buffer metadata describing the GstVideoTimeCode of the frame. + line="370">Extra buffer metadata describing the GstVideoTimeCode of the frame. Each frame is assumed to have its own timecode, i.e. they are not automatically incremented/interpolated.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="385"/> + line="386"/> <field name="meta" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.h" - line="371">parent #GstMeta</doc> + line="372">parent #GstMeta</doc> <type name="Gst.Meta" c:type="GstMeta"/> </field> <field name="tc" writable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.h" - line="372">the GstVideoTimeCode to attach</doc> + line="373">the GstVideoTimeCode to attach</doc> <type name="VideoTimeCode" c:type="GstVideoTimeCode"/> </field> <function name="get_info" c:identifier="gst_video_time_code_meta_get_info"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="392"/> + line="393"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -20446,7 +20492,7 @@ automatically incremented/interpolated.</doc> c:type="GstVideoTransferFunction"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="71">The video transfer function defines the formula for converting between + line="73">The video transfer function defines the formula for converting between non-linear RGB (R'G'B') and linear RGB</doc> <member name="unknown" value="0" @@ -20454,7 +20500,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="unknown"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="73">unknown transfer function</doc> + line="75">unknown transfer function</doc> </member> <member name="gamma10" value="1" @@ -20462,7 +20508,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="gamma10"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="74">linear RGB, gamma 1.0 curve</doc> + line="76">linear RGB, gamma 1.0 curve</doc> </member> <member name="gamma18" value="2" @@ -20470,7 +20516,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="gamma18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="75">Gamma 1.8 curve</doc> + line="77">Gamma 1.8 curve</doc> </member> <member name="gamma20" value="3" @@ -20478,7 +20524,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="gamma20"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="76">Gamma 2.0 curve</doc> + line="78">Gamma 2.0 curve</doc> </member> <member name="gamma22" value="4" @@ -20486,7 +20532,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="gamma22"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="77">Gamma 2.2 curve</doc> + line="79">Gamma 2.2 curve</doc> </member> <member name="bt709" value="5" @@ -20494,8 +20540,9 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="bt709"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="78">Gamma 2.2 curve with a linear segment in the lower - range</doc> + line="80">Gamma 2.2 curve with a linear segment in the lower + range, also ITU-R BT470M / ITU-R BT1700 625 PAL & + SECAM / ITU-R BT1361</doc> </member> <member name="smpte240m" value="6" @@ -20503,7 +20550,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="smpte240m"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="80">Gamma 2.2 curve with a linear segment in the + line="83">Gamma 2.2 curve with a linear segment in the lower range</doc> </member> <member name="srgb" @@ -20512,8 +20559,8 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="srgb"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="82">Gamma 2.4 curve with a linear segment in the lower - range</doc> + line="85">Gamma 2.4 curve with a linear segment in the lower + range. IEC 61966-2-1 (sRGB or sYCC)</doc> </member> <member name="gamma28" value="8" @@ -20521,7 +20568,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="gamma28"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="84">Gamma 2.8 curve</doc> + line="87">Gamma 2.8 curve, also ITU-R BT470BG</doc> </member> <member name="log100" value="9" @@ -20529,7 +20576,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="log100"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="85">Logarithmic transfer characteristic + line="88">Logarithmic transfer characteristic 100:1 range</doc> </member> <member name="log316" @@ -20538,8 +20585,8 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="log316"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="87">Logarithmic transfer characteristic - 316.22777:1 range</doc> + line="90">Logarithmic transfer characteristic + 316.22777:1 range (100 * sqrt(10) : 1)</doc> </member> <member name="bt2020_12" value="11" @@ -20547,7 +20594,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="bt2020-12"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="89">Gamma 2.2 curve with a linear segment in the lower + line="92">Gamma 2.2 curve with a linear segment in the lower range. Used for BT.2020 with 12 bits per component. Since: 1.6</doc> </member> @@ -20557,7 +20604,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="adobergb"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="92">Gamma 2.19921875. Since: 1.8</doc> + line="95">Gamma 2.19921875. Since: 1.8</doc> </member> <member name="bt2020_10" value="13" @@ -20565,9 +20612,9 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="bt2020-10"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="93">Rec. ITU-R BT.2020-2 with 10 bits per component. + line="96">Rec. ITU-R BT.2020-2 with 10 bits per component. (functionally the same as the values - GST_VIDEO_TRANSFER_BT709 and GST_VIDEO_TRANSFER_BT2020_12). + GST_VIDEO_TRANSFER_BT709 and GST_VIDEO_TRANSFER_BT601). Since: 1.18</doc> </member> <member name="smpte2084" @@ -20576,7 +20623,7 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="smpte2084"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="97">SMPTE ST 2084 for 10, 12, 14, and 16-bit systems. + line="100">SMPTE ST 2084 for 10, 12, 14, and 16-bit systems. Known as perceptual quantization (PQ) Since: 1.18</doc> </member> @@ -20586,10 +20633,123 @@ non-linear RGB (R'G'B') and linear RGB</doc> glib:nick="arib-std-b67"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.h" - line="100">Association of Radio Industries and Businesses (ARIB) + line="103">Association of Radio Industries and Businesses (ARIB) STD-B67 and Rec. ITU-R BT.2100-1 hybrid loggamma (HLG) system Since: 1.18</doc> </member> + <member name="bt601" + value="16" + c:identifier="GST_VIDEO_TRANSFER_BT601" + glib:nick="bt601"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.h" + line="106">also known as SMPTE170M / ITU-R BT1358 525 or 625 / ITU-R BT1700 NTSC + Functionally the same as the values + GST_VIDEO_TRANSFER_BT709, and GST_VIDEO_TRANSFER_BT2020_10. + Since: 1.18</doc> + </member> + <function name="from_iso" + c:identifier="gst_video_transfer_function_from_iso" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="806">Converts the @value to the #GstVideoTransferFunction +The transfer characteristics (TransferCharacteristics) value is +defined by "ISO/IEC 23001-8 Section 7.2 Table 3" +and "ITU-T H.273 Table 3". +"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" + line="287"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="816">the matched #GstVideoTransferFunction</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </return-value> + <parameters> + <parameter name="value" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="808">a ITU-T H.273 transfer characteristics value</doc> + <type name="guint" c:type="guint"/> + </parameter> + </parameters> + </function> + <function name="is_equivalent" + c:identifier="gst_video_transfer_function_is_equivalent" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="920">Returns whether @from_func and @to_func are equivalent. There are cases +(e.g. BT601, BT709, and BT2020_10) where several functions are functionally +identical. In these cases, when doing conversion, we should consider them +as equivalent. Also, BT2020_12 is the same as the aforementioned three for +less than 12 bits per pixel.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" + line="293"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="933">TRUE if @from_func and @to_func can be considered equivalent.</doc> + <type name="gboolean" c:type="gboolean"/> + </return-value> + <parameters> + <parameter name="from_func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="922">#GstVideoTransferFunction to convert from</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + <parameter name="from_bpp" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="923">bits per pixel to convert from</doc> + <type name="guint" c:type="guint"/> + </parameter> + <parameter name="to_func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="924">#GstVideoTransferFunction to convert into</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + <parameter name="to_bpp" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="925">bits per pixel to convert into</doc> + <type name="guint" c:type="guint"/> + </parameter> + </parameters> + </function> + <function name="to_iso" + c:identifier="gst_video_transfer_function_to_iso" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="671">Converts #GstVideoTransferFunction to the "transfer characteristics" +(TransferCharacteristics) value defined by "ISO/IEC 23001-8 Section 7.2 Table 3" +and "ITU-T H.273 Table 3". +"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" + line="278"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="680">The value of ISO/IEC 23001-8 transfer characteristics.</doc> + <type name="guint" c:type="guint"/> + </return-value> + <parameters> + <parameter name="func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="673">a #GstVideoTransferFunction</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + </parameters> + </function> </enumeration> <record name="VideoVBIEncoder" c:type="GstVideoVBIEncoder" @@ -20599,16 +20759,16 @@ non-linear RGB (R'G'B') and linear RGB</doc> c:symbol-prefix="video_vbi_encoder"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="480">An encoder for writing ancillary data to the + line="468">An encoder for writing ancillary data to the Vertical Blanking Interval lines of component signals.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="489"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="477"/> <constructor name="new" c:identifier="gst_video_vbi_encoder_new" version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="612">Create a new #GstVideoVBIEncoder for the specified @format and @pixel_width.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="495"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="483"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -20640,7 +20800,7 @@ is not supported.</doc> Note that the contents of the data are always read as 8bit data (i.e. do not contain the parity check bits).</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="504"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="492"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -20692,7 +20852,7 @@ the parity check bits).</doc> </parameters> </method> <method name="copy" c:identifier="gst_video_vbi_encoder_copy"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="498"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="486"/> <return-value transfer-ownership="full"> <type name="VideoVBIEncoder" c:type="GstVideoVBIEncoder*"/> </return-value> @@ -20708,7 +20868,7 @@ the parity check bits).</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="595">Frees the @encoder.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="501"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="489"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -20723,7 +20883,7 @@ the parity check bits).</doc> </method> <method name="write_line" c:identifier="gst_video_vbi_encoder_write_line"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="512"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="500"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -20745,16 +20905,16 @@ the parity check bits).</doc> c:symbol-prefix="video_vbi_parser"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="434">A parser for detecting and extracting @GstVideoAncillary data from + line="422">A parser for detecting and extracting @GstVideoAncillary data from Vertical Blanking Interval lines of component signals.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="443"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="431"/> <constructor name="new" c:identifier="gst_video_vbi_parser_new" version="1.16"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="331">Create a new #GstVideoVBIParser for the specified @format and @pixel_width.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="469"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="457"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -20784,7 +20944,7 @@ is not supported.</doc> filename="gst-libs/gst/video/video-anc.c" line="534">Provide a new line of data to the @parser. Call gst_video_vbi_parser_get_ancillary() to get the Ancillary data that might be present on that line.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="478"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="466"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -20806,7 +20966,7 @@ to get the Ancillary data that might be present on that line.</doc> </parameters> </method> <method name="copy" c:identifier="gst_video_vbi_parser_copy"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="472"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="460"/> <return-value transfer-ownership="full"> <type name="VideoVBIParser" c:type="GstVideoVBIParser*"/> </return-value> @@ -20822,7 +20982,7 @@ to get the Ancillary data that might be present on that line.</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="385">Frees the @parser.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="475"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="463"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -20841,7 +21001,7 @@ to get the Ancillary data that might be present on that line.</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="305">Parse the line provided previously by gst_video_vbi_parser_add_line().</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="465"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="453"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -20876,14 +21036,14 @@ data.</doc> c:type="GstVideoVBIParserResult"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="448">Return values for #GstVideoVBIParser</doc> + line="436">Return values for #GstVideoVBIParser</doc> <member name="done" value="0" c:identifier="GST_VIDEO_VBI_PARSER_RESULT_DONE" glib:nick="done"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="450">No line were provided, or no more Ancillary data was found.</doc> + line="438">No line were provided, or no more Ancillary data was found.</doc> </member> <member name="ok" value="1" @@ -20891,7 +21051,7 @@ data.</doc> glib:nick="ok"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="451">A #GstVideoAncillary was found.</doc> + line="439">A #GstVideoAncillary was found.</doc> </member> <member name="error" value="2" @@ -20899,7 +21059,7 @@ data.</doc> glib:nick="error"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="452">An error occurred</doc> + line="440">An error occurred</doc> </member> </enumeration> <function name="buffer_add_video_afd_meta" @@ -20907,38 +21067,38 @@ data.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1182">Attaches #GstVideoAFDMeta metadata to @buffer with the given + line="1229">Attaches #GstVideoAFDMeta metadata to @buffer with the given parameters.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="267"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="265"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1192">the #GstVideoAFDMeta on @buffer.</doc> + line="1239">the #GstVideoAFDMeta on @buffer.</doc> <type name="VideoAFDMeta" c:type="GstVideoAFDMeta*"/> </return-value> <parameters> <parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1184">a #GstBuffer</doc> + line="1231">a #GstBuffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1185">0 for progressive or field 1 and 1 for field 2</doc> + line="1232">0 for progressive or field 1 and 1 for field 2</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="spec" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1186">#GstVideoAFDSpec that applies to AFD value</doc> + line="1233">#GstVideoAFDSpec that applies to AFD value</doc> <type name="VideoAFDSpec" c:type="GstVideoAFDSpec"/> </parameter> <parameter name="afd" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1187">#GstVideoAFDValue AFD enumeration</doc> + line="1234">#GstVideoAFDValue AFD enumeration</doc> <type name="VideoAFDValue" c:type="GstVideoAFDValue"/> </parameter> </parameters> @@ -20973,13 +21133,13 @@ the given parameters.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1276">Attaches #GstVideoBarMeta metadata to @buffer with the given + line="1339">Attaches #GstVideoBarMeta metadata to @buffer with the given parameters.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="338"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="326"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1293">the #GstVideoBarMeta on @buffer. + line="1356">the #GstVideoBarMeta on @buffer. See Table 6.11 Bar Data Syntax @@ -20990,25 +21150,25 @@ https://www.atsc.org/wp-content/uploads/2015/03/a_53-Part-4-2009.pdf</doc> <parameter name="buffer" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1278">a #GstBuffer</doc> + line="1341">a #GstBuffer</doc> <type name="Gst.Buffer" c:type="GstBuffer*"/> </parameter> <parameter name="field" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1279">0 for progressive or field 1 and 1 for field 2</doc> + line="1342">0 for progressive or field 1 and 1 for field 2</doc> <type name="guint8" c:type="guint8"/> </parameter> <parameter name="is_letterbox" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1280">if true then bar data specifies letterbox, otherwise pillarbox</doc> + line="1343">if true then bar data specifies letterbox, otherwise pillarbox</doc> <type name="gboolean" c:type="gboolean"/> </parameter> <parameter name="bar_data1" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1281">If @is_letterbox is true, then the value specifies the + line="1344">If @is_letterbox is true, then the value specifies the last line of a horizontal letterbox bar area at top of reconstructed frame. Otherwise, it specifies the last horizontal luminance sample of a vertical pillarbox bar area at the left side of the reconstructed frame</doc> @@ -21017,7 +21177,7 @@ https://www.atsc.org/wp-content/uploads/2015/03/a_53-Part-4-2009.pdf</doc> <parameter name="bar_data2" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" - line="1285">If @is_letterbox is true, then the value specifies the + line="1348">If @is_letterbox is true, then the value specifies the first line of a horizontal letterbox bar area at bottom of reconstructed frame. Otherwise, it specifies the first horizontal luminance sample of a vertical pillarbox bar area at the right side of the reconstructed frame.</doc> @@ -21032,7 +21192,7 @@ https://www.atsc.org/wp-content/uploads/2015/03/a_53-Part-4-2009.pdf</doc> filename="gst-libs/gst/video/video-anc.c" line="1004">Attaches #GstVideoCaptionMeta metadata to @buffer with the given parameters.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="429"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="417"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -21315,7 +21475,7 @@ of @comp.</doc> line="948">Attaches #GstVideoRegionOfInterestMeta metadata to @buffer with the given parameters.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="347"/> + line="348"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -21369,7 +21529,7 @@ parameters.</doc> line="970">Attaches #GstVideoRegionOfInterestMeta metadata to @buffer with the given parameters.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="355"/> + line="356"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -21424,7 +21584,7 @@ parameters.</doc> line="1140">Attaches #GstVideoTimeCodeMeta metadata to @buffer with the given parameters.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="399"/> + line="400"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -21455,7 +21615,7 @@ parameters.</doc> line="1165">Attaches #GstVideoTimeCodeMeta metadata to @buffer with the given parameters.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="404"/> + line="405"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -21533,8 +21693,9 @@ parameters.</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" line="248">Gets the #GstVideoAFDMeta that might be present on @b. + Note: there may be two #GstVideoAFDMeta structs for interlaced video.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="263"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="261"/> <parameters> <parameter name="b"> <doc xml:space="preserve" @@ -21557,12 +21718,15 @@ Note: there may be two #GstVideoAFDMeta structs for interlaced video.</doc> c:identifier="gst_buffer_get_video_bar_meta" version="1.18" introspectable="0"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="314"/> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-anc.h" + line="311">Gets the #GstVideoBarMeta that might be present on @b.</doc> + <source-position filename="gst-libs/gst/video/video-anc.h" line="322"/> <parameters> <parameter name="b"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="319">A #GstBuffer</doc> + line="313">A #GstBuffer</doc> </parameter> </parameters> </function-macro> @@ -21572,13 +21736,13 @@ Note: there may be two #GstVideoAFDMeta structs for interlaced video.</doc> introspectable="0"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="414">Gets the #GstVideoCaptionMeta that might be present on @b.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="425"/> + line="402">Gets the #GstVideoCaptionMeta that might be present on @b.</doc> + <source-position filename="gst-libs/gst/video/video-anc.h" line="413"/> <parameters> <parameter name="b"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.h" - line="416">A #GstBuffer</doc> + line="404">A #GstBuffer</doc> </parameter> </parameters> </function-macro> @@ -21684,7 +21848,7 @@ on @buffer.</doc> c:identifier="gst_buffer_get_video_region_of_interest_meta" introspectable="0"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="340"/> + line="341"/> <parameters> <parameter name="b"> </parameter> @@ -21699,7 +21863,7 @@ on @buffer.</doc> Buffers can contain multiple #GstVideoRegionOfInterestMeta metadata items if multiple regions of interests are marked on a frame.</doc> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="343"/> + line="344"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/gstvideometa.c" @@ -21727,7 +21891,7 @@ no such metadata on @buffer.</doc> c:identifier="gst_buffer_get_video_time_code_meta" introspectable="0"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="395"/> + line="396"/> <parameters> <parameter name="b"> </parameter> @@ -22627,7 +22791,7 @@ of commands passed must be equal to @n_commands.</doc> </function> <function name="video_bar_meta_api_get_type" c:identifier="gst_video_bar_meta_api_get_type"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="308"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="306"/> <return-value transfer-ownership="none"> <type name="GType" c:type="GType"/> </return-value> @@ -22635,7 +22799,7 @@ of commands passed must be equal to @n_commands.</doc> <function name="video_bar_meta_get_info" c:identifier="gst_video_bar_meta_get_info" moved-to="VideoBarMeta.get_info"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="311"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="309"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -22816,7 +22980,7 @@ The return value is FALSE in the case of integer overflow or other error.</doc> </function> <function name="video_caption_meta_api_get_type" c:identifier="gst_video_caption_meta_api_get_type"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="407"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="395"/> <return-value transfer-ownership="none"> <type name="GType" c:type="GType"/> </return-value> @@ -22824,7 +22988,7 @@ The return value is FALSE in the case of integer overflow or other error.</doc> <function name="video_caption_meta_get_info" c:identifier="gst_video_caption_meta_get_info" moved-to="VideoCaptionMeta.get_info"> - <source-position filename="gst-libs/gst/video/video-anc.h" line="411"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="399"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -22837,7 +23001,7 @@ The return value is FALSE in the case of integer overflow or other error.</doc> filename="gst-libs/gst/video/video-anc.c" line="1051">Parses fixed Closed Caption #GstCaps and returns the corresponding caption type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="381"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="369"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -22860,7 +23024,7 @@ type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN.</doc> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" line="1091">Creates new caps corresponding to @type.</doc> - <source-position filename="gst-libs/gst/video/video-anc.h" line="385"/> + <source-position filename="gst-libs/gst/video/video-anc.h" line="373"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-anc.c" @@ -23015,23 +23179,23 @@ performed.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="765">Converts the @value to the #GstVideoColorMatrix + line="769">Converts the @value to the #GstVideoColorMatrix The matrix coefficients (MatrixCoefficients) value is defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="260"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="284"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="775">the matched #GstVideoColorMatrix</doc> + line="779">the matched #GstVideoColorMatrix</doc> <type name="VideoColorMatrix" c:type="GstVideoColorMatrix"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="767">a ITU-T H.273 matrix coefficients value</doc> + line="771">a ITU-T H.273 matrix coefficients value</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -23066,7 +23230,7 @@ and the other way around: G' = Y' - Cb*2*(1-Kb)*Kb/(1-Kr-Kb) - Cr*2*(1-Kr)*Kr/(1-Kr-Kb) B' = Y' + Cb*2*(1-Kb) ]|</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="69"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="71"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -23107,22 +23271,22 @@ and the other way around: version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="634">Converts #GstVideoColorMatrix to the "matrix coefficients" + line="636">Converts #GstVideoColorMatrix to the "matrix coefficients" (MatrixCoefficients) value defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="251"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="275"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="643">The value of ISO/IEC 23001-8 matrix coefficients.</doc> + line="645">The value of ISO/IEC 23001-8 matrix coefficients.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <parameter name="matrix" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="636">a #GstVideoColorMatrix</doc> + line="638">a #GstVideoColorMatrix</doc> <type name="VideoColorMatrix" c:type="GstVideoColorMatrix"/> </parameter> </parameters> @@ -23133,22 +23297,22 @@ and "ITU-T H.273 Table 4". version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="851">Converts the @value to the #GstVideoColorPrimaries + line="856">Converts the @value to the #GstVideoColorPrimaries The colour primaries (ColourPrimaries) value is defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="266"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="290"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="860">the matched #GstVideoColorPrimaries</doc> + line="865">the matched #GstVideoColorPrimaries</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </return-value> <parameters> <parameter name="value" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="853">a ITU-T H.273 colour primaries value</doc> + line="858">a ITU-T H.273 colour primaries value</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -23160,7 +23324,7 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" line="303">Get information about the chromaticity coordinates of @primaries.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="195"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="219"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" @@ -23183,22 +23347,22 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="719">Converts #GstVideoColorPrimaries to the "colour primaries" (ColourPrimaries) + line="723">Converts #GstVideoColorPrimaries to the "colour primaries" (ColourPrimaries) value defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="257"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="281"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="728">The value of ISO/IEC 23001-8 colour primaries.</doc> + line="732">The value of ISO/IEC 23001-8 colour primaries.</doc> <type name="guint" c:type="guint"/> </return-value> <parameters> <parameter name="primaries" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="721">a #GstVideoColorPrimaries</doc> + line="725">a #GstVideoColorPrimaries</doc> <type name="VideoColorPrimaries" c:type="GstVideoColorPrimaries"/> </parameter> </parameters> @@ -23215,7 +23379,7 @@ range [0.0 .. 1.0]. The reverse operation (c[i] * scale[i]) + offset[i] can be used to convert the component values in range [0.0 .. 1.0] back to their representation in @info and @range.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="240"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="264"/> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -23261,7 +23425,7 @@ the component values in range [0.0 .. 1.0] back to their representation in version="1.6"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="513">Convert @val to its gamma decoded value. This is the inverse operation of + line="514">Convert @val to its gamma decoded value. This is the inverse operation of @gst_video_color_transfer_encode(). For a non-linear value L' in the range [0..1], conversion to the linear @@ -23273,25 +23437,25 @@ L is in general performed with a power function like: Depending on @func, different formulas might be applied. Some formulas encode a linear segment in the lower range.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="130"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="145"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="531">the gamme decoded value of @val</doc> + line="532">the gamma decoded value of @val</doc> <type name="gdouble" c:type="gdouble"/> </return-value> <parameters> <parameter name="func" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="515">a #GstVideoTransferFunction</doc> + line="516">a #GstVideoTransferFunction</doc> <type name="VideoTransferFunction" c:type="GstVideoTransferFunction"/> </parameter> <parameter name="val" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="516">a value</doc> + line="517">a value</doc> <type name="gdouble" c:type="gdouble"/> </parameter> </parameters> @@ -23312,11 +23476,11 @@ For a linear value L in the range [0..1], conversion to the non-linear Depending on @func, different formulas might be applied. Some formulas encode a linear segment in the lower range.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="127"/> + <source-position filename="gst-libs/gst/video/video-color.h" line="142"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-color.c" - line="414">the gamme encoded value of @val</doc> + line="414">the gamma encoded value of @val</doc> <type name="gdouble" c:type="gdouble"/> </return-value> <parameters> @@ -23335,58 +23499,6 @@ encode a linear segment in the lower range.</doc> </parameter> </parameters> </function> - <function name="video_color_transfer_from_iso" - c:identifier="gst_video_color_transfer_from_iso" - version="1.18"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="802">Converts the @value to the #GstVideoTransferFunction -The transfer characteristics (TransferCharacteristics) value is -defined by "ISO/IEC 23001-8 Section 7.2 Table 3" -and "ITU-T H.273 Table 3". -"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="263"/> - <return-value transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="812">the matched #GstVideoTransferFunction</doc> - <type name="VideoTransferFunction" c:type="GstVideoTransferFunction"/> - </return-value> - <parameters> - <parameter name="value" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="804">a ITU-T H.273 transfer characteristics value</doc> - <type name="guint" c:type="guint"/> - </parameter> - </parameters> - </function> - <function name="video_color_transfer_to_iso" - c:identifier="gst_video_color_transfer_to_iso" - version="1.18"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="669">Converts #GstVideoTransferFunction to the "transfer characteristics" -(TransferCharacteristics) value defined by "ISO/IEC 23001-8 Section 7.2 Table 3" -and "ITU-T H.273 Table 3". -"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> - <source-position filename="gst-libs/gst/video/video-color.h" line="254"/> - <return-value transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="678">The value of ISO/IEC 23001-8 transfer characteristics.</doc> - <type name="guint" c:type="guint"/> - </return-value> - <parameters> - <parameter name="func" transfer-ownership="none"> - <doc xml:space="preserve" - filename="gst-libs/gst/video/video-color.c" - line="671">a #GstVideoTransferFunction</doc> - <type name="VideoTransferFunction" - c:type="GstVideoTransferFunction"/> - </parameter> - </parameters> - </function> <function name="video_convert_sample" c:identifier="gst_video_convert_sample" throws="1"> @@ -23960,22 +24072,22 @@ Create an upstream force key unit event using gst_video_event_new_upstream_forc moved-to="VideoFormat.from_fourcc"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6804">Converts a FOURCC value into the corresponding #GstVideoFormat. + line="6815">Converts a FOURCC value into the corresponding #GstVideoFormat. If the FOURCC cannot be represented by #GstVideoFormat, #GST_VIDEO_FORMAT_UNKNOWN is returned.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="552"/> + line="571"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6812">the #GstVideoFormat describing the FOURCC value</doc> + line="6823">the #GstVideoFormat describing the FOURCC value</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> <parameters> <parameter name="fourcc" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6806">a FOURCC value representing raw YUV video</doc> + line="6817">a FOURCC value representing raw YUV video</doc> <type name="guint32" c:type="guint32"/> </parameter> </parameters> @@ -23985,13 +24097,13 @@ If the FOURCC cannot be represented by #GstVideoFormat, moved-to="VideoFormat.from_masks"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6730">Find the #GstVideoFormat for the given parameters.</doc> + line="6741">Find the #GstVideoFormat for the given parameters.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="547"/> + line="566"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6743">a #GstVideoFormat or GST_VIDEO_FORMAT_UNKNOWN when the parameters to + line="6754">a #GstVideoFormat or GST_VIDEO_FORMAT_UNKNOWN when the parameters to not specify a known format.</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> @@ -23999,44 +24111,44 @@ not specify a known format.</doc> <parameter name="depth" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6732">the amount of bits used for a pixel</doc> + line="6743">the amount of bits used for a pixel</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="bpp" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6733">the amount of bits used to store a pixel. This value is bigger than + line="6744">the amount of bits used to store a pixel. This value is bigger than @depth</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="endianness" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6735">the endianness of the masks, #G_LITTLE_ENDIAN or #G_BIG_ENDIAN</doc> + line="6746">the endianness of the masks, #G_LITTLE_ENDIAN or #G_BIG_ENDIAN</doc> <type name="gint" c:type="gint"/> </parameter> <parameter name="red_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6736">the red mask</doc> + line="6747">the red mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="green_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6737">the green mask</doc> + line="6748">the green mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="blue_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6738">the blue mask</doc> + line="6749">the blue mask</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="alpha_mask" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6739">the alpha mask, or 0 if no alpha mask</doc> + line="6750">the alpha mask, or 0 if no alpha mask</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -24046,13 +24158,13 @@ not specify a known format.</doc> moved-to="VideoFormat.from_string"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6896">Convert the @format string to its #GstVideoFormat.</doc> + line="6907">Convert the @format string to its #GstVideoFormat.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="555"/> + line="574"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6902">the #GstVideoFormat for @format or GST_VIDEO_FORMAT_UNKNOWN when the + line="6913">the #GstVideoFormat for @format or GST_VIDEO_FORMAT_UNKNOWN when the string is not a known format.</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </return-value> @@ -24060,7 +24172,7 @@ string is not a known format.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6898">a format string</doc> + line="6909">a format string</doc> <type name="utf8" c:type="const gchar*"/> </parameter> </parameters> @@ -24070,20 +24182,20 @@ string is not a known format.</doc> moved-to="VideoFormat.get_info"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6961">Get the #GstVideoFormatInfo for @format</doc> + line="6972">Get the #GstVideoFormatInfo for @format</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="565"/> + line="584"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6967">The #GstVideoFormatInfo for @format.</doc> + line="6978">The #GstVideoFormatInfo for @format.</doc> <type name="VideoFormatInfo" c:type="const GstVideoFormatInfo*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6963">a #GstVideoFormat</doc> + line="6974">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -24094,14 +24206,14 @@ string is not a known format.</doc> version="1.2"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6977">Get the default palette of @format. This the palette used in the pack + line="6988">Get the default palette of @format. This the palette used in the pack function for paletted formats.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="568"/> + line="587"/> <return-value transfer-ownership="none" nullable="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6985">the default palette of @format or %NULL when + line="6996">the default palette of @format or %NULL when @format does not have a palette.</doc> <type name="gpointer" c:type="gconstpointer"/> </return-value> @@ -24109,7 +24221,7 @@ function for paletted formats.</doc> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6979">a #GstVideoFormat</doc> + line="6990">a #GstVideoFormat</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> <parameter name="size" @@ -24118,7 +24230,7 @@ function for paletted formats.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6980">size of the palette in bytes</doc> + line="6991">size of the palette in bytes</doc> <type name="gsize" c:type="gsize*"/> </parameter> </parameters> @@ -24128,22 +24240,22 @@ function for paletted formats.</doc> moved-to="VideoFormat.to_fourcc"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6920">Converts a #GstVideoFormat value into the corresponding FOURCC. Only + line="6931">Converts a #GstVideoFormat value into the corresponding FOURCC. Only a few YUV formats have corresponding FOURCC values. If @format has no corresponding FOURCC value, 0 is returned.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="558"/> + line="577"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6928">the FOURCC corresponding to @format</doc> + line="6939">the FOURCC corresponding to @format</doc> <type name="guint32" c:type="guint32"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6922">a #GstVideoFormat video format</doc> + line="6933">a #GstVideoFormat video format</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -24153,21 +24265,21 @@ no corresponding FOURCC value, 0 is returned.</doc> moved-to="VideoFormat.to_string"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6941">Returns a string containing a descriptive name for + line="6952">Returns a string containing a descriptive name for the #GstVideoFormat if there is one, or NULL otherwise.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="561"/> + line="580"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6948">the name corresponding to @format</doc> + line="6959">the name corresponding to @format</doc> <type name="utf8" c:type="const gchar*"/> </return-value> <parameters> <parameter name="format" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="6943">a #GstVideoFormat video format</doc> + line="6954">a #GstVideoFormat video format</doc> <type name="VideoFormat" c:type="GstVideoFormat"/> </parameter> </parameters> @@ -24177,13 +24289,13 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7073">Return all the raw video formats supported by GStreamer.</doc> + line="7084">Return all the raw video formats supported by GStreamer.</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="627"/> + line="646"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7079">an array of #GstVideoFormat</doc> + line="7090">an array of #GstVideoFormat</doc> <array length="0" zero-terminated="0" c:type="const GstVideoFormat*"> <type name="VideoFormat" c:type="GstVideoFormat"/> </array> @@ -24195,7 +24307,7 @@ the #GstVideoFormat if there is one, or NULL otherwise.</doc> transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7075">the number of elements in the returned array</doc> + line="7086">the number of elements in the returned array</doc> <type name="guint" c:type="guint*"/> </parameter> </parameters> @@ -24322,15 +24434,15 @@ recognised, and %FALSE otherwise.</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7097">Return a generic raw video caps for formats defined in @formats. + line="7108">Return a generic raw video caps for formats defined in @formats. If @formats is %NULL returns a caps for all the supported raw video formats, see gst_video_formats_raw().</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="662"/> + line="681"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7106">a video @GstCaps</doc> + line="7117">a video @GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> @@ -24340,7 +24452,7 @@ see gst_video_formats_raw().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7099">an array of raw #GstVideoFormat, or %NULL</doc> + line="7110">an array of raw #GstVideoFormat, or %NULL</doc> <array length="1" zero-terminated="0" c:type="const GstVideoFormat*"> <type name="VideoFormat" c:type="GstVideoFormat"/> </array> @@ -24348,7 +24460,7 @@ see gst_video_formats_raw().</doc> <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7100">the size of @formats</doc> + line="7111">the size of @formats</doc> <type name="guint" c:type="guint"/> </parameter> </parameters> @@ -24358,16 +24470,16 @@ see gst_video_formats_raw().</doc> version="1.18"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7115">Return a generic raw video caps for formats defined in @formats with features + line="7126">Return a generic raw video caps for formats defined in @formats with features @features. If @formats is %NULL returns a caps for all the supported video formats, see gst_video_formats_raw().</doc> <source-position filename="gst-libs/gst/video/video-format.h" - line="665"/> + line="684"/> <return-value transfer-ownership="full"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7126">a video @GstCaps</doc> + line="7137">a video @GstCaps</doc> <type name="Gst.Caps" c:type="GstCaps*"/> </return-value> <parameters> @@ -24377,7 +24489,7 @@ see gst_video_formats_raw().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7117">an array of raw #GstVideoFormat, or %NULL</doc> + line="7128">an array of raw #GstVideoFormat, or %NULL</doc> <array length="1" zero-terminated="0" c:type="const GstVideoFormat*"> <type name="VideoFormat" c:type="GstVideoFormat"/> </array> @@ -24385,7 +24497,7 @@ see gst_video_formats_raw().</doc> <parameter name="len" transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7118">the size of @formats</doc> + line="7129">the size of @formats</doc> <type name="guint" c:type="guint"/> </parameter> <parameter name="features" @@ -24394,7 +24506,7 @@ see gst_video_formats_raw().</doc> allow-none="1"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-format.c" - line="7119">the #GstCapsFeatures to set on the caps</doc> + line="7130">the #GstCapsFeatures to set on the caps</doc> <type name="Gst.CapsFeatures" c:type="GstCapsFeatures*"/> </parameter> </parameters> @@ -24773,7 +24885,7 @@ gst_video_overlay_set_render_rectangle().</doc> <function name="video_region_of_interest_meta_api_get_type" c:identifier="gst_video_region_of_interest_meta_api_get_type"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="334"/> + line="335"/> <return-value transfer-ownership="none"> <type name="GType" c:type="GType"/> </return-value> @@ -24782,7 +24894,7 @@ gst_video_overlay_set_render_rectangle().</doc> c:identifier="gst_video_region_of_interest_meta_get_info" moved-to="VideoRegionOfInterestMeta.get_info"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="337"/> + line="338"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> @@ -24857,7 +24969,7 @@ on the @method and @in_size/@out_size.</doc> image of @x_tiles by @y_tiles. Use this method when @mode is of type %GST_VIDEO_TILE_TYPE_INDEXED.</doc> - <source-position filename="gst-libs/gst/video/video-tile.h" line="125"/> + <source-position filename="gst-libs/gst/video/video-tile.h" line="134"/> <return-value transfer-ownership="none"> <doc xml:space="preserve" filename="gst-libs/gst/video/video-tile.c" @@ -24901,7 +25013,7 @@ Use this method when @mode is of type %GST_VIDEO_TILE_TYPE_INDEXED.</doc> <function name="video_time_code_meta_api_get_type" c:identifier="gst_video_time_code_meta_api_get_type"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="388"/> + line="389"/> <return-value transfer-ownership="none"> <type name="GType" c:type="GType"/> </return-value> @@ -24910,10 +25022,111 @@ Use this method when @mode is of type %GST_VIDEO_TILE_TYPE_INDEXED.</doc> c:identifier="gst_video_time_code_meta_get_info" moved-to="VideoTimeCodeMeta.get_info"> <source-position filename="gst-libs/gst/video/gstvideometa.h" - line="392"/> + line="393"/> <return-value transfer-ownership="none"> <type name="Gst.MetaInfo" c:type="const GstMetaInfo*"/> </return-value> </function> + <function name="video_transfer_function_from_iso" + c:identifier="gst_video_transfer_function_from_iso" + moved-to="VideoTransferFunction.from_iso" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="806">Converts the @value to the #GstVideoTransferFunction +The transfer characteristics (TransferCharacteristics) value is +defined by "ISO/IEC 23001-8 Section 7.2 Table 3" +and "ITU-T H.273 Table 3". +"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" line="287"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="816">the matched #GstVideoTransferFunction</doc> + <type name="VideoTransferFunction" c:type="GstVideoTransferFunction"/> + </return-value> + <parameters> + <parameter name="value" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="808">a ITU-T H.273 transfer characteristics value</doc> + <type name="guint" c:type="guint"/> + </parameter> + </parameters> + </function> + <function name="video_transfer_function_is_equivalent" + c:identifier="gst_video_transfer_function_is_equivalent" + moved-to="VideoTransferFunction.is_equivalent" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="920">Returns whether @from_func and @to_func are equivalent. There are cases +(e.g. BT601, BT709, and BT2020_10) where several functions are functionally +identical. In these cases, when doing conversion, we should consider them +as equivalent. Also, BT2020_12 is the same as the aforementioned three for +less than 12 bits per pixel.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" line="293"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="933">TRUE if @from_func and @to_func can be considered equivalent.</doc> + <type name="gboolean" c:type="gboolean"/> + </return-value> + <parameters> + <parameter name="from_func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="922">#GstVideoTransferFunction to convert from</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + <parameter name="from_bpp" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="923">bits per pixel to convert from</doc> + <type name="guint" c:type="guint"/> + </parameter> + <parameter name="to_func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="924">#GstVideoTransferFunction to convert into</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + <parameter name="to_bpp" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="925">bits per pixel to convert into</doc> + <type name="guint" c:type="guint"/> + </parameter> + </parameters> + </function> + <function name="video_transfer_function_to_iso" + c:identifier="gst_video_transfer_function_to_iso" + moved-to="VideoTransferFunction.to_iso" + version="1.18"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="671">Converts #GstVideoTransferFunction to the "transfer characteristics" +(TransferCharacteristics) value defined by "ISO/IEC 23001-8 Section 7.2 Table 3" +and "ITU-T H.273 Table 3". +"H.264 Table E-4" and "H.265 Table E.4" share the identical values.</doc> + <source-position filename="gst-libs/gst/video/video-color.h" line="278"/> + <return-value transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="680">The value of ISO/IEC 23001-8 transfer characteristics.</doc> + <type name="guint" c:type="guint"/> + </return-value> + <parameters> + <parameter name="func" transfer-ownership="none"> + <doc xml:space="preserve" + filename="gst-libs/gst/video/video-color.c" + line="673">a #GstVideoTransferFunction</doc> + <type name="VideoTransferFunction" + c:type="GstVideoTransferFunction"/> + </parameter> + </parameters> + </function> </namespace> </repository> |