player.c

Go to the documentation of this file.

/*
 * player.c: The basic player interface
 *
 * See the main source file 'vdr.c' for copyright information and
 * how to reach the author.
 *
 * $Id: player.c 5.4 2026/08/22 11:23:08 kls Exp $
 */
 
#include "player.h"
#include "i18n.h"
 
// --- cPlayer ---------------------------------------------------------------
 
cPlayer::cPlayer(ePlayMode PlayMode)
{
  device = NULL;
  playMode = PlayMode;
}
 
cPlayer::~cPlayer()
{
  Detach();
}
 
int cPlayer::PlayPes(const uchar *Data, int Length, bool VideoOnly)
{
  if (cDevice *d = device)
     return d->PlayPes(Data, Length, VideoOnly);
  esyslog("ERROR: attempt to use cPlayer::PlayPes() without attaching to a cDevice!");
  return -1;
}
 
void cPlayer::Detach(void)
{
  if (cDevice *d = device)
     d->Detach(this);
}
 
// --- cControl --------------------------------------------------------------
 
cControl *cControl::control = NULL;
cMutex cControl::mutex;
 
cControl::cControl(cPlayer *Player, bool Hidden)
{
  attached = false;
  hidden = Hidden;
  player = Player;
}
 
cControl::~cControl()
{
  if (this == control)
     control = NULL;
}
 
cOsdObject *cControl::GetInfo(void)
{
  return NULL;
}
 
const cRecording *cControl::GetRecording(void)
{
  return NULL;
}
 
cString cControl::GetHeader(void)
{
  return "";
}
 
#define CONTROL_LOCK_TIMEOUT 100 // ms
 
cControl *cControl::Control(cMutexLock &MutexLock, bool Hidden, bool *LockedOtherwise)
{
  int Timeout = cThread::IsMainThread() ? 0 : CONTROL_LOCK_TIMEOUT;
  if (LockedOtherwise)
     *LockedOtherwise = false;
  // Only a control needs the caller to keep the mutex locked. The main loop holds
  // it across its key dispatch, which takes the Channels lock, while
  // cControl::Shutdown() is called with the Channels lock held:
  cMutexLock ControlMutexLock;
  if (ControlMutexLock.Lock(&mutex, Timeout, LockedOtherwise)) {
     if (control && (!control->hidden || Hidden) && MutexLock.Lock(&mutex)) // recursive, stays locked for the caller
        return control;
     }
  return NULL;
}
 
void cControl::Launch(cControl *Control)
{
  cMutexLock MutexLock(&mutex);
  delete control;
  control = Control;
}
 
void cControl::Attach(void)
{
  cMutexLock MutexLock(&mutex);
  if (control && !control->attached && control->player && !control->player->IsAttached()) {
     if (cDevice::PrimaryDevice()->AttachPlayer(control->player))
        control->attached = true;
     else {
        Skins.QueueMessage(mtError, tr("Primary device has no MPEG decoder, can't attach player!"));
        Shutdown();
        }
     }
}
 
void cControl::Shutdown(void)
{
  cMutexLock MutexLock(&mutex);
  cControl *c = control; // avoids recursions
  control = NULL;
  delete c;
}