![]() | ![]() | ![]() | GStreamer 0.10 Core Reference Manual | ![]() |
---|
GstSegmentGstSegment — |
#include <gst/gst.h> GstSegment; gboolean gst_segment_clip (GstSegment *segment, GstFormat format, gint64 start, gint64 stop, gint64 *clip_start, gint64 *clip_stop); void gst_segment_init (GstSegment *segment, GstFormat format); GstSegment* gst_segment_new (void); void gst_segment_free (GstSegment *segment); void gst_segment_set_duration (GstSegment *segment, GstFormat format, gint64 duration); void gst_segment_set_last_stop (GstSegment *segment, GstFormat format, gint64 position); void gst_segment_set_newsegment (GstSegment *segment, gboolean update, gdouble rate, GstFormat format, gint64 start, gint64 stop, gint64 time); void gst_segment_set_seek (GstSegment *segment, gdouble rate, GstFormat format, GstSeekFlags flags, GstSeekType cur_type, gint64 cur, GstSeekType stop_type, gint64 stop, gboolean *update); gint64 gst_segment_to_running_time (GstSegment *segment, GstFormat format, gint64 position); gint64 gst_segment_to_stream_time (GstSegment *segment, GstFormat format, gint64 position);
typedef struct { gdouble rate; gdouble abs_rate; GstFormat format; GstSeekFlags flags; gint64 start; gint64 stop; gint64 time; gint64 accum; gint64 last_stop; gint64 duration; } GstSegment;
A helper structure that holds the configured region of interest in a media file.
gdouble rate ; | the rate of the segment |
gdouble abs_rate ; | absolute value of the rate |
GstFormat format ; | the format of the segment values |
GstSeekFlags flags ; | flags for this segment |
gint64 start ; | the start of the segment |
gint64 stop ; | the stop of the segment |
gint64 time ; | the stream time of the segment |
gint64 accum ; | accumulated segment |
gint64 last_stop ; | last known stop time |
gint64 duration ; | total duration of segment |
gboolean gst_segment_clip (GstSegment *segment, GstFormat format, gint64 start, gint64 stop, gint64 *clip_start, gint64 *clip_stop);
Clip the given start
and stop
values to the segment boundaries given
in segment
.
segment : | a GstSegment structure. |
format : | the format of the segment. |
start : | the start position in the segment |
stop : | the stop position in the segment |
clip_start : | the clipped start position in the segment |
clip_stop : | the clipped stop position in the segment |
Returns : | TRUE if the given start and stop times fall partially in
segment , FALSE if the values are completely outside of the segment.
|
void gst_segment_init (GstSegment *segment, GstFormat format);
Initialize segment
to its default values, which is a rate of 1.0, a
start time of 0.
segment : | a GstSegment structure. |
format : | the format of the segment. |
GstSegment* gst_segment_new (void);
Allocate a new GstSegment structure and initialize it using
gst_segment_init()
.
Returns : | a new GstSegment, free with gst_segment_free() .
|
void gst_segment_free (GstSegment *segment);
Free the allocated segment segment
.
segment : | a GstSegment |
void gst_segment_set_duration (GstSegment *segment, GstFormat format, gint64 duration);
Set the duration of the segment to duration
. This function is mainly
used by elements that perform seeking and know the total duration of the
segment.
segment : | a GstSegment structure. |
format : | the format of the segment. |
duration : | the duration of the segment info. |
void gst_segment_set_last_stop (GstSegment *segment, GstFormat format, gint64 position);
Set the last observed stop position in the segment to position
.
segment : | a GstSegment structure. |
format : | the format of the segment. |
position : | the position |
void gst_segment_set_newsegment (GstSegment *segment, gboolean update, gdouble rate, GstFormat format, gint64 start, gint64 stop, gint64 time);
Update the segment structure with the field values of a new segment event.
segment : | a GstSegment structure. |
update : | flag indicating a new segment is started or updated |
rate : | the rate of the segment. |
format : | the format of the segment. |
start : | the new start value |
stop : | the new stop value |
time : | the new stream time |
void gst_segment_set_seek (GstSegment *segment, gdouble rate, GstFormat format, GstSeekFlags flags, GstSeekType cur_type, gint64 cur, GstSeekType stop_type, gint64 stop, gboolean *update);
Update the segment structure with the field values of a seek event.
segment : | a GstSegment structure. |
rate : | the rate of the segment. |
format : | the format of the segment. |
flags : | the seek flags for the segment |
cur_type : | the seek method |
cur : | the seek start value |
stop_type : | the seek method |
stop : | the seek stop value |
update : | boolean holding whether an update the current segment is needed. |
gint64 gst_segment_to_running_time (GstSegment *segment, GstFormat format, gint64 position);
Translate position
to the total running time using the currently configured
segment.
This function is typically used by elements that need to synchronize to the global clock in a pipeline.
segment : | a GstSegment structure. |
format : | the format of the segment. |
position : | the position in the segment |
Returns : | the position as the total running time. |
gint64 gst_segment_to_stream_time (GstSegment *segment, GstFormat format, gint64 position);
Translate position
to stream time using the currently configured
segment.
This function is typically used by elements that need to operate on the stream time of the buffers it receives, such as effect plugins.
segment : | a GstSegment structure. |
format : | the format of the segment. |
position : | the position in the segment |
Returns : | the position in stream_time. |
<< GstRegistry | GstStructure >> |