mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-10-05 02:02:26 +00:00
docs: use the gtk-doc syntax to link to properties
Don't use docbook unless needed. Also stip other docbook tags in the the files we fix.
This commit is contained in:
parent
3abad7af66
commit
35da463618
6 changed files with 95 additions and 172 deletions
|
@ -20,34 +20,24 @@
|
||||||
/**
|
/**
|
||||||
* SECTION:element-capssetter
|
* SECTION:element-capssetter
|
||||||
*
|
*
|
||||||
* <refsect2>
|
* Sets or merges caps on a stream's buffers. That is, a buffer's caps are
|
||||||
* <para>
|
* updated using (fields of) #GstCapsSetter:caps. Note that this may contain
|
||||||
* Sets or merges caps on a stream's buffers.
|
* multiple structures (though not likely recommended), but each of these must
|
||||||
* That is, a buffer's caps are updated using (fields of)
|
* be fixed (or will otherwise be rejected).
|
||||||
* <link linkend="GstCapsSetter--caps">caps</link>. Note that this may
|
*
|
||||||
* contain multiple structures (though not likely recommended), but each
|
* If #GstCapsSetter:join is %TRUE, then the incoming caps' mime-type is
|
||||||
* of these must be fixed (or will otherwise be rejected).
|
* compared to the mime-type(s) of provided caps and only matching structure(s)
|
||||||
* </para>
|
* are considered for updating.
|
||||||
* <para>
|
*
|
||||||
* If <link linkend="GstCapsSetter--join">join</link>
|
* If #GstCapsSetter:replace is %TRUE, then any caps update is preceded by
|
||||||
* is TRUE, then the incoming caps' mime-type is compared to the mime-type(s)
|
* clearing existing fields, making provided fields (as a whole) replace
|
||||||
* of provided caps and only matching structure(s) are considered for updating.
|
* incoming ones. Otherwise, no clearing is performed, in which case provided
|
||||||
* </para>
|
* fields are added/merged onto incoming caps
|
||||||
* <para>
|
*
|
||||||
* If <link linkend="GstCapsSetter--replace">replace</link>
|
|
||||||
* is TRUE, then any caps update is preceded by clearing existing fields,
|
|
||||||
* making provided fields (as a whole) replace incoming ones.
|
|
||||||
* Otherwise, no clearing is performed, in which case provided fields are
|
|
||||||
* added/merged onto incoming caps
|
|
||||||
* </para>
|
|
||||||
* <para>
|
|
||||||
* Although this element might mainly serve as debug helper,
|
* Although this element might mainly serve as debug helper,
|
||||||
* it can also practically be used to correct a faulty pixel-aspect-ratio,
|
* it can also practically be used to correct a faulty pixel-aspect-ratio,
|
||||||
* or to modify a yuv fourcc value to effectively swap chroma components or such
|
* or to modify a yuv fourcc value to effectively swap chroma components or such
|
||||||
* alike.
|
* alike.
|
||||||
* </para>
|
|
||||||
* </refsect2>
|
|
||||||
*
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -65,35 +65,21 @@
|
||||||
* The fragmented file features defined (only) in ISO Base Media are used by
|
* The fragmented file features defined (only) in ISO Base Media are used by
|
||||||
* ISMV files making up (a.o.) Smooth Streaming (ismlmux).
|
* ISMV files making up (a.o.) Smooth Streaming (ismlmux).
|
||||||
*
|
*
|
||||||
* A few properties (<link linkend="GstMP4Mux--movie-timescale">movie-timescale</link>,
|
* A few properties (#GstMp4Mux:movie-timescale, #GstMp4Mux:trak-timescale)
|
||||||
* <link linkend="GstMP4Mux--trak-timescale">trak-timescale</link>) allow adjusting
|
* allow adjusting some technical parameters, which might be useful in (rare)
|
||||||
* some technical parameters, which might be useful in (rare) cases to resolve
|
* cases to resolve compatibility issues in some situations.
|
||||||
* compatibility issues in some situations.
|
|
||||||
*
|
*
|
||||||
* Some other properties influence the result more fundamentally.
|
* Some other properties influence the result more fundamentally.
|
||||||
* A typical mov/mp4 file's metadata (aka moov) is located at the end of the file,
|
* A typical mov/mp4 file's metadata (aka moov) is located at the end of the
|
||||||
* somewhat contrary to this usually being called "the header".
|
* file, somewhat contrary to this usually being called "the header".
|
||||||
* However, a <link linkend="GstMP4Mux--faststart">faststart</link> file will
|
* However, a #GstMp4Mux:faststart file will (with some effort) arrange this to
|
||||||
* (with some effort) arrange this to be located near start of the file,
|
* be located near start of the file, which then allows it e.g. to be played
|
||||||
* which then allows it e.g. to be played while downloading.
|
* while downloading. Alternatively, rather than having one chunk of metadata at
|
||||||
* Alternatively, rather than having one chunk of metadata at start (or end),
|
* start (or end), there can be some metadata at start and most of the other
|
||||||
* there can be some metadata at start and most of the other data can be spread
|
* data can be spread out into fragments of #GstMp4Mux:fragment-duration.
|
||||||
* out into fragments of <link linkend="GstMP4Mux--fragment-duration">fragment-duration</link>.
|
|
||||||
* If such fragmented layout is intended for streaming purposes, then
|
* If such fragmented layout is intended for streaming purposes, then
|
||||||
* <link linkend="GstMP4Mux--streamable">streamable</link> allows foregoing to add
|
* #GstMp4Mux:streamable allows foregoing to add index metadata (at the end of
|
||||||
* index metadata (at the end of file).
|
* file).
|
||||||
*
|
|
||||||
* <link linkend="GstMP4Mux--dts-method">dts-method</link> allows selecting a
|
|
||||||
* method for managing input timestamps (stay tuned for 0.11 to have this
|
|
||||||
* automagically settled). The default delta/duration method should handle nice
|
|
||||||
* (aka perfect streams) just fine, but may experience problems otherwise
|
|
||||||
* (e.g. input stream with re-ordered B-frames and/or with frame dropping).
|
|
||||||
* The re-ordering approach re-assigns incoming timestamps in ascending order
|
|
||||||
* to incoming buffers and offers an alternative in such cases. In cases where
|
|
||||||
* that might fail, the remaining method can be tried, which is exact and
|
|
||||||
* according to specs, but might experience playback on not so spec-wise players.
|
|
||||||
* Note that this latter approach also requires one to enable
|
|
||||||
* <link linkend="GstMP4Mux--presentation-timestamp">presentation-timestamp</link>.
|
|
||||||
*
|
*
|
||||||
* <refsect2>
|
* <refsect2>
|
||||||
* <title>Example pipelines</title>
|
* <title>Example pipelines</title>
|
||||||
|
@ -129,35 +115,21 @@
|
||||||
* The fragmented file features defined (only) in ISO Base Media are used by
|
* The fragmented file features defined (only) in ISO Base Media are used by
|
||||||
* ISMV files making up (a.o.) Smooth Streaming (ismlmux).
|
* ISMV files making up (a.o.) Smooth Streaming (ismlmux).
|
||||||
*
|
*
|
||||||
* A few properties (<link linkend="Gst3GPPMux--movie-timescale">movie-timescale</link>,
|
* A few properties (#Gst3GPPMux:movie-timescale, #Gst3GPPMux:trak-timescale)
|
||||||
* <link linkend="Gst3GPPMux--trak-timescale">trak-timescale</link>) allow adjusting
|
* allow adjusting some technical parameters, which might be useful in (rare)
|
||||||
* some technical parameters, which might be useful in (rare) cases to resolve
|
* cases to resolve compatibility issues in some situations.
|
||||||
* compatibility issues in some situations.
|
|
||||||
*
|
*
|
||||||
* Some other properties influence the result more fundamentally.
|
* Some other properties influence the result more fundamentally.
|
||||||
* A typical mov/mp4 file's metadata (aka moov) is located at the end of the file,
|
* A typical mov/mp4 file's metadata (aka moov) is located at the end of the file,
|
||||||
* somewhat contrary to this usually being called "the header".
|
* somewhat contrary to this usually being called "the header". However, a
|
||||||
* However, a <link linkend="Gst3GPPMux--faststart">faststart</link> file will
|
* #Gst3GPPMux:faststart file will (with some effort) arrange this to be located
|
||||||
* (with some effort) arrange this to be located near start of the file,
|
* near start of the file, which then allows it e.g. to be played while
|
||||||
* which then allows it e.g. to be played while downloading.
|
* downloading. Alternatively, rather than having one chunk of metadata at start
|
||||||
* Alternatively, rather than having one chunk of metadata at start (or end),
|
* (or end), there can be some metadata at start and most of the other data can
|
||||||
* there can be some metadata at start and most of the other data can be spread
|
* be spread out into fragments of #Gst3GPPMux:fragment-duration. If such
|
||||||
* out into fragments of <link linkend="Gst3GPPMux--fragment-duration">fragment-duration</link>.
|
* fragmented layout is intended for streaming purposes, then
|
||||||
* If such fragmented layout is intended for streaming purposes, then
|
* #Gst3GPPMux:streamable allows foregoing to add index metadata (at the end of
|
||||||
* <link linkend="Gst3GPPMux--streamable">streamable</link> allows foregoing to add
|
* file).
|
||||||
* index metadata (at the end of file).
|
|
||||||
*
|
|
||||||
* <link linkend="Gst3GPPMux--dts-method">dts-method</link> allows selecting a
|
|
||||||
* method for managing input timestamps (stay tuned for 0.11 to have this
|
|
||||||
* automagically settled). The default delta/duration method should handle nice
|
|
||||||
* (aka perfect streams) just fine, but may experience problems otherwise
|
|
||||||
* (e.g. input stream with re-ordered B-frames and/or with frame dropping).
|
|
||||||
* The re-ordering approach re-assigns incoming timestamps in ascending order
|
|
||||||
* to incoming buffers and offers an alternative in such cases. In cases where
|
|
||||||
* that might fail, the remaining method can be tried, which is exact and
|
|
||||||
* according to specs, but might experience playback on not so spec-wise players.
|
|
||||||
* Note that this latter approach also requires one to enable
|
|
||||||
* <link linkend="Gst3GPPMux--presentation-timestamp">presentation-timestamp</link>.
|
|
||||||
*
|
*
|
||||||
* <refsect2>
|
* <refsect2>
|
||||||
* <title>Example pipelines</title>
|
* <title>Example pipelines</title>
|
||||||
|
@ -193,35 +165,21 @@
|
||||||
* The fragmented file features defined (only) in ISO Base Media are used by
|
* The fragmented file features defined (only) in ISO Base Media are used by
|
||||||
* ISMV files making up (a.o.) Smooth Streaming (ismlmux).
|
* ISMV files making up (a.o.) Smooth Streaming (ismlmux).
|
||||||
*
|
*
|
||||||
* A few properties (<link linkend="GstMJ2Mux--movie-timescale">movie-timescale</link>,
|
* A few properties (#GstMJ2Mux:movie-timescale, #GstMJ2Mux:trak-timescale)
|
||||||
* <link linkend="GstMJ2Mux--trak-timescale">trak-timescale</link>) allow adjusting
|
* allow adjusting some technical parameters, which might be useful in (rare)
|
||||||
* some technical parameters, which might be useful in (rare) cases to resolve
|
* cases to resolve compatibility issues in some situations.
|
||||||
* compatibility issues in some situations.
|
|
||||||
*
|
*
|
||||||
* Some other properties influence the result more fundamentally.
|
* Some other properties influence the result more fundamentally.
|
||||||
* A typical mov/mp4 file's metadata (aka moov) is located at the end of the file,
|
* A typical mov/mp4 file's metadata (aka moov) is located at the end of the file,
|
||||||
* somewhat contrary to this usually being called "the header".
|
* somewhat contrary to this usually being called "the header". However, a
|
||||||
* However, a <link linkend="GstMJ2Mux--faststart">faststart</link> file will
|
* #GstMJ2Mux:faststart file will (with some effort) arrange this to be located
|
||||||
* (with some effort) arrange this to be located near start of the file,
|
* near start of the file, which then allows it e.g. to be played while
|
||||||
* which then allows it e.g. to be played while downloading.
|
* downloading. Alternatively, rather than having one chunk of metadata at start
|
||||||
* Alternatively, rather than having one chunk of metadata at start (or end),
|
* (or end), there can be some metadata at start and most of the other data can
|
||||||
* there can be some metadata at start and most of the other data can be spread
|
* be spread out into fragments of #GstMJ2Mux:fragment-duration. If such
|
||||||
* out into fragments of <link linkend="GstMJ2Mux--fragment-duration">fragment-duration</link>.
|
* fragmented layout is intended for streaming purposes, then
|
||||||
* If such fragmented layout is intended for streaming purposes, then
|
* #GstMJ2Mux:streamable allows foregoing to add index metadata (at the end of
|
||||||
* <link linkend="GstMJ2Mux--streamable">streamable</link> allows foregoing to add
|
* file).
|
||||||
* index metadata (at the end of file).
|
|
||||||
*
|
|
||||||
* <link linkend="GstMJ2Mux--dts-method">dts-method</link> allows selecting a
|
|
||||||
* method for managing input timestamps (stay tuned for 0.11 to have this
|
|
||||||
* automagically settled). The default delta/duration method should handle nice
|
|
||||||
* (aka perfect streams) just fine, but may experience problems otherwise
|
|
||||||
* (e.g. input stream with re-ordered B-frames and/or with frame dropping).
|
|
||||||
* The re-ordering approach re-assigns incoming timestamps in ascending order
|
|
||||||
* to incoming buffers and offers an alternative in such cases. In cases where
|
|
||||||
* that might fail, the remaining method can be tried, which is exact and
|
|
||||||
* according to specs, but might experience playback on not so spec-wise players.
|
|
||||||
* Note that this latter approach also requires one to enable
|
|
||||||
* <link linkend="GstMJ2Mux--presentation-timestamp">presentation-timestamp</link>.
|
|
||||||
*
|
*
|
||||||
* <refsect2>
|
* <refsect2>
|
||||||
* <title>Example pipelines</title>
|
* <title>Example pipelines</title>
|
||||||
|
@ -257,35 +215,21 @@
|
||||||
* The fragmented file features defined (only) in ISO Base Media are used by
|
* The fragmented file features defined (only) in ISO Base Media are used by
|
||||||
* ISMV files making up (a.o.) Smooth Streaming (ismlmux).
|
* ISMV files making up (a.o.) Smooth Streaming (ismlmux).
|
||||||
*
|
*
|
||||||
* A few properties (<link linkend="GstISMLMux--movie-timescale">movie-timescale</link>,
|
* A few properties (#GstISMLMux:movie-timescale, #GstISMLMux:trak-timescale)
|
||||||
* <link linkend="GstISMLMux--trak-timescale">trak-timescale</link>) allow adjusting
|
* allow adjusting some technical parameters, which might be useful in (rare)
|
||||||
* some technical parameters, which might be useful in (rare) cases to resolve
|
* cases to resolve compatibility issues in some situations.
|
||||||
* compatibility issues in some situations.
|
|
||||||
*
|
*
|
||||||
* Some other properties influence the result more fundamentally.
|
* Some other properties influence the result more fundamentally.
|
||||||
* A typical mov/mp4 file's metadata (aka moov) is located at the end of the file,
|
* A typical mov/mp4 file's metadata (aka moov) is located at the end of the file,
|
||||||
* somewhat contrary to this usually being called "the header".
|
* somewhat contrary to this usually being called "the header". However, a
|
||||||
* However, a <link linkend="GstISMLMux--faststart">faststart</link> file will
|
* #GstISMLMux:faststart file will (with some effort) arrange this to be located
|
||||||
* (with some effort) arrange this to be located near start of the file,
|
* near start of the file, which then allows it e.g. to be played while
|
||||||
* which then allows it e.g. to be played while downloading.
|
* downloading. Alternatively, rather than having one chunk of metadata at start
|
||||||
* Alternatively, rather than having one chunk of metadata at start (or end),
|
* (or end), there can be some metadata at start and most of the other data can
|
||||||
* there can be some metadata at start and most of the other data can be spread
|
* be spread out into fragments of #GstISMLMux:fragment-duration. If such
|
||||||
* out into fragments of <link linkend="GstISMLMux--fragment-duration">fragment-duration</link>.
|
* fragmented layout is intended for streaming purposes, then
|
||||||
* If such fragmented layout is intended for streaming purposes, then
|
* #GstISMLMux:streamable allows foregoing to add index metadata (at the end of
|
||||||
* <link linkend="GstISMLMux--streamable">streamable</link> allows foregoing to add
|
* file).
|
||||||
* index metadata (at the end of file).
|
|
||||||
*
|
|
||||||
* <link linkend="GstISMLMux--dts-method">dts-method</link> allows selecting a
|
|
||||||
* method for managing input timestamps (stay tuned for 0.11 to have this
|
|
||||||
* automagically settled). The default delta/duration method should handle nice
|
|
||||||
* (aka perfect streams) just fine, but may experience problems otherwise
|
|
||||||
* (e.g. input stream with re-ordered B-frames and/or with frame dropping).
|
|
||||||
* The re-ordering approach re-assigns incoming timestamps in ascending order
|
|
||||||
* to incoming buffers and offers an alternative in such cases. In cases where
|
|
||||||
* that might fail, the remaining method can be tried, which is exact and
|
|
||||||
* according to specs, but might experience playback on not so spec-wise players.
|
|
||||||
* Note that this latter approach also requires one to enable
|
|
||||||
* <link linkend="GstISMLMux--presentation-timestamp">presentation-timestamp</link>.
|
|
||||||
*
|
*
|
||||||
* <refsect2>
|
* <refsect2>
|
||||||
* <title>Example pipelines</title>
|
* <title>Example pipelines</title>
|
||||||
|
|
|
@ -64,23 +64,21 @@
|
||||||
* The fragmented file features defined (only) in ISO Base Media are used by
|
* The fragmented file features defined (only) in ISO Base Media are used by
|
||||||
* ISMV files making up (a.o.) Smooth Streaming (ismlmux).
|
* ISMV files making up (a.o.) Smooth Streaming (ismlmux).
|
||||||
*
|
*
|
||||||
* A few properties (<link linkend="GstQTMux--movie-timescale">movie-timescale</link>,
|
* A few properties (#GstQTMux:movie-timescale, #GstQTMux:trak-timescale) allow
|
||||||
* <link linkend="GstQTMux--trak-timescale">trak-timescale</link>) allow adjusting
|
* adjusting some technical parameters, which might be useful in (rare) cases to
|
||||||
* some technical parameters, which might be useful in (rare) cases to resolve
|
* resolve compatibility issues in some situations.
|
||||||
* compatibility issues in some situations.
|
|
||||||
*
|
*
|
||||||
* Some other properties influence the result more fundamentally.
|
* Some other properties influence the result more fundamentally.
|
||||||
* A typical mov/mp4 file's metadata (aka moov) is located at the end of the file,
|
* A typical mov/mp4 file's metadata (aka moov) is located at the end of the
|
||||||
* somewhat contrary to this usually being called "the header".
|
* file, somewhat contrary to this usually being called "the header".
|
||||||
* However, a <link linkend="GstQTMux--faststart">faststart</link> file will
|
* However, a #GstQTMux:faststart file will (with some effort) arrange this to
|
||||||
* (with some effort) arrange this to be located near start of the file,
|
* be located near start of the file, which then allows it e.g. to be played
|
||||||
* which then allows it e.g. to be played while downloading.
|
* while downloading. Alternatively, rather than having one chunk of metadata at
|
||||||
* Alternatively, rather than having one chunk of metadata at start (or end),
|
* start (or end), there can be some metadata at start and most of the other
|
||||||
* there can be some metadata at start and most of the other data can be spread
|
* data can be spread out into fragments of #GstQTMux:fragment-duration.
|
||||||
* out into fragments of <link linkend="GstQTMux--fragment-duration">fragment-duration</link>.
|
|
||||||
* If such fragmented layout is intended for streaming purposes, then
|
* If such fragmented layout is intended for streaming purposes, then
|
||||||
* <link linkend="GstQTMux--streamable">streamable</link> allows foregoing to add
|
* #GstQTMux:streamable allows foregoing to add index metadata (at the end of
|
||||||
* index metadata (at the end of file).
|
* file).
|
||||||
*
|
*
|
||||||
* <refsect2>
|
* <refsect2>
|
||||||
* <title>Example pipelines</title>
|
* <title>Example pipelines</title>
|
||||||
|
|
|
@ -76,12 +76,10 @@
|
||||||
* #GValueArray of #gdouble
|
* #GValueArray of #gdouble
|
||||||
* <classname>"decay"</classname>:
|
* <classname>"decay"</classname>:
|
||||||
* the decaying peak power level in dB for each channel
|
* the decaying peak power level in dB for each channel
|
||||||
* the decaying peak level follows the peak level, but starts dropping
|
* The decaying peak level follows the peak level, but starts dropping if no
|
||||||
* if no new peak is reached after the time given by
|
* new peak is reached after the time given by the #GstLevel:peak-ttl.
|
||||||
* the <link linkend="GstLevel--peak-ttl">the time to live</link>.
|
* When the decaying peak level drops, it does so at the decay rate as
|
||||||
* When the decaying peak level drops, it does so at the decay rate
|
* specified by the #GstLevel:peak-falloff.
|
||||||
* as specified by the
|
|
||||||
* <link linkend="GstLevel--peak-falloff">the peak falloff rate</link>.
|
|
||||||
* </para>
|
* </para>
|
||||||
* </listitem>
|
* </listitem>
|
||||||
* <listitem>
|
* <listitem>
|
||||||
|
|
|
@ -39,9 +39,9 @@
|
||||||
* their output since they generally save metadata in the file header.
|
* their output since they generally save metadata in the file header.
|
||||||
* Therefore, it is often necessary that applications read the results in a bus
|
* Therefore, it is often necessary that applications read the results in a bus
|
||||||
* event handler for the tag message. Obtaining the values this way is always
|
* event handler for the tag message. Obtaining the values this way is always
|
||||||
* needed for <link linkend="GstRgAnalysis--num-tracks">album processing</link>
|
* needed for album processing (see #GstRgAnalysis:num-tracks property) since
|
||||||
* since the album gain and peak values need to be associated with all tracks of
|
* the album gain and peak values need to be associated with all tracks of an
|
||||||
* an album, not just the last one.
|
* album, not just the last one.
|
||||||
*
|
*
|
||||||
* <refsect2>
|
* <refsect2>
|
||||||
* <title>Example launch lines</title>
|
* <title>Example launch lines</title>
|
||||||
|
|
|
@ -162,8 +162,7 @@ gst_rg_volume_class_init (GstRgVolumeClass * klass)
|
||||||
*
|
*
|
||||||
* If album mode is enabled but the album gain tag is absent in the stream,
|
* If album mode is enabled but the album gain tag is absent in the stream,
|
||||||
* the track gain is used instead. If both gain tags are missing, the value
|
* the track gain is used instead. If both gain tags are missing, the value
|
||||||
* of the <link linkend="GstRgVolume--fallback-gain">fallback-gain</link>
|
* of the #GstRgVolume:fallback-gain property is used instead.
|
||||||
* property is used instead.
|
|
||||||
*/
|
*/
|
||||||
g_object_class_install_property (gobject_class, PROP_ALBUM_MODE,
|
g_object_class_install_property (gobject_class, PROP_ALBUM_MODE,
|
||||||
g_param_spec_boolean ("album-mode", "Album mode",
|
g_param_spec_boolean ("album-mode", "Album mode",
|
||||||
|
@ -223,24 +222,22 @@ gst_rg_volume_class_init (GstRgVolumeClass * klass)
|
||||||
*
|
*
|
||||||
* Applied gain [dB]. This gain is applied to processed buffer data.
|
* Applied gain [dB]. This gain is applied to processed buffer data.
|
||||||
*
|
*
|
||||||
* This is set to the <link linkend="GstRgVolume--target-gain">target
|
* This is set to the #GstRgVolume:target-gain if amplification by that amount
|
||||||
* gain</link> if amplification by that amount can be applied safely.
|
* can be applied safely. "Safely" means that the volume adjustment does not
|
||||||
* "Safely" means that the volume adjustment does not inflict clipping
|
* inflict clipping distortion. Should this not be the case, the result gain
|
||||||
* distortion. Should this not be the case, the result gain is set to an
|
* is set to an appropriately reduced value (by applying peak normalization).
|
||||||
* appropriately reduced value (by applying peak normalization). The proposed
|
* The proposed standard calls this "clipping prevention".
|
||||||
* standard calls this "clipping prevention".
|
|
||||||
*
|
*
|
||||||
* The difference between target and result gain reflects the necessary amount
|
* The difference between target and result gain reflects the necessary amount
|
||||||
* of reduction. Applications can make use of this information to temporarily
|
* of reduction. Applications can make use of this information to temporarily
|
||||||
* reduce the <link linkend="GstRgVolume--pre-amp">pre-amp</link> for
|
* reduce the #GstRgVolume:pre-amp for subsequent streams, as recommended by
|
||||||
* subsequent streams, as recommended by the ReplayGain standard.
|
* the ReplayGain standard.
|
||||||
*
|
*
|
||||||
* Note that target and result gain differing for a great majority of streams
|
* Note that target and result gain differing for a great majority of streams
|
||||||
* indicates a problem: What happens in this case is that most streams receive
|
* indicates a problem: What happens in this case is that most streams receive
|
||||||
* peak normalization instead of amplification by the ideal replay gain. To
|
* peak normalization instead of amplification by the ideal replay gain. To
|
||||||
* prevent this, the <link linkend="GstRgVolume--pre-amp">pre-amp</link> has
|
* prevent this, the #GstRgVolume:pre-amp has to be lowered and/or a limiter
|
||||||
* to be lowered and/or a limiter has to be used which facilitates the use of
|
* has to be used which facilitates the use of #GstRgVolume:headroom.
|
||||||
* <link linkend="GstRgVolume--headroom">headroom</link>.
|
|
||||||
*/
|
*/
|
||||||
g_object_class_install_property (gobject_class, PROP_RESULT_GAIN,
|
g_object_class_install_property (gobject_class, PROP_RESULT_GAIN,
|
||||||
g_param_spec_double ("result-gain", "Result-gain", "Applied gain [dB]",
|
g_param_spec_double ("result-gain", "Result-gain", "Applied gain [dB]",
|
||||||
|
@ -250,18 +247,14 @@ gst_rg_volume_class_init (GstRgVolumeClass * klass)
|
||||||
*
|
*
|
||||||
* Applicable gain [dB]. This gain is supposed to be applied.
|
* Applicable gain [dB]. This gain is supposed to be applied.
|
||||||
*
|
*
|
||||||
* Depending on the value of the <link
|
* Depending on the value of the #GstRgVolume:album-mode property and the
|
||||||
* linkend="GstRgVolume--album-mode">album-mode</link> property and the
|
|
||||||
* presence of ReplayGain tags in the stream, this is set according to one of
|
* presence of ReplayGain tags in the stream, this is set according to one of
|
||||||
* these simple formulas:
|
* these simple formulas:
|
||||||
*
|
*
|
||||||
* <itemizedlist>
|
* <itemizedlist>
|
||||||
* <listitem><link linkend="GstRgVolume--pre-amp">pre-amp</link> + album gain
|
* <listitem>#GstRgVolume:pre-amp + album gain of the stream</listitem>
|
||||||
* of the stream</listitem>
|
* <listitem>#GstRgVolume:pre-amp + track gain of the stream</listitem>
|
||||||
* <listitem><link linkend="GstRgVolume--pre-amp">pre-amp</link> + track gain
|
* <listitem>#GstRgVolume:pre-amp + #GstRgVolume:fallback-gain</listitem>
|
||||||
* of the stream</listitem>
|
|
||||||
* <listitem><link linkend="GstRgVolume--pre-amp">pre-amp</link> + <link
|
|
||||||
* linkend="GstRgVolume--fallback-gain">fallback gain</link></listitem>
|
|
||||||
* </itemizedlist>
|
* </itemizedlist>
|
||||||
*/
|
*/
|
||||||
g_object_class_install_property (gobject_class, PROP_TARGET_GAIN,
|
g_object_class_install_property (gobject_class, PROP_TARGET_GAIN,
|
||||||
|
|
Loading…
Reference in a new issue