mp4atom.h

Go to the documentation of this file.

/**************************************************************************
    copyright            : (C) 2007,2011 by Lukáš Lalinský
    email                : lalinsky@gmail.com
 **************************************************************************/
 
/***************************************************************************
 *   This library is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU Lesser General Public License version   *
 *   2.1 as published by the Free Software Foundation.                     *
 *                                                                         *
 *   This library is distributed in the hope that it will be useful, but   *
 *   WITHOUT ANY WARRANTY; without even the implied warranty of            *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU     *
 *   Lesser General Public License for more details.                       *
 *                                                                         *
 *   You should have received a copy of the GNU Lesser General Public      *
 *   License along with this library; if not, write to the Free Software   *
 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA         *
 *   02110-1301  USA                                                       *
 *                                                                         *
 *   Alternatively, this file is available under the Mozilla Public        *
 *   License Version 1.1.  You may obtain a copy of the License at         *
 *   http://www.mozilla.org/MPL/                                           *
 ***************************************************************************/
 
// This file is not part of the public API!
 
#ifndef TAGLIB_MP4ATOM_H
#define TAGLIB_MP4ATOM_H
 
#include "tfile.h"
#include "tlist.h"
 
namespace TagLib {
  namespace MP4 {
 
    enum AtomDataType {
      TypeImplicit  = 0,
      TypeUTF8      = 1,
      TypeUTF16     = 2,
      TypeSJIS      = 3,
      TypeHTML      = 6,
      TypeXML       = 7,
      TypeUUID      = 8,
      TypeISRC      = 9,
      TypeMI3P      = 10,
      TypeGIF       = 12,
      TypeJPEG      = 13,
      TypePNG       = 14,
      TypeURL       = 15,
      TypeDuration  = 16,
      TypeDateTime  = 17,
      TypeGenred    = 18,
      TypeInteger   = 21,
      TypeRIAAPA    = 24,
      TypeUPC       = 25,
      TypeBMP       = 27,
      TypeUndefined = 255
    };
 
#ifndef DO_NOT_DOCUMENT
    struct AtomData {
      AtomData(AtomDataType ptype, const ByteVector &pdata) :
        type(ptype), data(pdata) { }
      AtomDataType type;
      int locale { 0 };
      ByteVector data;
    };
 
    class Atom;
    using AtomList = TagLib::List<Atom *>;
    using AtomDataList = TagLib::List<AtomData>;
 
    class TAGLIB_EXPORT Atom
    {
    public:
      Atom(File *file);
      ~Atom();
      Atom(const Atom &) = delete;
      Atom &operator=(const Atom &) = delete;
      Atom *find(const char *name1, const char *name2 = nullptr, const char *name3 = nullptr, const char *name4 = nullptr);
      bool path(AtomList &path, const char *name1, const char *name2 = nullptr, const char *name3 = nullptr);
      AtomList findall(const char *name, bool recursive = false) const;
      void addToOffset(offset_t delta);
      void prependChild(Atom *atom);
      bool removeChild(Atom *meta);
      offset_t offset() const;
      offset_t length() const;
      const ByteVector &name() const;
      const AtomList &children() const;
 
    protected:
      Atom(File *file, int depth);
 
    private:
      class AtomPrivate;
      TAGLIB_MSVC_SUPPRESS_WARNING_NEEDS_TO_HAVE_DLL_INTERFACE
      std::unique_ptr<AtomPrivate> d;
    };
 
    class TAGLIB_EXPORT Atoms
    {
    public:
      Atoms(File *file);
      ~Atoms();
      Atoms(const Atoms &) = delete;
      Atoms &operator=(const Atoms &) = delete;
      Atom *find(const char *name1, const char *name2 = nullptr, const char *name3 = nullptr, const char *name4 = nullptr) const;
      AtomList path(const char *name1, const char *name2 = nullptr, const char *name3 = nullptr, const char *name4 = nullptr) const;
      bool checkRootLevelAtoms();
      const AtomList &atoms() const;
 
    private:
      class AtomsPrivate;
      TAGLIB_MSVC_SUPPRESS_WARNING_NEEDS_TO_HAVE_DLL_INTERFACE
      std::unique_ptr<AtomsPrivate> d;
    };
#endif  // DO_NOT_DOCUMENT
  } // namespace MP4
} // namespace TagLib
 
#endif