vdr  2.0.6
Classes | Public Member Functions | Static Public Member Functions | Protected Types | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Static Protected Attributes | Private Member Functions | Private Attributes | Static Private Attributes | Friends | List of all members
cDevice Class Reference

#include <device.h>

Collaboration diagram for cDevice:
[legend]

Classes

class  cPidHandle
 

Public Member Functions

int DeviceNumber (void) const
 
virtual cString DeviceType (void) const
 
virtual cString DeviceName (void) const
 
virtual bool HasDecoder (void) const
 
virtual bool AvoidRecording (void) const
 
virtual cSpuDecoderGetSpuDecoder (void)
 
virtual bool ProvidesSource (int Source) const
 
virtual bool ProvidesTransponder (const cChannel *Channel) const
 
virtual bool ProvidesTransponderExclusively (const cChannel *Channel) const
 
virtual bool ProvidesChannel (const cChannel *Channel, int Priority=IDLEPRIORITY, bool *NeedsDetachReceivers=NULL) const
 
virtual bool ProvidesEIT (void) const
 
virtual int NumProvidedSystems (void) const
 
virtual int SignalStrength (void) const
 
virtual int SignalQuality (void) const
 
virtual const cChannelGetCurrentlyTunedTransponder (void) const
 
virtual bool IsTunedToTransponder (const cChannel *Channel) const
 
virtual bool MaySwitchTransponder (const cChannel *Channel) const
 
bool SwitchChannel (const cChannel *Channel, bool LiveView)
 
void ForceTransferMode (void)
 
int Occupied (void) const
 
void SetOccupied (int Seconds)
 
virtual bool HasLock (int TimeoutMs=0) const
 
virtual bool HasProgramme (void) const
 
void DelLivePids (void)
 
virtual int OpenFilter (u_short Pid, u_char Tid, u_char Mask)
 
virtual int ReadFilter (int Handle, void *Buffer, size_t Length)
 
virtual void CloseFilter (int Handle)
 
void AttachFilter (cFilter *Filter)
 
void Detach (cFilter *Filter)
 
virtual bool HasCi (void)
 
virtual bool HasInternalCam (void)
 
void SetCamSlot (cCamSlot *CamSlot)
 
virtual ucharGrabImage (int &Size, bool Jpeg=true, int Quality=-1, int SizeX=-1, int SizeY=-1)
 
bool GrabImageFile (const char *FileName, bool Jpeg=true, int Quality=-1, int SizeX=-1, int SizeY=-1)
 
virtual void SetVideoDisplayFormat (eVideoDisplayFormat VideoDisplayFormat)
 
virtual void SetVideoFormat (bool VideoFormat16_9)
 
virtual eVideoSystem GetVideoSystem (void)
 
virtual void GetVideoSize (int &Width, int &Height, double &VideoAspect)
 
virtual void GetOsdSize (int &Width, int &Height, double &PixelAspect)
 
void ClrAvailableTracks (bool DescriptionsOnly=false, bool IdsOnly=false)
 
bool SetAvailableTrack (eTrackType Type, int Index, uint16_t Id, const char *Language=NULL, const char *Description=NULL)
 
const tTrackIdGetTrack (eTrackType Type)
 
int NumTracks (eTrackType FirstTrack, eTrackType LastTrack) const
 
int NumAudioTracks (void) const
 
int NumSubtitleTracks (void) const
 
eTrackType GetCurrentAudioTrack (void) const
 
bool SetCurrentAudioTrack (eTrackType Type)
 
eTrackType GetCurrentSubtitleTrack (void) const
 
bool SetCurrentSubtitleTrack (eTrackType Type, bool Manual=false)
 
void EnsureAudioTrack (bool Force=false)
 
void EnsureSubtitleTrack (void)
 
void SetKeepTracks (bool KeepTracks)
 
bool IsMute (void) const
 
bool ToggleMute (void)
 
int GetAudioChannel (void)
 
void SetAudioChannel (int AudioChannel)
 
void SetVolume (int Volume, bool Absolute=false)
 
virtual int64_t GetSTC (void)
 
virtual bool IsPlayingVideo (void) const
 
virtual cRect CanScaleVideo (const cRect &Rect, int Alignment=taCenter)
 
virtual void ScaleVideo (const cRect &Rect=cRect::Null)
 
virtual bool HasIBPTrickSpeed (void)
 
virtual void TrickSpeed (int Speed)
 
virtual void Clear (void)
 
virtual void Play (void)
 
virtual void Freeze (void)
 
virtual void Mute (void)
 
virtual void StillPicture (const uchar *Data, int Length)
 
virtual bool Poll (cPoller &Poller, int TimeoutMs=0)
 
virtual bool Flush (int TimeoutMs=0)
 
virtual int PlayPes (const uchar *Data, int Length, bool VideoOnly=false)
 
virtual int PlayTs (const uchar *Data, int Length, bool VideoOnly=false)
 
bool Replaying (void) const
 
bool Transferring (void) const
 
void StopReplay (void)
 
bool AttachPlayer (cPlayer *Player)
 
void Detach (cPlayer *Player)
 
int Priority (void) const
 
bool Receiving (bool Dummy=false) const
 
bool AttachReceiver (cReceiver *Receiver)
 
void Detach (cReceiver *Receiver)
 
void DetachAll (int Pid)
 
virtual void DetachAllReceivers (void)
 
bool IsPrimaryDevice (void) const
 
int CardIndex (void) const
 
cCamSlotCamSlot (void) const
 
bool IsSubDevice (void) const
 
bool HasSubDevice (void) const
 
cDeviceSubDevice (void) const
 
bool IsIdle (void) const
 
bool SetIdle (bool Idle)
 
virtual bool SetIdleDevice (bool Idle, bool TestOnly)
 
- Public Member Functions inherited from cThread
 cThread (const char *Description=NULL, bool LowPriority=false)
 
virtual ~cThread ()
 
void SetDescription (const char *Description,...) __attribute__((format(printf
 
void bool Start (void)
 
bool Active (void)
 

Static Public Member Functions

static int NumDevices (void)
 
static bool WaitForAllDevicesReady (int Timeout=0)
 
static void SetUseDevice (int n)
 
static bool UseDevice (int n)
 
static bool SetPrimaryDevice (int n)
 
static cDevicePrimaryDevice (void)
 
static cDeviceActualDevice (void)
 
static cDeviceGetDevice (int Index)
 
static cDeviceGetDevice (const cChannel *Channel, int Priority, bool LiveView, bool Query=false)
 
static cDeviceGetDeviceForTransponder (const cChannel *Channel, int Priority)
 
static void Shutdown (void)
 
static bool SwitchChannel (int Direction)
 
static int CurrentChannel (void)
 
static void SetCurrentChannel (const cChannel *Channel)
 
static int CurrentVolume (void)
 
- Static Public Member Functions inherited from cThread
static tThreadId ThreadId (void)
 
static tThreadId IsMainThread (void)
 
static void SetMainThreadId (void)
 

Protected Types

enum  ePidType {
  ptAudio, ptVideo, ptPcr, ptTeletext,
  ptDolby, ptOther
}
 

Protected Member Functions

virtual ~cDevice ()
 
virtual bool Ready (void)
 
virtual void MakePrimaryDevice (bool On)
 
bool DeviceHooksProvidesTransponder (const cChannel *Channel) const
 
virtual bool SetChannelDevice (const cChannel *Channel, bool LiveView)
 
bool HasPid (int Pid) const
 
bool AddPid (int Pid, ePidType PidType=ptOther, int StreamType=0)
 
void DelPid (int Pid, ePidType PidType=ptOther)
 
virtual bool SetPid (cPidHandle *Handle, int Type, bool On)
 
void StartSectionHandler (void)
 
void StopSectionHandler (void)
 
virtual void SetAudioTrackDevice (eTrackType Type)
 
virtual void SetSubtitleTrackDevice (eTrackType Type)
 
virtual int GetAudioChannelDevice (void)
 
virtual void SetAudioChannelDevice (int AudioChannel)
 
virtual void SetVolumeDevice (int Volume)
 
virtual void SetDigitalAudioDevice (bool On)
 
virtual bool CanReplay (void) const
 
virtual bool SetPlayMode (ePlayMode PlayMode)
 
virtual int PlayVideo (const uchar *Data, int Length)
 
virtual int PlayAudio (const uchar *Data, int Length, uchar Id)
 
virtual int PlaySubtitle (const uchar *Data, int Length)
 
virtual int PlayPesPacket (const uchar *Data, int Length, bool VideoOnly=false)
 
virtual int PlayTsVideo (const uchar *Data, int Length)
 
virtual int PlayTsAudio (const uchar *Data, int Length)
 
virtual int PlayTsSubtitle (const uchar *Data, int Length)
 
virtual bool OpenDvr (void)
 
virtual void CloseDvr (void)
 
virtual bool GetTSPacket (uchar *&Data)
 
 cDevice (cDevice *ParentDevice=NULL)
 
const cPatPmtParserPatPmtParser (void) const
 
- Protected Member Functions inherited from cThread
void SetPriority (int Priority)
 
void SetIOPriority (int Priority)
 
void Lock (void)
 
void Unlock (void)
 
bool Running (void)
 
void Cancel (int WaitSeconds=0)
 

Static Protected Member Functions

static int NextCardIndex (int n=0)
 

Protected Attributes

cPidHandle pidHandles [MAXPIDHANDLES]
 
cDeviceparentDevice
 
cDevicesubDevice
 

Static Protected Attributes

static int currentChannel = 1
 

Private Member Functions

eSetChannelResult SetChannel (const cChannel *Channel, bool LiveView)
 
virtual void Action (void)
 

Private Attributes

int cardIndex
 
cLiveSubtitleliveSubtitle
 
cDvbSubtitleConverterdvbSubtitleConverter
 
time_t occupiedTimeout
 
cSectionHandlersectionHandler
 
cEitFiltereitFilter
 
cPatFilterpatFilter
 
cSdtFiltersdtFilter
 
cNitFilternitFilter
 
time_t startScrambleDetection
 
cCamSlotcamSlot
 
tTrackId availableTracks [ttMaxTrackTypes]
 
eTrackType currentAudioTrack
 
eTrackType currentSubtitleTrack
 
cMutex mutexCurrentAudioTrack
 
cMutex mutexCurrentSubtitleTrack
 
int currentAudioTrackMissingCount
 
bool autoSelectPreferredSubtitleLanguage
 
bool keepTracks
 
int pre_1_3_19_PrivateStream
 
bool mute
 
int volume
 
cPlayerplayer
 
cPatPmtParser patPmtParser
 
cTsToPes tsToPesVideo
 
cTsToPes tsToPesAudio
 
cTsToPes tsToPesSubtitle
 
bool isPlayingVideo
 
cMutex mutexReceiver
 
cReceiverreceiver [MAXRECEIVERS]
 
bool isIdle
 

Static Private Attributes

static int numDevices = 0
 
static int useDevice = 0
 
static cDevicedevice [MAXDEVICES] = { NULL }
 
static cDeviceprimaryDevice = NULL
 
static int nextCardIndex = 0
 
static cList< cDeviceHookdeviceHooks
 
static cDevicenextParentDevice = NULL
 

Friends

class cLiveSubtitle
 
class cDeviceHook
 
class cDynamicDevice
 

Detailed Description

The cDevice class is the base from which actual devices can be derived.

Definition at line 104 of file device.h.

Member Enumeration Documentation

enum cDevice::ePidType
protected
Enumerator
ptAudio 
ptVideo 
ptPcr 
ptTeletext 
ptDolby 
ptOther 

Definition at line 342 of file device.h.

Constructor & Destructor Documentation

cDevice::~cDevice ( )
protectedvirtual
cDevice::cDevice ( cDevice ParentDevice = NULL)
protected

Member Function Documentation

void cDevice::Action ( void  )
privatevirtual

A derived cThread class must implement the code it wants to execute as a separate thread in this function.

If this is a loop, it must check Running() repeatedly to see whether it's time to stop.

Implements cThread.

Definition at line 1642 of file device.c.

References CamSlot(), ChannelCamRelations, CloseDvr(), Detach(), GetTSPacket(), cThread::Lock(), MAXRECEIVERS, OpenDvr(), cReceiver::Receive(), receiver, cThread::Running(), cChannelCamRelations::SetChecked(), cChannelCamRelations::SetDecrypt(), cCamSlot::SlotNumber(), startScrambleDetection, TS_SCRAMBLING_CONTROL, TS_SCRAMBLING_TIME_OK, TS_SCRAMBLING_TIMEOUT, TS_SIZE, TsPid(), and cThread::Unlock().

cDevice * cDevice::ActualDevice ( void  )
static

Returns the actual receiving device in case of Transfer Mode, or the primary device otherwise.

Definition at line 252 of file device.c.

References PrimaryDevice(), and cTransferControl::ReceiverDevice().

Referenced by cSkinLCARSDisplayChannel::DrawDevice(), cSkinLCARSDisplayMenu::DrawLiveIndicator(), cSkinLCARSDisplayChannel::DrawSignal(), cSkinSTTNGDisplayChannel::Flush(), main(), and cEITScanner::Process().

bool cDevice::AddPid ( int  Pid,
ePidType  PidType = ptOther,
int  StreamType = 0 
)
protected
void cDevice::AttachFilter ( cFilter Filter)

Attaches the given filter to this device.

Definition at line 661 of file device.c.

References cSectionHandler::Attach(), AttachFilter(), parentDevice, sectionHandler, and SetIdle().

Referenced by AttachFilter(), and StartSectionHandler().

bool cDevice::AttachPlayer ( cPlayer Player)
bool cDevice::AttachReceiver ( cReceiver Receiver)
virtual bool cDevice::AvoidRecording ( void  ) const
inlinevirtual

Returns true if this device should only be used for recording if no other device is available.

Reimplemented in cDvbSdFfDevice.

Definition at line 211 of file device.h.

Referenced by GetDevice().

cCamSlot* cDevice::CamSlot ( void  ) const
inline

Returns the CAM slot that is currently used with this device, or NULL if no CAM slot is in use.

Definition at line 814 of file device.h.

References camSlot, and CamSlot().

Referenced by Action(), CamSlot(), cCamSlot::Device(), DrawDeviceData(), GetDevice(), cDvbDevice::ProvidesChannel(), cDvbHdFfDevice::SetAudioTrackDevice(), cDvbSdFfDevice::SetAudioTrackDevice(), SetCamSlot(), cDvbHdFfDevice::SetChannelDevice(), and cDvbSdFfDevice::SetChannelDevice().

bool cDevice::CanReplay ( void  ) const
protectedvirtual

Returns true if this device can currently start a replay session.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1168 of file device.c.

References HasDecoder().

Referenced by AttachPlayer(), cDvbSdFfDevice::CanReplay(), cDvbHdFfDevice::CanReplay(), and SetChannel().

virtual cRect cDevice::CanScaleVideo ( const cRect Rect,
int  Alignment = taCenter 
)
inlinevirtual

Asks the output device whether it can scale the currently shown video in such a way that it fits into the given Rect, while retaining its proper aspect ratio.

If the scaled video doesn't exactly fit into Rect, Alignment is used to determine how to align the actual rectangle with the requested one. The actual rectangle can be smaller, larger or the same size as the given Rect, and its location may differ, depending on the capabilities of the output device, which may not be able to display a scaled video at arbitrary sizes and locations. The device shall, however, do its best to match the requested Rect as closely as possible, preferring a size and location that fits completely into the requested Rect if possible. Returns the rectangle that can actually be used when scaling the video. A skin plugin using this function should rearrange its content according to the rectangle returned from calling this function, and should especially be prepared for cases where the returned rectangle is way off the requested Rect, or even Null. In such cases, the skin may want to fall back to working with full screen video. The coordinates of Rect are in the range of the width and height returned by GetOsdSize(). If this device can't scale the video, a Null rectangle is returned (this is also the default implementation).

Reimplemented in cDvbHdFfDevice.

Definition at line 653 of file device.h.

References cRect::Null.

int cDevice::CardIndex ( void  ) const
inline
void cDevice::Clear ( void  )
virtual

Clears all video and audio data from the device.

A derived class must call the base class function to make sure all registered cAudio objects are notified.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1187 of file device.c.

References Audios, cAudios::ClearAudio(), dvbSubtitleConverter, and cDvbSubtitleConverter::Reset().

Referenced by cDvbSdFfDevice::Clear(), cDvbHdFfDevice::Clear(), and cPlayer::DeviceClear().

void cDevice::CloseDvr ( void  )
protectedvirtual

Shuts down the DVR.

Reimplemented in cDvbDevice.

Definition at line 1700 of file device.c.

Referenced by Action().

void cDevice::CloseFilter ( int  Handle)
virtual

Closes a file handle that has previously been opened by OpenFilter().

If this is as simple as calling close(Handle), a derived class need not implement this function, because this is done by the default implementation.

Reimplemented in cDvbDevice.

Definition at line 656 of file device.c.

Referenced by cSectionHandler::Del().

void cDevice::ClrAvailableTracks ( bool  DescriptionsOnly = false,
bool  IdsOnly = false 
)

Clears the list of currently available tracks.

If DescriptionsOnly is true, only the track descriptions will be cleared. With IdsOnly set to true only the ids will be cleared. IdsOnly is only taken into account if DescriptionsOnly is false.

Definition at line 990 of file device.c.

References availableTracks, currentAudioTrack, currentAudioTrackMissingCount, currentSubtitleTrack, cThread::description, keepTracks, pre_1_3_19_PrivateStream, SetAudioChannel(), ttMaxTrackTypes, and ttNone.

Referenced by AttachPlayer(), cDevice(), cPlayer::DeviceClrAvailableTracks(), cPatPmtParser::ParsePmt(), PlayPesPacket(), SetChannel(), and SetTrackDescriptions().

static int cDevice::CurrentChannel ( void  )
inlinestatic
static int cDevice::CurrentVolume ( void  )
inlinestatic

Definition at line 570 of file device.h.

References volume.

Referenced by cSVDRP::CmdVOLU(), main(), cDvbSdFfDevice::SetDigitalAudioDevice(), and cDisplayVolume::Show().

void cDevice::DelLivePids ( void  )

Deletes the live viewing PIDs.

Definition at line 603 of file device.c.

References DelPid(), pidHandles, ptAudio, and ptOther.

Referenced by cDvbTuner::SetChannel().

void cDevice::DelPid ( int  Pid,
ePidType  PidType = ptOther 
)
protected
void cDevice::Detach ( cFilter Filter)

Detaches the given filter from this device.

Definition at line 670 of file device.c.

References cSectionHandler::Detach(), Detach(), parentDevice, and sectionHandler.

Referenced by Action(), AttachPlayer(), cReceiver::Detach(), cPlayer::Detach(), Detach(), DetachAll(), DetachAllReceivers(), SetIdle(), StopReplay(), and ~cDevice().

void cDevice::Detach ( cPlayer Player)
void cDevice::Detach ( cReceiver Receiver)
void cDevice::DetachAll ( int  Pid)
void cDevice::DetachAllReceivers ( void  )
virtual

Detaches all receivers from this device.

Reimplemented in cDvbDevice.

Definition at line 1795 of file device.c.

References Detach(), MAXRECEIVERS, mutexReceiver, and receiver.

Referenced by GetDevice(), SetIdle(), and ~cDevice().

bool cDevice::DeviceHooksProvidesTransponder ( const cChannel Channel) const
protected
cString cDevice::DeviceName ( void  ) const
virtual

Returns a string identifying the name of this device.

The default implementation returns an empty string.

Reimplemented in cDvbDevice.

Definition at line 212 of file device.c.

int cDevice::DeviceNumber ( void  ) const
cString cDevice::DeviceType ( void  ) const
virtual

Returns a string identifying the type of this device (like "DVB-S").

If this device can receive different delivery systems, the returned string shall be that of the currently used system. The length of the returned string should not exceed 6 characters. The default implementation returns an empty string.

Reimplemented in cDvbDevice.

Definition at line 207 of file device.c.

Referenced by DrawDeviceData().

void cDevice::EnsureAudioTrack ( bool  Force = false)

Makes sure an audio track is selected that is actually available.

If Force is true, the language and Dolby Digital settings will be verified even if the current audio track is available.

Definition at line 1113 of file device.c.

References cSetup::AudioLanguages, availableTracks, currentAudioTrack, cSetup::CurrentDolby, dsyslog, GetCurrentAudioTrack(), GetTrack(), I18nIsPreferredLanguage(), tTrackId::id, keepTracks, tTrackId::language, SetAudioChannel(), SetCurrentAudioTrack(), Setup, ttAudioFirst, ttAudioLast, ttDolbyFirst, and ttDolbyLast.

Referenced by cDisplayTracks::cDisplayTracks(), cPatPmtParser::ParsePmt(), SetAvailableTrack(), and SetChannel().

void cDevice::EnsureSubtitleTrack ( void  )

Makes sure one of the preferred language subtitle tracks is selected.

Only has an effect if Setup.DisplaySubtitles is on.

Definition at line 1146 of file device.c.

References cSetup::DisplaySubtitles, GetCurrentSubtitleTrack(), GetTrack(), I18nIsPreferredLanguage(), tTrackId::id, keepTracks, tTrackId::language, SetCurrentSubtitleTrack(), Setup, cSetup::SubtitleLanguages, ttNone, ttSubtitleFirst, and ttSubtitleLast.

Referenced by cPatPmtParser::ParsePmt(), cMenuSetupDVB::ProcessKey(), SetAvailableTrack(), and SetChannel().

bool cDevice::Flush ( int  TimeoutMs = 0)
virtual

Returns true if the device's output buffers are empty, i.

e. any data which was buffered so far has been processed. If TimeoutMs is not zero, the device will wait up to the given number of milliseconds before returning in case there is still data in the buffers.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1341 of file device.c.

Referenced by cPlayer::DeviceFlush().

void cDevice::ForceTransferMode ( void  )

Forces the device into transfermode for the current channel.

Definition at line 879 of file device.c.

References Channels, CurrentChannel(), cChannels::GetByNumber(), cTransferControl::ReceiverDevice(), SetChannelDevice(), and SetIdle().

Referenced by cDvbSdFfDevice::SetAudioTrackDevice().

void cDevice::Freeze ( void  )
virtual

Puts the device into "freeze frame" mode.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1201 of file device.c.

References Audios, dvbSubtitleConverter, cDvbSubtitleConverter::Freeze(), and cAudios::MuteAudio().

Referenced by cPlayer::DeviceFreeze(), cDvbSdFfDevice::Freeze(), and cDvbHdFfDevice::Freeze().

int cDevice::GetAudioChannel ( void  )

Gets the current audio channel, which is stereo (0), mono left (1) or mono right (2).

Definition at line 965 of file device.c.

References GetAudioChannelDevice().

Referenced by cDisplayTracks::cDisplayTracks(), and cDisplayTracks::ProcessKey().

int cDevice::GetAudioChannelDevice ( void  )
protectedvirtual

Gets the current audio channel, which is stereo (0), mono left (1) or mono right (2).

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 923 of file device.c.

Referenced by GetAudioChannel().

eTrackType cDevice::GetCurrentAudioTrack ( void  ) const
inline
const cChannel * cDevice::GetCurrentlyTunedTransponder ( void  ) const
virtual

Returns a pointer to the currently tuned transponder.

This is not one of the channels in the global cChannels list, but rather a local copy. The result may be NULL if the device is not tuned to any transponder.

Reimplemented in cDvbDevice.

Definition at line 733 of file device.c.

eTrackType cDevice::GetCurrentSubtitleTrack ( void  ) const
inline
cDevice * cDevice::GetDevice ( int  Index)
static
cDevice * cDevice::GetDevice ( const cChannel Channel,
int  Priority,
bool  LiveView,
bool  Query = false 
)
static

Returns a device that is able to receive the given Channel at the given Priority, with the least impact on active recordings and live viewing.

The LiveView parameter tells whether the device will be used for live viewing or a recording. If the Channel is encrypted, a CAM slot that claims to be able to decrypt the channel is automatically selected and assigned to the returned device. Whether or not this combination of device and CAM slot is actually able to decrypt the channel can only be determined by checking the "scrambling control" bits of the received TS packets. The Action() function automatically does this and takes care that after detaching any receivers because the channel can't be decrypted, this device/CAM combination will be skipped in the next call to GetDevice(). If Query is true, no actual CAM assignments or receiver detachments will be done, so that this function can be called without any side effects in order to just determine whether a device is available for the given Channel. See also ProvidesChannel().

Definition at line 280 of file device.c.

References cCamSlot::Assign(), AvoidRecording(), cChannel::Ca(), CA_DVB_MAX, CA_ENCRYPTED_MIN, cChannel::Caids(), cChannelCamRelations::CamChecked(), cChannelCamRelations::CamDecrypt(), CamSlot(), CamSlots, CardIndex(), ChannelCamRelations, cListBase::Count(), DetachAllReceivers(), device, cCamSlot::Device(), cList< T >::First(), cList< T >::Get(), cChannel::GetChannelID(), GetClippedNumProvidedSystems(), HasCi(), HasInternalCam(), IDLEPRIORITY, cListObject::Index(), cCamSlot::IsDecrypting(), IsPrimaryDevice(), MAXPRIORITY, cCamSlot::ModuleStatus(), msReady, cList< T >::Next(), numDevices, cCamSlot::Priority(), Priority(), cCamSlot::ProvidesCa(), ProvidesChannel(), cTransferControl::ReceiverDevice(), Receiving(), and cCamSlot::SlotNumber().

cDevice * cDevice::GetDeviceForTransponder ( const cChannel Channel,
int  Priority 
)
static

Returns a device that is not currently "occupied" and can be tuned to the transponder of the given Channel, without disturbing any receiver at priorities higher or equal to Priority.

If no such device is currently available, NULL will be returned.

Definition at line 373 of file device.c.

References GetDevice(), NumDevices(), and Priority().

Referenced by main().

void cDevice::GetOsdSize ( int &  Width,
int &  Height,
double &  PixelAspect 
)
virtual

Returns the Width, Height and PixelAspect ratio the OSD should use to best fit the resolution of the output device.

If PixelAspect is not 1.0, the OSD may take this as a hint to scale its graphics in a way that, e.g., a circle will actually show up as a circle on the screen, and not as an ellipse. Values greater than 1.0 mean to stretch the graphics in the vertical direction (or shrink it in the horizontal direction, depending on which dimension shall be fixed). Values less than 1.0 work the other way round. Note that the OSD is not guaranteed to actually use this hint.

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 485 of file device.c.

Referenced by cDvbSdFfDevice::GetOsdSize(), cDvbSubtitleConverter::SetOsdData(), cDvbSpuDecoder::SetSpuScaling(), and cOsdProvider::UpdateOsdSize().

cSpuDecoder * cDevice::GetSpuDecoder ( void  )
virtual

Returns a pointer to the device's SPU decoder (or NULL, if this device doesn't have an SPU decoder).

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 247 of file device.c.

Referenced by SetVideoDisplayFormat().

int64_t cDevice::GetSTC ( void  )
virtual

Gets the current System Time Counter, which can be used to synchronize audio, video and subtitles.

If this device is able to replay, it must provide an STC. The value returned doesn't need to be an actual "clock" value, it is sufficient if it holds the PTS (Presentation Time Stamp) of the most recently presented frame. A proper value must be returned in normal replay mode as well as in any trick modes (like slow motion, fast forward/rewind). Only the lower 32 bit of this value are actually used, since some devices can't handle the msb correctly.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1178 of file device.c.

Referenced by cDvbSubtitleConverter::Action(), and cPlayer::DeviceGetSTC().

const tTrackId * cDevice::GetTrack ( eTrackType  Type)
bool cDevice::GetTSPacket ( uchar *&  Data)
protectedvirtual

Gets exactly one TS packet from the DVR of this device and returns a pointer to it in Data.

Only the first 188 bytes (TS_SIZE) Data points to are valid and may be accessed. If there is currently no new data available, Data will be set to NULL. The function returns false in case of a non recoverable error, otherwise it returns true, even if Data is NULL.

Reimplemented in cDvbDevice.

Definition at line 1704 of file device.c.

Referenced by Action().

void cDevice::GetVideoSize ( int &  Width,
int &  Height,
double &  VideoAspect 
)
virtual

Returns the Width, Height and VideoAspect ratio of the currently displayed video material.

Width and Height are given in pixel (e.g. 720x576) and VideoAspect is e.g. 1.33333 for a 4:3 broadcast, or 1.77778 for 16:9. The default implementation returns 0 for Width and Height and 1.0 for VideoAspect.

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 478 of file device.c.

Referenced by cDvbHdFfDevice::GetVideoSize(), cDvbSdFfDevice::GetVideoSize(), and cDvbSubtitleConverter::SetOsdData().

eVideoSystem cDevice::GetVideoSystem ( void  )
virtual

Returns the video system of the currently displayed material (default is PAL).

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 473 of file device.c.

References vsPAL.

uchar * cDevice::GrabImage ( int &  Size,
bool  Jpeg = true,
int  Quality = -1,
int  SizeX = -1,
int  SizeY = -1 
)
virtual

Grabs the currently visible screen image.

Size is the size of the returned data block. If Jpeg is true it will write a JPEG file. Otherwise a PNM file will be written. Quality is the compression factor for JPEG. 1 will create a very blocky and small image, 70..80 will yield reasonable quality images while keeping the image file size around 50 KB for a full frame. The default will create a big but very high quality image. SizeX is the number of horizontal pixels in the frame (default is the current screen width). SizeY is the number of vertical pixels in the frame (default is the current screen height). Returns a pointer to the grabbed image data, or NULL in case of an error. The caller takes ownership of the returned memory and must free() it once it isn't needed any more.

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 414 of file device.c.

Referenced by cSVDRP::CmdGRAB(), and GrabImageFile().

bool cDevice::GrabImageFile ( const char *  FileName,
bool  Jpeg = true,
int  Quality = -1,
int  SizeX = -1,
int  SizeY = -1 
)

Calls GrabImage() and stores the resulting image in a file with the given name.

Returns true if all went well. The caller is responsible for making sure that the given file name doesn't lead to overwriting any important other file.

Definition at line 419 of file device.c.

References GrabImage(), isyslog, LOG_ERROR_STR, and safe_write().

bool cDevice::HasCi ( void  )
virtual

Returns true if this device has a Common Interface.

Reimplemented in cDvbDevice.

Definition at line 393 of file device.c.

Referenced by GetDevice().

bool cDevice::HasDecoder ( void  ) const
virtual

Tells whether this device has an MPEG decoder.

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 242 of file device.c.

Referenced by CanReplay(), and main().

virtual bool cDevice::HasIBPTrickSpeed ( void  )
inlinevirtual

Returns true if this device can handle all frames in 'fast forward' trick speeds.

Definition at line 682 of file device.h.

Referenced by cPlayer::DeviceHasIBPTrickSpeed(), PlayPesPacket(), and PlayTs().

virtual bool cDevice::HasInternalCam ( void  )
inlinevirtual

Returns true if this device handles encrypted channels itself without VDR assistance.

This can be e.g. if the device is a client that gets the stream from another VDR instance that has already decrypted the stream. In this case ProvidesChannel() shall check whether the channel can be decrypted.

Definition at line 414 of file device.h.

Referenced by GetDevice().

bool cDevice::HasLock ( int  TimeoutMs = 0) const
virtual

Returns true if the device has a lock on the requested transponder.

Default is true, a specific device implementation may return false to indicate that it is not ready yet. If TimeoutMs is not zero, waits for the given number of milliseconds before returning false.

Reimplemented in cDvbDevice.

Definition at line 913 of file device.c.

Referenced by cSectionHandler::Action(), AttachReceiver(), and cSectionHandler::SetStatus().

bool cDevice::HasPid ( int  Pid) const
protected

Returns true if this device is currently receiving the given PID.

Definition at line 495 of file device.c.

References MAXPIDHANDLES, and pidHandles.

Referenced by cDvbDevice::ProvidesChannel(), cDvbHdFfDevice::SetChannelDevice(), and cDvbSdFfDevice::SetChannelDevice().

bool cDevice::HasProgramme ( void  ) const
virtual

Returns true if the device is currently showing any programme to the user, either through replaying or live.

Definition at line 918 of file device.c.

References cDevice::cPidHandle::pid, pidHandles, ptAudio, ptVideo, and Replaying().

Referenced by main(), and Priority().

bool cDevice::HasSubDevice ( void  ) const
inline

Definition at line 818 of file device.h.

Referenced by cDvbDevice::UnBondDevices(), and cDvbCiAdapter::~cDvbCiAdapter().

bool cDevice::IsIdle ( void  ) const
inline

Definition at line 820 of file device.h.

References isIdle, and IsIdle().

Referenced by IsIdle(), and cDvbDevice::ProvidesEIT().

bool cDevice::IsMute ( void  ) const
inline

Definition at line 558 of file device.h.

References mute.

Referenced by cDvbSdFfDevice::SetDigitalAudioDevice().

virtual bool cDevice::IsPlayingVideo ( void  ) const
inlinevirtual

Returns true if the currently attached player has delivered any video packets.

Definition at line 650 of file device.h.

References isPlayingVideo.

Referenced by cPlayer::DeviceIsPlayingVideo().

bool cDevice::IsPrimaryDevice ( void  ) const
inline
bool cDevice::IsSubDevice ( void  ) const
inline

Definition at line 817 of file device.h.

Referenced by cDvbCiAdapter::~cDvbCiAdapter(), and cDvbTuner::~cDvbTuner().

bool cDevice::IsTunedToTransponder ( const cChannel Channel) const
virtual

Returns true if this device is currently tuned to the given Channel's transponder.

Reimplemented in cDvbDevice.

Definition at line 738 of file device.c.

Referenced by main().

void cDevice::MakePrimaryDevice ( bool  On)
protectedvirtual

Informs a device that it will be the primary device.

If there is anything the device needs to set up when it becomes the primary device (On = true) or to shut down when it no longer is the primary device (On = false), it should do so in this function. A derived class must call the MakePrimaryDevice() function of its base class.

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 217 of file device.c.

References DELETENULL(), dvbSubtitleConverter, and liveSubtitle.

Referenced by cDvbHdFfDevice::MakePrimaryDevice(), cDvbSdFfDevice::MakePrimaryDevice(), and SetPrimaryDevice().

bool cDevice::MaySwitchTransponder ( const cChannel Channel) const
virtual

Returns true if it is ok to switch to the Channel's transponder on this device, without disturbing any other activities.

If an occupied timeout has been set for this device, and that timeout has not yet expired, this function returns false,

Reimplemented in cDvbDevice.

Definition at line 743 of file device.c.

References occupiedTimeout, cDevice::cPidHandle::pid, pidHandles, ptAudio, ptDolby, ptVideo, and Receiving().

Referenced by cDvbDevice::MaySwitchTransponder(), and cEITScanner::Process().

void cDevice::Mute ( void  )
virtual

Turns off audio while replaying.

A derived class must call the base class function to make sure all registered cAudio objects are notified.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1208 of file device.c.

References Audios, and cAudios::MuteAudio().

Referenced by cPlayer::DeviceMute(), cDvbSdFfDevice::Mute(), and cDvbHdFfDevice::Mute().

int cDevice::NextCardIndex ( int  n = 0)
staticprotected

Calculates the next card index.

Each device in a given machine must have a unique card index, which will be used to identify the device for assigning Ca parameters and deciding whether to actually use that device in this particular instance of VDR. Every time a new cDevice is created, it will be given the current nextCardIndex, and then nextCardIndex will be automatically incremented by 1. A derived class can determine whether a given device shall be used by checking UseDevice(NextCardIndex()). If a device is skipped, or if there are possible device indexes left after a derived class has set up all its devices, NextCardIndex(n) must be called, where n is the number of card indexes to skip.

Definition at line 184 of file device.c.

References esyslog, MAXDEVICES, and nextCardIndex.

Referenced by cDvbDevice::Initialize().

int cDevice::NumAudioTracks ( void  ) const

Returns the number of audio tracks that are currently available.

This is just for information, to quickly find out whether there is more than one audio track.

Definition at line 1057 of file device.c.

References NumTracks(), ttAudioFirst, and ttDolbyLast.

Referenced by SetAvailableTrack().

static int cDevice::NumDevices ( void  )
inlinestatic
int cDevice::NumProvidedSystems ( void  ) const
virtual

Returns the number of individual "delivery systems" this device provides.

The default implementation returns 0, so any derived class that can actually provide channels must implement this function. The result of this function is used when selecting a device, in order to avoid devices that provide more than one system.

Reimplemented in cDvbDevice, and cDvbSdFfDevice.

Definition at line 718 of file device.c.

Referenced by GetClippedNumProvidedSystems().

int cDevice::NumSubtitleTracks ( void  ) const

Returns the number of subtitle tracks that are currently available.

Definition at line 1062 of file device.c.

References NumTracks(), ttSubtitleFirst, and ttSubtitleLast.

int cDevice::NumTracks ( eTrackType  FirstTrack,
eTrackType  LastTrack 
) const

Returns the number of tracks in the given range that are currently available.

Definition at line 1047 of file device.c.

References availableTracks.

Referenced by NumAudioTracks(), and NumSubtitleTracks().

int cDevice::Occupied ( void  ) const

Returns the number of seconds this device is still occupied for.

Definition at line 890 of file device.c.

References Occupied(), occupiedTimeout, and parentDevice.

Referenced by Occupied().

bool cDevice::OpenDvr ( void  )
protectedvirtual

Opens the DVR of this device and prepares it to deliver a Transport Stream for use in a cReceiver.

Reimplemented in cDvbDevice.

Definition at line 1695 of file device.c.

Referenced by Action().

int cDevice::OpenFilter ( u_short  Pid,
u_char  Tid,
u_char  Mask 
)
virtual

Opens a file handle for the given filter data.

A derived device that provides section data must implement this function.

Reimplemented in cDvbDevice.

Definition at line 646 of file device.c.

Referenced by cSectionHandler::Add().

const cPatPmtParser* cDevice::PatPmtParser ( void  ) const
inlineprotected

Returns a pointer to the patPmtParser, so that a derived device can use the stream information from it.

Definition at line 807 of file device.h.

References patPmtParser, and PatPmtParser().

Referenced by PatPmtParser(), cDvbHdFfDevice::PlayTsAudio(), cDvbHdFfDevice::PlayTsVideo(), and cDvbHdFfDevice::StillPicture().

void cDevice::Play ( void  )
virtual

Sets the device into play mode (after a previous trick mode).

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1194 of file device.c.

References Audios, dvbSubtitleConverter, cDvbSubtitleConverter::Freeze(), mute, and cAudios::MuteAudio().

Referenced by cPlayer::DevicePlay(), cDvbSdFfDevice::Play(), and cDvbHdFfDevice::Play().

int cDevice::PlayAudio ( const uchar Data,
int  Length,
uchar  Id 
)
protectedvirtual

Plays the given data block as audio.

Data points to exactly one complete PES packet of the given Length. Id indicates the type of audio data this packet holds. PlayAudio() shall process the packet either as a whole (returning Length) or not at all (returning 0 or -1 and setting 'errno' accordingly). Returns the number of bytes actually taken from Data, or -1 in case of an error.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1351 of file device.c.

Referenced by PlayPesPacket(), and PlayTsAudio().

int cDevice::PlayPes ( const uchar Data,
int  Length,
bool  VideoOnly = false 
)
virtual

Plays all valid PES packets in Data with the given Length.

If Data is NULL any leftover data from a previous call will be discarded. If VideoOnly is true, only the video will be displayed, which is necessary for trick modes like 'fast forward'. Data should point to a sequence of complete PES packets. If the last packet in Data is not complete, it will be copied and combined to a complete packet with data from the next call to PlayPes(). That way any functions called from within PlayPes() will be guaranteed to always receive complete PES packets.

Definition at line 1461 of file device.c.

References dvbSubtitleConverter, esyslog, PesLength(), PlayPesPacket(), and cDvbSubtitleConverter::Reset().

Referenced by cPlayer::PlayPes().

int cDevice::PlayPesPacket ( const uchar Data,
int  Length,
bool  VideoOnly = false 
)
protectedvirtual

Plays the single PES packet in Data with the given Length.

If VideoOnly is true, only the video will be displayed, which is necessary for trick modes like 'fast forward'. Data must point to one single, complete PES packet.

Definition at line 1363 of file device.c.

References Audios, availableTracks, ClrAvailableTracks(), currentAudioTrack, currentSubtitleTrack, dsyslog, esyslog, HasIBPTrickSpeed(), isPlayingVideo, MIN_PRE_1_3_19_PRIVATESTREAM, cAudios::PlayAudio(), PlayAudio(), PlaySubtitle(), PlayVideo(), pre_1_3_19_PrivateStream, SetAvailableTrack(), Setup, cThread::Start(), ttAudio, ttDolby, ttNone, ttSubtitle, and cSetup::UseDolbyDigital.

Referenced by PlayPes().

int cDevice::PlaySubtitle ( const uchar Data,
int  Length 
)
protectedvirtual

Plays the given data block as a subtitle.

Data points to exactly one complete PES packet of the given Length. PlaySubtitle() shall process the packet either as a whole (returning Length) or not at all (returning 0 or -1 and setting 'errno' accordingly). Returns the number of bytes actually taken from Data, or -1 in case of an error.

Definition at line 1356 of file device.c.

References cDvbSubtitleConverter::ConvertFragments(), and dvbSubtitleConverter.

Referenced by PlayPesPacket().

int cDevice::PlayTs ( const uchar Data,
int  Length,
bool  VideoOnly = false 
)
virtual

Plays the given TS packet.

If VideoOnly is true, only the video will be displayed, which is necessary for trick modes like 'fast forward'. Data points to a single TS packet, Length is always TS_SIZE (the total size of a single TS packet). If Data is NULL any leftover data from a previous call will be discarded. A derived device can reimplement this function to handle the TS packets itself. Any packets the derived function can't handle must be sent to the base class function. This applies especially to the PAT/PMT packets. Returns -1 in case of error, otherwise the number of actually processed bytes is returned. PlayTs() shall process the TS packets either as a whole (returning TS_SIZE) or not at all, returning 0 or -1 and setting 'errno' accordingly).

Definition at line 1539 of file device.c.

References Audios, availableTracks, currentAudioTrack, currentSubtitleTrack, esyslog, HasIBPTrickSpeed(), isPlayingVideo, cPatPmtParser::IsPmtPid(), cPatPmtParser::ParsePat(), cPatPmtParser::ParsePmt(), PATPID, patPmtParser, cAudios::PlayTsAudio(), PlayTsAudio(), PlayTsSubtitle(), PlayTsVideo(), cPatPmtParser::Ppid(), cTsToPes::Reset(), TS_SIZE, TS_SYNC_BYTE, TsHasPayload(), TsPayloadOffset(), TsPid(), tsToPesAudio, tsToPesSubtitle, tsToPesVideo, and cPatPmtParser::Vpid().

Referenced by Detach(), cPlayer::PlayTs(), and cLiveSubtitle::Receive().

int cDevice::PlayTsAudio ( const uchar Data,
int  Length 
)
protectedvirtual

Plays the given data block as audio.

Data points to exactly one complete TS packet of the given Length (which is always TS_SIZE). PlayTsAudio() shall process the packet either as a whole (returning Length) or not at all (returning 0 or -1 and setting 'errno' accordingly). The default implementation collects all incoming TS payload belonging to one PES packet and calls PlayAudio() with the resulting packet.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1509 of file device.c.

References cTsToPes::GetPes(), PlayAudio(), cTsToPes::PutTs(), cTsToPes::Reset(), cTsToPes::SetRepeatLast(), and tsToPesAudio.

Referenced by PlayTs().

int cDevice::PlayTsSubtitle ( const uchar Data,
int  Length 
)
protectedvirtual

Plays the given data block as a subtitle.

Data points to exactly one complete TS packet of the given Length (which is always TS_SIZE). PlayTsSubtitle() shall process the packet either as a whole (returning Length) or not at all (returning 0 or -1 and setting 'errno' accordingly). The default implementation collects all incoming TS payload belonging to one PES packet and displays the resulting subtitle via the OSD.

Definition at line 1525 of file device.c.

References cDvbSubtitleConverter::Convert(), dvbSubtitleConverter, cTsToPes::GetPes(), cTsToPes::PutTs(), cTsToPes::Reset(), and tsToPesSubtitle.

Referenced by PlayTs().

int cDevice::PlayTsVideo ( const uchar Data,
int  Length 
)
protectedvirtual

Plays the given data block as video.

Data points to exactly one complete TS packet of the given Length (which is always TS_SIZE). PlayTsVideo() shall process the packet either as a whole (returning Length) or not at all (returning 0 or -1 and setting 'errno' accordingly). The default implementation collects all incoming TS payload belonging to one PES packet and calls PlayVideo() with the resulting packet.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1490 of file device.c.

References cTsToPes::GetPes(), PlayVideo(), cTsToPes::PutTs(), cTsToPes::Reset(), cTsToPes::SetRepeatLast(), TsPayloadStart(), and tsToPesVideo.

Referenced by PlayTs().

int cDevice::PlayVideo ( const uchar Data,
int  Length 
)
protectedvirtual

Plays the given data block as video.

Data points to exactly one complete PES packet of the given Length. PlayVideo() shall process the packet either as a whole (returning Length) or not at all (returning 0 or -1 and setting 'errno' accordingly). Returns the number of bytes actually taken from Data, or -1 in case of an error.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1346 of file device.c.

Referenced by PlayPesPacket(), and PlayTsVideo().

bool cDevice::Poll ( cPoller Poller,
int  TimeoutMs = 0 
)
virtual

Returns true if the device itself or any of the file handles in Poller is ready for further action.

If TimeoutMs is not zero, the device will wait up to the given number of milliseconds before returning in case it can't accept any data.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1336 of file device.c.

Referenced by cPlayer::DevicePoll().

static cDevice* cDevice::PrimaryDevice ( void  )
inlinestatic
int cDevice::Priority ( void  ) const

Returns the priority of the current receiving session (-MAXPRIORITY..MAXPRIORITY), or IDLEPRIORITY if no receiver is currently active.

Definition at line 1607 of file device.c.

References HasProgramme(), IDLEPRIORITY, IsPrimaryDevice(), max(), MAXRECEIVERS, mutexReceiver, parentDevice, Priority(), receiver, Replaying(), and TRANSFERPRIORITY.

Referenced by GetDevice(), GetDeviceForTransponder(), cCamSlot::Priority(), Priority(), cEITScanner::Process(), and cDvbDevice::ProvidesChannel().

bool cDevice::ProvidesChannel ( const cChannel Channel,
int  Priority = IDLEPRIORITY,
bool *  NeedsDetachReceivers = NULL 
) const
virtual

Returns true if this device can provide the given channel.

In case the device has cReceivers attached to it, Priority is used to decide whether the caller's request can be honored. The special Priority value IDLEPRIORITY will tell the caller whether this device is principally able to provide the given Channel, regardless of any attached cReceivers. If NeedsDetachReceivers is given, the resulting value in it will tell the caller whether or not it will have to detach any currently attached receivers from this device before calling SwitchChannel. Note that the return value in NeedsDetachReceivers is only meaningful if the function itself actually returns true. The default implementation always returns false, so a derived cDevice class that can provide channels must implement this function.

Reimplemented in cDvbDevice.

Definition at line 708 of file device.c.

Referenced by GetDevice().

bool cDevice::ProvidesEIT ( void  ) const
virtual

Returns true if this device provides EIT data and thus wants to be tuned to the channels it can receive regularly to update the data.

The default implementation returns false.

Reimplemented in cDvbDevice.

Definition at line 713 of file device.c.

Referenced by cEITScanner::Process().

bool cDevice::ProvidesSource ( int  Source) const
virtual

Returns true if this device can provide the given source.

Reimplemented in cDvbDevice, and cDvbSdFfDevice.

Definition at line 678 of file device.c.

Referenced by cMenuSetupLNB::Setup().

bool cDevice::ProvidesTransponder ( const cChannel Channel) const
virtual

Returns true if this device can provide the transponder of the given Channel (which implies that it can provide the Channel's source).

Reimplemented in cDvbDevice.

Definition at line 694 of file device.c.

Referenced by main(), cEITScanner::Process(), and ProvidesTransponderExclusively().

bool cDevice::ProvidesTransponderExclusively ( const cChannel Channel) const
virtual

Returns true if this is the only device that is able to provide the given channel's transponder.

Definition at line 699 of file device.c.

References device, numDevices, and ProvidesTransponder().

Referenced by cEITScanner::Process().

int cDevice::ReadFilter ( int  Handle,
void *  Buffer,
size_t  Length 
)
virtual

Reads data from a handle for the given filter.

A derived class need not implement this function, because this is done by the default implementation.

Definition at line 651 of file device.c.

References safe_read().

Referenced by cSectionHandler::Action().

bool cDevice::Ready ( void  )
protectedvirtual

Returns true if this device is ready.

Devices with conditional access hardware may need some time until they are up and running. This function is called in a loop at startup until all devices are ready (see WaitForAllDevicesReady()).

Reimplemented in cDvbDevice.

Definition at line 1622 of file device.c.

Referenced by WaitForAllDevicesReady().

bool cDevice::Receiving ( bool  Dummy = false) const

Returns true if we are currently receiving. The parameter has no meaning (for backwards compatibility only).

Definition at line 1627 of file device.c.

References MAXRECEIVERS, mutexReceiver, parentDevice, receiver, and Receiving().

Referenced by GetDevice(), MaySwitchTransponder(), cDvbDevice::ProvidesChannel(), Receiving(), cRcuRemote::Recording(), and SetIdle().

bool cDevice::Replaying ( void  ) const
virtual void cDevice::ScaleVideo ( const cRect Rect = cRect::Null)
inlinevirtual

Scales the currently shown video in such a way that it fits into the given Rect.

Rect should be one retrieved through a previous call to CanScaleVideo() (otherwise results may be undefined). Even if video output is scaled, the functions GetVideoSize() and GetOsdSize() must still return the same values as if in full screen mode! If this device can't scale the video, nothing happens. To restore full screen video, call this function with a Null rectangle.

Reimplemented in cDvbHdFfDevice.

Definition at line 674 of file device.h.

void cDevice::SetAudioChannel ( int  AudioChannel)

Sets the audio channel to stereo (0), mono left (1) or mono right (2).

Any other values will be silently ignored.

Definition at line 971 of file device.c.

References SetAudioChannelDevice().

Referenced by ClrAvailableTracks(), EnsureAudioTrack(), and cDisplayTracks::ProcessKey().

void cDevice::SetAudioChannelDevice ( int  AudioChannel)
protectedvirtual

Sets the audio channel to stereo (0), mono left (1) or mono right (2).

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 928 of file device.c.

Referenced by SetAudioChannel().

void cDevice::SetAudioTrackDevice ( eTrackType  Type)
protectedvirtual

Sets the current audio track to the given value.

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 940 of file device.c.

Referenced by SetCurrentAudioTrack().

bool cDevice::SetAvailableTrack ( eTrackType  Type,
int  Index,
uint16_t  Id,
const char *  Language = NULL,
const char *  Description = NULL 
)

Sets the track of the given Type and Index to the given values.

Type must be one of the basic eTrackType values, like ttAudio or ttDolby. Index tells which track of the given basic type is meant. If Id is 0 any existing id will be left untouched and only the given Language and Description will be set. Returns true if the track was set correctly, false otherwise.

Definition at line 1013 of file device.c.

References autoSelectPreferredSubtitleLanguage, availableTracks, currentAudioTrack, currentAudioTrackMissingCount, cThread::description, EnsureAudioTrack(), EnsureSubtitleTrack(), esyslog, tTrackId::id, IS_AUDIO_TRACK, IS_DOLBY_TRACK, IS_SUBTITLE_TRACK, NumAudioTracks(), strn0cpy(), ttAudio, ttDolby, ttSubtitle, and Utf8Strn0Cpy().

Referenced by cPlayer::DeviceSetAvailableTrack(), cPatPmtParser::ParsePmt(), PlayPesPacket(), SetChannel(), and SetTrackDescriptions().

void cDevice::SetCamSlot ( cCamSlot CamSlot)

Sets the given CamSlot to be used with this device.

Definition at line 398 of file device.c.

References camSlot, CamSlot(), parentDevice, and SetCamSlot().

Referenced by cCamSlot::Assign(), SetCamSlot(), and cCamSlot::~cCamSlot().

eSetChannelResult cDevice::SetChannel ( const cChannel Channel,
bool  LiveView 
)
private
bool cDevice::SetChannelDevice ( const cChannel Channel,
bool  LiveView 
)
protectedvirtual

Sets the device to the given channel (actual physical setup).

Reimplemented in cDvbDevice, cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 908 of file device.c.

Referenced by ForceTransferMode(), and SetChannel().

bool cDevice::SetCurrentAudioTrack ( eTrackType  Type)

Sets the current audio track to the given Type.

Returns true if Type is a valid audio track, false otherwise.

Definition at line 1067 of file device.c.

References currentAudioTrack, GetTrack(), IS_AUDIO_TRACK, IS_DOLBY_TRACK, mutexCurrentAudioTrack, player, cPlayer::SetAudioTrack(), SetAudioTrackDevice(), SetDigitalAudioDevice(), ttDolbyLast, and ttNone.

Referenced by cPlayer::DeviceSetCurrentAudioTrack(), EnsureAudioTrack(), and cDisplayTracks::ProcessKey().

static void cDevice::SetCurrentChannel ( const cChannel Channel)
inlinestatic

Sets the number of the current channel on the primary device, without actually switching to it.

This can be used to correct the current channel number while replaying.

Definition at line 311 of file device.h.

References cChannel::Number().

Referenced by cSVDRP::CmdDELC(), cSVDRP::CmdMOVC(), cMenuChannels::Delete(), and cMenuChannels::Move().

bool cDevice::SetCurrentSubtitleTrack ( eTrackType  Type,
bool  Manual = false 
)

Sets the current subtitle track to the given Type.

IF Manual is true, no automatic preferred subtitle language selection will be done for the rest of the current replay session, or until the channel is changed. Returns true if Type is a valid subtitle track, false otherwise.

Definition at line 1085 of file device.c.

References AttachReceiver(), autoSelectPreferredSubtitleLanguage, cLiveSubtitle, currentSubtitleTrack, DELETENULL(), dvbSubtitleConverter, GetTrack(), tTrackId::id, IS_SUBTITLE_TRACK, liveSubtitle, mutexCurrentSubtitleTrack, player, Replaying(), cDvbSubtitleConverter::Reset(), cPlayer::SetSubtitleTrack(), SetSubtitleTrackDevice(), Transferring(), and ttNone.

Referenced by cPlayer::DeviceSetCurrentSubtitleTrack(), EnsureSubtitleTrack(), and cDisplaySubtitleTracks::ProcessKey().

void cDevice::SetDigitalAudioDevice ( bool  On)
protectedvirtual

Tells the actual device that digital audio output shall be switched on or off.

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 936 of file device.c.

Referenced by SetCurrentAudioTrack().

bool cDevice::SetIdle ( bool  Idle)
virtual bool cDevice::SetIdleDevice ( bool  Idle,
bool  TestOnly 
)
inlinevirtual

Called by SetIdle if TestOnly, don't do anything, just return, if the device can be set to the new idle state.

Reimplemented in cDvbDevice.

Definition at line 822 of file device.h.

Referenced by SetIdle().

void cDevice::SetKeepTracks ( bool  KeepTracks)
inline

Controls whether the current audio and subtitle track settings shall be kept as they currently are, or if they shall be automatically adjusted.

This is used when pausing live video.

Definition at line 536 of file device.h.

Referenced by cReplayControl::cReplayControl(), and cReplayControl::~cReplayControl().

void cDevice::SetOccupied ( int  Seconds)

Sets the occupied timeout for this device to the given number of Seconds, This can be used to tune a device to a particular transponder and make sure it will stay there for a certain amount of time, for instance to collect EPG data.

This function shall only be called after the device has been successfully tuned to the requested transponder. Seconds will be silently limited to MAXOCCUPIEDTIMEOUT. Values less than 0 will be silently ignored.

Definition at line 898 of file device.c.

References MAXOCCUPIEDTIMEOUT, min(), occupiedTimeout, parentDevice, and SetOccupied().

Referenced by main(), and SetOccupied().

bool cDevice::SetPid ( cPidHandle Handle,
int  Type,
bool  On 
)
protectedvirtual

Does the actual PID setting on this device.

On indicates whether the PID shall be added or deleted. Handle->handle can be used by the device to store information it needs to receive this PID (for instance a file handle). Handle->used indicates how many receivers are using this PID. Type indicates some special types of PIDs, which the device may need to set in a specific way.

Reimplemented in cDvbDevice, cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 598 of file device.c.

Referenced by AddPid(), and DelPid().

bool cDevice::SetPlayMode ( ePlayMode  PlayMode)
protectedvirtual

Sets the device into the given play mode.

Returns true if the operation was successful.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1173 of file device.c.

Referenced by AttachPlayer(), and Detach().

bool cDevice::SetPrimaryDevice ( int  n)
static

Sets the primary device to 'n'.

n must be in the range 1...numDevices. Returns true if this was possible.

Definition at line 225 of file device.c.

References cSetup::CurrentVolume, device, esyslog, isyslog, MakePrimaryDevice(), numDevices, primaryDevice, Setup, SetVideoFormat(), SetVolumeDevice(), and cSetup::VideoFormat.

Referenced by main().

void cDevice::SetSubtitleTrackDevice ( eTrackType  Type)
protectedvirtual

Sets the current subtitle track to the given value.

Definition at line 944 of file device.c.

Referenced by SetCurrentSubtitleTrack().

void cDevice::SetUseDevice ( int  n)
static

Sets the 'useDevice' flag of the given device.

If this function is not called before initializing, all devices will be used.

Definition at line 178 of file device.c.

References MAXDEVICES, and useDevice.

Referenced by main().

void cDevice::SetVideoDisplayFormat ( eVideoDisplayFormat  VideoDisplayFormat)
virtual

Sets the video display format to the given one (only useful if this device has an MPEG decoder).

A derived class must first call the base class function!

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 446 of file device.c.

References cSpuDecoder::eSpuLetterBox, cSpuDecoder::eSpuNormal, cSpuDecoder::eSpuPanAndScan, esyslog, GetSpuDecoder(), cSpuDecoder::setScaleMode(), Setup, vdfCenterCutOut, vdfLetterBox, vdfPanAndScan, and cSetup::VideoFormat.

Referenced by Detach(), cPlayer::DeviceSetVideoDisplayFormat(), cMenuSetupDVB::ProcessKey(), cDvbHdFfDevice::SetVideoDisplayFormat(), and cDvbSdFfDevice::SetVideoDisplayFormat().

void cDevice::SetVideoFormat ( bool  VideoFormat16_9)
virtual

Sets the output video format to either 16:9 or 4:3 (only useful if this device has an MPEG decoder).

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 469 of file device.c.

Referenced by cMenuSetupDVB::ProcessKey(), and SetPrimaryDevice().

void cDevice::SetVolume ( int  Volume,
bool  Absolute = false 
)

Sets the volume to the given value, either absolutely or relative to the current volume.

Definition at line 977 of file device.c.

References Audios, constrain(), MAXVOLUME, cStatus::MsgSetVolume(), mute, cAudios::MuteAudio(), SetVolumeDevice(), and volume.

Referenced by cSVDRP::CmdVOLU(), main(), and ToggleMute().

void cDevice::SetVolumeDevice ( int  Volume)
protectedvirtual

Sets the audio volume on this device (Volume = 0...255).

Reimplemented in cDvbSdFfDevice, and cDvbHdFfDevice.

Definition at line 932 of file device.c.

Referenced by SetPrimaryDevice(), and SetVolume().

void cDevice::Shutdown ( void  )
static

Closes down all devices.

Must be called at the end of the program.

Definition at line 405 of file device.c.

References cListBase::Clear(), device, deviceHooks, and numDevices.

Referenced by main().

int cDevice::SignalQuality ( void  ) const
virtual

Returns the "quality" of the currently received signal.

This is a value in the range 0 (worst quality) through 100 (best possible quality). A value of -1 indicates that this device has no concept of a "signal quality".

Reimplemented in cDvbDevice.

Definition at line 728 of file device.c.

Referenced by DrawDeviceSignal(), and cSkinSTTNGDisplayChannel::Flush().

int cDevice::SignalStrength ( void  ) const
virtual

Returns the "strength" of the currently received signal.

This is a value in the range 0 (no signal at all) through 100 (best possible signal). A value of -1 indicates that this device has no concept of a "signal strength".

Reimplemented in cDvbDevice.

Definition at line 723 of file device.c.

Referenced by DrawDeviceSignal(), and cSkinSTTNGDisplayChannel::Flush().

void cDevice::StartSectionHandler ( void  )
protected

A derived device that provides section data must call this function (typically in its constructor) to actually set up the section handler.

Definition at line 611 of file device.c.

References AttachFilter(), eitFilter, nitFilter, parentDevice, patFilter, sdtFilter, sectionHandler, and StartSectionHandler().

Referenced by cDvbDevice::cDvbDevice(), cDvbDevice::SetIdleDevice(), and StartSectionHandler().

void cDevice::StillPicture ( const uchar Data,
int  Length 
)
virtual

Displays the given I-frame as a still picture.

Data points either to TS (first byte is 0x47) or PES (first byte is 0x00) data of the given Length. The default implementation converts TS to PES and calls itself again, allowing a derived class to display PES if it can't handle TS directly.

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1213 of file device.c.

References buf(), esyslog, cTsToPes::GetPes(), cPatPmtParser::IsPmtPid(), LOG_ERROR_STR, cPatPmtParser::ParsePat(), cPatPmtParser::ParsePmt(), PATPID, patPmtParser, cTsToPes::PutTs(), cTsToPes::Reset(), TS_SIZE, TsPayloadStart(), TsPid(), and cPatPmtParser::Vpid().

Referenced by cPlayer::DeviceStillPicture(), cDvbSdFfDevice::StillPicture(), and cDvbHdFfDevice::StillPicture().

void cDevice::StopReplay ( void  )

Stops the current replay session (if any).

Definition at line 1325 of file device.c.

References Detach(), IsPrimaryDevice(), parentDevice, player, cControl::Shutdown(), and StopReplay().

Referenced by main(), cEITScanner::Process(), cMenuRecordings::Rewind(), SetChannel(), and StopReplay().

void cDevice::StopSectionHandler ( void  )
protected

A device that has called StartSectionHandler() must call this function (typically in its destructor) to stop the section handler.

Definition at line 626 of file device.c.

References eitFilter, nitFilter, parentDevice, patFilter, sdtFilter, sectionHandler, and StopSectionHandler().

Referenced by cDvbDevice::SetIdleDevice(), StopSectionHandler(), and cDvbDevice::~cDvbDevice().

cDevice* cDevice::SubDevice ( void  ) const
inline

Definition at line 819 of file device.h.

References subDevice.

Referenced by cDvbDevice::UnBondDevices().

bool cDevice::SwitchChannel ( const cChannel Channel,
bool  LiveView 
)
bool cDevice::SwitchChannel ( int  Direction)
static

Switches the primary device to the next available channel in the given Direction (only the sign of Direction is evaluated, positive values switch to higher channel numbers).

Definition at line 769 of file device.c.

References Channels, CurrentChannel(), dsyslog, cChannels::GetByNumber(), GetDevice(), LIVEPRIORITY, cSkins::Message(), mtError, cChannel::Number(), PrimaryDevice(), sgn(), cControl::Shutdown(), Skins, SwitchChannel(), and tr.

bool cDevice::ToggleMute ( void  )

Turns the volume off or on and returns the new mute state.

Definition at line 948 of file device.c.

References Audios, mute, cAudios::MuteAudio(), SetVolume(), and volume.

Referenced by cSVDRP::CmdVOLU(), and main().

bool cDevice::Transferring ( void  ) const
void cDevice::TrickSpeed ( int  Speed)
virtual

Sets the device into a mode where replay is done slower.

Every single frame shall then be displayed the given number of times. The cDvbPlayer uses the following values for the various speeds: 1x 2x 3x Fast Forward 6 3 1 Fast Reverse 6 3 1 Slow Forward 8 4 2 Slow Reverse 63 48 24

Reimplemented in cDvbHdFfDevice, and cDvbSdFfDevice.

Definition at line 1183 of file device.c.

Referenced by cPlayer::DeviceTrickSpeed().

static bool cDevice::UseDevice ( int  n)
inlinestatic

Tells whether the device with the given card index shall be used in this instance of VDR.

Definition at line 125 of file device.h.

Referenced by cDvbDevice::Initialize().

bool cDevice::WaitForAllDevicesReady ( int  Timeout = 0)
static

Waits until all devices have become ready, or the given Timeout (seconds) has expired.

While waiting, the Ready() function of each device is called in turn, until they all return true. Returns true if all devices have become ready within the given timeout.

Definition at line 162 of file device.c.

References device, numDevices, Ready(), and cCondWait::SleepMs().

Referenced by main().

Friends And Related Function Documentation

friend class cDeviceHook
friend

Definition at line 106 of file device.h.

friend class cDynamicDevice
friend

Definition at line 797 of file device.h.

friend class cLiveSubtitle
friend

Definition at line 105 of file device.h.

Referenced by SetCurrentSubtitleTrack().

Member Data Documentation

bool cDevice::autoSelectPreferredSubtitleLanguage
private

Definition at line 485 of file device.h.

Referenced by cDevice(), SetAvailableTrack(), and SetCurrentSubtitleTrack().

tTrackId cDevice::availableTracks[ttMaxTrackTypes]
private
cCamSlot* cDevice::camSlot
private

Definition at line 410 of file device.h.

Referenced by AddPid(), AttachReceiver(), CamSlot(), cDevice(), DelPid(), Detach(), SetCamSlot(), and SetChannel().

int cDevice::cardIndex
private

Definition at line 170 of file device.h.

Referenced by CardIndex(), and cDevice().

eTrackType cDevice::currentAudioTrack
private
int cDevice::currentAudioTrackMissingCount
private

Definition at line 484 of file device.h.

Referenced by cDevice(), ClrAvailableTracks(), and SetAvailableTrack().

int cDevice::currentChannel = 1
staticprotected

Definition at line 237 of file device.h.

Referenced by SetChannel().

eTrackType cDevice::currentSubtitleTrack
private
cDevice * cDevice::device = { NULL }
staticprivate
cList< cDeviceHook > cDevice::deviceHooks
staticprivate

Definition at line 218 of file device.h.

Referenced by cDeviceHook::cDeviceHook(), DeviceHooksProvidesTransponder(), and Shutdown().

cDvbSubtitleConverter* cDevice::dvbSubtitleConverter
private
cEitFilter* cDevice::eitFilter
private

Definition at line 374 of file device.h.

Referenced by cDevice(), StartSectionHandler(), and StopSectionHandler().

bool cDevice::isIdle
private

Definition at line 802 of file device.h.

Referenced by IsIdle(), and SetIdle().

bool cDevice::isPlayingVideo
private

Definition at line 580 of file device.h.

Referenced by cDevice(), Detach(), IsPlayingVideo(), PlayPesPacket(), and PlayTs().

bool cDevice::keepTracks
private

Definition at line 486 of file device.h.

Referenced by cDevice(), ClrAvailableTracks(), EnsureAudioTrack(), and EnsureSubtitleTrack().

cLiveSubtitle* cDevice::liveSubtitle
private
bool cDevice::mute
private

Definition at line 544 of file device.h.

Referenced by cDevice(), IsMute(), Play(), SetVolume(), and ToggleMute().

cMutex cDevice::mutexCurrentAudioTrack
private

Definition at line 482 of file device.h.

Referenced by SetCurrentAudioTrack().

cMutex cDevice::mutexCurrentSubtitleTrack
private

Definition at line 483 of file device.h.

Referenced by Detach(), and SetCurrentSubtitleTrack().

cMutex cDevice::mutexReceiver
mutableprivate

Definition at line 765 of file device.h.

Referenced by AttachReceiver(), Detach(), DetachAll(), DetachAllReceivers(), Priority(), and Receiving().

int cDevice::nextCardIndex = 0
staticprivate

Definition at line 169 of file device.h.

Referenced by cDevice(), and NextCardIndex().

cDevice * cDevice::nextParentDevice = NULL
staticprivate

Holds the parent device for the next subdevice so the dynamite-plugin can work with unpatched plugins.

Definition at line 799 of file device.h.

Referenced by cDevice().

cNitFilter* cDevice::nitFilter
private

Definition at line 377 of file device.h.

Referenced by cDevice(), StartSectionHandler(), and StopSectionHandler().

int cDevice::numDevices = 0
staticprivate
time_t cDevice::occupiedTimeout
private

Definition at line 235 of file device.h.

Referenced by cDevice(), MaySwitchTransponder(), Occupied(), and SetOccupied().

cDevice* cDevice::parentDevice
protected
cPatFilter* cDevice::patFilter
private

Definition at line 375 of file device.h.

Referenced by cDevice(), SetChannel(), StartSectionHandler(), and StopSectionHandler().

cPatPmtParser cDevice::patPmtParser
private

Definition at line 576 of file device.h.

Referenced by AttachPlayer(), Detach(), PatPmtParser(), PlayTs(), and StillPicture().

cPidHandle cDevice::pidHandles[MAXPIDHANDLES]
protected
cPlayer* cDevice::player
private
int cDevice::pre_1_3_19_PrivateStream
private

Definition at line 487 of file device.h.

Referenced by ClrAvailableTracks(), and PlayPesPacket().

cDevice * cDevice::primaryDevice = NULL
staticprivate

Definition at line 111 of file device.h.

Referenced by IsPrimaryDevice(), PrimaryDevice(), SetPrimaryDevice(), and ~cDevice().

cReceiver* cDevice::receiver[MAXRECEIVERS]
private
cSdtFilter* cDevice::sdtFilter
private

Definition at line 376 of file device.h.

Referenced by cDevice(), StartSectionHandler(), and StopSectionHandler().

cSectionHandler* cDevice::sectionHandler
private
time_t cDevice::startScrambleDetection
private

Definition at line 409 of file device.h.

Referenced by Action(), AttachReceiver(), and cDevice().

cDevice* cDevice::subDevice
protected

Definition at line 805 of file device.h.

Referenced by cDevice(), SubDevice(), and ~cDevice().

cTsToPes cDevice::tsToPesAudio
private

Definition at line 578 of file device.h.

Referenced by PlayTs(), and PlayTsAudio().

cTsToPes cDevice::tsToPesSubtitle
private

Definition at line 579 of file device.h.

Referenced by PlayTs(), and PlayTsSubtitle().

cTsToPes cDevice::tsToPesVideo
private

Definition at line 577 of file device.h.

Referenced by PlayTs(), and PlayTsVideo().

int cDevice::useDevice = 0
staticprivate

Definition at line 109 of file device.h.

Referenced by SetUseDevice().

int cDevice::volume
private

Definition at line 545 of file device.h.

Referenced by cDevice(), CurrentVolume(), SetVolume(), and ToggleMute().


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