This file is indexed.

/usr/include/thunderbird/MediaMetadataManager.h is in thunderbird-dev 1:52.8.0-1~deb8u1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim:set ts=2 sw=2 sts=2 et cindent: */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#if !defined(MediaMetadataManager_h__)
#define MediaMetadataManager_h__

#include "mozilla/AbstractThread.h"
#include "mozilla/LinkedList.h"

#include "nsAutoPtr.h"
#include "AbstractMediaDecoder.h"
#include "MediaEventSource.h"
#include "TimeUnits.h"
#include "VideoUtils.h"

namespace mozilla {

class TimedMetadata;
typedef MediaEventProducerExc<TimedMetadata> TimedMetadataEventProducer;
typedef MediaEventSourceExc<TimedMetadata> TimedMetadataEventSource;

// A struct that contains the metadata of a media, and the time at which those
// metadata should start to be reported.
class TimedMetadata : public LinkedListElement<TimedMetadata> {
public:
  TimedMetadata(const media::TimeUnit& aPublishTime,
                nsAutoPtr<MetadataTags>&& aTags,
                nsAutoPtr<MediaInfo>&& aInfo)
    : mPublishTime(aPublishTime)
    , mTags(Move(aTags))
    , mInfo(Move(aInfo)) {}

  // Define our move constructor because we don't want to move the members of
  // LinkedListElement to change the list.
  TimedMetadata(TimedMetadata&& aOther)
    : mPublishTime(aOther.mPublishTime)
    , mTags(Move(aOther.mTags))
    , mInfo(Move(aOther.mInfo)) {}

  // The time, in microseconds, at which those metadata should be available.
  media::TimeUnit mPublishTime;
  // The metadata. The ownership is transfered to the element when dispatching to
  // the main threads.
  nsAutoPtr<MetadataTags> mTags;
  // The media info, including the info of audio tracks and video tracks.
  // The ownership is transfered to MediaDecoder when dispatching to the
  // main thread.
  nsAutoPtr<MediaInfo> mInfo;
};

// This class encapsulate the logic to give the metadata from the reader to
// the content, at the right time.
class MediaMetadataManager {
public:
  ~MediaMetadataManager() {
    TimedMetadata* element;
    while((element = mMetadataQueue.popFirst()) != nullptr) {
      delete element;
    }
  }

  // Connect to an event source to receive TimedMetadata events.
  void Connect(TimedMetadataEventSource& aEvent, AbstractThread* aThread) {
    mListener = aEvent.Connect(
      aThread, this, &MediaMetadataManager::OnMetadataQueued);
  }

  // Stop receiving TimedMetadata events.
  void Disconnect() {
    mListener.Disconnect();
  }

  // Return an event source through which we will send TimedMetadata events
  // when playback position reaches the publish time.
  TimedMetadataEventSource& TimedMetadataEvent() {
    return mTimedMetadataEvent;
  }

  void DispatchMetadataIfNeeded(const media::TimeUnit& aCurrentTime) {
    TimedMetadata* metadata = mMetadataQueue.getFirst();
    while (metadata && aCurrentTime >= metadata->mPublishTime) {
      // Our listener will figure out what to do with TimedMetadata.
      mTimedMetadataEvent.Notify(Move(*metadata));
      delete mMetadataQueue.popFirst();
      metadata = mMetadataQueue.getFirst();
    }
  }

protected:
  void OnMetadataQueued(TimedMetadata&& aMetadata) {
    mMetadataQueue.insertBack(new TimedMetadata(Move(aMetadata)));
  }

  LinkedList<TimedMetadata> mMetadataQueue;
  MediaEventListener mListener;
  TimedMetadataEventProducer mTimedMetadataEvent;
};

} // namespace mozilla

#endif