X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gst%2Fgstsample.h;h=268119ccc43155eb94ee16d51a634f3d701a61b8;hb=b89b1802df44829a0c034db5807bc893ad3c7774;hp=662240aba4a42202160cdeae91d0b7cb15c59e12;hpb=39664da1f07bda3032ea867fc695450b689b9d8f;p=platform%2Fupstream%2Fgstreamer.git

diff --git a/gst/gstsample.h b/gst/gstsample.h
index 662240a..268119c 100644
--- a/gst/gstsample.h
+++ b/gst/gstsample.h
@@ -31,7 +31,7 @@
 
 G_BEGIN_DECLS
 
-GST_EXPORT GType _gst_sample_type;
+GST_API GType _gst_sample_type;
 
 #define GST_TYPE_SAMPLE      (_gst_sample_type)
 #define GST_IS_SAMPLE(obj)   (GST_IS_MINI_OBJECT_TYPE(obj, GST_TYPE_SAMPLE))
@@ -47,34 +47,46 @@ GST_EXPORT GType _gst_sample_type;
  */
 typedef struct _GstSample GstSample;
 
-GST_EXPORT
+GST_API
 GType                gst_sample_get_type      (void);
 
 /* allocation */
 
-GST_EXPORT
+GST_API
 GstSample *          gst_sample_new           (GstBuffer          *buffer,
                                                GstCaps            *caps,
                                                const GstSegment   *segment,
                                                GstStructure       *info);
-GST_EXPORT
+GST_API
 GstBuffer *          gst_sample_get_buffer    (GstSample *sample);
 
-GST_EXPORT
+GST_API
 GstCaps *            gst_sample_get_caps      (GstSample *sample);
 
-GST_EXPORT
+GST_API
 GstSegment *         gst_sample_get_segment   (GstSample *sample);
 
-GST_EXPORT
+GST_API
 const GstStructure * gst_sample_get_info      (GstSample *sample);
 
-GST_EXPORT
+GST_API
 GstBufferList *      gst_sample_get_buffer_list (GstSample *sample);
 
-GST_EXPORT
+GST_API
 void                 gst_sample_set_buffer_list (GstSample *sample, GstBufferList *buffer_list);
 
+GST_API
+void                 gst_sample_set_buffer    (GstSample *sample, GstBuffer *buffer);
+
+GST_API
+void                 gst_sample_set_caps      (GstSample *sample, GstCaps *caps);
+
+GST_API
+void                 gst_sample_set_segment   (GstSample * sample, const GstSegment *segment);
+
+GST_API
+gboolean             gst_sample_set_info      (GstSample *sample, GstStructure *info);
+
 /* refcounting */
 /**
  * gst_sample_ref:
@@ -104,6 +116,45 @@ gst_sample_unref (GstSample * sample)
   gst_mini_object_unref (GST_MINI_OBJECT_CAST (sample));
 }
 
+/**
+ * gst_sample_is_writable:
+ * @sample: A #GstSample
+ *
+ * Tests if you can safely set the buffer and / or buffer list of @sample.
+ *
+ * Since: 1.16
+ */
+#define         gst_sample_is_writable(sample)     gst_mini_object_is_writable (GST_MINI_OBJECT_CAST (sample))
+
+/**
+ * gst_sample_make_writable:
+ * @sample: (transfer full): A #GstSample
+ *
+ * Returns a writable copy of @sample. If the source sample is
+ * already writable, this will simply return the same sample.
+ *
+ * Use this function to ensure that a sample can be safely modified before
+ * making changes to it, for example before calling gst_sample_set_buffer()
+ *
+ * If the reference count of the source sample @sample is exactly one, the caller
+ * is the sole owner and this function will return the sample object unchanged.
+ *
+ * If there is more than one reference on the object, a copy will be made using
+ * gst_sample_copy(). The passed-in @sample will be unreffed in that case, and the
+ * caller will now own a reference to the new returned sample object.
+ *
+ * In short, this function unrefs the sample in the argument and refs the sample
+ * that it returns. Don't access the argument after calling this function unless
+ * you have an additional reference to it.
+ *
+ * Returns: (transfer full): a writable sample which may or may not be the
+ *     same as @sample
+ *
+ * Since: 1.16
+ */
+#define         gst_sample_make_writable(sample)   GST_SAMPLE_CAST (gst_mini_object_make_writable (GST_MINI_OBJECT_CAST (sample)))
+
+
 /* copy sample */
 /**
  * gst_sample_copy: