|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
<html>
|
|
Packit Service |
963350 |
<head>
|
|
Packit Service |
963350 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
Packit Service |
963350 |
<title>GstSegment: GStreamer 1.0 Core Reference Manual</title>
|
|
Packit Service |
963350 |
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
|
|
Packit Service |
963350 |
<link rel="home" href="index.html" title="GStreamer 1.0 Core Reference Manual">
|
|
Packit Service |
963350 |
<link rel="up" href="libgstreamer.html" title="GStreamer Core Library">
|
|
Packit Service |
963350 |
<link rel="prev" href="GstRegistry.html" title="GstRegistry">
|
|
Packit Service |
963350 |
<link rel="next" href="gstreamer-GstStream.html" title="GstStreams">
|
|
Packit Service |
963350 |
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
|
|
Packit Service |
963350 |
<link rel="stylesheet" href="style.css" type="text/css">
|
|
Packit Service |
963350 |
</head>
|
|
Packit Service |
963350 |
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Top |
|
|
Packit Service |
963350 |
Description |
|
|
Packit Service |
963350 |
Object Hierarchy
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GstSegment
|
|
Packit Service |
963350 |
GstSegment — Structure describing the configured region of interest
|
|
Packit Service |
963350 |
in a media file.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Functions
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gboolean
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_clip ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
void
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_init ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GstSegment *
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_new ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GstSegment *
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_copy ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
void
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_free ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gboolean
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_do_seek ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_position_from_stream_time ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gint
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_position_from_stream_time_full ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_running_time ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gint
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_running_time_full ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_stream_time ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gint
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_stream_time_full ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_position_from_running_time ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gint
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_position_from_running_time_full ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_position ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gboolean
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_set_running_time ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
void
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_copy_into ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gboolean
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_offset_running_time ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gboolean
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_is_equal ()
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Types and Values
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
struct
|
|
Packit Service |
963350 |
GstSegment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
enum
|
|
Packit Service |
963350 |
GstSegmentFlags
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Object Hierarchy
|
|
Packit Service |
963350 |
GBoxed
|
|
Packit Service |
963350 |
╰── GstSegment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Includes
|
|
Packit Service |
963350 |
#include <gst/gstprotection.h>
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Description
|
|
Packit Service |
963350 |
This helper structure holds the relevant values for tracking the region of
|
|
Packit Service |
963350 |
interest in a media file, called a segment.
|
|
Packit Service |
963350 |
The structure can be used for two purposes:
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
performing seeks (handling seek events)
|
|
Packit Service |
963350 |
tracking playback regions (handling newsegment events)
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
The segment is usually configured by the application with a seek event which
|
|
Packit Service |
963350 |
is propagated upstream and eventually handled by an element that performs the seek.
|
|
Packit Service |
963350 |
The configured segment is then propagated back downstream with a newsegment event.
|
|
Packit Service |
963350 |
This information is then used to clip media to the segment boundaries.
|
|
Packit Service |
963350 |
A segment structure is initialized with gst_segment_init(), which takes a GstFormat
|
|
Packit Service |
963350 |
that will be used as the format of the segment values. The segment will be configured
|
|
Packit Service |
963350 |
with a start value of 0 and a stop/duration of -1, which is undefined. The default
|
|
Packit Service |
963350 |
rate and applied_rate is 1.0.
|
|
Packit Service |
963350 |
The public duration field contains the duration of the segment. When using
|
|
Packit Service |
963350 |
the segment for seeking, the start and time members should normally be left
|
|
Packit Service |
963350 |
to their default 0 value. The stop position is left to -1 unless explicitly
|
|
Packit Service |
963350 |
configured to a different value after a seek event.
|
|
Packit Service |
963350 |
The current position in the segment should be set by changing the position
|
|
Packit Service |
963350 |
member in the structure.
|
|
Packit Service |
963350 |
For elements that perform seeks, the current segment should be updated with the
|
|
Packit Service |
963350 |
gst_segment_do_seek() and the values from the seek event. This method will update
|
|
Packit Service |
963350 |
all the segment fields. The position field will contain the new playback position.
|
|
Packit Service |
963350 |
If the start_type was different from GST_SEEK_TYPE_NONE, playback continues from
|
|
Packit Service |
963350 |
the position position, possibly with updated flags or rate.
|
|
Packit Service |
963350 |
For elements that want to use GstSegment to track the playback region,
|
|
Packit Service |
963350 |
update the segment fields with the information from the newsegment event.
|
|
Packit Service |
963350 |
The gst_segment_clip() method can be used to check and clip
|
|
Packit Service |
963350 |
the media data to the segment boundaries.
|
|
Packit Service |
963350 |
For elements that want to synchronize to the pipeline clock, gst_segment_to_running_time()
|
|
Packit Service |
963350 |
can be used to convert a timestamp to a value that can be used to synchronize
|
|
Packit Service |
963350 |
to the clock. This function takes into account the base as well as
|
|
Packit Service |
963350 |
any rate or applied_rate conversions.
|
|
Packit Service |
963350 |
For elements that need to perform operations on media data in stream_time,
|
|
Packit Service |
963350 |
gst_segment_to_stream_time() can be used to convert a timestamp and the segment
|
|
Packit Service |
963350 |
info to stream time (which is always between 0 and the duration of the stream).
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Functions
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_clip ()
|
|
Packit Service |
963350 |
gboolean
|
|
Packit Service |
963350 |
gst_segment_clip (const GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 start,
|
|
Packit Service |
963350 |
guint64 stop,
|
|
Packit Service |
963350 |
guint64 *clip_start,
|
|
Packit Service |
963350 |
guint64 *clip_stop);
|
|
Packit Service |
963350 |
Clip the given start
|
|
Packit Service |
963350 |
and stop
|
|
Packit Service |
963350 |
values to the segment boundaries given
|
|
Packit Service |
963350 |
in segment
|
|
Packit Service |
963350 |
. start
|
|
Packit Service |
963350 |
and stop
|
|
Packit Service |
963350 |
are compared and clipped to segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
start and stop values.
|
|
Packit Service |
963350 |
If the function returns FALSE, start
|
|
Packit Service |
963350 |
and stop
|
|
Packit Service |
963350 |
are known to fall
|
|
Packit Service |
963350 |
outside of segment
|
|
Packit Service |
963350 |
and clip_start
|
|
Packit Service |
963350 |
and clip_stop
|
|
Packit Service |
963350 |
are not updated.
|
|
Packit Service |
963350 |
When the function returns TRUE, clip_start
|
|
Packit Service |
963350 |
and clip_stop
|
|
Packit Service |
963350 |
will be
|
|
Packit Service |
963350 |
updated. If clip_start
|
|
Packit Service |
963350 |
or clip_stop
|
|
Packit Service |
963350 |
are different from start
|
|
Packit Service |
963350 |
or stop
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
respectively, the region fell partially in the segment.
|
|
Packit Service |
963350 |
Note that when stop
|
|
Packit Service |
963350 |
is -1, clip_stop
|
|
Packit Service |
963350 |
will be set to the end of the
|
|
Packit Service |
963350 |
segment. Depending on the use case, this may or may not be what you want.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
start
|
|
Packit Service |
963350 |
the start position in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
stop
|
|
Packit Service |
963350 |
the stop position in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
clip_start
|
|
Packit Service |
963350 |
the clipped start position in the segment.
|
|
Packit Service |
963350 |
[out][allow-none]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
clip_stop
|
|
Packit Service |
963350 |
the clipped stop position in the segment.
|
|
Packit Service |
963350 |
[out][allow-none]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
TRUE if the given start
|
|
Packit Service |
963350 |
and stop
|
|
Packit Service |
963350 |
times fall partially or
|
|
Packit Service |
963350 |
completely in segment
|
|
Packit Service |
963350 |
, FALSE if the values are completely outside
|
|
Packit Service |
963350 |
of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_init ()
|
|
Packit Service |
963350 |
void
|
|
Packit Service |
963350 |
gst_segment_init (GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format);
|
|
Packit Service |
963350 |
The start/position fields are set to 0 and the stop/duration
|
|
Packit Service |
963350 |
fields are set to -1 (unknown). The default rate of 1.0 and no
|
|
Packit Service |
963350 |
flags are set.
|
|
Packit Service |
963350 |
Initialize segment
|
|
Packit Service |
963350 |
to its default values.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_new ()
|
|
Packit Service |
963350 |
GstSegment *
|
|
Packit Service |
963350 |
gst_segment_new (void);
|
|
Packit Service |
963350 |
Allocate a new GstSegment structure and initialize it using
|
|
Packit Service |
963350 |
gst_segment_init().
|
|
Packit Service |
963350 |
Free-function: gst_segment_free
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
a new GstSegment, free with gst_segment_free().
|
|
Packit Service |
963350 |
[transfer full]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_copy ()
|
|
Packit Service |
963350 |
GstSegment *
|
|
Packit Service |
963350 |
gst_segment_copy (const GstSegment *segment);
|
|
Packit Service |
963350 |
Create a copy of given segment
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
Free-function: gst_segment_free
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment.
|
|
Packit Service |
963350 |
[transfer none]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
a new GstSegment, free with gst_segment_free().
|
|
Packit Service |
963350 |
[transfer full]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_free ()
|
|
Packit Service |
963350 |
void
|
|
Packit Service |
963350 |
gst_segment_free (GstSegment *segment);
|
|
Packit Service |
963350 |
Free the allocated segment segment
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment.
|
|
Packit Service |
963350 |
[in][transfer full]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_do_seek ()
|
|
Packit Service |
963350 |
gboolean
|
|
Packit Service |
963350 |
gst_segment_do_seek (GstSegment *segment,
|
|
Packit Service |
963350 |
gdouble rate,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
GstSeekFlags flags,
|
|
Packit Service |
963350 |
GstSeekType start_type,
|
|
Packit Service |
963350 |
guint64 start,
|
|
Packit Service |
963350 |
GstSeekType stop_type,
|
|
Packit Service |
963350 |
guint64 stop,
|
|
Packit Service |
963350 |
gboolean *update);
|
|
Packit Service |
963350 |
Update the segment structure with the field values of a seek event (see
|
|
Packit Service |
963350 |
gst_event_new_seek()).
|
|
Packit Service |
963350 |
After calling this method, the segment field position and time will
|
|
Packit Service |
963350 |
contain the requested new position in the segment. The new requested
|
|
Packit Service |
963350 |
position in the segment depends on rate
|
|
Packit Service |
963350 |
and start_type
|
|
Packit Service |
963350 |
and stop_type
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
For positive rate
|
|
Packit Service |
963350 |
, the new position in the segment is the new segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
start field when it was updated with a start_type
|
|
Packit Service |
963350 |
different from
|
|
Packit Service |
963350 |
GST_SEEK_TYPE_NONE. If no update was performed on segment
|
|
Packit Service |
963350 |
start position
|
|
Packit Service |
963350 |
(GST_SEEK_TYPE_NONE), start
|
|
Packit Service |
963350 |
is ignored and segment
|
|
Packit Service |
963350 |
position is
|
|
Packit Service |
963350 |
unmodified.
|
|
Packit Service |
963350 |
For negative rate
|
|
Packit Service |
963350 |
, the new position in the segment is the new segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
stop field when it was updated with a stop_type
|
|
Packit Service |
963350 |
different from
|
|
Packit Service |
963350 |
GST_SEEK_TYPE_NONE. If no stop was previously configured in the segment, the
|
|
Packit Service |
963350 |
duration of the segment will be used to update the stop position.
|
|
Packit Service |
963350 |
If no update was performed on segment
|
|
Packit Service |
963350 |
stop position (GST_SEEK_TYPE_NONE),
|
|
Packit Service |
963350 |
stop
|
|
Packit Service |
963350 |
is ignored and segment
|
|
Packit Service |
963350 |
position is unmodified.
|
|
Packit Service |
963350 |
The applied rate of the segment will be set to 1.0 by default.
|
|
Packit Service |
963350 |
If the caller can apply a rate change, it should update segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
rate and applied_rate after calling this function.
|
|
Packit Service |
963350 |
update
|
|
Packit Service |
963350 |
will be set to TRUE if a seek should be performed to the segment
|
|
Packit Service |
963350 |
position field. This field can be FALSE if, for example, only the rate
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
has been changed but not the playback position.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
rate
|
|
Packit Service |
963350 |
the rate of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
flags
|
|
Packit Service |
963350 |
the segment flags for the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
start_type
|
|
Packit Service |
963350 |
the seek method
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
start
|
|
Packit Service |
963350 |
the seek start value
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
stop_type
|
|
Packit Service |
963350 |
the seek method
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
stop
|
|
Packit Service |
963350 |
the seek stop value
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
update
|
|
Packit Service |
963350 |
boolean holding whether position was updated.
|
|
Packit Service |
963350 |
[out][allow-none]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
TRUE if the seek could be performed.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_position_from_stream_time ()
|
|
Packit Service |
963350 |
guint64
|
|
Packit Service |
963350 |
gst_segment_position_from_stream_time (const GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 stream_time);
|
|
Packit Service |
963350 |
Convert stream_time
|
|
Packit Service |
963350 |
into a position in the segment so that
|
|
Packit Service |
963350 |
gst_segment_to_stream_time() with that position returns stream_time
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
stream_time
|
|
Packit Service |
963350 |
the stream_time in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
the position in the segment for stream_time
|
|
Packit Service |
963350 |
. This function returns
|
|
Packit Service |
963350 |
-1 when stream_time
|
|
Packit Service |
963350 |
is -1 or when it is not inside segment
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Since: 1.8
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_position_from_stream_time_full ()
|
|
Packit Service |
963350 |
gint
|
|
Packit Service |
963350 |
gst_segment_position_from_stream_time_full
|
|
Packit Service |
963350 |
(const GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 stream_time,
|
|
Packit Service |
963350 |
guint64 *position);
|
|
Packit Service |
963350 |
Translate stream_time
|
|
Packit Service |
963350 |
to the segment position using the currently configured
|
|
Packit Service |
963350 |
segment. Compared to gst_segment_position_from_stream_time() this function can
|
|
Packit Service |
963350 |
return negative segment position.
|
|
Packit Service |
963350 |
This function is typically used by elements that need to synchronize buffers
|
|
Packit Service |
963350 |
against the clock or each other.
|
|
Packit Service |
963350 |
stream_time
|
|
Packit Service |
963350 |
can be any value and the result of this function for values outside
|
|
Packit Service |
963350 |
of the segment is extrapolated.
|
|
Packit Service |
963350 |
When 1 is returned, stream_time
|
|
Packit Service |
963350 |
resulted in a positive position returned
|
|
Packit Service |
963350 |
in position
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
When this function returns -1, the returned position
|
|
Packit Service |
963350 |
should be negated
|
|
Packit Service |
963350 |
to get the real negative segment position.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
stream_time
|
|
Packit Service |
963350 |
the stream-time
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
position
|
|
Packit Service |
963350 |
the resulting position in the segment.
|
|
Packit Service |
963350 |
[out]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
a 1 or -1 on success, 0 on failure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Since: 1.8
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_running_time ()
|
|
Packit Service |
963350 |
guint64
|
|
Packit Service |
963350 |
gst_segment_to_running_time (const GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 position);
|
|
Packit Service |
963350 |
Translate position
|
|
Packit Service |
963350 |
to the total running time using the currently configured
|
|
Packit Service |
963350 |
segment. Position is a value between segment
|
|
Packit Service |
963350 |
start and stop time.
|
|
Packit Service |
963350 |
This function is typically used by elements that need to synchronize to the
|
|
Packit Service |
963350 |
global clock in a pipeline. The running time is a constantly increasing value
|
|
Packit Service |
963350 |
starting from 0. When gst_segment_init() is called, this value will reset to
|
|
Packit Service |
963350 |
0.
|
|
Packit Service |
963350 |
This function returns -1 if the position is outside of segment
|
|
Packit Service |
963350 |
start and stop.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
position
|
|
Packit Service |
963350 |
the position in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
the position as the total running time or -1 when an invalid position
|
|
Packit Service |
963350 |
was given.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_running_time_full ()
|
|
Packit Service |
963350 |
gint
|
|
Packit Service |
963350 |
gst_segment_to_running_time_full (const GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 position,
|
|
Packit Service |
963350 |
guint64 *running_time);
|
|
Packit Service |
963350 |
Translate position
|
|
Packit Service |
963350 |
to the total running time using the currently configured
|
|
Packit Service |
963350 |
segment. Compared to gst_segment_to_running_time() this function can return
|
|
Packit Service |
963350 |
negative running-time.
|
|
Packit Service |
963350 |
This function is typically used by elements that need to synchronize buffers
|
|
Packit Service |
963350 |
against the clock or eachother.
|
|
Packit Service |
963350 |
position
|
|
Packit Service |
963350 |
can be any value and the result of this function for values outside
|
|
Packit Service |
963350 |
of the segment is extrapolated.
|
|
Packit Service |
963350 |
When 1 is returned, position
|
|
Packit Service |
963350 |
resulted in a positive running-time returned
|
|
Packit Service |
963350 |
in running_time
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
When this function returns -1, the returned running_time
|
|
Packit Service |
963350 |
should be negated
|
|
Packit Service |
963350 |
to get the real negative running time.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
position
|
|
Packit Service |
963350 |
the position in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
running_time
|
|
Packit Service |
963350 |
result running-time.
|
|
Packit Service |
963350 |
[out][allow-none]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
a 1 or -1 on success, 0 on failure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Since: 1.6
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_stream_time ()
|
|
Packit Service |
963350 |
guint64
|
|
Packit Service |
963350 |
gst_segment_to_stream_time (const GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 position);
|
|
Packit Service |
963350 |
Translate position
|
|
Packit Service |
963350 |
to stream time using the currently configured
|
|
Packit Service |
963350 |
segment. The position
|
|
Packit Service |
963350 |
value must be between segment
|
|
Packit Service |
963350 |
start and
|
|
Packit Service |
963350 |
stop value.
|
|
Packit Service |
963350 |
This function is typically used by elements that need to operate on
|
|
Packit Service |
963350 |
the stream time of the buffers it receives, such as effect plugins.
|
|
Packit Service |
963350 |
In those use cases, position
|
|
Packit Service |
963350 |
is typically the buffer timestamp or
|
|
Packit Service |
963350 |
clock time that one wants to convert to the stream time.
|
|
Packit Service |
963350 |
The stream time is always between 0 and the total duration of the
|
|
Packit Service |
963350 |
media stream.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
position
|
|
Packit Service |
963350 |
the position in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
the position in stream_time or -1 when an invalid position
|
|
Packit Service |
963350 |
was given.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Since: 1.8
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_stream_time_full ()
|
|
Packit Service |
963350 |
gint
|
|
Packit Service |
963350 |
gst_segment_to_stream_time_full (const GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 position,
|
|
Packit Service |
963350 |
guint64 *stream_time);
|
|
Packit Service |
963350 |
Translate position
|
|
Packit Service |
963350 |
to the total stream time using the currently configured
|
|
Packit Service |
963350 |
segment. Compared to gst_segment_to_stream_time() this function can return
|
|
Packit Service |
963350 |
negative stream-time.
|
|
Packit Service |
963350 |
This function is typically used by elements that need to synchronize buffers
|
|
Packit Service |
963350 |
against the clock or eachother.
|
|
Packit Service |
963350 |
position
|
|
Packit Service |
963350 |
can be any value and the result of this function for values outside
|
|
Packit Service |
963350 |
of the segment is extrapolated.
|
|
Packit Service |
963350 |
When 1 is returned, position
|
|
Packit Service |
963350 |
resulted in a positive stream-time returned
|
|
Packit Service |
963350 |
in stream_time
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
When this function returns -1, the returned stream_time
|
|
Packit Service |
963350 |
should be negated
|
|
Packit Service |
963350 |
to get the real negative stream time.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
position
|
|
Packit Service |
963350 |
the position in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
stream_time
|
|
Packit Service |
963350 |
result stream-time.
|
|
Packit Service |
963350 |
[out]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
a 1 or -1 on success, 0 on failure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Since: 1.8
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_position_from_running_time ()
|
|
Packit Service |
963350 |
guint64
|
|
Packit Service |
963350 |
gst_segment_position_from_running_time
|
|
Packit Service |
963350 |
(const GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 running_time);
|
|
Packit Service |
963350 |
Convert running_time
|
|
Packit Service |
963350 |
into a position in the segment so that
|
|
Packit Service |
963350 |
gst_segment_to_running_time() with that position returns running_time
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
running_time
|
|
Packit Service |
963350 |
the running_time in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
the position in the segment for running_time
|
|
Packit Service |
963350 |
. This function returns
|
|
Packit Service |
963350 |
-1 when running_time
|
|
Packit Service |
963350 |
is -1 or when it is not inside segment
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Since: 1.8
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_position_from_running_time_full ()
|
|
Packit Service |
963350 |
gint
|
|
Packit Service |
963350 |
gst_segment_position_from_running_time_full
|
|
Packit Service |
963350 |
(const GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 running_time,
|
|
Packit Service |
963350 |
guint64 *position);
|
|
Packit Service |
963350 |
Translate running_time
|
|
Packit Service |
963350 |
to the segment position using the currently configured
|
|
Packit Service |
963350 |
segment. Compared to gst_segment_position_from_running_time() this function can
|
|
Packit Service |
963350 |
return negative segment position.
|
|
Packit Service |
963350 |
This function is typically used by elements that need to synchronize buffers
|
|
Packit Service |
963350 |
against the clock or each other.
|
|
Packit Service |
963350 |
running_time
|
|
Packit Service |
963350 |
can be any value and the result of this function for values
|
|
Packit Service |
963350 |
outside of the segment is extrapolated.
|
|
Packit Service |
963350 |
When 1 is returned, running_time
|
|
Packit Service |
963350 |
resulted in a positive position returned
|
|
Packit Service |
963350 |
in position
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
When this function returns -1, the returned position
|
|
Packit Service |
963350 |
should be negated
|
|
Packit Service |
963350 |
to get the real negative segment position.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
running_time
|
|
Packit Service |
963350 |
the running-time
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
position
|
|
Packit Service |
963350 |
the resulting position in the segment.
|
|
Packit Service |
963350 |
[out]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
a 1 or -1 on success, 0 on failure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Since: 1.8
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_position ()
|
|
Packit Service |
963350 |
guint64
|
|
Packit Service |
963350 |
gst_segment_to_position (const GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 running_time);
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_to_position is deprecated and should not be used in newly-written code.
|
|
Packit Service |
963350 |
Use gst_segment_position_from_running_time() instead.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Convert running_time
|
|
Packit Service |
963350 |
into a position in the segment so that
|
|
Packit Service |
963350 |
gst_segment_to_running_time() with that position returns running_time
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
running_time
|
|
Packit Service |
963350 |
the running_time in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
the position in the segment for running_time
|
|
Packit Service |
963350 |
. This function returns
|
|
Packit Service |
963350 |
-1 when running_time
|
|
Packit Service |
963350 |
is -1 or when it is not inside segment
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_set_running_time ()
|
|
Packit Service |
963350 |
gboolean
|
|
Packit Service |
963350 |
gst_segment_set_running_time (GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
guint64 running_time);
|
|
Packit Service |
963350 |
Adjust the start/stop and base values of segment
|
|
Packit Service |
963350 |
such that the next valid
|
|
Packit Service |
963350 |
buffer will be one with running_time
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
running_time
|
|
Packit Service |
963350 |
the running_time in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
TRUE if the segment could be updated successfully. If FALSE is
|
|
Packit Service |
963350 |
returned, running_time
|
|
Packit Service |
963350 |
is -1 or not in segment
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_copy_into ()
|
|
Packit Service |
963350 |
void
|
|
Packit Service |
963350 |
gst_segment_copy_into (const GstSegment *src,
|
|
Packit Service |
963350 |
GstSegment *dest);
|
|
Packit Service |
963350 |
Copy the contents of src
|
|
Packit Service |
963350 |
into dest
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
src
|
|
Packit Service |
963350 |
a GstSegment.
|
|
Packit Service |
963350 |
[transfer none]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
dest
|
|
Packit Service |
963350 |
a GstSegment.
|
|
Packit Service |
963350 |
[transfer none]
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_offset_running_time ()
|
|
Packit Service |
963350 |
gboolean
|
|
Packit Service |
963350 |
gst_segment_offset_running_time (GstSegment *segment,
|
|
Packit Service |
963350 |
GstFormat format,
|
|
Packit Service |
963350 |
gint64 offset);
|
|
Packit Service |
963350 |
Adjust the values in segment
|
|
Packit Service |
963350 |
so that offset
|
|
Packit Service |
963350 |
is applied to all
|
|
Packit Service |
963350 |
future running-time calculations.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
segment
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
format
|
|
Packit Service |
963350 |
the format of the segment.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
offset
|
|
Packit Service |
963350 |
the offset to apply in the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
TRUE if the segment could be updated successfully. If FALSE is
|
|
Packit Service |
963350 |
returned, offset
|
|
Packit Service |
963350 |
is not in segment
|
|
Packit Service |
963350 |
.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Since: 1.2.3
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gst_segment_is_equal ()
|
|
Packit Service |
963350 |
gboolean
|
|
Packit Service |
963350 |
gst_segment_is_equal (const GstSegment *s0,
|
|
Packit Service |
963350 |
const GstSegment *s1);
|
|
Packit Service |
963350 |
Checks for two segments being equal. Equality here is defined
|
|
Packit Service |
963350 |
as perfect equality, including floating point values.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Parameters
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
s0
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
s1
|
|
Packit Service |
963350 |
a GstSegment structure.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Returns
|
|
Packit Service |
963350 |
TRUE if the segments are equal, FALSE otherwise.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Since: 1.6
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Types and Values
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
struct GstSegment
|
|
Packit Service |
963350 |
struct GstSegment {
|
|
Packit Service |
963350 |
GstSegmentFlags flags;
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gdouble rate;
|
|
Packit Service |
963350 |
gdouble applied_rate;
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GstFormat format;
|
|
Packit Service |
963350 |
guint64 base;
|
|
Packit Service |
963350 |
guint64 offset;
|
|
Packit Service |
963350 |
guint64 start;
|
|
Packit Service |
963350 |
guint64 stop;
|
|
Packit Service |
963350 |
guint64 time;
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64 position;
|
|
Packit Service |
963350 |
guint64 duration;
|
|
Packit Service |
963350 |
};
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
A helper structure that holds the configured region of
|
|
Packit Service |
963350 |
interest in a media file.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Members
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GstSegmentFlags flags;
|
|
Packit Service |
963350 |
flags for this segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gdouble rate;
|
|
Packit Service |
963350 |
the playback rate of the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
gdouble applied_rate;
|
|
Packit Service |
963350 |
the already applied rate to the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GstFormat format;
|
|
Packit Service |
963350 |
the format of the segment values
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64 base;
|
|
Packit Service |
963350 |
the running time (plus elapsed time, see offset) of the segment start
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64 offset;
|
|
Packit Service |
963350 |
the amount (in buffer timestamps) that has already been elapsed in
|
|
Packit Service |
963350 |
the segment
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64 start;
|
|
Packit Service |
963350 |
the start of the segment in buffer timestamp time (PTS)
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64 stop;
|
|
Packit Service |
963350 |
the stop of the segment in buffer timestamp time (PTS)
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64 time;
|
|
Packit Service |
963350 |
the stream time of the segment start
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64 position;
|
|
Packit Service |
963350 |
the buffer timestamp position in the segment (used internally by
|
|
Packit Service |
963350 |
elements such as sources, demuxers or parsers to track progress)
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
guint64 duration;
|
|
Packit Service |
963350 |
the duration of the stream
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
enum GstSegmentFlags
|
|
Packit Service |
963350 |
Flags for the GstSegment structure. Currently mapped to the corresponding
|
|
Packit Service |
963350 |
values of the seek flags.
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Members
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GST_SEGMENT_FLAG_NONE
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
no flags
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GST_SEGMENT_FLAG_RESET
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
reset the pipeline running_time to the segment
|
|
Packit Service |
963350 |
running_time
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GST_SEGMENT_FLAG_TRICKMODE
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
perform skip playback (Since 1.6)
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GST_SEGMENT_FLAG_SKIP
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Deprecated backward compatibility flag, replaced
|
|
Packit Service |
963350 |
by GST_SEGMENT_FLAG_TRICKMODE
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GST_SEGMENT_FLAG_SEGMENT
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
send SEGMENT_DONE instead of EOS
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GST_SEGMENT_FLAG_TRICKMODE_KEY_UNITS
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Decode only keyframes, where
|
|
Packit Service |
963350 |
possible (Since 1.6)
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
GST_SEGMENT_FLAG_TRICKMODE_NO_AUDIO
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Do not decode any audio, where
|
|
Packit Service |
963350 |
possible (Since 1.6)
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
See Also
|
|
Packit Service |
963350 |
GstEvent
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
|
|
Packit Service |
963350 |
Generated by GTK-Doc V1.27
|
|
Packit Service |
963350 |
</body>
|
|
Packit Service |
963350 |
</html>
|