FileDocCategorySizeDatePackage
FrameBodyEQUA.javaAPI DocJaudiotagger 2.0.43627Wed Mar 30 16:12:02 BST 2011org.jaudiotagger.tag.id3.framebody

FrameBodyEQUA

public class FrameBodyEQUA extends AbstractID3v2FrameBody implements ID3v23FrameBody
Equalisation frame.

This is another subjective, alignment frame. It allows the user to predefine an equalisation curve within the audio file. There may only be one "EQUA" frame in each tag.

<Header of 'Equalisation', ID: "EQUA">
Adjustment bits$xx

The 'adjustment bits' field defines the number of bits used for representation of the adjustment. This is normally $10 (16 bits) for MPEG 2 layer I, II and III and MPEG 2.5. This value may not be $00.

This is followed by 2 bytes + ('adjustment bits' rounded up to the nearest byte) for every equalisation band in the following format, giving a frequency range of 0 - 32767Hz:

Increment/decrement%x (MSB of the Frequency)
Frequency (lower 15 bits)
Adjustment$xx (xx ...)

The increment/decrement bit is 1 for increment and 0 for decrement. The equalisation bands should be ordered increasingly with reference to frequency. All frequencies don't have to be declared. The equalisation curve in the reading software should be interpolated between the values in this frame. Three equal adjustments for three subsequent frequencies. A frequency should only be described once in the frame.

For more details, please refer to the ID3 specifications:

author
: Paul Taylor
author
: Eric Farng
version
$Id: FrameBodyEQUA.java 905 2010-05-14 19:37:31Z paultaylor $

Fields Summary
Constructors Summary
public FrameBodyEQUA()
Creates a new FrameBodyEQUA dataType.

    
public FrameBodyEQUA(FrameBodyEQUA body)

        super(body);
    
Methods Summary
public java.lang.StringgetIdentifier()
The ID3v2 frame identifier

return
the ID3v2 frame identifier for this frame type

        return ID3v23Frames.FRAME_ID_V3_EQUALISATION;
    
protected voidsetupObjectList()
TODO:proper mapping

        objectList.add(new ByteArraySizeTerminated(DataTypes.OBJ_DATA, this));