From dc839287d21dad495acaffc51df3f059c1df9ea1 Mon Sep 17 00:00:00 2001 From: Josh Coalson Date: Mon, 16 Apr 2001 20:27:00 +0000 Subject: [PATCH] add documentation of SEEKTABLE and escape codes in Rice partition --- doc/format.html | 113 +++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 107 insertions(+), 6 deletions(-) diff --git a/doc/format.html b/doc/format.html index d4fe8f5d..b90d3515 100644 --- a/doc/format.html +++ b/doc/format.html @@ -218,9 +218,10 @@

  • FLAC supports up to 128 kinds of metadata blocks; currently the following are defined:

  • @@ -364,6 +365,9 @@
  • 2 : APPLICATION
    • +
  • + 3 : SEEKTABLE +
  • 3-127 : reserved
    • @@ -392,7 +396,7 @@ -     METADATA_BLOCK_STREAMINFO
    || METADATA_BLOCK_PADDING
    || METADATA_BLOCK_APPLICATION + METADATA_BLOCK_STREAMINFO
    || METADATA_BLOCK_PADDING
    || METADATA_BLOCK_APPLICATION
    || METADATA_BLOCK_SEEKTABLE The block data must match the block type in the block header. @@ -546,6 +550,95 @@

    +

    +
    + + + + + + + + + + + + +
    + METADATA_BLOCK_SEEKTABLE +
    + SEEKPOINT+ + + One or more seek points. +
    + + NOTE
    +
      +
    • + The number of seek points is implied by the metadata header 'length' field, i.e. equal to length / 18. +
      • +
    +
    +
    +

    + +

    +
    + + + + + + + + + + + + + + + + + + + + +
    + METADATA_BLOCK_SEEKPOINT +
    + <64> + + Sample number of first sample in the target frame, or 0xFFFFFFFFFFFFFFFF for a placeholder point. +
    + <64> + + Offset (in bytes) from the first byte of the first frame header to the first byte of the target frame's header. +
    + <16> + + Number of samples in the target frame. +
    + + NOTES
    +
      +
    • + For placeholder points, the second and third field values are undefined. +
      • +
    • + Seek points within a table must be sorted in ascending order by sample number. +
      • +
    • + Seek points within a table must be unique by sample number, with the exception of placeholder points. +
      • +
    • + The previous two notes imply that there may be any number of placeholder points, but they must all occur at the end of the table. +
      • +
    +
    +
    +

    +

    @@ -1145,10 +1238,18 @@
    - <4> + <4(+5)> - Rice parameter + Encoding parameter:
    +
      +
    • + 0000-1110 : Rice parameter. +
      • +
    • + 1111 : Escape code, meaning the partition is in unencoded binary form using n bits per sample; n follows as a 5-bit number. +
      • +