OpusExtensions: Difference between revisions

From XiphWiki
Jump to navigation Jump to search
(Derf's braindump from IRC)
(RFC 7845)
 
(3 intermediate revisions by 2 users not shown)
Line 3: Line 3:
Below is a list of such alternate sequences, to avoid duplication.
Below is a list of such alternate sequences, to avoid duplication.


== List of invalid Opus audio data sequences ==
== List of reserved invalid Opus TOC sequences ==


* `Op` is used as a prefix for metadata headers in .opus files. [https://tools.ietf.org/html/draft-ietf-codec-oggopus RFC 7845]
* `Op` is used as a prefix for metadata headers in .opus files. [https://tools.ietf.org/html/rfc7845 RFC 7845]
* '0x3FF' in the first 11 bits marks an `opus_access_unit` in mpeg-ts. [[OpusTS]]
* '0x3FF' in the first 11 bits marks an `opus_control_header` in MPEG-TS. [[OpusTS]]


== Constructing invalid sequences ==
== Space of all invalid Opus TOC sequences ==


  The only restriction that doesn't depend on the number of bytes
* 0x0300
  in the packet is [R5], which is, "Code 3 packets contain at least
* 0x030D...0x0340
  one frame, but no more than 120 ms of audio total."
* 0x034D...0x0380
* 0x038D...0x03C0
* 0x03CD...0x03FF
 
* 0x0700
* 0x070D...0x0740
* 0x074D...0x0780
* 0x078D...0x07C0
* 0x07CD...0x07FF
 
* 0x0B00
* 0x0B07...0x0B40
* 0x0B47...0x0B80
* 0x0B87...0x0BC0
* 0x0BC7...0x0BFF
 
* 0x0F00
* 0x0F07...0x0F40
* 0x0F47...0x0F80
* 0x0F87...0x0FC0
* 0x0FC7...0x0FFF
 
* 0x1300
* 0x1304...0x1340
* 0x1344...0x1380
* 0x1384...0x13C0
* 0x13C4...0x13FF
 
* 0x1700
* 0x1704...0x1740
* 0x1744...0x1780
* 0x1784...0x17C0
* 0x17C4...0x17FF
 
* 0x1B00
* 0x1B03...0x1B40
* 0x1B43...0x1B80
* 0x1B83...0x1BC0
* 0x1BC3...0x1BFF
 
* 0x1F00
* 0x1F03...0x1F40
* 0x1F43...0x1F80
* 0x1F83...0x1FC0
* 0x1FC3...0x1FFF
 
* 0x2300
* 0x230D...0x2340
* 0x234D...0x2380
* 0x238D...0x23C0
* 0x23CD...0x23FF
 
* 0x2700
* 0x270D...0x2740
* 0x274D...0x2780
* 0x278D...0x27C0
* 0x27CD...0x27FF
 
* 0x2B00
* 0x2B07...0x2B40
* 0x2B47...0x2B80
* 0x2B87...0x2BC0
* 0x2BC7...0x2BFF
 
* 0x2F00
* 0x2F07...0x2F40
* 0x2F47...0x2F80
* 0x2F87...0x2FC0
* 0x2FC7...0x2FFF
 
* 0x3300
* 0x3304...0x3340
* 0x3344...0x3380
* 0x3384...0x33C0
* 0x33C4...0x33FF
 
* 0x3700
* 0x3704...0x3740
* 0x3744...0x3780
* 0x3784...0x37C0
* 0x37C4...0x37FF
 
* 0x3B00
* 0x3B03...0x3B40
* 0x3B43...0x3B80
* 0x3B83...0x3BC0
* 0x3BC3...0x3BFF
 
* 0x3F00
* 0x3F03...0x3F40
* 0x3F43...0x3F80
* 0x3F83...0x3FC0
* 0x3FC3...0x3FFF
 
* 0x4300
* 0x430D...0x4340
* 0x434D...0x4380
* 0x438D...0x43C0
* 0x43CD...0x43FF
 
* 0x4700
* 0x470D...0x4740
* 0x474D...0x4780
* 0x478D...0x47C0
* 0x47CD...0x47FF
 
* 0x4B00
* 0x4B07...0x4B40
* 0x4B47...0x4B80
* 0x4B87...0x4BC0
* 0x4BC7...0x4BFF
 
* 0x4F00
* 0x4F07...0x4F40
* 0x4F47...0x4F6F
* 0x4F70 ("Op"): ID and Comment headers in .opus files [https://tools.ietf.org/html/rfc7845 RFC 7845]
* 0x4F71...0x4F80
* 0x4F87...0x4FC0
* 0x4FC7...0x4FFF
 
* 0x5300
* 0x5304...0x5340
* 0x5344...0x5380
* 0x5384...0x53C0
* 0x53C4...0x53FF
 
* 0x5700
* 0x5704...0x5740
* 0x5744...0x5780
* 0x5784...0x57C0
* 0x57C4...0x57FF
 
* 0x5B00
* 0x5B03...0x5B40
* 0x5B43...0x5B80
* 0x5B83...0x5BC0
* 0x5BC3...0x5BFF
 
* 0x5F00
* 0x5F03...0x5F40
* 0x5F43...0x5F80
* 0x5F83...0x5FC0
* 0x5FC3...0x5FFF
 
* 0x6300
* 0x630D...0x6340
* 0x634D...0x6380
* 0x638D...0x63C0
* 0x63CD...0x63FF
 
* 0x6700
* 0x670D...0x6740
* 0x674D...0x6780
* 0x678D...0x67C0
* 0x67CD...0x67FF
 
* 0x6B00
* 0x6B07...0x6B40
* 0x6B47...0x6B80
* 0x6B87...0x6BC0
* 0x6BC7...0x6BFF
 
* 0x6F00
* 0x6F07...0x6F40
* 0x6F47...0x6F80
* 0x6F87...0x6FC0
* 0x6FC7...0x6FFF
 
* 0x7300
* 0x730D...0x7340
* 0x734D...0x7380
* 0x738D...0x73C0
* 0x73CD...0x73FF
 
* 0x7700
* 0x770D...0x7740
* 0x774D...0x7780
* 0x778D...0x77C0
* 0x77CD...0x77FF
 
* 0x7B00
* 0x7B07...0x7B40
* 0x7B47...0x7B80
* 0x7B87...0x7BC0
* 0x7BC7...0x7BFF
 
* 0x7F00
* 0x7F07...0x7F40
* 0x7F47...0x7F80
* 0x7F87...0x7FC0
* 0x7FC7...0x7FDF
* 0x7FE0...0x7FFF: opus_control_header in MPEG-TS [[OpusTS]]
 
* 0x8300
* 0x8331...0x8340
* 0x8371...0x8380
* 0x83B1...0x83C0
* 0x83F1...0x83FF
 
* 0x8700
* 0x8731...0x8740
* 0x8771...0x8780
* 0x87B1...0x87C0
* 0x87F1...0x87FF
 
* 0x8B00
* 0x8B19...0x8B40
* 0x8B59...0x8B80
* 0x8B99...0x8BC0
* 0x8BD9...0x8BFF
 
* 0x8F00
* 0x8F19...0x8F40
* 0x8F59...0x8F80
* 0x8F99...0x8FC0
* 0x8FD9...0x8FFF
 
* 0x9300
* 0x930D...0x9340
* 0x934D...0x9380
* 0x938D...0x93C0
* 0x93CD...0x93FF
 
* 0x9700
* 0x970D...0x9740
* 0x974D...0x9780
* 0x978D...0x97C0
* 0x97CD...0x97FF
 
* 0x9B00
* 0x9B07...0x9B40
* 0x9B47...0x9B80
* 0x9B87...0x9BC0
* 0x9BC7...0x9BFF
 
* 0x9F00
* 0x9F07...0x9F40
* 0x9F47...0x9F80
* 0x9F87...0x9FC0
* 0x9FC7...0x9FFF
 
* 0xA300
* 0xA331...0xA340
* 0xA371...0xA380
* 0xA3B1...0xA3C0
* 0xA3F1...0xA3FF
 
* 0xA700
* 0xA731...0xA740
* 0xA771...0xA780
* 0xA7B1...0xA7C0
* 0xA7F1...0xA7FF
 
* 0xAB00
* 0xAB19...0xAB40
* 0xAB59...0xAB80
* 0xAB99...0xABC0
* 0xABD9...0xABFF
 
* 0xAF00
* 0xAF19...0xAF40
* 0xAF59...0xAF80
* 0xAF99...0xAFC0
* 0xAFD9...0xAFFF
 
* 0xB300
* 0xB30D...0xB340
* 0xB34D...0xB380
* 0xB38D...0xB3C0
* 0xB3CD...0xB3FF
 
* 0xB700
* 0xB70D...0xB740
* 0xB74D...0xB780
* 0xB78D...0xB7C0
* 0xB7CD...0xB7FF
 
* 0xBB00
* 0xBB07...0xBB40
* 0xBB47...0xBB80
* 0xBB87...0xBBC0
* 0xBBC7...0xBBFF
 
* 0xBF00
* 0xBF07...0xBF40
* 0xBF47...0xBF80
* 0xBF87...0xBFC0
* 0xBFC7...0xBFFF
 
* 0xC300
* 0xC331...0xC340
* 0xC371...0xC380
* 0xC3B1...0xC3C0
* 0xC3F1...0xC3FF
 
* 0xC700
* 0xC731...0xC740
* 0xC771...0xC780
* 0xC7B1...0xC7C0
* 0xC7F1...0xC7FF
 
* 0xCB00
* 0xCB19...0xCB40
* 0xCB59...0xCB80
* 0xCB99...0xCBC0
* 0xCBD9...0xCBFF
 
* 0xCF00
* 0xCF19...0xCF40
* 0xCF59...0xCF80
* 0xCF99...0xCFC0
* 0xCFD9...0xCFFF
 
* 0xD300
* 0xD30D...0xD340
* 0xD34D...0xD380
* 0xD38D...0xD3C0
* 0xD3CD...0xD3FF
 
* 0xD700
* 0xD70D...0xD740
* 0xD74D...0xD780
* 0xD78D...0xD7C0
* 0xD7CD...0xD7FF
 
* 0xDB00
* 0xDB07...0xDB40
* 0xDB47...0xDB80
* 0xDB87...0xDBC0
* 0xDBC7...0xDBFF
 
* 0xDF00
* 0xDF07...0xDF40
* 0xDF47...0xDF80
* 0xDF87...0xDFC0
* 0xDFC7...0xDFFF
 
* 0xE300
* 0xE331...0xE340
* 0xE371...0xE380
* 0xE3B1...0xE3C0
* 0xE3F1...0xE3FF
 
* 0xE700
* 0xE731...0xE740
* 0xE771...0xE780
* 0xE7B1...0xE7C0
* 0xE7F1...0xE7FF
 
* 0xEB00
* 0xEB19...0xEB40
* 0xEB59...0xEB80
* 0xEB99...0xEBC0
* 0xEBD9...0xEBFF
 
* 0xEF00
* 0xEF19...0xEF40
* 0xEF59...0xEF80
* 0xEF99...0xEFC0
* 0xEFD9...0xEFFF
 
* 0xF300
* 0xF30D...0xF340
* 0xF34D...0xF380
* 0xF38D...0xF3C0
* 0xF3CD...0xF3FF
 
* 0xF700
* 0xF70D...0xF740
* 0xF74D...0xF780
* 0xF78D...0xF7C0
* 0xF7CD...0xF7FF
 
* 0xFB00
* 0xFB07...0xFB40
* 0xFB47...0xFB80
* 0xFB87...0xFBC0
* 0xFBC7...0xFBFF
 
* 0xFF00
* 0xFF07...0xFF40
* 0xFF47...0xFF80
* 0xFF87...0xFFC0
* 0xFFC7...0xFFFF

Latest revision as of 20:12, 30 April 2016

Opus audio data packets begin with a "table of contents" (TOC) sequence which defines the frame duration, audio bandwidth and coding mode of the packet, as well as describing how individual frames are packed into the data packet. [RFC 6716 Section 3.1]. Other types of data packets are used with Opus in various containers are designed to start with a sequence which is not a valid TOC. This simplifies sorting such data for muxing implementations and ensures they will be rejected by the decoder if they are accidentally passed as Opus audio data.

Below is a list of such alternate sequences, to avoid duplication.

List of reserved invalid Opus TOC sequences

  • `Op` is used as a prefix for metadata headers in .opus files. RFC 7845
  • '0x3FF' in the first 11 bits marks an `opus_control_header` in MPEG-TS. OpusTS

Space of all invalid Opus TOC sequences

  • 0x0300
  • 0x030D...0x0340
  • 0x034D...0x0380
  • 0x038D...0x03C0
  • 0x03CD...0x03FF
  • 0x0700
  • 0x070D...0x0740
  • 0x074D...0x0780
  • 0x078D...0x07C0
  • 0x07CD...0x07FF
  • 0x0B00
  • 0x0B07...0x0B40
  • 0x0B47...0x0B80
  • 0x0B87...0x0BC0
  • 0x0BC7...0x0BFF
  • 0x0F00
  • 0x0F07...0x0F40
  • 0x0F47...0x0F80
  • 0x0F87...0x0FC0
  • 0x0FC7...0x0FFF
  • 0x1300
  • 0x1304...0x1340
  • 0x1344...0x1380
  • 0x1384...0x13C0
  • 0x13C4...0x13FF
  • 0x1700
  • 0x1704...0x1740
  • 0x1744...0x1780
  • 0x1784...0x17C0
  • 0x17C4...0x17FF
  • 0x1B00
  • 0x1B03...0x1B40
  • 0x1B43...0x1B80
  • 0x1B83...0x1BC0
  • 0x1BC3...0x1BFF
  • 0x1F00
  • 0x1F03...0x1F40
  • 0x1F43...0x1F80
  • 0x1F83...0x1FC0
  • 0x1FC3...0x1FFF
  • 0x2300
  • 0x230D...0x2340
  • 0x234D...0x2380
  • 0x238D...0x23C0
  • 0x23CD...0x23FF
  • 0x2700
  • 0x270D...0x2740
  • 0x274D...0x2780
  • 0x278D...0x27C0
  • 0x27CD...0x27FF
  • 0x2B00
  • 0x2B07...0x2B40
  • 0x2B47...0x2B80
  • 0x2B87...0x2BC0
  • 0x2BC7...0x2BFF
  • 0x2F00
  • 0x2F07...0x2F40
  • 0x2F47...0x2F80
  • 0x2F87...0x2FC0
  • 0x2FC7...0x2FFF
  • 0x3300
  • 0x3304...0x3340
  • 0x3344...0x3380
  • 0x3384...0x33C0
  • 0x33C4...0x33FF
  • 0x3700
  • 0x3704...0x3740
  • 0x3744...0x3780
  • 0x3784...0x37C0
  • 0x37C4...0x37FF
  • 0x3B00
  • 0x3B03...0x3B40
  • 0x3B43...0x3B80
  • 0x3B83...0x3BC0
  • 0x3BC3...0x3BFF
  • 0x3F00
  • 0x3F03...0x3F40
  • 0x3F43...0x3F80
  • 0x3F83...0x3FC0
  • 0x3FC3...0x3FFF
  • 0x4300
  • 0x430D...0x4340
  • 0x434D...0x4380
  • 0x438D...0x43C0
  • 0x43CD...0x43FF
  • 0x4700
  • 0x470D...0x4740
  • 0x474D...0x4780
  • 0x478D...0x47C0
  • 0x47CD...0x47FF
  • 0x4B00
  • 0x4B07...0x4B40
  • 0x4B47...0x4B80
  • 0x4B87...0x4BC0
  • 0x4BC7...0x4BFF
  • 0x4F00
  • 0x4F07...0x4F40
  • 0x4F47...0x4F6F
  • 0x4F70 ("Op"): ID and Comment headers in .opus files RFC 7845
  • 0x4F71...0x4F80
  • 0x4F87...0x4FC0
  • 0x4FC7...0x4FFF
  • 0x5300
  • 0x5304...0x5340
  • 0x5344...0x5380
  • 0x5384...0x53C0
  • 0x53C4...0x53FF
  • 0x5700
  • 0x5704...0x5740
  • 0x5744...0x5780
  • 0x5784...0x57C0
  • 0x57C4...0x57FF
  • 0x5B00
  • 0x5B03...0x5B40
  • 0x5B43...0x5B80
  • 0x5B83...0x5BC0
  • 0x5BC3...0x5BFF
  • 0x5F00
  • 0x5F03...0x5F40
  • 0x5F43...0x5F80
  • 0x5F83...0x5FC0
  • 0x5FC3...0x5FFF
  • 0x6300
  • 0x630D...0x6340
  • 0x634D...0x6380
  • 0x638D...0x63C0
  • 0x63CD...0x63FF
  • 0x6700
  • 0x670D...0x6740
  • 0x674D...0x6780
  • 0x678D...0x67C0
  • 0x67CD...0x67FF
  • 0x6B00
  • 0x6B07...0x6B40
  • 0x6B47...0x6B80
  • 0x6B87...0x6BC0
  • 0x6BC7...0x6BFF
  • 0x6F00
  • 0x6F07...0x6F40
  • 0x6F47...0x6F80
  • 0x6F87...0x6FC0
  • 0x6FC7...0x6FFF
  • 0x7300
  • 0x730D...0x7340
  • 0x734D...0x7380
  • 0x738D...0x73C0
  • 0x73CD...0x73FF
  • 0x7700
  • 0x770D...0x7740
  • 0x774D...0x7780
  • 0x778D...0x77C0
  • 0x77CD...0x77FF
  • 0x7B00
  • 0x7B07...0x7B40
  • 0x7B47...0x7B80
  • 0x7B87...0x7BC0
  • 0x7BC7...0x7BFF
  • 0x7F00
  • 0x7F07...0x7F40
  • 0x7F47...0x7F80
  • 0x7F87...0x7FC0
  • 0x7FC7...0x7FDF
  • 0x7FE0...0x7FFF: opus_control_header in MPEG-TS OpusTS
  • 0x8300
  • 0x8331...0x8340
  • 0x8371...0x8380
  • 0x83B1...0x83C0
  • 0x83F1...0x83FF
  • 0x8700
  • 0x8731...0x8740
  • 0x8771...0x8780
  • 0x87B1...0x87C0
  • 0x87F1...0x87FF
  • 0x8B00
  • 0x8B19...0x8B40
  • 0x8B59...0x8B80
  • 0x8B99...0x8BC0
  • 0x8BD9...0x8BFF
  • 0x8F00
  • 0x8F19...0x8F40
  • 0x8F59...0x8F80
  • 0x8F99...0x8FC0
  • 0x8FD9...0x8FFF
  • 0x9300
  • 0x930D...0x9340
  • 0x934D...0x9380
  • 0x938D...0x93C0
  • 0x93CD...0x93FF
  • 0x9700
  • 0x970D...0x9740
  • 0x974D...0x9780
  • 0x978D...0x97C0
  • 0x97CD...0x97FF
  • 0x9B00
  • 0x9B07...0x9B40
  • 0x9B47...0x9B80
  • 0x9B87...0x9BC0
  • 0x9BC7...0x9BFF
  • 0x9F00
  • 0x9F07...0x9F40
  • 0x9F47...0x9F80
  • 0x9F87...0x9FC0
  • 0x9FC7...0x9FFF
  • 0xA300
  • 0xA331...0xA340
  • 0xA371...0xA380
  • 0xA3B1...0xA3C0
  • 0xA3F1...0xA3FF
  • 0xA700
  • 0xA731...0xA740
  • 0xA771...0xA780
  • 0xA7B1...0xA7C0
  • 0xA7F1...0xA7FF
  • 0xAB00
  • 0xAB19...0xAB40
  • 0xAB59...0xAB80
  • 0xAB99...0xABC0
  • 0xABD9...0xABFF
  • 0xAF00
  • 0xAF19...0xAF40
  • 0xAF59...0xAF80
  • 0xAF99...0xAFC0
  • 0xAFD9...0xAFFF
  • 0xB300
  • 0xB30D...0xB340
  • 0xB34D...0xB380
  • 0xB38D...0xB3C0
  • 0xB3CD...0xB3FF
  • 0xB700
  • 0xB70D...0xB740
  • 0xB74D...0xB780
  • 0xB78D...0xB7C0
  • 0xB7CD...0xB7FF
  • 0xBB00
  • 0xBB07...0xBB40
  • 0xBB47...0xBB80
  • 0xBB87...0xBBC0
  • 0xBBC7...0xBBFF
  • 0xBF00
  • 0xBF07...0xBF40
  • 0xBF47...0xBF80
  • 0xBF87...0xBFC0
  • 0xBFC7...0xBFFF
  • 0xC300
  • 0xC331...0xC340
  • 0xC371...0xC380
  • 0xC3B1...0xC3C0
  • 0xC3F1...0xC3FF
  • 0xC700
  • 0xC731...0xC740
  • 0xC771...0xC780
  • 0xC7B1...0xC7C0
  • 0xC7F1...0xC7FF
  • 0xCB00
  • 0xCB19...0xCB40
  • 0xCB59...0xCB80
  • 0xCB99...0xCBC0
  • 0xCBD9...0xCBFF
  • 0xCF00
  • 0xCF19...0xCF40
  • 0xCF59...0xCF80
  • 0xCF99...0xCFC0
  • 0xCFD9...0xCFFF
  • 0xD300
  • 0xD30D...0xD340
  • 0xD34D...0xD380
  • 0xD38D...0xD3C0
  • 0xD3CD...0xD3FF
  • 0xD700
  • 0xD70D...0xD740
  • 0xD74D...0xD780
  • 0xD78D...0xD7C0
  • 0xD7CD...0xD7FF
  • 0xDB00
  • 0xDB07...0xDB40
  • 0xDB47...0xDB80
  • 0xDB87...0xDBC0
  • 0xDBC7...0xDBFF
  • 0xDF00
  • 0xDF07...0xDF40
  • 0xDF47...0xDF80
  • 0xDF87...0xDFC0
  • 0xDFC7...0xDFFF
  • 0xE300
  • 0xE331...0xE340
  • 0xE371...0xE380
  • 0xE3B1...0xE3C0
  • 0xE3F1...0xE3FF
  • 0xE700
  • 0xE731...0xE740
  • 0xE771...0xE780
  • 0xE7B1...0xE7C0
  • 0xE7F1...0xE7FF
  • 0xEB00
  • 0xEB19...0xEB40
  • 0xEB59...0xEB80
  • 0xEB99...0xEBC0
  • 0xEBD9...0xEBFF
  • 0xEF00
  • 0xEF19...0xEF40
  • 0xEF59...0xEF80
  • 0xEF99...0xEFC0
  • 0xEFD9...0xEFFF
  • 0xF300
  • 0xF30D...0xF340
  • 0xF34D...0xF380
  • 0xF38D...0xF3C0
  • 0xF3CD...0xF3FF
  • 0xF700
  • 0xF70D...0xF740
  • 0xF74D...0xF780
  • 0xF78D...0xF7C0
  • 0xF7CD...0xF7FF
  • 0xFB00
  • 0xFB07...0xFB40
  • 0xFB47...0xFB80
  • 0xFB87...0xFBC0
  • 0xFBC7...0xFBFF
  • 0xFF00
  • 0xFF07...0xFF40
  • 0xFF47...0xFF80
  • 0xFF87...0xFFC0
  • 0xFFC7...0xFFFF