| /********** |
| 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-2020 Live Networks, Inc. All rights reserved. |
| // A file source that is a plain byte stream (rather than frames) |
| // C++ header |
| |
| #ifndef _BYTE_STREAM_FILE_SOURCE_HH |
| #define _BYTE_STREAM_FILE_SOURCE_HH |
| |
| #ifndef _FRAMED_FILE_SOURCE_HH |
| #include "FramedFileSource.hh" |
| #endif |
| |
| class ByteStreamFileSource: public FramedFileSource { |
| public: |
| static ByteStreamFileSource* createNew(UsageEnvironment& env, |
| char const* fileName, |
| unsigned preferredFrameSize = 0, |
| unsigned playTimePerFrame = 0); |
| // "preferredFrameSize" == 0 means 'no preference' |
| // "playTimePerFrame" is in microseconds |
| |
| static ByteStreamFileSource* createNew(UsageEnvironment& env, |
| FILE* fid, |
| unsigned preferredFrameSize = 0, |
| unsigned playTimePerFrame = 0); |
| // an alternative version of "createNew()" that's used if you already have |
| // an open file. |
| |
| u_int64_t fileSize() const { return fFileSize; } |
| // 0 means zero-length, unbounded, or unknown |
| |
| void seekToByteAbsolute(u_int64_t byteNumber, u_int64_t numBytesToStream = 0); |
| // if "numBytesToStream" is >0, then we limit the stream to that number of bytes, before treating it as EOF |
| void seekToByteRelative(int64_t offset, u_int64_t numBytesToStream = 0); |
| void seekToEnd(); // to force EOF handling on the next read |
| |
| protected: |
| ByteStreamFileSource(UsageEnvironment& env, |
| FILE* fid, |
| unsigned preferredFrameSize, |
| unsigned playTimePerFrame); |
| // called only by createNew() |
| |
| virtual ~ByteStreamFileSource(); |
| |
| static void fileReadableHandler(ByteStreamFileSource* source, int mask); |
| void doReadFromFile(); |
| |
| private: |
| // redefined virtual functions: |
| virtual void doGetNextFrame(); |
| virtual void doStopGettingFrames(); |
| |
| protected: |
| u_int64_t fFileSize; |
| |
| private: |
| unsigned fPreferredFrameSize; |
| unsigned fPlayTimePerFrame; |
| Boolean fFidIsSeekable; |
| unsigned fLastPlayTime; |
| Boolean fHaveStartedReading; |
| Boolean fLimitNumBytesToStream; |
| u_int64_t fNumBytesToStream; // used iff "fLimitNumBytesToStream" is True |
| }; |
| |
| #endif |