Merge branch 'master' into 0.11
[platform/upstream/gstreamer.git] / gst-libs / gst / app / gstappsink.c
index 76cff42..4e69069 100644 (file)
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
-
-/**
- * SECTION:element-appsink
- * 
- * Appsink is a sink plugin that supports many different methods for making
- * the application get a handle on the GStreamer data in a pipeline. Unlike
- * most GStreamer elements, Appsink provides external API functions.
- *
- * For the documentation of the API, please see the
- * <link linkend="gst-plugins-base-libs-appsink">libgstapp</link> section in
- * the GStreamer Plugins Base Libraries documentation.
- *
- * Since: 0.10.22
- */
-
-
 /**
  * SECTION:gstappsink
  * @short_description: Easy way for applications to extract buffers from a
@@ -281,10 +265,10 @@ gst_app_sink_class_init (GstAppSinkClass * klass)
    * GstAppSink::new-preroll:
    * @appsink: the appsink element that emited the signal
    *
-   * Signal that a new preroll buffer is available. 
+   * Signal that a new preroll buffer is available.
    *
    * This signal is emited from the steaming thread and only when the
-   * "emit-signals" property is %TRUE. 
+   * "emit-signals" property is %TRUE.
    *
    * The new preroll buffer can be retrieved with the "pull-preroll" action
    * signal or gst_app_sink_pull_preroll() either from this signal callback
@@ -304,7 +288,7 @@ gst_app_sink_class_init (GstAppSinkClass * klass)
    * Signal that a new buffer is available.
    *
    * This signal is emited from the steaming thread and only when the
-   * "emit-signals" property is %TRUE. 
+   * "emit-signals" property is %TRUE.
    *
    * The new buffer can be retrieved with the "pull-buffer" action
    * signal or gst_app_sink_pull_buffer() either from this signal callback
@@ -324,7 +308,7 @@ gst_app_sink_class_init (GstAppSinkClass * klass)
    * Signal that a new bufferlist is available.
    *
    * This signal is emited from the steaming thread and only when the
-   * "emit-signals" property is %TRUE. 
+   * "emit-signals" property is %TRUE.
    *
    * The new buffer can be retrieved with the "pull-buffer-list" action
    * signal or gst_app_sink_pull_buffer_list() either from this signal callback
@@ -354,10 +338,10 @@ gst_app_sink_class_init (GstAppSinkClass * klass)
    * when calling gst_app_sink_pull_buffer() or the "pull-buffer" action signal.
    *
    * If an EOS event was received before any buffers, this function returns
-   * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition. 
+   * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition.
    *
    * This function blocks until a preroll buffer or EOS is received or the appsink
-   * element is set to the READY/NULL state. 
+   * element is set to the READY/NULL state.
    *
    * Returns: a #GstBuffer or NULL when the appsink is stopped or EOS.
    */
@@ -371,11 +355,11 @@ gst_app_sink_class_init (GstAppSinkClass * klass)
    * @appsink: the appsink element to emit this signal on
    *
    * This function blocks until a buffer or EOS becomes available or the appsink
-   * element is set to the READY/NULL state. 
+   * element is set to the READY/NULL state.
    *
    * This function will only return buffers when the appsink is in the PLAYING
    * state. All rendered buffers will be put in a queue so that the application
-   * can pull buffers at its own rate. 
+   * can pull buffers at its own rate.
    *
    * Note that when the application does not pull buffers fast enough, the
    * queued buffers could consume a lot of memory, especially when dealing with
@@ -383,7 +367,7 @@ gst_app_sink_class_init (GstAppSinkClass * klass)
    * the "drop" and "max-buffers" properties.
    *
    * If an EOS event was received before any buffers, this function returns
-   * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition. 
+   * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition.
    *
    * Returns: a #GstBuffer or NULL when the appsink is stopped or EOS.
    */
@@ -397,11 +381,11 @@ gst_app_sink_class_init (GstAppSinkClass * klass)
    * @appsink: the appsink element to emit this signal on
    *
    * This function blocks until a buffer list or EOS becomes available or the appsink
-   * element is set to the READY/NULL state. 
+   * element is set to the READY/NULL state.
    *
    * This function will only return bufferlists when the appsink is in the PLAYING
    * state. All rendered bufferlists will be put in a queue so that the application
-   * can pull bufferlists at its own rate. 
+   * can pull bufferlists at its own rate.
    *
    * Note that when the application does not pull bufferlists fast enough, the
    * queued bufferlists could consume a lot of memory, especially when dealing with
@@ -409,7 +393,7 @@ gst_app_sink_class_init (GstAppSinkClass * klass)
    * the "drop" and "max-buffers" properties.
    *
    * If an EOS event was received before any buffers, this function returns
-   * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition. 
+   * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition.
    *
    * Returns: a #GstBufferList or NULL when the appsink is stopped or EOS.
    */
@@ -924,7 +908,7 @@ not_started:
  * Set the capabilities on the appsink element.  This function takes
  * a copy of the caps structure. After calling this method, the sink will only
  * accept caps that match @caps. If @caps is non-fixed, you must check the caps
- * on the buffers to get the actual used caps. 
+ * on the buffers to get the actual used caps.
  *
  * Since: 0.10.22
  */
@@ -1209,10 +1193,10 @@ gst_app_sink_get_drop (GstAppSink * appsink)
  * when calling gst_app_sink_pull_buffer().
  *
  * If an EOS event was received before any buffers, this function returns
- * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition. 
+ * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition.
  *
  * This function blocks until a preroll buffer or EOS is received or the appsink
- * element is set to the READY/NULL state. 
+ * element is set to the READY/NULL state.
  *
  * Returns: a #GstBuffer or NULL when the appsink is stopped or EOS.
  *
@@ -1271,7 +1255,7 @@ not_started:
  * @appsink: a #GstAppSink
  *
  * This function blocks until a buffer or EOS becomes available or the appsink
- * element is set to the READY/NULL state. 
+ * element is set to the READY/NULL state.
  *
  * This function will only return buffers when the appsink is in the PLAYING
  * state. All rendered buffers will be put in a queue so that the application
@@ -1280,7 +1264,7 @@ not_started:
  * especially when dealing with raw video frames.
  *
  * If an EOS event was received before any buffers, this function returns
- * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition. 
+ * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition.
  *
  * Returns: a #GstBuffer or NULL when the appsink is stopped or EOS.
  *
@@ -1299,7 +1283,7 @@ gst_app_sink_pull_buffer (GstAppSink * appsink)
  * @appsink: a #GstAppSink
  *
  * This function blocks until a buffer list or EOS becomes available or the
- * appsink element is set to the READY/NULL state. 
+ * appsink element is set to the READY/NULL state.
  *
  * This function will only return buffer lists when the appsink is in the
  * PLAYING state. All rendered buffer lists will be put in a queue so that
@@ -1309,7 +1293,7 @@ gst_app_sink_pull_buffer (GstAppSink * appsink)
  * video frames.
  *
  * If an EOS event was received before any buffer lists, this function returns
- * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition. 
+ * %NULL. Use gst_app_sink_is_eos () to check for the EOS condition.
  *
  * Returns: a #GstBufferList or NULL when the appsink is stopped or EOS.
  */