home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2007 September / PCWSEP07.iso / Software / Linux / Linux Mint 3.0 Light / LinuxMint-3.0-Light.iso / casper / filesystem.squashfs / usr / share / doc / libxine1 / README.opengl < prev    next >
Encoding:
Text File  |  2007-03-09  |  3.8 KB  |  97 lines
  1. Startup
  2. -------
  3.  
  4. Start xine with '-V opengl'.
  5.  
  6. You can choose the render technique in xine's configuration menu
  7. (video.output.opengl_renderer). The following renderer are available:
  8.  
  9. * 2D_Tex_Fragprog
  10.   This module downloads the images as YUV 2D textures and renders a textured
  11.   slice using fragment programs for reconstructing RGB.
  12.   This is the best and fastest method on modern graphics cards.
  13.   Performance similar to XVideo or even better. Good for 1080p HDTV.
  14. * 2D_Tex
  15.   This module downloads the images as 2D textures and renders a textured
  16.   slice.
  17. * 2D_Tex_Tiled
  18.   This module downloads the images as multiple 2D textures and renders a
  19.   textured slice. Thus this works with smaller maximum texture sizes as well.
  20. * Image_Pipeline
  21.   This module uses glDraw() to render the images.
  22.   Only accelerated on few drivers.
  23.   Does not interpolate on scaling.
  24. * Cylinder
  25.   Shows images on a rotating cylinder. Nice effect :)
  26. * Environment_Mapped_Torus
  27.   Show images reflected in a spinning torus. Way cool =)
  28.  
  29.  
  30.  
  31. Problems you might encounter (FAQ)
  32. ----------------------------------
  33.  
  34. * Output is *extremely* slow
  35.  
  36.   Run 'glxinfo' and check the third output line saying 'direct rendering:'
  37.   If it doesn't say 'Yes', you are not running an accelerated OpenGL setup.
  38.   Check your installation.
  39.   Image_Pipeline based rendering is typically slower than 2D_Textures.
  40.   Note that OpenGL output is always slower than XVideo, and often faster
  41.   than X shared memory.
  42.  
  43. * Output is still slower than xshm, even though I do have direct rendering
  44.  
  45.   The Mesa hardware accelerated drivers do not seem to be optimized WRT
  46.   texture transfer, at least for the older radeon chips.
  47.   If it does not work well with other drivers please drop me a line.
  48.  
  49. * xine crashes when switching to fullscreen ('f') and back
  50.  
  51.   This only happens with accelerated Mesa drivers (reproducable), not with
  52.   the binary only NVIDIA and ATI drivers.
  53.   So either I uncovered a seldomly triggered bug in Mesa, or (more likely)
  54.   there is still an undiscovered race or bug in the output plugin. I have
  55.   debugged it a lot, but I cannot find anything wrong in my code.  Can
  56.   someone verify this behavior?
  57.  
  58. * I've chosing a more complex rendering option, but suddenly xine switched
  59.   back to '2D_Tex' or '2D_Tex_Tiled'
  60.  
  61.   If the current video cannot be displayed with the render settings, xine
  62.   falls back to a render technique that is capable of displaying the video.
  63.   Unfortunately, this can happen e.g. for large video frames, while smaller
  64.   video frames could be rendered differently, but xine does not switch back
  65.   to complex rendering techniques for them.
  66.   This also can happen for decoders using the WinAPI for loading windows
  67.   codecs from /usr/lib/codecs. They often decode into interleaved YUY2 video
  68.   instead of planar YUV, which is not yet implemented.
  69.   You have to switch back to more complex rendering techniques like
  70.   '2D_Tex_Fragprog' manually.
  71.  
  72. * Low color quality / quantization artifacts
  73.  
  74.   xine might choose a visual with a different color depth than you would
  75.   prefer.  Choose an appropriate visual with 'glxinfo' and select it with '-V
  76.   opengl --visual xyz' in this case.
  77.  
  78.  
  79. Known minor issues
  80. ------------------
  81.  
  82. * GL_BGRA (used on little endian machines, i.e. ix86) needs an extension
  83.   check. This is implemented, but not used yet...
  84. * Big endian machines have not been checked yet.
  85. * VO_CAP_UNSCALED_OVERLAY reduces performance a lot during the first few
  86.   frames. Thus disabled.
  87. * Cropping is not yet implemented - this is done by video_out.c
  88. * XINE_GUI_SEND_WILL_DESTROY_DRAWABLE only sent by few UIs
  89. * On startup or when switching to fullscreen, the screen may remain black
  90.   on rare occasions. On the next switch, however, everything looks normal.
  91.   Seems like a race, again. I've given up finding it. Feel free to look at
  92.   the code. Hasn't happened for a while for me, maybe it is gone now.
  93.  
  94.  
  95.  
  96. Matthias Hopf <mat@mshopf.de>
  97.