player.h

Go to the documentation of this file.

/*
 * player.h: The basic player interface
 *
 * See the main source file 'vdr.c' for copyright information and
 * how to reach the author.
 *
 * $Id: player.h 5.10 2026/08/22 11:23:08 kls Exp $
 */
 
#ifndef __PLAYER_H
#define __PLAYER_H
 
#include "device.h"
#include "osdbase.h"
 
class cPlayer {
  friend class cDevice;
private:
  std::atomic<cDevice *> device; // cleared by cDevice::Detach() while the player's threads use it
  ePlayMode playMode;
protected:
  void DeviceClrAvailableTracks(bool DescriptionsOnly = false) { if (cDevice *d = device) d->ClrAvailableTracks(DescriptionsOnly); }
  bool DeviceSetAvailableTrack(eTrackType Type, int Index, uint16_t Id, const char *Language = NULL, const char *Description = NULL) { cDevice *d = device; return d ? d->SetAvailableTrack(Type, Index, Id, Language, Description) : false; }
  bool DeviceSetCurrentAudioTrack(eTrackType Type) { cDevice *d = device; return d ? d->SetCurrentAudioTrack(Type) : false; }
  bool DeviceSetCurrentSubtitleTrack(eTrackType Type) { cDevice *d = device; return d ? d->SetCurrentSubtitleTrack(Type) : false; }
  bool DevicePoll(cPoller &Poller, int TimeoutMs = 0) { cDevice *d = device; return d ? d->Poll(Poller, TimeoutMs) : false; }
  [[deprecated("use DeviceDrain() instead")]]
  bool DeviceFlush(int TimeoutMs = 0) { return DeviceDrain(); }
  bool DeviceDrain(void) { cDevice *d = device; return d ? d->Drain() : false; }
  bool DeviceHasIBPTrickSpeed(void) { cDevice *d = device; return d ? d->HasIBPTrickSpeed() : false; }
  bool DeviceIsPlayingVideo(void) { cDevice *d = device; return d ? d->IsPlayingVideo() : false; }
  void DeviceTrickSpeed(int Speed, bool Forward) { if (cDevice *d = device) d->TrickSpeed(Speed, Forward); }
  void DeviceClear(void) { if (cDevice *d = device) d->Clear(); }
  void DevicePlay(void) { if (cDevice *d = device) d->Play(); }
  void DeviceFreeze(void) { if (cDevice *d = device) d->Freeze(); }
  void DeviceMute(void) { if (cDevice *d = device) d->Mute(); }
  void DeviceSetVideoDisplayFormat(eVideoDisplayFormat VideoDisplayFormat) { if (cDevice *d = device) d->SetVideoDisplayFormat(VideoDisplayFormat); }
  void DeviceStillPicture(const uchar *Data, int Length) { if (cDevice *d = device) d->StillPicture(Data, Length); }
  void DeviceSetTempSubtitles(void) { if (cDevice *d = device) d->SetTempSubtitles(); }
  uint64_t DeviceGetSTC(void) { cDevice *d = device; return d ? d->GetSTC() : -1; }
  void Detach(void);
  virtual void Activate(bool On) {}
       // This function is called right after the cPlayer has been attached to
       // (On == true) or before it gets detached from (On == false) a cDevice.
       // It can be used to do things like starting/stopping a thread.
  int PlayPes(const uchar *Data, int Length, bool VideoOnly = false);
       // Sends the given PES Data to the device and returns the number of
       // bytes that have actually been accepted by the device (or a
       // negative value in case of an error).
  int PlayTs(const uchar *Data, int Length, bool VideoOnly = false) { cDevice *d = device; return d ? d->PlayTs(Data, Length, VideoOnly) : -1; }
       // Sends the given TS packet to the device and returns a positive number
       // if the packet has been accepted by the device, or a negative value in
       // case of an error.
public:
  cPlayer(ePlayMode PlayMode = pmAudioVideo);
  virtual ~cPlayer();
  bool IsAttached(void) { return device != NULL; }
  virtual double FramesPerSecond(void) { return DEFAULTFRAMESPERSECOND; }
       // Returns the number of frames per second of the currently played material.
  virtual const cErrors *GetErrors(void) { return NULL; }
       // Returns the frame indexes of errors in the recording (if any).
  virtual bool GetIndex(int &Current, int &Total, bool SnapToIFrame = false) { return false; }
       // Returns the current and total frame index, optionally snapped to the
       // nearest I-frame.
  virtual bool GetFrameNumber(int &Current, int &Total) { return false; }
       // Returns the current and total frame number. In contrast to GetIndex(),
       // this function respects the chronological order of frames, which is
       // different from its index for streams containing B frames (e.g. H264)
  virtual bool GetReplayMode(bool &Play, bool &Forward, int &Speed) { return false; }
       // Returns the current replay mode (if applicable).
       // 'Play' tells whether we are playing or pausing, 'Forward' tells whether
       // we are going forward or backward and 'Speed' is -1 if this is normal
       // play/pause mode, 0 if it is single speed fast/slow forward/back mode
       // and >0 if this is multi speed mode.
  virtual void SetAudioTrack(eTrackType Type, const tTrackId *TrackId) {}
       // Sets the current audio track to the given value.
       // This is just a virtual hook for players that need to do special things
       // in order to switch audio tracks.
  virtual void SetSubtitleTrack(eTrackType Type, const tTrackId *TrackId) {}
       // Sets the current subtitle track to the given value.
       // This is just a virtual hook for players that need to do special things
       // in order to switch subtitle tracks.
  };
 
class cControl : public cOsdObject {
private:
  static cControl *control;
  static cMutex mutex;
  bool attached;
  bool hidden;
protected:
  cPlayer *player;
public:
  cControl(cPlayer *Player, bool Hidden = false);
  virtual ~cControl() override;
  virtual void Hide(void) = 0;
  virtual cOsdObject *GetInfo(void);
  virtual const cRecording *GetRecording(void);
  virtual cString GetHeader(void);
  virtual void ClearEditingMarks(void) {}
  void SetPlayer(cPlayer *Player) { player = Player; }
  double FramesPerSecond(void) const { return player ? player->FramesPerSecond() : DEFAULTFRAMESPERSECOND; }
  bool GetIndex(int &Current, int &Total, bool SnapToIFrame = false) const { return player ? player->GetIndex(Current, Total, SnapToIFrame) : false; }
  bool GetFrameNumber(int &Current, int &Total) const { return player ? player->GetFrameNumber(Current, Total) : false; }
  bool GetReplayMode(bool &Play, bool &Forward, int &Speed) const { return player ? player->GetReplayMode(Play, Forward, Speed) : false; }
  static void Launch(cControl *Control);
  static void Attach(void);
  static void Shutdown(void);
  static cControl *Control(cMutexLock &MutexLock, bool Hidden = false, bool *LockedOtherwise = NULL);
  };
 
#endif //__PLAYER_H