[Bug 690564] New: 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

           Summary: Design documentation is out of date WRT GstSegment
    Classification: Platform
           Product: GStreamer
           Version: 1.0.0
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: normal
          Priority: Normal
         Component: documentation
        AssignedTo: gstreamer-bugs at lists.freedesktop.org
        ReportedBy: gnome at williammanley.net
         QAContact: gstreamer-bugs at lists.freedesktop.org
     GNOME version: ---


Created an attachment (id=231999)
 --> (https://bugzilla.gnome.org/attachment.cgi?id=231999)
Notes on GstSegment fields and functions

part-synchronisation.txt, part-clocks.txt and part-segments.txt still refer to
GstSegment fields only present in Gstreamer 0.10 but removed for Gstreamer 1.0.
 This includes the field "accum" - I believe this has been replaced by "base"
and abs_rate which can be derived from rate and applied_rate.  Also
GST_SEEK_TYPE_CUR has been removed.

It seems from the Gstreamer 1.0 porting guide that GstSegment underwent a
sanitization process between 0.10 and 1.0 so it would be good if the
documentation could reflect that.

I have been attempting to understand GstSegment in 1.0 (having had no exposure
to GstSegment in 0.10).  I have attached my notes so far from reading
gstsegment.c and working though the different transformations that the included
functions do.  I'm still trying to work things out so hopefully I'll be able to
make the notes more coherent in the future.

-- 
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.