xingzilong
2017-08-18 9e5babf9db52e64bdae60137be7696e56241fca6
VisitFace/RtspNativeCodec/app/libs/live555/include/liveMedia/FramedSource.hh
New file
@@ -0,0 +1,95 @@
/**********
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-2017 Live Networks, Inc.  All rights reserved.
// Framed Sources
// C++ header
#ifndef _FRAMED_SOURCE_HH
#define _FRAMED_SOURCE_HH
#ifndef _NET_COMMON_H
#include "NetCommon.h"
#endif
#ifndef _MEDIA_SOURCE_HH
#include "MediaSource.hh"
#endif
class FramedSource: public MediaSource {
public:
  static Boolean lookupByName(UsageEnvironment& env, char const* sourceName,
               FramedSource*& resultSource);
  typedef void (afterGettingFunc)(void* clientData, unsigned frameSize,
              unsigned numTruncatedBytes,
              struct timeval presentationTime,
              unsigned durationInMicroseconds);
  typedef void (onCloseFunc)(void* clientData);
  void getNextFrame(unsigned char* to, unsigned maxSize,
          afterGettingFunc* afterGettingFunc,
          void* afterGettingClientData,
          onCloseFunc* onCloseFunc,
          void* onCloseClientData);
  static void handleClosure(void* clientData);
  void handleClosure();
      // This should be called (on ourself) if the source is discovered
      // to be closed (i.e., no longer readable)
  void stopGettingFrames();
  virtual unsigned maxFrameSize() const;
      // size of the largest possible frame that we may serve, or 0
      // if no such maximum is known (default)
  virtual void doGetNextFrame() = 0;
      // called by getNextFrame()
  Boolean isCurrentlyAwaitingData() const {return fIsCurrentlyAwaitingData;}
  static void afterGetting(FramedSource* source);
      // doGetNextFrame() should arrange for this to be called after the
      // frame has been read (*iff* it is read successfully)
protected:
  FramedSource(UsageEnvironment& env); // abstract base class
  virtual ~FramedSource();
  virtual void doStopGettingFrames();
protected:
  // The following variables are typically accessed/set by doGetNextFrame()
  unsigned char* fTo; // in
  unsigned fMaxSize; // in
  unsigned fFrameSize; // out
  unsigned fNumTruncatedBytes; // out
  struct timeval fPresentationTime; // out
  unsigned fDurationInMicroseconds; // out
private:
  // redefined virtual functions:
  virtual Boolean isFramedSource() const;
private:
  afterGettingFunc* fAfterGettingFunc;
  void* fAfterGettingClientData;
  onCloseFunc* fOnCloseFunc;
  void* fOnCloseClientData;
  Boolean fIsCurrentlyAwaitingData;
};
#endif