/usr/include/liveMedia/StreamReplicator.hh is in liblivemedia-dev 2018.02.18-1.
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 | /**********
This library is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the
Free Software Foundation; either version 3 of the License, or (at your
option) any later version. (See <http://www.gnu.org/copyleft/lesser.html>.)
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
**********/
// "liveMedia"
// Copyright (c) 1996-2018 Live Networks, Inc. All rights reserved.
// An class that can be used to create (possibly multiple) 'replicas' of an incoming stream.
// C++ header
#ifndef _STREAM_REPLICATOR_HH
#define _STREAM_REPLICATOR_HH
#ifndef _FRAMED_SOURCE_HH
#include "FramedSource.hh"
#endif
class StreamReplica; // forward
class StreamReplicator: public Medium {
public:
static StreamReplicator* createNew(UsageEnvironment& env, FramedSource* inputSource, Boolean deleteWhenLastReplicaDies = True);
// If "deleteWhenLastReplicaDies" is True (the default), then the "StreamReplicator" object is deleted when (and only when)
// all replicas have been deleted. (In this case, you must *not* call "Medium::close()" on the "StreamReplicator" object,
// unless you never created any replicas from it to begin with.)
// If "deleteWhenLastReplicaDies" is False, then the "StreamReplicator" object remains in existence, even when all replicas
// have been deleted. (This allows you to create new replicas later, if you wish.) In this case, you delete the
// "StreamReplicator" object by calling "Medium::close()" on it - but you must do so only when "numReplicas()" returns 0.
FramedSource* createStreamReplica();
unsigned numReplicas() const { return fNumReplicas; }
FramedSource* inputSource() const { return fInputSource; }
// Call before destruction if you want to prevent the destructor from closing the input source
void detachInputSource() { fInputSource = NULL; }
protected:
StreamReplicator(UsageEnvironment& env, FramedSource* inputSource, Boolean deleteWhenLastReplicaDies);
// called only by "createNew()"
virtual ~StreamReplicator();
private:
// Routines called by replicas to implement frame delivery, and the stopping/restarting/deletion of replicas:
friend class StreamReplica;
void getNextFrame(StreamReplica* replica);
void deactivateStreamReplica(StreamReplica* replica);
void removeStreamReplica(StreamReplica* replica);
private:
static void afterGettingFrame(void* clientData, unsigned frameSize,
unsigned numTruncatedBytes,
struct timeval presentationTime,
unsigned durationInMicroseconds);
void afterGettingFrame(unsigned frameSize, unsigned numTruncatedBytes,
struct timeval presentationTime, unsigned durationInMicroseconds);
static void onSourceClosure(void* clientData);
void onSourceClosure();
void deliverReceivedFrame();
private:
FramedSource* fInputSource;
Boolean fDeleteWhenLastReplicaDies, fInputSourceHasClosed;
unsigned fNumReplicas, fNumActiveReplicas, fNumDeliveriesMadeSoFar;
int fFrameIndex; // 0 or 1; used to figure out if a replica is requesting the current frame, or the next frame
StreamReplica* fMasterReplica; // the first replica that requests each frame. We use its buffer when copying to the others.
StreamReplica* fReplicasAwaitingCurrentFrame; // other than the 'master' replica
StreamReplica* fReplicasAwaitingNextFrame; // replicas that have already received the current frame, and have asked for the next
};
#endif
|