mtv-1.0.8.0 has a new full-screen mode!

To enter full-screen mode use the menu Window->Fullscreen.
If it does not work, please read further!

To exit full-screen mode and return to normal display mode, press
any key or click the mouse.

FEEDBACK APPRECIATED
====================

If the new full-screen mode works for you, please send us some
feedback at support@mpegtv.com.

Requirements for using the full-screen mode
-------------------------------------------

The SDL library libSDLx11.so.0.9 must be installed in
/usr/X11R6/lib/ (path is hard-coded for security reasons).

You run mtv as root (or mtvp must be set-iud root). To set-uid root,
become root and type: $ chown root mtvp; chmod +s mtvp

The environment variable DISPLAY must be set to ":0.0". To
check: $ printenv DISPLAY

The X server must run in 16, 24 or 32-bit depth.

Full-screen will always use the current depth of your X server.
Use 24 or 32-bit depth for optimum color quality.

The Color mode of mtv (Menu Option->Video) should be set to
Full-color.

SDL currently relies on XFree86's DGA extension, therefore
full-screen will only work with XFree86, not with other X servers
like XiG's Accelerated-X.

The full-screen mode will use the closest XFree86 mode that matches
or is larger than the size of the video.

Usually, it is a good idea to make sure that the following
resolutions are defined in your XFree86 configuration file
(XF86Config):

   Mode "320x240" 
    DotClock   15.750   
    HTimings   320 336 384 400     
    VTimings   240 244 246 262 
     Flags        "Doublescan"
   EndMode 

   Mode "352x240" 
    DotClock   15.750   
    HTimings   352 368 416 432     
    VTimings   240 244 246 262 
     Flags        "Doublescan"
   EndMode 

   Mode "352x280" 
    DotClock   15.750   
    HTimings   352 368 416 432     
    VTimings   280 288 286 302 
     Flags        "Doublescan"
   EndMode 

   Mode "352x288" 
    DotClock   15.750   
    HTimings   352 368 416 432     
    VTimings   288 296 290 310 
     Flags        "Doublescan"
   EndMode 

Note: The timing indicated here may be inadequate for your graphic
board and/or monitor.  Please refer to the XFree86 Howto page or
documentation for setting video modes.

Current limitations & Known problems
------------------------------------

You run the program as root (or that mtvp be set-iud root) in
order to use full-screen.  This is currently the only way to get
full-screen access with SDL but it may create security holes,
therefore it not advised on systems that must be secured.

Full-screen mode is currently not available in 8-bit depth
and does not work with Gray color mode.

XFree86 prints spurious messages:
video memory unprotecting
video memory protecting

Full-screen mode may not look good if the video size is not
a multiple of 16.

Full-screen will not work when using remote display.  Because of
a bug in SDL, it won't work with DISPLAY set to "localhost:0.0",
even though this is the local display.  The environment variable
DISPLAY must be set to ":0.0".

Full-screen mode will work better if there is enough on-board
memory installed on your graphic board to support hardware planes
and double-buffering.  If double-buffering cannot be used the image
may appear teared (i.e. no sync on vertical retrace).

Due to a bug in XFree86's DGA extension, Full-screen mode will not
work if you have a RIVA128 graphic chip or card!

A bug in SDL causes mtvp to crash if full-screen mode is set more
than once.  If that happens, you should kill all the remaining mtvp
processes with "kill -9 <pid>".

Final notes
-----------

If you still have problems with full-screen, please tell us at
support@mpegtv.com.

Use full-screen mode at you own risks!  On some systems, this mode
may cause your X server to die or hang, due to problems in the SDL
library or in XFree86 drivers.  The full-screen mode is quite new
and not fully tested yet.

Enjoy!

-- MpegTV
