ID3v2.h

Go to the documentation of this file.

#ifndef __DCL_ID3V2_H__
#define __DCL_ID3V2_H__ 20250118
 
#ifndef __DCL_OBJECT_H__
#include <dcl/Object.h>
#endif
#ifndef __DCL_ARRAY_H__
#include <dcl/Array.h>
#endif
 
__DCL_BEGIN_NAMESPACE
 
class File;
 
class ID3v2 : public Object
{
    DECLARE_CLASSINFO(ID3v2)
 
public:
    ID3v2();
    ~ID3v2();

    static uint32_t word7(const char* _bytes, size_t _n);

    static uint32_t word8(const char* _bytes, size_t _n);

    bool read(File& _file, const char _header[10]);
 
    virtual String toString() const;
 
    const String& ID3() const {
        return __ID3;
    }
 
    char version() const {
        return __header[3];
    }
 
    char revision() const {
        return __header[4];
    }
 
    char flags() const {
        return __header[5];
    }
 
    uint32_t size() const {
        return __size;
    }
 
    // frame size에 사용된 bits의 수
    // 0 7 8
    unsigned fsbits() const {
        return __fsbits;
    }
 
    const PointerArray& frames() const {
        return __frames;
    }
 
protected:
 
    size_t skipExtendedHeader(
            const char* _begin,
            const char* _end
        ) const;
 
#define Unsynchronisation(flags)        flags & 0x0080
#define Extended_header(flags)          flags & 0x0040
#define Experimental_indicator(flags)   flags & 0x0020
#define Footer_present(flags)           flags & 0x0010
 
    char        __header[10];
 
    unsigned    __fsbits;
 
 
    char*       __data;

    String      __ID3;

    uint32_t    __size;
 
    PointerArray    __frames;
 
};
 
class ID3v2Frame : public Object
{
    DECLARE_CLASSINFO(ID3v2Frame)
protected:
    String decode(
            char _encoding,
            const char* _mbs, size_t _nmbs
        ) const;
 
public:
    ID3v2Frame(const ID3v2& _tag);
 
    uint32_t word(const char* _bytes, size_t _n) {
        return __tag.fsbits() == 7 ?
            ID3v2::word7(_bytes, _n)
            : ID3v2::word8(_bytes, _n);
    }
 
    size_t read(const char* _begin, const char* _end);
 
    virtual String toString() const;
 
    const ID3v2& tag() const {
        return __tag;
    }
 
    const String id() const {
        return __id;
    }
 
    uint32_t size() const {
        return __size;
    }
 
    short flags() const {
        return __flags;
    }
 
    char encoding() const {
        return __encoding;
    }
 
    char type() const {
        return __type;
    }
 
    const String& url() const {
        return __url;
    }
 
    const String& description() const {
        return __description;
    }
 
    const String& text() const {
        return __text;
    }
 
    const ByteString& binary() const {
        return __binary;
    }
 
protected:
 
    const ID3v2& __tag;
 
    // Frame ID 
    String      __id;
 
    // Frame header 10 bytes를 제외한 프레임 데이터 크기
    uint32_t    __size;
 
    short       __flags;
 
    // ISO-8859-1(0) UTF-16LE(1) UTF-16BE(2) UTF-8(3)
    char        __encoding;
    // Picture type
    char        __type;
 
    // URL, MIME, lang
    String      __url;
    String      __description;
    String      __text;
    ByteString  __binary;
 
};
 
__DCL_END_NAMESPACE
 
#endif  // __DCL_ID3V2_H__