#ifndef __lib_dvb_iservice_h
#define __lib_dvb_iservice_h
+#include <lib/python/swig.h>
#include <lib/base/object.h>
#include <string>
#include <connection.h>
#include <list>
+class eServiceEvent;
+
class eServiceReference
{
public:
};
int type;
- int flags; // flags will NOT be compared.
enum
{
isDirectory=1, // SHOULD enter (implies mustDescent)
hasSortKey=16, // has a sort key in data[3]. not having a sort key implies 0.
sort1=32 // sort key is 1 instead of 0
};
+ int flags; // flags will NOT be compared.
inline int getSortKey() const { return (flags & hasSortKey) ? data[3] : ((flags & sort1) ? 1 : 0); }
+#ifndef SWIG
int data[8];
std::string path;
+#endif
+ std::string getPath() { return path; }
+ void setPath( const std::string &n ) { path=n; }
+
+ int getData(unsigned int num) const
+ {
+ if ( num < sizeof(data)/sizeof(int) )
+ return data[num];
+ return 0;
+ }
+
+ void setData(unsigned int num, int val)
+ {
+ if ( num < sizeof(data)/sizeof(int) )
+ data[num] = val;
+ }
+
+// only for override service names in bouquets or to give servicerefs a name which not have a
+// real existing service ( for dvb eServiceDVB )
+#ifndef SWIG
+ std::string name;
+#endif
+ std::string getName() { return name; }
+ void setName( const std::string &n ) { name=n; }
eServiceReference()
: type(idInvalid), flags(0)
{
+ memset(data, 0, sizeof(data));
}
-
+#ifndef SWIG
eServiceReference(int type, int flags)
: type(type), flags(flags)
{
{
memset(data, 0, sizeof(data));
}
+#endif
eServiceReference(const std::string &string);
std::string toString() const;
bool operator==(const eServiceReference &c) const
{
if (type != c.type)
return 0;
- return /* (flags == c.flags) && */ (memcmp(data, c.data, sizeof(int)*8)==0) && (path == c.path);
+ return (memcmp(data, c.data, sizeof(int)*8)==0) && (path == c.path);
}
bool operator!=(const eServiceReference &c) const
{
if (type > c.type)
return 0;
-
-/* if (flags < c.flags)
- return 1;
- if (flags > c.flags)
- return 0; */
int r=memcmp(data, c.data, sizeof(int)*8);
if (r)
return path < c.path;
}
operator bool() const
+ {
+ return valid();
+ }
+
+ int valid() const
{
return type != idInvalid;
}
};
+SWIG_ALLOW_OUTPUT_SIMPLE(eServiceReference);
+
+typedef long long pts_t;
+
/* the reason we have the servicereference as additional argument is
that we don't have to create one object for every entry in a possibly
large list, provided that no state information is nessesary to deliver
the required information. Anyway - ref *must* be the same as the argument
to the info() or getIServiceInformation call! */
+
+ /* About the usage of SWIG_VOID:
+ SWIG_VOID(real_returntype_t) hides a return value from swig. This is used for
+ the "superflouus" RESULT return values.
+
+ Python code has to check the returned pointer against 0. This works,
+ as all functions returning instances in smartpointers AND having a
+ RESULT have to BOTH return non-zero AND set the pointer to zero.
+
+ Python code thus can't check for the reason, but the reason isn't
+ user-servicable anyway. If you want to return a real reason which
+ goes beyong "it just doesn't work", use extra variables for this,
+ not the RESULT.
+
+ Hide the result only if there is another way to check for failure! */
+
class iStaticServiceInformation: public iObject
{
+#ifdef SWIG
+ iStaticServiceInformation();
+ ~iStaticServiceInformation();
+#endif
public:
- virtual RESULT getName(const eServiceReference &ref, std::string &name)=0;
+ virtual SWIG_VOID(RESULT) getName(const eServiceReference &ref, std::string &SWIG_OUTPUT)=0;
+
+ // doesn't need to be implemented, should return -1 then.
+ virtual int getLength(const eServiceReference &ref);
+ virtual SWIG_VOID(RESULT) getEvent(const eServiceReference &ref, ePtr<eServiceEvent> &SWIG_OUTPUT, time_t start_time=-1);
+ // returns true when not implemented
+ virtual bool isPlayable(const eServiceReference &ref, const eServiceReference &ignore);
- // FOR SWIG
- std::string getName(const eServiceReference &ref) { std::string temp; getName(ref, temp); return temp; }
+ virtual int getInfo(const eServiceReference &ref, int w);
+ virtual std::string getInfoString(const eServiceReference &ref,int w);
};
TEMPLATE_TYPEDEF(ePtr<iStaticServiceInformation>, iStaticServiceInformationPtr);
-class eServiceEvent;
+TEMPLATE_TYPEDEF(ePtr<eServiceEvent>, eServiceEventPtr);
class iServiceInformation: public iObject
{
+#ifdef SWIG
+ iServiceInformation();
+ ~iServiceInformation();
+#endif
public:
- virtual RESULT getName(std::string &name)=0;
- // FOR SWIG
- std::string getName() { std::string temp; getName(temp); return temp; }
- virtual RESULT getEvent(ePtr<eServiceEvent> &evt, int nownext);
+ virtual SWIG_VOID(RESULT) getName(std::string &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) getEvent(ePtr<eServiceEvent> &SWIG_OUTPUT, int nownext);
+
+ enum {
+ sIsCrypted, /* is encrypted (no indication if decrypt was possible) */
+ sAspect, /* aspect ratio: 0=4:3, 1=16:9, 2=whatever we need */
+ sIsMultichannel, /* multichannel *available* (probably not selected) */
+
+ /* "user serviceable info" - they are not reliable. Don't use them for anything except the service menu!
+ that's also the reason why they are so globally defined.
+
+
+ again - if somebody EVER tries to use this information for anything else than simply displaying it,
+ i will change this to return a user-readable text like "zero x zero three three" (and change the
+ exact spelling in every version) to stop that!
+ */
+ sVideoPID,
+ sAudioPID,
+ sPCRPID,
+ sPMTPID,
+ sTXTPID,
+
+ sSID,
+ sONID,
+ sTSID,
+ sNamespace,
+ sProvider,
+
+ sDescription,
+ sTimeCreate, // unix time or string
+ };
+ enum { resNA = -1, resIsString = -2 };
+
+ virtual int getInfo(int w);
+ virtual std::string getInfoString(int w);
};
TEMPLATE_TYPEDEF(ePtr<iServiceInformation>, iServiceInformationPtr);
+class iFrontendStatusInformation: public iObject
+{
+#ifdef SWIG
+ iFrontendStatusInformation();
+ ~iFrontendStatusInformation();
+#endif
+public:
+ enum {
+ bitErrorRate,
+ signalPower,
+ signalQuality
+ };
+ virtual int getFrontendInfo(int w)=0;
+};
+
+TEMPLATE_TYPEDEF(ePtr<iFrontendStatusInformation>, iFrontendStatusInformationPtr);
+
class iPauseableService: public iObject
{
+#ifdef SWIG
+ iPausableService();
+ ~iPausableService();
+#endif
public:
virtual RESULT pause()=0;
virtual RESULT unpause()=0;
+
+ /* hm. */
+ virtual RESULT setSlowMotion(int ratio=0)=0;
+ virtual RESULT setFastForward(int ratio=0)=0;
};
TEMPLATE_TYPEDEF(ePtr<iPauseableService>, iPauseableServicePtr);
+class iSeekableService: public iObject
+{
+#ifdef SWIG
+ iSeekableService();
+ ~iSeekableService();
+#endif
+public:
+ virtual RESULT getLength(pts_t &SWIG_OUTPUT)=0;
+ virtual RESULT seekTo(pts_t to)=0;
+ enum { dirForward = +1, dirBackward = -1 };
+ virtual RESULT seekRelative(int direction, pts_t to)=0;
+ virtual RESULT getPlayPosition(pts_t &SWIG_OUTPUT)=0;
+ /* if you want to do several seeks in a row, you can enable the trickmode.
+ audio will be switched off, sync will be disabled etc. */
+ virtual RESULT setTrickmode(int trick=0)=0;
+};
+
+TEMPLATE_TYPEDEF(ePtr<iSeekableService>, iSeekableServicePtr);
+
+struct iAudioTrackInfo
+{
+#ifdef SWIG
+private:
+ iAudioTrackInfo();
+ ~iAudioTrackInfo();
+public:
+#endif
+#ifndef SWIG
+ std::string m_description;
+ std::string m_language; /* iso639 */
+#endif
+ std::string getDescription() { return m_description; }
+ std::string getLanguage() { return m_language; }
+};
+
+SWIG_ALLOW_OUTPUT_SIMPLE(iAudioTrackInfo);
+
+class iAudioTrackSelection: public iObject
+{
+#ifdef SWIG
+ iAudioTrackSelection();
+ ~iAudioTrackSelection();
+#endif
+public:
+ virtual int getNumberOfTracks()=0;
+ virtual RESULT selectTrack(unsigned int i)=0;
+ virtual SWIG_VOID(RESULT) getTrackInfo(struct iAudioTrackInfo &SWIG_OUTPUT, unsigned int n)=0;
+};
+
+TEMPLATE_TYPEDEF(ePtr<iAudioTrackSelection>, iAudioTrackSelectionPtr);
+
+class iSubserviceList: public iObject
+{
+#ifdef SWIG
+ iSubserviceList();
+ ~iSubserviceList();
+#endif
+public:
+ virtual int getNumberOfSubservices()=0;
+ virtual SWIG_VOID(RESULT) getSubservice(eServiceReference &SWIG_OUTPUT, unsigned int n)=0;
+};
+
+TEMPLATE_TYPEDEF(ePtr<iSubserviceList>, iSubserviceListPtr);
+
+class iTimeshiftService: public iObject
+{
+#ifdef SWIG
+ iTimeshiftService();
+ ~iTimeshiftService();
+#endif
+public:
+ virtual RESULT startTimeshift()=0;
+ virtual RESULT stopTimeshift()=0;
+};
+
+TEMPLATE_TYPEDEF(ePtr<iTimeshiftService>, iTimeshiftServicePtr);
+
class iPlayableService: public iObject
{
+#ifdef SWIG
+ iPlayableService();
+ ~iPlaybleService();
+#endif
friend class iServiceHandler;
public:
enum
evStart,
evEnd,
- // when iServiceInformation is implemented:
- evUpdatedEventInfo
+ evTuneFailed,
+ // when iServiceInformation is implemented:
+ evUpdatedEventInfo,
+ evUpdatedInfo,
};
virtual RESULT connectEvent(const Slot2<void,iPlayableService*,int> &event, ePtr<eConnection> &connection)=0;
virtual RESULT start()=0;
virtual RESULT stop()=0;
- virtual RESULT pause(ePtr<iPauseableService> &ptr)=0;
- virtual RESULT info(ePtr<iServiceInformation> &ptr)=0;
+ virtual SWIG_VOID(RESULT) seek(ePtr<iSeekableService> &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) pause(ePtr<iPauseableService> &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) info(ePtr<iServiceInformation> &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) audioTracks(ePtr<iAudioTrackSelection> &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) subServices(ePtr<iSubserviceList> &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) frontendStatusInfo(ePtr<iFrontendStatusInformation> &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) timeshift(ePtr<iTimeshiftService> &SWIG_OUTPUT)=0;
};
TEMPLATE_TYPEDEF(ePtr<iPlayableService>, iPlayableServicePtr);
class iRecordableService: public iObject
{
+#ifdef SWIG
+ iRecordableService();
+ ~iRecordableService();
+#endif
public:
- virtual RESULT prepare()=0;
+ virtual RESULT prepare(const char *filename)=0;
virtual RESULT start()=0;
virtual RESULT stop()=0;
};
// TEMPLATE_TYPEDEF(std::list<eServiceReference>, eServiceReferenceList);
+class iMutableServiceList: public iObject
+{
+#ifdef SWIG
+ iMutableServiceList();
+ ~iMutableServiceList();
+#endif
+public:
+ /* flush changes */
+ virtual RESULT flushChanges()=0;
+ /* adds a service to a list */
+ virtual RESULT addService(eServiceReference &ref)=0;
+ /* removes a service from a list */
+ virtual RESULT removeService(eServiceReference &ref)=0;
+ /* moves a service in a list, only if list suppports a specific sort method. */
+ /* pos is the new, absolute position from 0..size-1 */
+ virtual RESULT moveService(eServiceReference &ref, int pos)=0;
+};
+
+TEMPLATE_TYPEDEF(ePtr<iMutableServiceList>, iMutableServiceListPtr);
+
class iListableService: public iObject
{
+#ifdef SWIG
+ iListableService();
+ ~iListableService();
+#endif
public:
+ /* legacy interface: get a list */
virtual RESULT getContent(std::list<eServiceReference> &list)=0;
+
+ /* new, shiny interface: streaming. */
+ virtual SWIG_VOID(RESULT) getNext(eServiceReference &SWIG_OUTPUT)=0;
+
+ /* use this for sorting. output is not sorted because of either
+ - performance reasons: the whole list must be buffered or
+ - the interface would be restricted to a list. streaming
+ (as well as a future "active" extension) won't be possible.
+ */
+ virtual int compareLessEqual(const eServiceReference &, const eServiceReference &)=0;
+
+ virtual SWIG_VOID(RESULT) startEdit(ePtr<iMutableServiceList> &SWIG_OUTPUT)=0;
};
TEMPLATE_TYPEDEF(ePtr<iListableService>, iListableServicePtr);
+#ifndef SWIG
+ /* a helper class which can be used as argument to stl's sort(). */
+class iListableServiceCompare
+{
+ ePtr<iListableService> m_list;
+public:
+ iListableServiceCompare(iListableService *list): m_list(list) { }
+ bool operator()(const eServiceReference &a, const eServiceReference &b)
+ {
+ return m_list->compareLessEqual(a, b);
+ }
+};
+#endif
+
+class iServiceOfflineOperations: public iObject
+{
+#ifdef SWIG
+ iServiceOfflineOperations();
+ ~iServiceOfflineOperations();
+#endif
+public:
+ /* to delete a service, forever. */
+ virtual RESULT deleteFromDisk(int simulate=1)=0;
+
+ /* for transferring a service... */
+ virtual SWIG_VOID(RESULT) getListOfFilenames(std::list<std::string> &SWIG_OUTPUT)=0;
+
+ // TODO: additional stuff, like a conversion interface?
+};
+
+TEMPLATE_TYPEDEF(ePtr<iServiceOfflineOperations>, iServiceOfflineOperationsPtr);
+
class iServiceHandler: public iObject
{
+#ifdef SWIG
+ iServiceHandler();
+ ~iServiceHandler();
+#endif
public:
- virtual RESULT play(const eServiceReference &, ePtr<iPlayableService> &ptr)=0;
- virtual RESULT record(const eServiceReference &, ePtr<iRecordableService> &ptr)=0;
- virtual RESULT list(const eServiceReference &, ePtr<iListableService> &ptr)=0;
- virtual RESULT info(const eServiceReference &, ePtr<iStaticServiceInformation> &ptr);
+ virtual SWIG_VOID(RESULT) play(const eServiceReference &, ePtr<iPlayableService> &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) record(const eServiceReference &, ePtr<iRecordableService> &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) list(const eServiceReference &, ePtr<iListableService> &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) info(const eServiceReference &, ePtr<iStaticServiceInformation> &SWIG_OUTPUT)=0;
+ virtual SWIG_VOID(RESULT) offlineOperations(const eServiceReference &, ePtr<iServiceOfflineOperations> &SWIG_OUTPUT)=0;
};
TEMPLATE_TYPEDEF(ePtr<iServiceHandler>, iServiceHandlerPtr);
git.cweiske.de / enigma2.git / blobdiff