[cvs-annodex] commit (/annodex): liboggz/trunk/include/oggz/oggz_seek.h

[conrad]

Update of /annodex (new revision 871)

Modified files:
   liboggz/trunk/include/oggz/oggz_seek.h

Log Message:
add definitions for granulerate and granuleshift getters


Modified: liboggz/trunk/include/oggz/oggz_seek.h
===================================================================
--- liboggz/trunk/include/oggz/oggz_seek.h	2005-02-10 08:17:22 UTC (rev 870)
+++ liboggz/trunk/include/oggz/oggz_seek.h	2005-02-10 16:47:48 UTC (rev 871)
@@ -245,6 +245,17 @@
  */
 
 /**
+ * Retrieve the granuleshift of a logical bitstream.
+ * \param oggz An OGGZ handle
+ * \param serialno Identify the logical bitstream in \a oggz
+ * \returns The granuleshift of the specified logical bitstream.
+ * \retval OGGZ_ERR_BAD_SERIALNO \a serialno does not identify an existing
+ * logical bitstream in \a oggz.
+ * \retval OGGZ_ERR_BAD_OGGZ \a oggz does not refer to an existing OGGZ
+ */
+int oggz_get_granuleshift (OGGZ * oggz, long serialno);
+
+/**
  * Specify the granuleshift of a logical bitstream.
  * \param oggz An OGGZ handle
  * \param serialno Identify the logical bitstream in \a oggz to attach
@@ -259,6 +270,22 @@
 int oggz_set_granuleshift (OGGZ * oggz, long serialno, int granuleshift);
 
 /**
+ * Retrieve the granulerate of a logical bitstream.
+ * \param oggz An OGGZ handle
+ * \param serialno Identify the logical bitstream in \a oggz
+ * \param granulerate_n Return location for the granulerate numerator
+ * \param granulerate_d Return location for the granulerate denominator
+ * \returns 0 Success
+ * \retval OGGZ_ERR_BAD_SERIALNO \a serialno does not identify an existing
+ * logical bitstream in \a oggz.
+ * \retval OGGZ_ERR_BAD_OGGZ \a oggz does not refer to an existing OGGZ
+ *
+ */
+int oggz_get_granulerate (OGGZ * oggz, long serialno,
+			  ogg_int64_t * granulerate_n,
+			  ogg_int64_t * granulerate_d);
+
+/**
  * Specify the granulerate of a logical bitstream.
  * \param oggz An OGGZ handle
  * \param serialno Identify the logical bitstream in \a oggz to attach


-- 
conrad