[Bug 690564] Design documentation is out of date WRT GstSegment

[GStreamer (bugzilla.gnome.org)]

https://bugzilla.gnome.org/show_bug.cgi?id=690564
  GStreamer | documentation | 1.0.0

--- Comment #7 from Will Manley <gnome at williammanley.net> 2012-12-21 14:15:59 UTC ---
Notes from IRC:

<willmanley> wtay: I've created a diagram of the GstSegment members:
http://bugzilla-attachments.gnome.org/attachment.cgi?id=232045
<willmanley> does this look correct?
<wtay> willmanley, It looks ok to me
<wtay> willmanley,
http://gstreamer.freedesktop.org/data/doc/gstreamer/head/manual/html/section-time-overview.html
<willmanley> I'd seen that but I was a little confused as I didn't realize that
there was also buffer timestamp time in addition to stream, running and clock
time.  It's much clearer to me now, thanks.
<wtay> ok, maybe I can merge this into the document
<willmanley> wtay, I'm still a little unsure about offset though
<willmanley> in your updated documentation you say "s.offset: an offset to
apply to S.start or S.stop. This is the amount that has already been elapsed in
the segment."
<wtay> willmanley, the reason is that when you are using the segment for
tracking the current playing position and you do a seek that only changes the
rate, you don't want to modify the start/stop in the segment
<willmanley> right
<willmanley> ok
<wtay> but you still want to have the rate change happen from the current
position
<willmanley> but that still qualifies as a new segment right? e.g. you would
receieve GST_EVENT_SEGMENT_DONE and then GST_EVENT_SEGMENT
<wtay> you would and the demuxer uses the GstSegment structure to generate the
event
<willmanley> And the offset is expressed in timestamp time
<wtay> yes
<wtay> a value between start and stop
<willmanley> wtay, Thanks for your help, I'll see if I can write some of this
stuff up and submit it as a patch

-- 
Configure bugmail: https://bugzilla.gnome.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.