Implemented cDevice::GetOsdSize(); fixed the way the OSD size is determined on full featured DVB cards

1 files changed, 13 insertions, 2 deletions

diff --git a/device.h b/device.h
index 4d96d312..05a936aa 100644
--- a/device.h
+++ b/device.h
@@ -4,7 +4,7 @@
  * See the main source file 'vdr.c' for copyright information and
  * how to reach the author.
  *
- * $Id: device.h 2.11 2009/05/08 13:28:09 kls Exp $
+ * $Id: device.h 2.12 2009/05/08 13:39:08 kls Exp $
  */
 
 #ifndef __DEVICE_H
@@ -386,7 +386,18 @@ public:
          ///< (default is PAL).
   virtual void GetVideoSize(int &Width, int &Height, eVideoAspect &Aspect);
          ///< Returns the With, Height and Aspect ratio of the currently
-         ///< displayed material.
+         ///< displayed material. The data returned by this function is
+         ///< only used for informational purposes (if any).
+         ///< The default implementation returns 0 for Width and Height.
+  virtual void GetOsdSize(int &Width, int &Height, double &Aspect);
+         ///< Returns the With, Height and Aspect ratio the OSD should use
+         ///< to best fit the resolution of the output device. If Aspect
+         ///< is not 1.0, the OSD may take this as a hint to stretch its
+         ///< graphics in a way that, e.g., a square area will actually
+         ///< show up as a square on the screen, and not as a rectangle.
+         ///< Values greater than 1.0 will stretch the graphics in the
+         ///< vertical direction. Note that the OSD is not guaranteed to
+         ///< actually use this hint.
 
 // Track facilities