2 * Copyright (C) <2005,2006> Wim Taymans <wim@fluendo.com>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
17 * Boston, MA 02110-1301, USA.
20 * Unless otherwise indicated, Source Code is licensed under MIT license.
21 * See further explanation attached in License Statement (distributed in the file
24 * Permission is hereby granted, free of charge, to any person obtaining a copy of
25 * this software and associated documentation files (the "Software"), to deal in
26 * the Software without restriction, including without limitation the rights to
27 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
28 * of the Software, and to permit persons to whom the Software is furnished to do
29 * so, subject to the following conditions:
31 * The above copyright notice and this permission notice shall be included in all
32 * copies or substantial portions of the Software.
34 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
35 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
36 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
37 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
38 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
39 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
44 * SECTION:gstrtsprange
45 * @short_description: dealing with time ranges
47 * Provides helper functions to deal with time ranges.
49 * Last reviewed on 2007-07-25 (0.10.14)
56 #include "gstrtsprange.h"
59 gst_strtod (const gchar * dstr)
61 gchar s[G_ASCII_DTOSTR_BUF_SIZE] = { 0, };
63 /* canonicalise floating point string so we can handle float strings
64 * in the form "24.930" or "24,930" irrespective of the current locale.
65 * We should always be getting floats in 24.930 format with a floating point,
66 * but let's accept malformed ones as well, easy mistake to make after all */
67 g_strlcpy (s, dstr, sizeof (s));
68 g_strdelimit (s, ",", '.');
69 return g_ascii_strtod (s, NULL);
72 /* npt-time = "now" | npt-sec | npt-hhmmss
73 * npt-sec = 1*DIGIT [ "." *DIGIT ]
74 * npt-hhmmss = npt-hh ":" npt-mm ":" npt-ss [ "." *DIGIT ]
75 * npt-hh = 1*DIGIT ; any positive number
76 * npt-mm = 1*2DIGIT ; 0-59
77 * npt-ss = 1*2DIGIT ; 0-59
80 parse_npt_time (const gchar * str, GstRTSPTime * time)
82 if (strncmp (str, "now", 3) == 0) {
83 time->type = GST_RTSP_TIME_NOW;
84 } else if (str[0] == '\0' || str[0] == '-') {
85 time->type = GST_RTSP_TIME_END;
86 } else if (strstr (str, ":")) {
89 sscanf (str, "%2d:%2d:", &hours, &mins);
90 str = strchr (str, ':') + 1;
91 str = strchr (str, ':') + 1;
92 time->type = GST_RTSP_TIME_SECONDS;
93 time->seconds = ((hours * 60) + mins) * 60 + gst_strtod (str);
95 time->type = GST_RTSP_TIME_SECONDS;
96 time->seconds = gst_strtod (str);
101 /* npt-range = ( npt-time "-" [ npt-time ] ) | ( "-" npt-time )
104 parse_npt_range (const gchar * str, GstRTSPTimeRange * range)
109 range->unit = GST_RTSP_RANGE_NPT;
111 /* find '-' separator */
112 p = strstr (str, "-");
114 return GST_RTSP_EINVAL;
116 if ((res = parse_npt_time (str, &range->min)) != GST_RTSP_OK)
119 res = parse_npt_time (p + 1, &range->max);
121 /* a single - is not allowed */
122 if (range->min.type == GST_RTSP_TIME_END
123 && range->max.type == GST_RTSP_TIME_END)
124 return GST_RTSP_EINVAL;
131 parse_clock_range (const gchar * str, GstRTSPTimeRange * range)
133 return GST_RTSP_ENOTIMPL;
137 parse_smpte_range (const gchar * str, GstRTSPTimeRange * range)
139 return GST_RTSP_ENOTIMPL;
143 * gst_rtsp_range_parse:
144 * @rangestr: a range string to parse
145 * @range: location to hold the #GstRTSPTimeRange result
147 * Parse @rangestr to a #GstRTSPTimeRange.
149 * Returns: #GST_RTSP_OK on success.
152 gst_rtsp_range_parse (const gchar * rangestr, GstRTSPTimeRange ** range)
155 GstRTSPTimeRange *res;
158 g_return_val_if_fail (rangestr != NULL, GST_RTSP_EINVAL);
159 g_return_val_if_fail (range != NULL, GST_RTSP_EINVAL);
161 res = g_new0 (GstRTSPTimeRange, 1);
163 p = (gchar *) rangestr;
164 /* first figure out the units of the range */
165 if (g_str_has_prefix (p, "npt=")) {
166 ret = parse_npt_range (p + 4, res);
167 } else if (g_str_has_prefix (p, "clock=")) {
168 ret = parse_clock_range (p + 6, res);
169 } else if (g_str_has_prefix (p, "smpte=")) {
170 res->unit = GST_RTSP_RANGE_SMPTE;
171 ret = parse_smpte_range (p + 6, res);
172 } else if (g_str_has_prefix (p, "smpte-30-drop=")) {
173 res->unit = GST_RTSP_RANGE_SMPTE_30_DROP;
174 ret = parse_smpte_range (p + 14, res);
175 } else if (g_str_has_prefix (p, "smpte-25=")) {
176 res->unit = GST_RTSP_RANGE_SMPTE_25;
177 ret = parse_smpte_range (p + 9, res);
181 if (ret != GST_RTSP_OK)
190 gst_rtsp_range_free (res);
191 return GST_RTSP_EINVAL;
196 npt_time_string (const GstRTSPTime * time, GString * string)
198 gchar dstrbuf[G_ASCII_DTOSTR_BUF_SIZE] = { 0, };
199 gboolean res = TRUE;;
201 switch (time->type) {
202 case GST_RTSP_TIME_SECONDS:
203 /* need to format floating point value strings as in C locale */
204 g_ascii_dtostr (dstrbuf, G_ASCII_DTOSTR_BUF_SIZE, time->seconds);
205 g_string_append (string, dstrbuf);
207 case GST_RTSP_TIME_NOW:
208 g_string_append (string, "now");
210 case GST_RTSP_TIME_END:
220 npt_range_string (const GstRTSPTimeRange * range, GString * string)
224 if (!(res = npt_time_string (&range->min, string)))
227 g_string_append (string, "-");
229 if (!(res = npt_time_string (&range->max, string)))
237 * gst_rtsp_range_to_string:
238 * @range: a #GstRTSPTimeRange
240 * Convert @range into a string representation.
242 * Returns: The string representation of @range. g_free() after usage.
245 gst_rtsp_range_to_string (const GstRTSPTimeRange * range)
247 gchar *result = NULL;
250 g_return_val_if_fail (range != NULL, NULL);
252 string = g_string_new ("");
254 switch (range->unit) {
255 case GST_RTSP_RANGE_NPT:
256 g_string_append (string, "npt=");
257 if (!npt_range_string (range, string)) {
258 g_string_free (string, TRUE);
262 case GST_RTSP_RANGE_SMPTE:
263 case GST_RTSP_RANGE_SMPTE_30_DROP:
264 case GST_RTSP_RANGE_SMPTE_25:
265 case GST_RTSP_RANGE_CLOCK:
267 g_warning ("time range unit not yet implemented");
268 g_string_free (string, TRUE);
273 result = g_string_free (string, FALSE);
279 * gst_rtsp_range_free:
280 * @range: a #GstRTSPTimeRange
282 * Free the memory allocated by @range.
285 gst_rtsp_range_free (GstRTSPTimeRange * range)