OggOpus - Revision history

MrZeus: /* Content Type */ use latest rfc and link to section directly

2017-01-06T15:55:40Z

Content Type: use latest rfc and link to section directly

← Older revision		Revision as of 15:55, 6 January 2017
Line 16:		Line 16:
	=== Content Type ===		=== Content Type ===

	The recommended mime-type for Ogg Opus files is '''audio/ogg''', defined in [https://~~www~~.ietf.org/~~rfc~~/~~rfc5334.txt~~ RFC ~~5334~~].		The recommended mime-type for Ogg Opus files is '''audio/ogg''', defined in '''[https://tools.ietf.org/html/rfc7845#section-9 RFC 7845]'''.

	If more specificity is desired, one can distinguish Opus files as 'audio/ogg; codecs=opus'.		If more specificity is desired, one can distinguish Opus files as 'audio/ogg; codecs=opus'.

MrZeus at 10:05, 18 May 2016

2016-05-18T10:05:52Z

← Older revision		Revision as of 10:05, 18 May 2016
Line 1:		Line 1:
	'''~~Superceded~~ by [https://tools.ietf.org/html/rfc7845 RFC 7845].'''		'''The mappings described in this page have been superseded by [https://tools.ietf.org/html/rfc7845 RFC 7845].'''


Line 11:		Line 11:

	* The magic number for stream identification,		* The magic number for stream identification,
	* The stream count and coupling for ~~multichannel~~ audio, and		* The stream count and coupling for multi-channel audio, and
	* Any metadata or tags.		* Any metadata or tags.

MarkH: draft is now RFC 7845

2016-05-01T04:05:38Z

draft is now RFC 7845

← Older revision		Revision as of 04:05, 1 May 2016
Line 1:		Line 1:
	'''Superceded by [https://tools.ietf.org/html/~~draft-ietf-codec-oggopus the IETF draft~~].'''		'''Superceded by [https://tools.ietf.org/html/rfc7845 RFC 7845].'''

MarkH: spelling, update URLs

2015-12-31T04:55:06Z

spelling, update URLs

← Older revision		Revision as of 04:55, 31 December 2015
Line 1:		Line 1:
	'''~~Superceeded~~ by [~~http~~://tools.ietf.org/html/draft-~~terriberry~~-oggopus the ~~ietf~~ draft].'''		'''Superceded by [https://tools.ietf.org/html/draft-ietf-codec-oggopus the IETF draft].'''


	== Ogg Mapping for Opus ==		== Ogg Mapping for Opus ==

	The IETF Opus codec is a low-latency audio codec optimized for both voice and general-purpose audio. See the [~~http~~://tools.ietf.org/html/~~draft-ietf-codec-opus~~ Opus Specification] for technical details.		The IETF Opus codec is a low-latency audio codec optimized for both voice and general-purpose audio. See the [https://tools.ietf.org/html/rfc6716 Opus Specification] for technical details.

	Almost everything about Opus is either fixed or dynamically switchable, so most of the usual ID and setup header parameters in the header packets of an Ogg encapsulation aren't needed. In particular, bitrate, packet duration, mono/stereo flags, and coding modes are all dynamically switchable from packet to packet. The first one or two bytes in each data packet, the start of the 'TOC sequence' that defines the layout of the packet, specifies all of these parameters for that particular packet. See Section 3 of the Opus Specification for the exact format of the TOC sequence.		Almost everything about Opus is either fixed or dynamically switchable, so most of the usual ID and setup header parameters in the header packets of an Ogg encapsulation aren't needed. In particular, bitrate, packet duration, mono/stereo flags, and coding modes are all dynamically switchable from packet to packet. The first one or two bytes in each data packet, the start of the 'TOC sequence' that defines the layout of the packet, specifies all of these parameters for that particular packet. See Section 3 of the Opus Specification for the exact format of the TOC sequence.
Line 16:		Line 16:
	=== Content Type ===		=== Content Type ===

	The recommended mime-type for Ogg Opus files is '''audio/ogg''', defined in [~~http~~://www.ietf.org/rfc/rfc5334.txt RFC 5334].		The recommended mime-type for Ogg Opus files is '''audio/ogg''', defined in [https://www.ietf.org/rfc/rfc5334.txt RFC 5334].

	If more specificity is desired, one can distinguish Opus files as 'audio/ogg; codecs=opus'.		If more specificity is desired, one can distinguish Opus files as 'audio/ogg; codecs=opus'.
Line 24:		Line 24:
	=== Packet Organization ===		=== Packet Organization ===

	Opus is framed in a continuous logical [~~http~~://www.xiph.org/ogg/doc/framing.html Ogg stream].		Opus is framed in a continuous logical [https://www.xiph.org/ogg/doc/framing.html Ogg stream].

	There are two mandatory headers. The granule position of the pages containing these headers MUST be zero.		There are two mandatory headers. The granule position of the pages containing these headers MUST be zero.
Line 160:		Line 160:
	** 2 channels: stereo (left, right)		** 2 channels: stereo (left, right)
	** '''Special mapping''': this channel mapping value also indicates that the contents consists of a single Opus stream that is stereo if and only if c==2, with stream index 0 mapped to channel 0, and (if stereo) stream index 1 mapped to channel 1. When the channel mapping byte has this value, no further fields are present in OpusHead.		** '''Special mapping''': this channel mapping value also indicates that the contents consists of a single Opus stream that is stereo if and only if c==2, with stream index 0 mapped to channel 0, and (if stereo) stream index 1 mapped to channel 1. When the channel mapping byte has this value, no further fields are present in OpusHead.
	* Family 1 ([~~http~~://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-~~800004~~.3.9 Vorbis channel order])		* Family 1 ([https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-810004.3.9 Vorbis channel order])
	** Allowed numbers of channels: 1 ... 8		** Allowed numbers of channels: 1 ... 8
	** Channel meanings depend on the number of channels, see the Vorbis mapping for details.		** Channel meanings depend on the number of channels, see the Vorbis mapping for details.
Line 206:		Line 206:
	One new comment field is introduced for Ogg Opus:		One new comment field is introduced for Ogg Opus:
	R128_TRACK_GAIN=-573		R128_TRACK_GAIN=-573
	representing the volume shift needed to normalize the track's volume. The gain is a Q7.8 fixed point number in dB, as in the OpusHead "output gain" field. This field is similar to the [[VorbisComment#Replay_Gain\|REPLAYGAIN_TRACK_GAIN field in Vorbis]], although the normal volume reference is the [~~http~~://tech.ebu.ch/loudness EBU-R128] standard.		representing the volume shift needed to normalize the track's volume. The gain is a Q7.8 fixed point number in dB, as in the OpusHead "output gain" field. This field is similar to the [[VorbisComment#Replay_Gain\|REPLAYGAIN_TRACK_GAIN field in Vorbis]], although the normal volume reference is the [https://tech.ebu.ch/loudness EBU-R128] standard.

	An Ogg Opus file MUST NOT have more than one such field, and if present its value MUST be an integer from -32768 to +32767 inclusive, represented in ASCII with no whitespace. If present, it MUST correctly represent the R128 normalization gain (relative to the OpusHead output gain). If a player chooses to make use of the TRACK_GAIN, it MUST be applied ''in addition'' to the OpusHead output gain. If an encoder populates the TRACK_GAIN field, and the output gain is not otherwise constrained or specified, the encoder SHOULD write the R128 gain into the OpusHead output gain and write "R128_TRACK_GAIN=0". If a tool modifies the OpusHead "output gain" field, it MUST also update or remove the R128_TRACK_GAIN comment field.		An Ogg Opus file MUST NOT have more than one such field, and if present its value MUST be an integer from -32768 to +32767 inclusive, represented in ASCII with no whitespace. If present, it MUST correctly represent the R128 normalization gain (relative to the OpusHead output gain). If a player chooses to make use of the TRACK_GAIN, it MUST be applied ''in addition'' to the OpusHead output gain. If an encoder populates the TRACK_GAIN field, and the output gain is not otherwise constrained or specified, the encoder SHOULD write the R128 gain into the OpusHead output gain and write "R128_TRACK_GAIN=0". If a tool modifies the OpusHead "output gain" field, it MUST also update or remove the R128_TRACK_GAIN comment field.

MrZeus at 09:05, 19 August 2015

2015-08-19T09:05:19Z

← Older revision		Revision as of 09:05, 19 August 2015
Line 227:		Line 227:
	* Opus test vectors		* Opus test vectors

			[[Category:Ogg]]
	[[Category:Opus]]		[[Category:Opus]]

MrZeus: /* Test Vectors */

2015-08-18T15:34:00Z

Test Vectors

← Older revision		Revision as of 15:34, 18 August 2015
Line 226:		Line 226:
	* [[OggOpus/testvectors\|Planned test vectors for OggOpus]]		* [[OggOpus/testvectors\|Planned test vectors for OggOpus]]
	* Opus test vectors		* Opus test vectors

			[[Category:Opus]]

Gmaxwell: Reverted edits by Domtheo (talk) to last revision by Rillian

2013-11-13T06:59:34Z

Reverted edits by Domtheo (talk) to last revision by Rillian

← Older revision		Revision as of 06:59, 13 November 2013
Line 24:		Line 24:
	=== Packet Organization ===		=== Packet Organization ===

	Opus is framed in a continuous logical [http://www.~~awanirentcar~~.~~com Sewa mobil jakarta], [http:~~//~~kiosauto.com Aksesoris mobil], [http:/~~/~~www.tokobungasabana~~.~~com Toko bunga online bandung], [http://vamostech.com/gps-tracking Gps tracking motor~~].		Opus is framed in a continuous logical [http://www.xiph.org/ogg/doc/framing.html Ogg stream].

	There are two mandatory headers. The granule position of the pages containing these headers MUST be zero.		There are two mandatory headers. The granule position of the pages containing these headers MUST be zero.

Domtheo at 06:55, 13 November 2013

2013-11-13T06:55:28Z

← Older revision		Revision as of 06:55, 13 November 2013
Line 24:		Line 24:
	=== Packet Organization ===		=== Packet Organization ===

	Opus is framed in a continuous logical [http://www.~~xiph~~.~~org~~/~~ogg~~/~~doc~~/~~framing~~.~~html Ogg stream~~].		Opus is framed in a continuous logical [http://www.awanirentcar.com Sewa mobil jakarta], [http://kiosauto.com Aksesoris mobil], [http://www.tokobungasabana.com Toko bunga online bandung], [http://vamostech.com/gps-tracking Gps tracking motor].

	There are two mandatory headers. The granule position of the pages containing these headers MUST be zero.		There are two mandatory headers. The granule position of the pages containing these headers MUST be zero.

Rillian: Link to the ietf draft

2012-07-05T22:44:49Z

Link to the ietf draft

← Older revision		Revision as of 22:44, 5 July 2012
Line 1:		Line 1:
			'''Superceeded by [http://tools.ietf.org/html/draft-terriberry-oggopus the ietf draft].'''


	== Ogg Mapping for Opus ==		== Ogg Mapping for Opus ==

Rillian: /* Ogg Mapping for Opus */ mime-type and filename extension

2012-05-23T23:40:12Z

Ogg Mapping for Opus: mime-type and filename extension

← Older revision		Revision as of 23:40, 23 May 2012
Line 10:		Line 10:
	* The stream count and coupling for multichannel audio, and		* The stream count and coupling for multichannel audio, and
	* Any metadata or tags.		* Any metadata or tags.

			=== Content Type ===

			The recommended mime-type for Ogg Opus files is '''audio/ogg''', defined in [http://www.ietf.org/rfc/rfc5334.txt RFC 5334].

			If more specificity is desired, one can distinguish Opus files as 'audio/ogg; codecs=opus'.

			The recommended filename extension for Ogg Opus files is '''.opus'''.

	=== Packet Organization ===		=== Packet Organization ===