OPAL  Version 3.18.8
OpalFileMediaStream Class Reference

#include <mediastrm.h>

Inheritance diagram for OpalFileMediaStream:
Collaboration diagram for OpalFileMediaStream:

Public Member Functions

Construction
 OpalFileMediaStream (OpalConnection &conn, const OpalMediaFormat &mediaFormat, unsigned sessionID, bool isSource, PFile *file, bool autoDelete=true)
 
 OpalFileMediaStream (OpalConnection &conn, const OpalMediaFormat &mediaFormat, unsigned sessionID, bool isSource, const PFilePath &path)
 
Overrides of OpalMediaStream class
virtual PBoolean IsSynchronous () const
 
virtual PBoolean ReadData (BYTE *data, PINDEX size, PINDEX &length)
 
virtual PBoolean WriteData (const BYTE *data, PINDEX length, PINDEX &written)
 
- Public Member Functions inherited from OpalRawMediaStream
PChannel * GetChannel ()
 
bool SetChannel (PChannel *channel, bool autoDelete=true)
 
virtual unsigned GetAverageSignalLevel ()
 
- Public Member Functions inherited from OpalMediaStream
virtual PString GetPatchThreadName () const
 
virtual bool InternalUpdateMediaFormat (const OpalMediaFormat &mediaFormat)
 
virtual bool InternalSetPaused (bool pause, bool fromUser, bool fromPatch)
 
virtual bool InternalExecuteCommand (const OpalMediaCommand &command)
 
void PrintOn (ostream &strm) const
 
virtual OpalMediaFormat GetMediaFormat () const
 
virtual bool SetMediaFormat (const OpalMediaFormat &mediaFormat)
 
bool UpdateMediaFormat (const OpalMediaFormat &mediaFormat, bool mergeOnly=false)
 
bool ExecuteCommand (const OpalMediaCommand &command) const
 
virtual PBoolean Open ()
 
virtual bool IsOpen () const
 
virtual bool IsEstablished () const
 
virtual PBoolean Start ()
 
virtual PBoolean Close ()
 
virtual void OnStartMediaPatch ()
 
virtual void OnStopMediaPatch (OpalMediaPatch &patch)
 
virtual bool SetMediaPassThrough (OpalMediaStream &otherStream, bool bypass)
 
virtual PBoolean WritePackets (RTP_DataFrameList &packets)
 
virtual PBoolean ReadPacket (RTP_DataFrame &packet)
 
virtual PBoolean WritePacket (RTP_DataFrame &packet)
 
virtual bool PushPacket (RTP_DataFrame &packet)
 
virtual PBoolean SetDataSize (PINDEX dataSize, PINDEX frameTime)
 
PINDEX GetDataSize () const
 
virtual PBoolean RequiresPatchThread (OpalMediaStream *stream) const
 
virtual PBoolean RequiresPatchThread () const
 
virtual bool RequireMediaTransportThread (OpalMediaStream &stream) const
 
virtual bool EnableJitterBuffer (bool enab=true)
 
OpalConnectionGetConnection () const
 
bool IsSource () const
 
bool IsSink () const
 
unsigned GetSessionID () const
 
void SetSessionID (unsigned id)
 
PString GetID () const
 
unsigned GetTimestamp () const
 
void SetTimestamp (unsigned ts)
 
bool GetMarker () const
 
void SetMarker (bool m)
 
bool IsPaused () const
 
bool SetPaused (bool pause)
 
virtual PBoolean SetPatch (OpalMediaPatch *patch)
 
OpalMediaPatchPtr GetPatch () const
 
void AddFilter (const PNotifier &filter, const OpalMediaFormat &stage=OpalMediaFormat()) const
 
bool RemoveFilter (const PNotifier &filter, const OpalMediaFormat &stage=OpalMediaFormat()) const
 
virtual void GetStatistics (OpalMediaStatistics &statistics, bool fromPatch=false) const
 
 P_DECLARE_BITWISE_ENUM (Details, 6,(DetailMinimum, DetailEOL, DetailNAT, DetailSecured, DetailFEC, DetailAudio, DetailAddresses))
 
virtual void PrintDetail (ostream &strm, const char *prefix=NULL, Details details=Details::All()) const
 
 ~OpalMediaStream ()
 
- Public Member Functions inherited from OpalMediaStreamPacing
 OpalMediaStreamPacing (const OpalMediaFormat &mediaFormat)
 
void Pace (bool generated, PINDEX bytes, bool &marker)
 Delay appropriate time for the written bytes. More...
 
bool UpdateMediaFormat (const OpalMediaFormat &mediaFormat)
 

Protected Attributes

PFile file
 
- Protected Attributes inherited from OpalRawMediaStream
PChannel * m_channel
 
bool m_autoDelete
 
PBYTEArray m_silence
 
PUInt64 m_averageSignalSum
 
unsigned m_averageSignalSamples
 
- Protected Attributes inherited from OpalMediaStream
OpalConnectionm_connection
 
unsigned m_sessionID
 
WORD m_sequenceNumber
 
RTP_SyncSourceId m_syncSourceId
 
PString m_identifier
 
OpalMediaFormat m_mediaFormat
 
atomic< bool > m_paused
 
bool m_isSource
 
atomic< bool > m_isOpen
 
PINDEX m_defaultDataSize
 
unsigned m_timestamp
 
bool m_marker
 
OpalMediaPatchPtr m_mediaPatch
 
RTP_DataFrame::PayloadTypes m_payloadType
 
unsigned m_frameTime
 
PINDEX m_frameSize
 
- Protected Attributes inherited from OpalMediaStreamPacing
bool m_timeOnMarkers
 
unsigned m_frameTime
 
PINDEX m_frameSize
 
unsigned m_timeUnits
 
PAdaptiveDelay m_delay
 
unsigned m_previousDelay
 

Additional Inherited Members

- Protected Types inherited from OpalMediaStream
typedef OpalMediaPatchPtr PatchPtr
 
- Protected Member Functions inherited from OpalRawMediaStream
virtual void InternalClose ()
 
 PDECLARE_MUTEX (m_channelMutex)
 
 PDECLARE_MUTEX (m_averagingMutex)
 
void CollectAverage (const BYTE *buffer, PINDEX size)
 
 OpalRawMediaStream (OpalConnection &conn, const OpalMediaFormat &mediaFormat, unsigned sessionID, bool isSource, PChannel *channel, bool autoDelete)
 
 ~OpalRawMediaStream ()
 
- Protected Member Functions inherited from OpalMediaStream
OpalMediaPatchPtr InternalSetPatchPart1 (OpalMediaPatch *newPatch)
 
void InternalSetPatchPart2 (const OpalMediaPatchPtr &oldPatch)
 
virtual bool InternalSetJitterBuffer (const OpalJitterBuffer::Init &init)
 
 OpalMediaStream (OpalConnection &conn, const OpalMediaFormat &mediaFormat, unsigned sessionID, bool isSource)
 
- Protected Member Functions inherited from OpalMediaStreamPacing
 PTRACE_THROTTLE (m_throttleLog, 4, 5000)
 

Detailed Description

This class describes a media stream that transfers data to/from a file.

Constructor & Destructor Documentation

OpalFileMediaStream::OpalFileMediaStream ( OpalConnection conn,
const OpalMediaFormat mediaFormat,
unsigned  sessionID,
bool  isSource,
PFile *  file,
bool  autoDelete = true 
)

Construct a new media stream for files.

Parameters
connConnection that owns the stream
mediaFormatMedia format for stream
sessionIDSession number for stream
isSourceIs a source stream
fileFile to stream to/from
autoDeleteAutomatically delete file
OpalFileMediaStream::OpalFileMediaStream ( OpalConnection conn,
const OpalMediaFormat mediaFormat,
unsigned  sessionID,
bool  isSource,
const PFilePath &  path 
)

Construct a new media stream for files.

Parameters
connConnection that owns the stream
mediaFormatMedia format for stream
sessionIDSession number for stream
isSourceIs a source stream
pathFile path to stream to/from

Member Function Documentation

virtual PBoolean OpalFileMediaStream::IsSynchronous ( ) const
virtual

Indicate if the media stream is synchronous. Returns true for LID streams.

Implements OpalMediaStream.

virtual PBoolean OpalFileMediaStream::ReadData ( BYTE *  data,
PINDEX  size,
PINDEX &  length 
)
virtual

Read raw media data from the source media stream. The default behaviour reads from the PChannel object.

Parameters
dataData buffer to read to
sizeSize of buffer
lengthLength of data actually read

Reimplemented from OpalRawMediaStream.

virtual PBoolean OpalFileMediaStream::WriteData ( const BYTE *  data,
PINDEX  length,
PINDEX &  written 
)
virtual

Write raw media data to the sink media stream. The default behaviour writes to the PChannel object.

Parameters
dataData to write
lengthLength of data to read.
writtenLength of data actually written

Reimplemented from OpalRawMediaStream.

Field Documentation

PFile OpalFileMediaStream::file
protected

The documentation for this class was generated from the following file: