org.farng.mp3.id3
Class FrameBodyEQU2

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

public class FrameBodyEQU2

extends AbstractID3v2FrameBody

4.12. Equalisation (2)

This is another subjective, alignment frame. It allows the user to

predefine an equalisation curve within the audio file. There may be
more than one "EQU2" frame in each tag, but only one with the same
identification string.

<Header of 'Equalisation (2)', ID: "EQU2">

Interpolation method $xx
Identification <text string> $00

The 'interpolation method' describes which method is preferred when

an interpolation between the adjustment point that follows. The
following methods are currently defined:

$00 Band
No interpolation is made. A jump from one adjustment level to

another occurs in the middle between two adjustment points.
$01 Linear
Interpolation between adjustment points is linear.

The 'identification' string is used to identify the situation and/or

device where this adjustment should apply. The following is then
repeated for every adjustment point

Frequency $xx xx
Volume adjustment $xx xx

The frequency is stored in units of 1/2 Hz, giving it a range from 0
to 32767 Hz.

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.

Adjustment points should be ordered by frequency and one frequency
should only be described once in the frame.

Version:

$Revision: 1.5 $

Author:

Eric Farng

Constructor Summary

FrameBodyEQU2()
Creates a new FrameBodyEQU2 object.

FrameBodyEQU2(byte interpolationMethod, java.lang.String owner, short frequency, short volumeAdjustment)
Creates a new FrameBodyEQU2 object.

FrameBodyEQU2(FrameBodyEQU2 body)
Creates a new FrameBodyEQU2 object.

FrameBodyEQU2(java.io.RandomAccessFile file)
Creates a new FrameBodyEQU2 object.

Method Summary

void	addGroup(short frequency, short volumeAdjustment)
java.lang.String	getIdentifier() ID string that usually corresponds to the class name, but can be displayed to the user.
java.lang.String	getOwner()
void	getOwner(java.lang.String description)
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

FrameBodyEQU2

public FrameBodyEQU2()

Creates a new FrameBodyEQU2 object.

FrameBodyEQU2

public FrameBodyEQU2(FrameBodyEQU2 body)

Creates a new FrameBodyEQU2 object.

FrameBodyEQU2

public FrameBodyEQU2(byte interpolationMethod,
                     java.lang.String owner,
                     short frequency,
                     short volumeAdjustment)

Creates a new FrameBodyEQU2 object.

FrameBodyEQU2

public FrameBodyEQU2(java.io.RandomAccessFile file)
              throws java.io.IOException,
                     InvalidTagException

Creates a new FrameBodyEQU2 object.

Method Detail

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

getOwner

public java.lang.String getOwner()

getOwner

public void getOwner(java.lang.String description)

addGroup

public void addGroup(short frequency,
                     short volumeAdjustment)

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