Documentation for the video magic (for Holger ;)

Small interface changes (better method names)

1 files changed, 184 insertions, 194 deletions

diff --git a/noncore/multimedia/opieplayer2/xinevideowidget.cpp b/noncore/multimedia/opieplayer2/xinevideowidget.cpp
index d06d62a..9b26d41 100644
--- a/noncore/multimedia/opieplayer2/xinevideowidget.cpp
+++ b/noncore/multimedia/opieplayer2/xinevideowidget.cpp
@@ -1,9 +1,8 @@
 
 /*
                             This file is part of the Opie Project
-
-                             Copyright (c)  2002 Max Reiss <harlekin@handhelds.org>
-                             Copyright (c)  2002 LJP <>
+ 
+                             Copyright (c)  2002 Robert Griebl <sandman@handhelds.org>
                              Copyright (c)  2002 Holger Freyther <zecke@handhelds.org>
               =.
             .=l.
@@ -29,7 +28,7 @@
                              If not, write to the Free Software Foundation,
                              Inc., 59 Temple Place - Suite 330,
                              Boston, MA 02111-1307, USA.
-
+ 
 */
 
 #include <qimage.h>
@@ -45,229 +44,220 @@
 
 #include "xinevideowidget.h"
 
+// 0 deg rot: copy a line from src to dst (use libc memcpy)
+
+// 180 deg rot: copy a line from src to dst reversed
 
 static inline void memcpy_rev ( void *dst, void *src, size_t len )
 {
-  ((char *) src ) += len;
+	((char *) src) += len;
 
-  len >>= 1;
-  while ( len-- )
-    *((short int *) dst )++ = *--((short int *) src );
+	len >>= 1;
+	while ( len-- )
+		*((short int *) dst) ++ = *--((short int *) src);
 }
 
-static inline void memcpy_step ( void *dst, void *src, size_t len, size_t step )
+// 90 deg rot: copy a column from src to dst
+
+static inline void memcpy_step ( void *dst, void *src, size_t len, size_t linestep )
 {
-  len >>= 1;
-  while ( len-- ) {
-    *((short int *) dst )++ = *((short int *) src );
-    ((char *) src ) += step;
-  }
+	len >>= 1;
+	while ( len-- ) {
+		*((short int *) dst) ++ = *((short int *) src);
+		((char * ) src) += linestep;
+	}
 }
 
-static inline void memcpy_step_rev ( void *dst, void *src, size_t len, size_t step )
+// 270 deg rot: copy a column from src to dst reversed
+
+static inline void memcpy_step_rev ( void *dst, void *src, size_t len, size_t linestep )
 {
-  len >>= 1;
+	len >>= 1;
 
-  ((char *) src ) += ( len * step );
+	((char *) src) += ( len * linestep );
 
-  while ( len-- ) {
-    ((char *) src ) -= step;
-    *((short int *) dst )++ = *((short int *) src );
-  }
+	while ( len-- ) {
+		((char *) src) -= linestep;
+		*((short int *) dst) ++ = *((short int *) src);
+	}
 }
 
 
 XineVideoWidget::XineVideoWidget ( QWidget* parent, const char* name )
-    : QWidget ( parent, name, WRepaintNoErase | WResizeNoErase )
+		: QWidget ( parent, name, WRepaintNoErase | WResizeNoErase )
 {
-  setBackgroundMode ( NoBackground );
+	setBackgroundMode ( NoBackground );
 
-  m_image             = 0;
-  m_buff              = 0;
-  m_bytes_per_line_fb = qt_screen-> linestep ( );
-  m_bytes_per_pixel   = ( qt_screen->depth() + 7 ) / 8;
-  m_rotation          = 0;
+	m_logo = 0;
+	m_buff = 0;
+	m_bytes_per_line_fb = qt_screen-> linestep ( );
+	m_bytes_per_pixel = ( qt_screen-> depth ( ) + 7 ) / 8;
+	m_rotation = 0;
 }
 
 
 XineVideoWidget::~XineVideoWidget ( )
 {
-  delete m_image;
+	delete m_logo;
 }
 
 void XineVideoWidget::clear ( )
 {
-  m_buff = 0;
-  repaint ( false );
+	m_buff = 0;
+	repaint ( false );
 }
 
 void XineVideoWidget::paintEvent ( QPaintEvent * )
 {
-  //qWarning( "painting <<<" );
-  if ( m_buff == 0 ) {
-    QPainter p ( this );
-    p. fillRect ( rect ( ), black );
-    if ( m_image )
-      p. drawImage ( 0, 0, *m_image );
-    //qWarning ( "logo\n" );
-  }
-  else {
-//    qWarning ( "paintevent\n" );
-
-    QArray <QRect> qt_bug_workaround_clip_rects;
-
-    {
-      QDirectPainter dp ( this );
-
-      int rot = dp. transformOrientation ( ) + m_rotation;
-
-      uchar *fb = dp. frameBuffer ( );
-      uchar *frame = m_buff;  // rot == 0 ? m_buff : m_buff + ( m_thisframe. height ( ) - 1 ) * m_bytes_per_line_frame;
-
-      QRect framerect = qt_screen-> mapToDevice ( QRect ( mapToGlobal ( m_thisframe. topLeft ( )), m_thisframe. size ( )), QSize ( qt_screen-> width ( ), qt_screen-> height ( )));
-
-      qt_bug_workaround_clip_rects. resize ( dp. numRects ( ));
-
-      for ( int i = dp. numRects ( ) - 1; i >= 0; i-- ) {
-          const QRect &clip = dp. rect ( i );
-
-          qt_bug_workaround_clip_rects [i] = qt_screen-> mapFromDevice ( clip, QSize ( qt_screen-> width ( ), qt_screen-> height ( )));
-
-          uchar *dst = fb + ( clip. x ( ) * m_bytes_per_pixel ) + ( clip. y ( ) * m_bytes_per_line_fb );
-          uchar *src = frame;
-
-          switch ( rot ) {
-          case 0: src += ( (( clip. x ( ) - framerect. x ( )) * m_bytes_per_pixel ) + (( clip. y ( ) - framerect. y ( )) * m_bytes_per_line_frame ) ); break;
-          case 1: src += ( (( clip. y ( ) - framerect. y ( )) * m_bytes_per_pixel ) + (( clip. x ( ) - framerect. x ( )) * m_bytes_per_line_frame ) + (( framerect. height ( ) - 1 ) * m_bytes_per_pixel ) ); break;
-          case 2: src += ( (( clip. x ( ) - framerect. x ( )) * m_bytes_per_pixel ) + (( clip. y ( ) - framerect. y ( )) * m_bytes_per_line_frame ) + (( framerect. height ( ) - 1 ) * m_bytes_per_line_frame ) ); break;
-          case 3: src += ( (( clip. y ( ) - framerect. y ( )) * m_bytes_per_pixel ) + (( clip. x ( ) - framerect. x ( )) * m_bytes_per_line_frame ) ); break;
-          default: break;
-          }
-
-          uint leftfill = 0;
-          uint framefill = 0;
-          uint rightfill = 0;
-          uint clipwidth = clip. width ( ) * m_bytes_per_pixel;
-
-          if ( clip. left ( ) < framerect. left ( ))
-              leftfill = (( framerect. left ( ) - clip. left ( )) * m_bytes_per_pixel ) <? clipwidth;
-          if ( clip. right ( ) > framerect. right ( ))
-              rightfill = (( clip. right ( ) - framerect. right ( )) * m_bytes_per_pixel ) <? clipwidth;
-
-          framefill = clipwidth - ( leftfill + rightfill );
-
-          for ( int y = clip. top ( ); y <= clip. bottom ( ); y++ ) {
-              if (( y < framerect. top ( )) || ( y > framerect. bottom ( ))) {
-                  memset ( dst, 0, clipwidth );
-              }
-          else {
-              if ( leftfill )
-                  memset ( dst, 0, leftfill );
-
-              if ( framefill ) {
-                  switch ( rot ) {
-                  case 0: memcpy ( dst + leftfill, src, framefill );                                  break;
-                  case 1: memcpy_step ( dst + leftfill, src, framefill, m_bytes_per_line_frame );     break;
-                  case 2: memcpy_rev ( dst + leftfill, src, framefill );                              break;
-                  case 3: memcpy_step_rev ( dst + leftfill, src, framefill, m_bytes_per_line_frame ); break;
-                  default: break;
-                  }
-              }
-            if ( rightfill )
-                memset ( dst + leftfill + framefill, 0, rightfill );
-          }
-
-              dst += m_bytes_per_line_fb;
-
-              switch ( rot ) {
-              case 0: src += m_bytes_per_line_frame; break;
-              case 1: src -= m_bytes_per_pixel;      break;
-              case 2: src -= m_bytes_per_line_frame; break;
-            case 3: src += m_bytes_per_pixel;      break;
-              default: break;
-              }
-          }
-      }
-    }
-    //qWarning ( " ||| painting |||" );
-    {
-        // QVFB hack by MArtin Jones
-        QPainter p ( this );
-
-        for ( int i = qt_bug_workaround_clip_rects. size ( ) - 1; i >= 0; i-- ) {
-            p. fillRect ( QRect ( mapFromGlobal ( qt_bug_workaround_clip_rects [i]. topLeft ( )), qt_bug_workaround_clip_rects [i]. size ( )), QBrush ( NoBrush ) );
-        }
-    }
-  }
-  //qWarning( "painting >>>" );
-}
-
-
-void XineVideoWidget::setImage ( QImage* image )
-{
-  delete m_image;
-  m_image = image;
-}
-
-void XineVideoWidget::setImage ( uchar* img, int w, int h, int bpl )
-{
-  bool rot90 = (( -m_rotation ) & 1 );
-
-  if ( rot90 ) {
-    int d = w;
-    w = h;
-    h = d;
-  }
-
-  m_lastframe = m_thisframe;
-  m_thisframe. setRect (( width ( ) - w ) / 2, ( height ( ) - h ) / 2, w , h );
-
-//  qDebug ( "Frame: %d,%d - %dx%d", ( width ( ) - w ) / 2, ( height ( ) - h ) / 2, w , h );
-
-  m_buff                 = img;
-  m_bytes_per_line_frame = bpl;
-
-  repaint ((( m_thisframe & m_lastframe ) != m_lastframe ) ? m_lastframe : m_thisframe, false );
-}
-
-void XineVideoWidget::resizeEvent ( QResizeEvent * )
-{
-  QSize s = size ( );
-  bool fs = ( s == qApp-> desktop ( )-> size ( ));
-
-  m_rotation = fs ? -qt_screen-> transformOrientation ( ) : 0;
-
-  if ( fs && qt_screen-> isTransformed ( )) {
-    s = qt_screen-> mapToDevice ( s );
-  }
-
-//  qDebug ( "\n\nResize: %dx%d, Rot: %d", s.width(),s.height(),m_rotation );
-
-  emit videoResized ( s );
-}
-
-
-void XineVideoWidget::mousePressEvent ( QMouseEvent * /*me*/ )
-{
-  QWidget *p = parentWidget ( );
+	if ( m_buff == 0 ) {
+		QPainter p ( this );
+		p. fillRect ( rect ( ), black );
+		if ( m_logo )
+			p. drawImage ( 0, 0, *m_logo );
+	}
+	else {
+		// Qt needs to be notified which areas were really updated .. strange
+		QArray <QRect> qt_bug_workaround_clip_rects;
+
+		{
+			QDirectPainter dp ( this );
+
+			int rot = dp. transformOrientation ( ) + m_rotation; // device rotation + custom rotation
+
+			uchar *fb = dp. frameBuffer ( );
+			uchar *frame = m_buff;
+
+			// where is the video frame in fb coordinates
+			QRect framerect = qt_screen-> mapToDevice ( QRect ( mapToGlobal ( m_thisframe. topLeft ( )), m_thisframe. size ( )), QSize ( qt_screen-> width ( ), qt_screen-> height ( )));
+
+			qt_bug_workaround_clip_rects. resize ( dp. numRects ( ));
+
+			for ( int i = dp. numRects ( ) - 1; i >= 0; i-- ) {
+				const QRect &clip = dp. rect ( i );
+
+				qt_bug_workaround_clip_rects [ i ] = qt_screen-> mapFromDevice ( clip, QSize ( qt_screen-> width ( ), qt_screen-> height ( )));
+
+				uchar *dst = fb + ( clip. x ( ) * m_bytes_per_pixel ) + ( clip. y ( ) * m_bytes_per_line_fb ); 	// clip x/y in the fb
+				uchar *src = frame;
+
+				// Adjust the start the source data based on the rotation (xine frame)
+				switch ( rot ) {
+					case  0: src += ((( clip. x ( ) - framerect. x ( )) * m_bytes_per_pixel ) + (( clip. y ( ) - framerect. y ( )) * m_bytes_per_line_frame )); break;
+					case  1: src += ((( clip. y ( ) - framerect. y ( )) * m_bytes_per_pixel ) + (( clip. x ( ) - framerect. x ( )) * m_bytes_per_line_frame ) + (( framerect. height ( ) - 1 ) * m_bytes_per_pixel )); break;
+					case  2: src += ((( clip. x ( ) - framerect. x ( )) * m_bytes_per_pixel ) + (( clip. y ( ) - framerect. y ( )) * m_bytes_per_line_frame ) + (( framerect. height ( ) - 1 ) * m_bytes_per_line_frame )); break;
+					case  3: src += ((( clip. y ( ) - framerect. y ( )) * m_bytes_per_pixel ) + (( clip. x ( ) - framerect. x ( )) * m_bytes_per_line_frame )); break;
+					default: break;
+				}
+
+				// all of the following widths/heights are fb relative (0deg rotation)
+
+				uint leftfill = 0;   // black border on the "left" side of the video frame
+				uint framefill = 0;  // "width" of the video frame
+				uint rightfill = 0;  // black border on the "right" side of the video frame
+				uint clipwidth = clip. width ( ) * m_bytes_per_pixel;  // "width" of the current clip rect
+
+				if ( clip. left ( ) < framerect. left ( ))
+					leftfill = (( framerect. left ( ) - clip. left ( )) * m_bytes_per_pixel ) < ? clipwidth;
+				if ( clip. right ( ) > framerect. right ( ))
+					rightfill = (( clip. right ( ) - framerect. right ( )) * m_bytes_per_pixel ) < ? clipwidth;
+
+				framefill = clipwidth - ( leftfill + rightfill );
+
+				for ( int y = clip. top ( ); y <= clip. bottom ( ); y++ ) {
+					if (( y < framerect. top ( )) || ( y > framerect. bottom ( ))) {
+						// "above" or "below" the video -> black
+						memset ( dst, 0, clipwidth );
+					}
+					else {
+						if ( leftfill )
+							memset ( dst, 0, leftfill ); // "left" border -> black
+
+						if ( framefill ) { // blit in the video frame
+							// see above for an explanation of the different memcpys
+
+							switch ( rot ) {
+								case  0: memcpy ( dst + leftfill, src, framefill ); break;
+								case  1: memcpy_step ( dst + leftfill, src, framefill, m_bytes_per_line_frame ); break;
+								case  2: memcpy_rev ( dst + leftfill, src, framefill ); break;
+								case  3: memcpy_step_rev ( dst + leftfill, src, framefill, m_bytes_per_line_frame ); break;
+								default: break;
+							}
+							if ( rightfill )
+								memset ( dst + leftfill + framefill, 0, rightfill ); // "right" border -> black
+						}
+
+						dst += m_bytes_per_line_fb; // advance one line in the framebuffer
+
+						// advance one "line" in the xine frame data
+						switch ( rot ) {
+							case  0: src += m_bytes_per_line_frame;	break;
+							case  1: src -= m_bytes_per_pixel;      break;
+							case  2: src -= m_bytes_per_line_frame; break;
+							case  3: src += m_bytes_per_pixel;      break;
+							default: break;
+						}
+					}
+				}
+
+				{
+					// QVFB hack by Martin Jones
+					// We need to "touch" all affected clip rects with a normal QPainter in addition to the QDirectPainter
+
+					QPainter p ( this );
+
+					for ( int i = qt_bug_workaround_clip_rects. size ( ) - 1; i >= 0; i-- ) {
+						p. fillRect ( QRect ( mapFromGlobal ( qt_bug_workaround_clip_rects [ i ]. topLeft ( )), qt_bug_workaround_clip_rects [ i ]. size ( )), QBrush ( NoBrush ));
+					}
+				}
+			}
+		}
+
+		QImage *XineVideoWidget::logo ( ) const {
+			return m_logo;
+		}
 
-  if ( p ) {
-      // QMouseEvent pme ( QEvent::MouseButtonPress, mapToParent ( me-> pos ( )), me-> globalPos ( ), me-> button ( ), me-> state ( ));
+		void XineVideoWidget::setLogo ( QImage * image ) {
+			delete m_logo;
+			m_logo = image;
+		}
 
-      // QApplication::sendEvent ( p, &pme );
-      //  emit clicked();
-  }
-}
-
-void XineVideoWidget::mouseReleaseEvent ( QMouseEvent * /*me*/ )
-{
-  QWidget *p = parentWidget ( );
+		void XineVideoWidget::setVideoFrame ( uchar * img, int w, int h, int bpl ) {
+			bool rot90 = (( -m_rotation ) & 1 );
 
-  if ( p ) {
-      //  QMouseEvent pme ( QEvent::MouseButtonRelease, mapToParent ( me-> pos ( )), me-> globalPos ( ), me-> button ( ), me-> state ( ));
+			if ( rot90 ) { // if the rotation is 90 or 270 we have to swap width / height
+				int d = w;
+				w = h;
+				h = d;
+			}
 
-      // QApplication::sendEvent ( p, &pme );
-     emit clicked();
-  }
-}
+			m_lastframe = m_thisframe;
+			m_thisframe. setRect (( width ( ) - w ) / 2, ( height ( ) - h ) / 2, w , h );
+
+			m_buff = img;
+			m_bytes_per_line_frame = bpl;
+
+			// only repaint the area that *really* needs to be repainted
+
+			repaint ((
+		}
+
+		void XineVideoWidget::resizeEvent ( QResizeEvent * ) {
+			QSize s = size ( );
+			bool fs = ( s == qApp-> desktop ( ) -> size ( ));
+
+			// if we are in fullscreen mode, do not rotate the video
+			// (!! the paint routine uses m_rotation + qt_screen-> transformOrientation() !!)
+
+			m_rotation = fs ? -qt_screen-> transformOrientation ( ) : 0;
+
+			if ( fs && qt_screen-> isTransformed ( ))
+				s = qt_screen-> mapToDevice ( s );
+
+			emit videoResized ( s );
+		}
+
+
+		void XineVideoWidget::mouseReleaseEvent ( QMouseEvent * ) {
+			emit clicked ( );
+		}