]> git.sesse.net Git - vlc/blobdiff - include/video_output.h
* Initialize SDL before opening the SDL audio output.
[vlc] / include / video_output.h
index 2cf36491a4f6bc710256fb07dd65ea4f4fe1e6e2..186d4f04430565304abf4cbe00561abc4d124dff 100644 (file)
@@ -5,6 +5,7 @@
  * thread, and destroy a previously oppenned video output thread.
  *****************************************************************************
  * Copyright (C) 1999, 2000 VideoLAN
+ * $Id: video_output.h,v 1.67 2001/12/19 03:50:22 sam Exp $
  *
  * Authors: Vincent Seguin <seguin@via.ecp.fr>
  *
  *****************************************************************************/
 
 /*****************************************************************************
- * vout_yuv_convert_t: YUV conversion function
+ * vout_bank_t, p_vout_bank (global variable)
  *****************************************************************************
- * This is the prototype common to all conversion functions. The type of p_pic
- * will change depending on the processed screen depth.
- * Parameters:
- *      p_vout                          video output thread
- *      p_pic                           picture address
- *      p_y, p_u, p_v                   Y,U,V samples addresses
- *      i_width, i_height               Y samples extension
- *      i_pic_width, i_pic_height       picture extension
- *      i_pic_line_width                picture total line width
- *      i_matrix_coefficients           matrix coefficients
- * Picture width and source dimensions must be multiples of 16.
+ * This global variable is accessed by any function using the video output.
  *****************************************************************************/
-typedef void (vout_yuv_convert_t)( p_vout_thread_t p_vout, void *p_pic,
-                                   yuv_data_t *p_y, yuv_data_t *p_u, yuv_data_t *p_v,
-                                   int i_width, int i_height,
-                                   int i_pic_width, int i_pic_height, int i_pic_line_width,
-                                   int i_matrix_coefficients );
+typedef struct vout_bank_s
+{
+    /* Array to all the video outputs */
+    struct vout_thread_s *pp_vout[ VOUT_MAX_THREADS ];
+
+    int                   i_count;
+    vlc_mutex_t           lock;                               /* Global lock */
+
+} vout_bank_t;
+
+extern vout_bank_t *p_vout_bank;
 
 /*****************************************************************************
- * vout_yuv_t: pre-calculated YUV conversion tables
+ * vout_chroma_t: Chroma conversion function
  *****************************************************************************
- * These tables are used by conversion and scaling functions.
+ * This is the prototype common to all conversion functions.
+ * Parameters:
+ *      p_source                        source picture
+ *      p_dest                          destination picture
+ * Picture width and source dimensions must be multiples of 16.
  *****************************************************************************/
-typedef int  (yuv_init_t)           ( p_vout_thread_t p_vout );
-typedef int  (yuv_reset_t)          ( p_vout_thread_t p_vout );
-typedef void (yuv_end_t)            ( p_vout_thread_t p_vout );
+typedef void (vout_chroma_convert_t)( picture_t *p_source, picture_t *p_dest );
 
-typedef struct vout_yuv_s
+typedef struct vout_chroma_s
 {
     /* conversion functions */
-    vout_yuv_convert_t *        p_Convert420;         /* YUV 4:2:0 converter */
-    vout_yuv_convert_t *        p_Convert422;         /* YUV 4:2:2 converter */
-    vout_yuv_convert_t *        p_Convert444;         /* YUV 4:4:4 converter */
-
-    /* Pre-calculated conversion tables */
-    void *              p_base;            /* base for all conversion tables */
-    union
-    {
-        u8 *            p_gray8;                        /* gray 8 bits table */
-        u16 *           p_gray16;                      /* gray 16 bits table */
-        u32 *           p_gray32;                      /* gray 32 bits table */
-        u8 *            p_rgb8;                          /* RGB 8 bits table */
-        u16 *           p_rgb16;                        /* RGB 16 bits table */
-        u32 *           p_rgb32;                        /* RGB 32 bits table */
-    } yuv;
-
-    /* Temporary conversion buffer and offset array */
-    void *              p_buffer;                       /* conversion buffer */
-    int *               p_offset;                            /* offset array */
+    vout_chroma_convert_t *pf_convert;
+
+    /* Private module-dependant data */
+    p_chroma_sys_t      p_sys;                               /* private data */
 
     /* Plugin used and shortcuts to access its capabilities */
     struct module_s *   p_module;
-    yuv_init_t *        pf_init;                    /* initialize YUV tables */
-    yuv_reset_t *       pf_reset;                        /* reset YUV tables */
-    yuv_end_t *         pf_end;                           /* free YUV tables */
+    int  ( * pf_init )  ( struct vout_thread_s * );
+    int  ( * pf_reset ) ( struct vout_thread_s * );
+    void ( * pf_end )   ( struct vout_thread_s * );
 
-} vout_yuv_t;
+} vout_chroma_t;
 
 /*****************************************************************************
- * vout_buffer_t: rendering buffer
- *****************************************************************************
- * This structure stores information about a buffer. Buffers are not completely
- * cleared between displays, and modified areas need to be stored.
+ * vout_fifo_t
  *****************************************************************************/
-typedef struct vout_buffer_s
+typedef struct vout_fifo_s
 {
-    /* Picture area */
-    int         i_pic_x, i_pic_y;                       /* picture position  */
-    int         i_pic_width, i_pic_height;                   /* picture size */
+    /* See the fifo types below */
+    int                 i_type;
+    boolean_t           b_die;
+    int                 i_fifo;      /* Just to keep track of the fifo index */
 
-    /* Other areas - only vertical extensions of areas are stored */
-    int         i_areas;                                  /* number of areas */
-    int         pi_area_begin[VOUT_MAX_AREAS];          /* beginning of area */
-    int         pi_area_end[VOUT_MAX_AREAS];                  /* end of area */
+    vlc_mutex_t         data_lock;
+    vlc_cond_t          data_wait;
 
-    /* Picture data */
-    byte_t *    p_data;                                    /* memory address */
-} vout_buffer_t;
+} vout_fifo_t;
+
+#define VOUT_EMPTY_FIFO         0
+#define VOUT_YUV_FIFO           1
+#define VOUT_SPU_FIFO           2
 
 /*****************************************************************************
  * vout_thread_t: video output thread descriptor
@@ -127,31 +109,13 @@ typedef struct vout_thread_s
                                                                    
     /* Current display properties */
     u16                 i_changes;             /* changes made to the thread */
-    int                 i_width;              /* current output method width */
-    int                 i_height;            /* current output method height */
-    int                 i_bytes_per_line;  /* bytes per line (incl. virtual) */
-    int                 i_screen_depth;  /* significant bpp: 8, 15, 16 or 24 */
-    int                 i_bytes_per_pixel;/* real screen depth: 1, 2, 3 or 4 */
     float               f_gamma;                                    /* gamma */
-    boolean_t           b_need_render;  /* does the output method need a YUV 
-                                         * conversion ?                      */
-
-    /* Color masks and shifts in RGB mode - masks are set by system
-     * initialization, shifts are calculated. A pixel color value can be
-     * obtained using the formula ((value >> rshift) << lshift) */
-    u32                 i_red_mask;                              /* red mask */
-    u32                 i_green_mask;                          /* green mask */
-    u32                 i_blue_mask;                            /* blue mask */
-    int                 i_red_lshift, i_red_rshift;            /* red shifts */
-    int                 i_green_lshift, i_green_rshift;      /* green shifts */
-    int                 i_blue_lshift, i_blue_rshift;         /* blue shifts */
-
-    /* Useful pre-calculated pixel values - these are not supposed to be
-     * accurate values, but rather values looking nice, given their usage. */
-    u32                 i_white_pixel;                              /* white */
-    u32                 i_black_pixel;                              /* black */
-    u32                 i_gray_pixel;                                /* gray */
-    u32                 i_blue_pixel;                                /* blue */
+    boolean_t           b_grayscale;           /* color or grayscale display */
+    boolean_t           b_info;              /* print additional information */
+    boolean_t           b_interface;                     /* render interface */
+    boolean_t           b_scale;                    /* allow picture scaling */
+    boolean_t           b_fullscreen;           /* toogle fullscreen display */
+    mtime_t             render_time;             /* last picture render time */
 
     /* Plugin used and shortcuts to access its capabilities */
     struct module_s *   p_module;
@@ -160,46 +124,44 @@ typedef struct vout_thread_s
     void             ( *pf_end )        ( struct vout_thread_s * );
     void             ( *pf_destroy )    ( struct vout_thread_s * );
     int              ( *pf_manage )     ( struct vout_thread_s * );
-    void             ( *pf_display )    ( struct vout_thread_s * );
-    void             ( *pf_setpalette ) ( struct vout_thread_s *, u16 *red,
-                                          u16 *green, u16 *blue, u16 *transp );
-
-    /* Pictures and rendering properties */
-    boolean_t           b_grayscale;           /* color or grayscale display */
-    boolean_t           b_info;              /* print additional information */
-    boolean_t           b_interface;                     /* render interface */
-    boolean_t           b_scale;                    /* allow picture scaling */
-    mtime_t             render_time;             /* last picture render time */
-
-
-    /* Idle screens management */
-    mtime_t             last_display_date;     /* last non idle display date */
-    mtime_t             last_idle_date;            /* last idle display date */
-    mtime_t             init_display_date;
+    void             ( *pf_display )    ( struct vout_thread_s *,
+                                          struct picture_s * );
+    void             ( *pf_setpalette ) ( struct vout_thread_s *,
+                                          u16 *, u16 *, u16 * );
 
     /* Statistics - these numbers are not supposed to be accurate, but are a
      * good indication of the thread status */
     count_t             c_fps_samples;                     /* picture counts */
     mtime_t             p_fps_sample[VOUT_FPS_SAMPLES]; /* FPS samples dates */
 
-    /* Rendering buffers */
-    int                 i_buffer_index;                      /* buffer index */
-    vout_buffer_t       p_buffer[2];                   /* buffers properties */
-
     /* Video heap and translation tables */
+    int                 i_heap_size;                            /* heap size */
+    picture_heap_t      render;                         /* rendered pictures */
+    picture_heap_t      output;                            /* direct buffers */
+    boolean_t           b_direct;              /* rendered are like direct ? */
+    vout_chroma_t       chroma;                        /* translation tables */
+
+    /* Picture and subpicture heaps */
     picture_t           p_picture[VOUT_MAX_PICTURES];            /* pictures */
     subpicture_t        p_subpicture[VOUT_MAX_PICTURES];      /* subpictures */
-    int                 i_pictures;                     /* current heap size */
-    vout_yuv_t          yuv;                           /* translation tables */
-    picture_t *         p_rendered_pic;  /* picture currently being rendered */
 
     /* Bitmap fonts */
     p_vout_font_t       p_default_font;                      /* default font */
     p_vout_font_t       p_large_font;                          /* large font */
 
+    /* Statistics */
     count_t             c_loops;
+    count_t             c_pictures, c_late_pictures;
+    mtime_t             display_jitter;    /* average deviation from the PTS */
+    count_t             c_jitter_samples;  /* number of samples used for the *
+                                            * calculation of the jitter      */
 } vout_thread_t;
 
+#define I_OUTPUTPICTURES p_vout->output.i_pictures
+#define PP_OUTPUTPICTURE p_vout->output.pp_picture
+#define I_RENDERPICTURES p_vout->render.i_pictures
+#define PP_RENDERPICTURE p_vout->render.pp_picture
+
 /* Flags for changes - these flags are set in the i_changes field when another
  * thread changed a variable */
 #define VOUT_INFO_CHANGE        0x0001                     /* b_info changed */
@@ -211,38 +173,43 @@ typedef struct vout_thread_s
 #define VOUT_FULLSCREEN_CHANGE  0x0040               /* b_fullscreen changed */
 #define VOUT_SIZE_CHANGE        0x0200                       /* size changed */
 #define VOUT_DEPTH_CHANGE       0x0400                      /* depth changed */
-#define VOUT_YUV_CHANGE         0x0800                  /* change yuv tables */
+#define VOUT_CHROMA_CHANGE      0x0800               /* change chroma tables */
 
 /* Disabled for thread deadlocks issues --Meuuh */
 //#define VOUT_NODISPLAY_CHANGE   0xff00    /* changes which forbidden display */
 
-/*****************************************************************************
- * Macros
- *****************************************************************************/
-
-/* RGB2PIXEL: assemble RGB components to a pixel value, returns a u32 */
-#define RGB2PIXEL( p_vout, i_red, i_green, i_blue )                           \
-    (((((u32)i_red)   >> p_vout->i_red_rshift)   << p_vout->i_red_lshift)   | \
-     ((((u32)i_green) >> p_vout->i_green_rshift) << p_vout->i_green_lshift) | \
-     ((((u32)i_blue)  >> p_vout->i_blue_rshift)  << p_vout->i_blue_lshift))
-
+#define MAX_JITTER_SAMPLES      20
 
 /*****************************************************************************
  * Prototypes
  *****************************************************************************/
-vout_thread_t * vout_CreateThread   ( int *pi_status );
-void            vout_DestroyThread  ( vout_thread_t *p_vout, int *pi_status );
-picture_t *     vout_CreatePicture  ( vout_thread_t *p_vout, int i_type,
-                                      int i_width, int i_height );
-void            vout_DestroyPicture ( vout_thread_t *p_vout, picture_t *p_pic );
-void            vout_DisplayPicture ( vout_thread_t *p_vout, picture_t *p_pic );
-void            vout_DatePicture    ( vout_thread_t *p_vout, picture_t *p_pic, mtime_t date );
-void            vout_LinkPicture    ( vout_thread_t *p_vout, picture_t *p_pic );
-void            vout_UnlinkPicture  ( vout_thread_t *p_vout, picture_t *p_pic );
-
-subpicture_t *  vout_CreateSubPicture   ( vout_thread_t *p_vout, int i_type, int i_size );
-void            vout_DestroySubPicture  ( vout_thread_t *p_vout, subpicture_t *p_subpic );
-void            vout_DisplaySubPicture  ( vout_thread_t *p_vout, subpicture_t *p_subpic );
-
-void            vout_SetBuffers         ( vout_thread_t *p_vout, void *p_buf1, void *p_buf2 );
+void            vout_InitBank       ( void );
+void            vout_EndBank        ( void );
+
+vout_thread_t * vout_CreateThread   ( int *pi_status, int, int, int, int );
+void            vout_DestroyThread  ( vout_thread_t *, int *pi_status );
+
+vout_fifo_t *   vout_CreateFifo     ( void );
+void            vout_DestroyFifo    ( vout_fifo_t * );
+void            vout_FreeFifo       ( vout_fifo_t * );
+
+picture_t *     vout_CreatePicture  ( vout_thread_t *,
+                                      boolean_t, boolean_t, boolean_t );
+void            vout_AllocatePicture( picture_t *, int, int, int );
+void            vout_DestroyPicture ( vout_thread_t *, picture_t * );
+void            vout_DisplayPicture ( vout_thread_t *, picture_t * );
+void            vout_DatePicture    ( vout_thread_t *, picture_t *, mtime_t );
+void            vout_LinkPicture    ( vout_thread_t *, picture_t * );
+void            vout_UnlinkPicture  ( vout_thread_t *, picture_t * );
+picture_t *     vout_RenderPicture  ( vout_thread_t *, picture_t *,
+                                                       subpicture_t * );
+void            vout_PlacePicture   ( vout_thread_t *, int, int,
+                                      int *, int *, int *, int * );
+
+subpicture_t *  vout_CreateSubPicture   ( vout_thread_t *, int, int );
+void            vout_DestroySubPicture  ( vout_thread_t *, subpicture_t * );
+void            vout_DisplaySubPicture  ( vout_thread_t *, subpicture_t * );
+subpicture_t *  vout_SortSubPictures    ( vout_thread_t *, mtime_t );
+void            vout_RenderSubPictures  ( vout_thread_t *, picture_t *,
+                                                           subpicture_t * );