| Chris@1 | 1 <html> | 
| Chris@1 | 2 | 
| Chris@1 | 3 <head> | 
| Chris@1 | 4 <title>libogg - datatype - ogg_page</title> | 
| Chris@1 | 5 <link rel=stylesheet href="style.css" type="text/css"> | 
| Chris@1 | 6 </head> | 
| Chris@1 | 7 | 
| Chris@1 | 8 <body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff"> | 
| Chris@1 | 9 <table border=0 width=100%> | 
| Chris@1 | 10 <tr> | 
| Chris@1 | 11 <td><p class=tiny>libogg documentation</p></td> | 
| Chris@1 | 12 <td align=right><p class=tiny>libogg release 1.3.0 - 20110804</p></td> | 
| Chris@1 | 13 </tr> | 
| Chris@1 | 14 </table> | 
| Chris@1 | 15 | 
| Chris@1 | 16 <h1>ogg_page</h1> | 
| Chris@1 | 17 | 
| Chris@1 | 18 <p><i>declared in "ogg/ogg.h"</i></p> | 
| Chris@1 | 19 | 
| Chris@1 | 20 <p> | 
| Chris@1 | 21 The ogg_page struct encapsulates the data for an Ogg page. | 
| Chris@1 | 22 <p> | 
| Chris@1 | 23 Ogg pages are the fundamental unit of framing and interleave in an ogg bitstream. | 
| Chris@1 | 24 They are made up of packet segments of 255 bytes each. There can be as many as | 
| Chris@1 | 25 255 packet segments per page, for a maximum page size of a little under 64 kB. | 
| Chris@1 | 26 This is not a practical limitation as the segments can be joined across | 
| Chris@1 | 27 page boundaries allowing packets of arbitrary size. In practice many | 
| Chris@1 | 28 applications will not completely fill all pages because they flush the | 
| Chris@1 | 29 accumulated packets periodically order to bound latency more tightly. | 
| Chris@1 | 30 <p> | 
| Chris@1 | 31 <p>For a complete description of ogg pages and headers, please refer to the <a href="../framing.html">framing document</a>. | 
| Chris@1 | 32 | 
| Chris@1 | 33 <table border=0 width=100% color=black cellspacing=0 cellpadding=7> | 
| Chris@1 | 34 <tr bgcolor=#cccccc> | 
| Chris@1 | 35 	<td> | 
| Chris@1 | 36 <pre><b> | 
| Chris@1 | 37 typedef struct { | 
| Chris@1 | 38   unsigned char *header; | 
| Chris@1 | 39   long           header_len; | 
| Chris@1 | 40   unsigned char *body; | 
| Chris@1 | 41   long           body_len; | 
| Chris@1 | 42 } ogg_page; | 
| Chris@1 | 43 </b></pre> | 
| Chris@1 | 44 	</td> | 
| Chris@1 | 45 </tr> | 
| Chris@1 | 46 </table> | 
| Chris@1 | 47 | 
| Chris@1 | 48 <h3>Relevant Struct Members</h3> | 
| Chris@1 | 49 <dl> | 
| Chris@1 | 50 <dt><i>header</i></dt> | 
| Chris@1 | 51 <dd>Pointer to the page header for this page.  The exact contents of this header are defined in the framing spec document.</dd> | 
| Chris@1 | 52 <dt><i>header_len</i></dt> | 
| Chris@1 | 53 <dd>Length of the page header in bytes.</a> | 
| Chris@1 | 54 <dt><i>body</i></dt> | 
| Chris@1 | 55 <dd>Pointer to the data for this page.</dd> | 
| Chris@1 | 56 <dt><i>body_len</i></dt> | 
| Chris@1 | 57 <dd>Length of the body data in bytes.</dd> | 
| Chris@1 | 58 </dl> | 
| Chris@1 | 59 | 
| Chris@1 | 60 | 
| Chris@1 | 61 <br><br> | 
| Chris@1 | 62 <hr noshade> | 
| Chris@1 | 63 <table border=0 width=100%> | 
| Chris@1 | 64 <tr valign=top> | 
| Chris@1 | 65 <td><p class=tiny>copyright © 2000-2011 Xiph.Org</p></td> | 
| Chris@1 | 66 <td align=right><p class=tiny><a href="http://www.xiph.org/ogg/">Ogg Container Format</a></p></td> | 
| Chris@1 | 67 </tr><tr> | 
| Chris@1 | 68 <td><p class=tiny>libogg documentation</p></td> | 
| Chris@1 | 69 <td align=right><p class=tiny>libogg release 1.3.0 - 20110804</p></td> | 
| Chris@1 | 70 </tr> | 
| Chris@1 | 71 </table> | 
| Chris@1 | 72 | 
| Chris@1 | 73 </body> | 
| Chris@1 | 74 | 
| Chris@1 | 75 </html> |