eventtimingcodesframe.h

Go to the documentation of this file.

/***************************************************************************
    copyright            : (C) 2014 by Urs Fleisch
    email                : ufleisch@users.sourceforge.net
 ***************************************************************************/
 
/***************************************************************************
 *   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/                                           *
 ***************************************************************************/
 
#ifndef TAGLIB_EVENTTIMINGCODESFRAME_H
#define TAGLIB_EVENTTIMINGCODESFRAME_H
 
#include "tlist.h"
#include "id3v2frame.h"
 
namespace TagLib {
 
  namespace ID3v2 {


    class TAGLIB_EXPORT EventTimingCodesFrame : public Frame
    {
      friend class FrameFactory;
 
    public:

      enum TimestampFormat {
        Unknown              = 0x00,
        AbsoluteMpegFrames   = 0x01,
        AbsoluteMilliseconds = 0x02
      };

      enum EventType {
        Padding                = 0x00,
        EndOfInitialSilence    = 0x01,
        IntroStart             = 0x02,
        MainPartStart          = 0x03,
        OutroStart             = 0x04,
        OutroEnd               = 0x05,
        VerseStart             = 0x06,
        RefrainStart           = 0x07,
        InterludeStart         = 0x08,
        ThemeStart             = 0x09,
        VariationStart         = 0x0a,
        KeyChange              = 0x0b,
        TimeChange             = 0x0c,
        MomentaryUnwantedNoise = 0x0d,
        SustainedNoise         = 0x0e,
        SustainedNoiseEnd      = 0x0f,
        IntroEnd               = 0x10,
        MainPartEnd            = 0x11,
        VerseEnd               = 0x12,
        RefrainEnd             = 0x13,
        ThemeEnd               = 0x14,
        Profanity              = 0x15,
        ProfanityEnd           = 0x16,
        NotPredefinedSynch0    = 0xe0,
        NotPredefinedSynch1    = 0xe1,
        NotPredefinedSynch2    = 0xe2,
        NotPredefinedSynch3    = 0xe3,
        NotPredefinedSynch4    = 0xe4,
        NotPredefinedSynch5    = 0xe5,
        NotPredefinedSynch6    = 0xe6,
        NotPredefinedSynch7    = 0xe7,
        NotPredefinedSynch8    = 0xe8,
        NotPredefinedSynch9    = 0xe9,
        NotPredefinedSynchA    = 0xea,
        NotPredefinedSynchB    = 0xeb,
        NotPredefinedSynchC    = 0xec,
        NotPredefinedSynchD    = 0xed,
        NotPredefinedSynchE    = 0xee,
        NotPredefinedSynchF    = 0xef,
        AudioEnd               = 0xfd,
        AudioFileEnds          = 0xfe
      };

      struct SynchedEvent {
        SynchedEvent(unsigned int ms, EventType t) : time(ms), type(t) {}
        unsigned int time;
        EventType type;
      };

      using SynchedEventList = TagLib::List<SynchedEvent>;

      explicit EventTimingCodesFrame();

      explicit EventTimingCodesFrame(const ByteVector &data);

      ~EventTimingCodesFrame() override;
 
      EventTimingCodesFrame(const EventTimingCodesFrame &) = delete;
      EventTimingCodesFrame &operator=(const EventTimingCodesFrame &) = delete;

      String toString() const override;

      TimestampFormat timestampFormat() const;

      SynchedEventList synchedEvents() const;

      void setTimestampFormat(TimestampFormat f);

      void setSynchedEvents(const SynchedEventList &e);
 
    protected:
      // Reimplementations.
 
      void parseFields(const ByteVector &data) override;
      ByteVector renderFields() const override;
 
    private:
      EventTimingCodesFrame(const ByteVector &data, Header *h);
 
      class EventTimingCodesFramePrivate;
      TAGLIB_MSVC_SUPPRESS_WARNING_NEEDS_TO_HAVE_DLL_INTERFACE
      std::unique_ptr<EventTimingCodesFramePrivate> d;
    };
 
  }  // namespace ID3v2
}  // namespace TagLib
#endif