Move talk/media to webrtc/media

talk/media/base/streamparams.h

Index: talk/media/base/streamparams.h
diff --git a/talk/media/base/streamparams.h b/talk/media/base/streamparams.h
deleted file mode 100644
index db5f78c1d71c95d7326a0cb19211756d48c36ef7..0000000000000000000000000000000000000000
--- a/talk/media/base/streamparams.h
+++ /dev/null
@@ -1,320 +0,0 @@
-/*
- * libjingle
- * Copyright 2011 Google Inc.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- *
- *  1. Redistributions of source code must retain the above copyright notice,
- *     this list of conditions and the following disclaimer.
- *  2. Redistributions in binary form must reproduce the above copyright notice,
- *     this list of conditions and the following disclaimer in the documentation
- *     and/or other materials provided with the distribution.
- *  3. The name of the author may not be used to endorse or promote products
- *     derived from this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
- * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
- * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
- * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
- * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
- * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
- * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
- * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
-// This file contains structures for describing SSRCs from a media source such
-// as a MediaStreamTrack when it is sent across an RTP session. Multiple media
-// sources may be sent across the same RTP session, each of them will be
-// described by one StreamParams object
-// SsrcGroup is used to describe the relationship between the SSRCs that
-// are used for this media source.
-// E.x: Consider a source that is sent as 3 simulcast streams
-// Let the simulcast elements have SSRC 10, 20, 30.
-// Let each simulcast element use FEC and let the protection packets have
-// SSRC 11,21,31.
-// To describe this 4 SsrcGroups are needed,
-// StreamParams would then contain ssrc = {10,11,20,21,30,31} and
-// ssrc_groups = {{SIM,{10,20,30}, {FEC,{10,11}, {FEC, {20,21}, {FEC {30,31}}}
-// Please see RFC 5576.
-
-#ifndef TALK_MEDIA_BASE_STREAMPARAMS_H_
-#define TALK_MEDIA_BASE_STREAMPARAMS_H_
-
-#include <algorithm>
-#include <set>
-#include <string>
-#include <vector>
-
-#include "webrtc/base/basictypes.h"
-#include "webrtc/base/constructormagic.h"
-
-namespace cricket {
-
-extern const char kFecSsrcGroupSemantics[];
-extern const char kFidSsrcGroupSemantics[];
-extern const char kSimSsrcGroupSemantics[];
-
-struct SsrcGroup {
-  SsrcGroup(const std::string& usage, const std::vector<uint32_t>& ssrcs)
-      : semantics(usage), ssrcs(ssrcs) {}
-
-  bool operator==(const SsrcGroup& other) const {
-    return (semantics == other.semantics && ssrcs == other.ssrcs);
-  }
-  bool operator!=(const SsrcGroup &other) const {
-    return !(*this == other);
-  }
-
-  bool has_semantics(const std::string& semantics) const;
-
-  std::string ToString() const;
-
-  std::string semantics;  // e.g FIX, FEC, SIM.
-  std::vector<uint32_t> ssrcs;  // SSRCs of this type.
-};
-
-struct StreamParams {
-  static StreamParams CreateLegacy(uint32_t ssrc) {
-    StreamParams stream;
-    stream.ssrcs.push_back(ssrc);
-    return stream;
-  }
-
-  bool operator==(const StreamParams& other) const {
-    return (groupid == other.groupid &&
-            id == other.id &&
-            ssrcs == other.ssrcs &&
-            ssrc_groups == other.ssrc_groups &&
-            type == other.type &&
-            display == other.display &&
-            cname == other.cname &&
-            sync_label == other.sync_label);
-  }
-  bool operator!=(const StreamParams &other) const {
-    return !(*this == other);
-  }
-
-  uint32_t first_ssrc() const {
-    if (ssrcs.empty()) {
-      return 0;
-    }
-
-    return ssrcs[0];
-  }
-  bool has_ssrcs() const {
-    return !ssrcs.empty();
-  }
-  bool has_ssrc(uint32_t ssrc) const {
-    return std::find(ssrcs.begin(), ssrcs.end(), ssrc) != ssrcs.end();
-  }
-  void add_ssrc(uint32_t ssrc) { ssrcs.push_back(ssrc); }
-  bool has_ssrc_groups() const {
-    return !ssrc_groups.empty();
-  }
-  bool has_ssrc_group(const std::string& semantics) const {
-    return (get_ssrc_group(semantics) != NULL);
-  }
-  const SsrcGroup* get_ssrc_group(const std::string& semantics) const {
-    for (std::vector<SsrcGroup>::const_iterator it = ssrc_groups.begin();
-         it != ssrc_groups.end(); ++it) {
-      if (it->has_semantics(semantics)) {
-        return &(*it);
-      }
-    }
-    return NULL;
-  }
-
-  // Convenience function to add an FID ssrc for a primary_ssrc
-  // that's already been added.
-  inline bool AddFidSsrc(uint32_t primary_ssrc, uint32_t fid_ssrc) {
-    return AddSecondarySsrc(kFidSsrcGroupSemantics, primary_ssrc, fid_ssrc);
-  }
-
-  // Convenience function to lookup the FID ssrc for a primary_ssrc.
-  // Returns false if primary_ssrc not found or FID not defined for it.
-  inline bool GetFidSsrc(uint32_t primary_ssrc, uint32_t* fid_ssrc) const {
-    return GetSecondarySsrc(kFidSsrcGroupSemantics, primary_ssrc, fid_ssrc);
-  }
-
-  // Convenience to get all the SIM SSRCs if there are SIM ssrcs, or
-  // the first SSRC otherwise.
-  void GetPrimarySsrcs(std::vector<uint32_t>* ssrcs) const;
-
-  // Convenience to get all the FID SSRCs for the given primary ssrcs.
-  // If a given primary SSRC does not have a FID SSRC, the list of FID
-  // SSRCS will be smaller than the list of primary SSRCs.
-  void GetFidSsrcs(const std::vector<uint32_t>& primary_ssrcs,
-                   std::vector<uint32_t>* fid_ssrcs) const;
-
-  std::string ToString() const;
-
-  // Resource of the MUC jid of the participant of with this stream.
-  // For 1:1 calls, should be left empty (which means remote streams
-  // and local streams should not be mixed together).
-  std::string groupid;
-  // Unique per-groupid, not across all groupids
-  std::string id;
-  std::vector<uint32_t> ssrcs;         // All SSRCs for this source
-  std::vector<SsrcGroup> ssrc_groups;  // e.g. FID, FEC, SIM
-  // Examples: "camera", "screencast"
-  std::string type;
-  // Friendly name describing stream
-  std::string display;
-  std::string cname;  // RTCP CNAME
-  std::string sync_label;  // Friendly name of cname.
-
- private:
-  bool AddSecondarySsrc(const std::string& semantics,
-                        uint32_t primary_ssrc,
-                        uint32_t secondary_ssrc);
-  bool GetSecondarySsrc(const std::string& semantics,
-                        uint32_t primary_ssrc,
-                        uint32_t* secondary_ssrc) const;
-};
-
-// A Stream can be selected by either groupid+id or ssrc.
-struct StreamSelector {
-  explicit StreamSelector(uint32_t ssrc) : ssrc(ssrc) {}
-
-  StreamSelector(const std::string& groupid,
-                 const std::string& streamid) :
-      ssrc(0),
-      groupid(groupid),
-      streamid(streamid) {
-  }
-
-  bool Matches(const StreamParams& stream) const {
-    if (ssrc == 0) {
-      return stream.groupid == groupid && stream.id == streamid;
-    } else {
-      return stream.has_ssrc(ssrc);
-    }
-  }
-
-  uint32_t ssrc;
-  std::string groupid;
-  std::string streamid;
-};
-
-typedef std::vector<StreamParams> StreamParamsVec;
-
-// A collection of audio and video and data streams. Most of the
-// methods are merely for convenience. Many of these methods are keyed
-// by ssrc, which is the source identifier in the RTP spec
-// (http://tools.ietf.org/html/rfc3550).
-// TODO(pthatcher):  Add basic unit test for these.
-// See https://code.google.com/p/webrtc/issues/detail?id=4107
-struct MediaStreams {
- public:
-  MediaStreams() {}
-  void CopyFrom(const MediaStreams& sources);
-
-  bool empty() const {
-    return audio_.empty() && video_.empty() && data_.empty();
-  }
-
-  std::vector<StreamParams>* mutable_audio() { return &audio_; }
-  std::vector<StreamParams>* mutable_video() { return &video_; }
-  std::vector<StreamParams>* mutable_data() { return &data_; }
-  const std::vector<StreamParams>& audio() const { return audio_; }
-  const std::vector<StreamParams>& video() const { return video_; }
-  const std::vector<StreamParams>& data() const { return data_; }
-
-  // Gets a stream, returning true if found.
-  bool GetAudioStream(
-      const StreamSelector& selector, StreamParams* stream);
-  bool GetVideoStream(
-      const StreamSelector& selector, StreamParams* stream);
-  bool GetDataStream(
-      const StreamSelector& selector, StreamParams* stream);
-  // Adds a stream.
-  void AddAudioStream(const StreamParams& stream);
-  void AddVideoStream(const StreamParams& stream);
-  void AddDataStream(const StreamParams& stream);
-  // Removes a stream, returning true if found and removed.
-  bool RemoveAudioStream(const StreamSelector& selector);
-  bool RemoveVideoStream(const StreamSelector& selector);
-  bool RemoveDataStream(const StreamSelector& selector);
-
- private:
-  std::vector<StreamParams> audio_;
-  std::vector<StreamParams> video_;
-  std::vector<StreamParams> data_;
-
-  RTC_DISALLOW_COPY_AND_ASSIGN(MediaStreams);
-};
-
-template <class Condition>
-const StreamParams* GetStream(const StreamParamsVec& streams,
-                              Condition condition) {
-  StreamParamsVec::const_iterator found =
-      std::find_if(streams.begin(), streams.end(), condition);
-  return found == streams.end() ? nullptr : &(*found);
-}
-
-inline const StreamParams* GetStreamBySsrc(const StreamParamsVec& streams,
-                                           uint32_t ssrc) {
-  return GetStream(streams,
-      [&ssrc](const StreamParams& sp) { return sp.has_ssrc(ssrc); });
-}
-
-inline const StreamParams* GetStreamByIds(const StreamParamsVec& streams,
-                                          const std::string& groupid,
-                                          const std::string& id) {
-  return GetStream(streams,
-      [&groupid, &id](const StreamParams& sp) {
-        return sp.groupid == groupid && sp.id == id;
-      });
-}
-
-inline const StreamParams* GetStream(const StreamParamsVec& streams,
-                                     const StreamSelector& selector) {
-  return GetStream(streams,
-      [&selector](const StreamParams& sp) { return selector.Matches(sp); });
-}
-
-template <class Condition>
-bool RemoveStream(StreamParamsVec* streams, Condition condition) {
-  auto iter(std::remove_if(streams->begin(), streams->end(), condition));
-  if (iter == streams->end())
-    return false;
-  streams->erase(iter, streams->end());
-  return true;
-}
-
-// Removes the stream from streams. Returns true if a stream is
-// found and removed.
-inline bool RemoveStream(StreamParamsVec* streams,
-                  const StreamSelector& selector) {
-  return RemoveStream(streams,
-      [&selector](const StreamParams& sp) { return selector.Matches(sp); });
-}
-inline bool RemoveStreamBySsrc(StreamParamsVec* streams, uint32_t ssrc) {
-  return RemoveStream(streams,
-      [&ssrc](const StreamParams& sp) { return sp.has_ssrc(ssrc); });
-}
-inline bool RemoveStreamByIds(StreamParamsVec* streams,
-                              const std::string& groupid,
-                              const std::string& id) {
-  return RemoveStream(streams,
-      [&groupid, &id](const StreamParams& sp) {
-        return sp.groupid == groupid && sp.id == id;
-      });
-}
-
-// Checks if |sp| defines parameters for a single primary stream. There may
-// be an RTX stream associated with the primary stream. Leaving as non-static so
-// we can test this function.
-bool IsOneSsrcStream(const StreamParams& sp);
-
-// Checks if |sp| defines parameters for one Simulcast stream. There may be RTX
-// streams associated with the simulcast streams. Leaving as non-static so we
-// can test this function.
-bool IsSimulcastStream(const StreamParams& sp);
-
-}  // namespace cricket
-
-#endif  // TALK_MEDIA_BASE_STREAMPARAMS_H_