org.farng.mp3.id3
Class FrameBodyRVA2

java.lang.Object
  org.farng.mp3.AbstractMP3FileItem
      org.farng.mp3.AbstractMP3FragmentBody
          org.farng.mp3.id3.AbstractID3v2FrameBody
              org.farng.mp3.id3.FrameBodyRVA2

public class FrameBodyRVA2

extends AbstractID3v2FrameBody

4.11. Relative volume adjustment (2)

This is a more subjective frame than the previous ones. It allows the
user to say how much he wants to increase/decrease the volume on each
channel when the file is played. The purpose is to be able to align

all files to a reference volume, so that you don't have to change the
volume constantly. This frame may also be used to balance adjust the
audio. The volume adjustment is encoded as a fixed point decibel
value, 16 bit signed integer representing (adjustment*512), giving
+/- 64 dB with a precision of 0.001953125 dB. E.g. +2 dB is stored as

$04 00 and -2 dB is $FC 00. There may be more than one "RVA2" frame
in each tag, but only one with the same identification string.

<Header for 'Relative volume adjustment (2)', ID: "RVA2">

Identification <text string> $00

The 'identification' string is used to identify the situation and/or
device where this adjustment should apply. The following is then
repeated for every channel

Type of channel $xx
Volume adjustment $xx xx
Bits representing peak $xx

Peak volume $xx (xx ...)

Type of channel: $00 Other

$01 Master volume
$02 Front right
$03 Front left

$04 Back right
$05 Back left
$06 Front centre

$07 Back centre
$08 Subwoofer

Bits representing peak can be any number between 0 and 255. 0 means

that there is no peak volume field. The peak volume field is always
padded to whole bytes, setting the most significant bits to zero.

Version:

$Revision: 1.3 $

Author:

Eric Farng

Constructor Summary

FrameBodyRVA2()
Creates a new FrameBodyRVA2 object.

FrameBodyRVA2(FrameBodyRVA2 body)
Creates a new FrameBodyRVA2 object.

Method Summary

java.lang.String	getIdentifier() ID string that usually corresponds to the class name, but can be displayed to the user.
protected void	setupObjectList() Create the order of MP3Object objects that this body expects.

Methods inherited from class org.farng.mp3.id3.AbstractID3v2FrameBody

equals, readHeader, writeHeader

Methods inherited from class org.farng.mp3.AbstractMP3FragmentBody

appendToObjectList, getBriefDescription, getDescription, getObject, getObjectListIterator, getSize, has6ByteHeader, isSubsetOf, iterator, read, setObject, toString, write

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

FrameBodyRVA2

public FrameBodyRVA2()

Creates a new FrameBodyRVA2 object.

FrameBodyRVA2

public FrameBodyRVA2(FrameBodyRVA2 body)

Creates a new FrameBodyRVA2 object.

Method Detail

setupObjectList

protected void setupObjectList()

Description copied from class: AbstractMP3FragmentBody

Create the order of MP3Object objects that this body expects. This method needs to be overwritten.

Specified by:

setupObjectList in class AbstractMP3FragmentBody

getIdentifier

public java.lang.String getIdentifier()

Description copied from class: AbstractMP3FileItem

ID string that usually corresponds to the class name, but can be displayed to the user. It is not indended to identify each individual instance.

Specified by:

getIdentifier in class AbstractMP3FileItem

Returns:

ID string