2 * Copyright (C) 2011 Wim Taymans <wim.taymans@gmail.com>
4 * gstsample.c: media sample
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Library General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Library General Public License for more details.
16 * You should have received a copy of the GNU Library General Public
17 * License along with this library; if not, write to the
18 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
19 * Boston, MA 02110-1301, USA.
24 * @short_description: A media sample
25 * @see_also: #GstBuffer, #GstCaps, #GstSegment
27 * A #GstSample is a small object containing data, a type, timing and
28 * extra arbitrary information.
30 #include "gst_private.h"
32 #include "gstsample.h"
34 GST_DEBUG_CATEGORY_STATIC (gst_sample_debug);
35 #define GST_CAT_DEFAULT gst_sample_debug
39 GstMiniObject mini_object;
47 GType _gst_sample_type = 0;
49 GST_DEFINE_MINI_OBJECT_TYPE (GstSample, gst_sample);
52 _priv_gst_sample_initialize (void)
54 _gst_sample_type = gst_sample_get_type ();
56 GST_DEBUG_CATEGORY_INIT (gst_sample_debug, "sample", 0, "GstSample debug");
60 _gst_sample_copy (GstSample * sample)
64 copy = gst_sample_new (sample->buffer, sample->caps, &sample->segment,
65 (sample->info) ? gst_structure_copy (sample->info) : NULL);
71 _gst_sample_free (GstSample * sample)
73 GST_LOG ("free %p", sample);
76 gst_buffer_unref (sample->buffer);
78 gst_caps_unref (sample->caps);
80 gst_structure_set_parent_refcount (sample->info, NULL);
81 gst_structure_free (sample->info);
83 g_slice_free1 (sizeof (GstSample), sample);
88 * @buffer: (transfer none) (allow-none): a #GstBuffer, or %NULL
89 * @caps: (transfer none) (allow-none): a #GstCaps, or %NULL
90 * @segment: (transfer none) (allow-none): a #GstSegment, or %NULL
91 * @info: (transfer full) (allow-none): a #GstStructure, or %NULL
93 * Create a new #GstSample with the provided details.
95 * Free-function: gst_sample_unref
97 * Returns: (transfer full): the new #GstSample. gst_sample_unref()
101 gst_sample_new (GstBuffer * buffer, GstCaps * caps, const GstSegment * segment,
106 sample = g_slice_new0 (GstSample);
108 GST_LOG ("new %p", sample);
110 gst_mini_object_init (GST_MINI_OBJECT_CAST (sample), 0, _gst_sample_type,
111 (GstMiniObjectCopyFunction) _gst_sample_copy, NULL,
112 (GstMiniObjectFreeFunction) _gst_sample_free);
114 sample->buffer = buffer ? gst_buffer_ref (buffer) : NULL;
115 sample->caps = caps ? gst_caps_ref (caps) : NULL;
118 gst_segment_copy_into (segment, &sample->segment);
120 gst_segment_init (&sample->segment, GST_FORMAT_TIME);
123 if (!gst_structure_set_parent_refcount (info,
124 &sample->mini_object.refcount))
134 gst_sample_unref (sample);
135 g_warning ("structure is already owned by another object");
141 * gst_sample_get_buffer:
142 * @sample: a #GstSample
144 * Get the buffer associated with @sample
146 * Returns: (transfer none): the buffer of @sample or %NULL when there
147 * is no buffer. The buffer remains valid as long as @sample is valid.
148 * If you need to hold on to it for longer than that, take a ref to
149 * the buffer with gst_buffer_ref().
152 gst_sample_get_buffer (GstSample * sample)
154 g_return_val_if_fail (GST_IS_SAMPLE (sample), NULL);
156 return sample->buffer;
160 * gst_sample_get_caps:
161 * @sample: a #GstSample
163 * Get the caps associated with @sample
165 * Returns: (transfer none): the caps of @sample or %NULL when there
166 * is no caps. The caps remain valid as long as @sample is valid.
167 * If you need to hold on to the caps for longer than that, take a ref to
168 * the caps with gst_caps_ref().
171 gst_sample_get_caps (GstSample * sample)
173 g_return_val_if_fail (GST_IS_SAMPLE (sample), NULL);
179 * gst_sample_get_segment:
180 * @sample: a #GstSample
182 * Get the segment associated with @sample
184 * Returns: (transfer none): the segment of @sample.
185 * The segment remains valid as long as @sample is valid.
188 gst_sample_get_segment (GstSample * sample)
190 g_return_val_if_fail (GST_IS_SAMPLE (sample), NULL);
192 return &sample->segment;
196 * gst_sample_get_info:
197 * @sample: a #GstSample
199 * Get extra information associated with @sample.
201 * Returns: (transfer none): the extra info of @sample.
202 * The info remains valid as long as @sample is valid.
205 gst_sample_get_info (GstSample * sample)
207 g_return_val_if_fail (GST_IS_SAMPLE (sample), NULL);