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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
/**********
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 2.1 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.,
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
**********/
// "liveMedia"
// Copyright (c) 1996-2004 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);
// ##### The following is for backwards-compatibility; remove it eventually:
#define BACKWARDS_COMPATIBLE_WITH_OLD_AFTER_GETTING_FUNC
#ifdef BACKWARDS_COMPATIBLE_WITH_OLD_AFTER_GETTING_FUNC
typedef void (bwCompatAfterGettingFunc)(void* clientData, unsigned frameSize,
struct timeval presentationTime);
void getNextFrame(unsigned char* to, unsigned maxSize,
bwCompatAfterGettingFunc* afterGettingFunc,
void* afterGettingClientData,
onCloseFunc* onCloseFunc,
void* onCloseClientData);
bwCompatAfterGettingFunc* fSavedBWCompatAfterGettingFunc;
void* fSavedBWCompatAfterGettingClientData;
#endif
// ##### End of code for backwards-compatibility.
static void handleClosure(void* clientData);
// 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;}
// Tests for specific types of 'framed source':
virtual Boolean isPrioritizedRTPStreamSelector() const;
protected:
FramedSource(UsageEnvironment& env); // abstract base class
virtual ~FramedSource();
static void afterGetting(FramedSource* source);
// doGetNextFrame() should arrange for this to be called after the
// frame has been read (*iff* it is read successfully)
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
|
