gstrtsprange

gstrtsprange — dealing with time ranges

Synopsis


#include <gst/rtsp/gstrtsrange.h>

enum                GstRTSPRangeUnit;
                    GstRTSPTimeRange;
                    GstRTSPTime;
enum                GstRTSPTimeType;
GstRTSPResult       gst_rtsp_range_parse                (const gchar *rangestr,
                                                         GstRTSPTimeRange **range);
gchar*              gst_rtsp_range_to_string            (const GstRTSPTimeRange *range);
void                gst_rtsp_range_free                 (GstRTSPTimeRange *range);

Description

Provides helper functions to deal with time ranges.

Last reviewed on 2007-07-25 (0.10.14)

Details

enum GstRTSPRangeUnit

typedef enum
{
  GST_RTSP_RANGE_SMPTE,
  GST_RTSP_RANGE_SMPTE_30_DROP,
  GST_RTSP_RANGE_SMPTE_25,
  GST_RTSP_RANGE_NPT,
  GST_RTSP_RANGE_CLOCK
} GstRTSPRangeUnit;

Different possible time range units.

GST_RTSP_RANGE_SMPTE SMPTE timecode
GST_RTSP_RANGE_SMPTE_30_DROP 29.97 frames per second
GST_RTSP_RANGE_SMPTE_25 25 frames per second
GST_RTSP_RANGE_NPT Normal play time
GST_RTSP_RANGE_CLOCK Absolute time expressed as ISO 8601 timestamps

GstRTSPTimeRange

typedef struct {
  GstRTSPRangeUnit unit;

  GstRTSPTime min;
  GstRTSPTime max;
} GstRTSPTimeRange;

A time range.

GstRTSPRangeUnit unit; the time units used
GstRTSPTime min; the minimum interval
GstRTSPTime max; the maximum interval

GstRTSPTime

typedef struct {
  GstRTSPTimeType type;
  gdouble         seconds;
} GstRTSPTime;

A time indication.

GstRTSPTimeType type; the time of the time
gdouble seconds; seconds when type is GST_RTSP_TIME_SECONDS

enum GstRTSPTimeType

typedef enum {
  GST_RTSP_TIME_SECONDS,
  GST_RTSP_TIME_NOW,
  GST_RTSP_TIME_END
} GstRTSPTimeType;

Possible time types.

GST_RTSP_TIME_SECONDS seconds
GST_RTSP_TIME_NOW now
GST_RTSP_TIME_END end

gst_rtsp_range_parse ()

GstRTSPResult       gst_rtsp_range_parse                (const gchar *rangestr,
                                                         GstRTSPTimeRange **range);

Parse rangestr to a GstRTSPTimeRange.

rangestr : a range string to parse
range : location to hold the GstRTSPTimeRange result
Returns : GST_RTSP_OK on success.

gst_rtsp_range_to_string ()

gchar*              gst_rtsp_range_to_string            (const GstRTSPTimeRange *range);

Convert range into a string representation.

range : a GstRTSPTimeRange
Returns : The string representation of range. g_free() after usage.

Since 0.10.23


gst_rtsp_range_free ()

void                gst_rtsp_range_free                 (GstRTSPTimeRange *range);

Free the memory alocated by range.

range : a GstRTSPTimeRange