libmpcodecs/vf.h

   1 /*
   2  * This file is part of MPlayer.
   3  *
   4  * MPlayer is free software; you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation; either version 2 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * MPlayer is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License along
  15  * with MPlayer; if not, write to the Free Software Foundation, Inc.,
  16  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  17  */
  18
  19 #ifndef MPLAYER_VF_H
  20 #define MPLAYER_VF_H
  21
  22 #include "mp_image.h"
  23 #include "mpcommon.h"
  24
  25 struct MPOpts;
  26 struct vf_instance;
  27 struct vf_priv_s;
  28
  29 typedef struct vf_info {
  30     const char *info;
  31     const char *name;
  32     const char *author;
  33     const char *comment;
  34     int (*vf_open)(struct vf_instance *vf,char* args);
  35     // Ptr to a struct dscribing the options
  36     const void* opts;
  37 } vf_info_t;
  38
  39 #define NUM_NUMBERED_MPI 50
  40
  41 typedef struct vf_image_context_s {
  42     mp_image_t* static_images[2];
  43     mp_image_t* temp_images[1];
  44     mp_image_t* export_images[1];
  45     mp_image_t* numbered_images[NUM_NUMBERED_MPI];
  46     int static_idx;
  47 } vf_image_context_t;
  48
  49 typedef struct vf_format_context_t {
  50     int have_configured;
  51     int orig_width, orig_height, orig_fmt;
  52 } vf_format_context_t;
  53
  54 typedef struct vf_instance {
  55     const vf_info_t* info;
  56     // funcs:
  57     int (*config)(struct vf_instance *vf,
  58         int width, int height, int d_width, int d_height,
  59         unsigned int flags, unsigned int outfmt);
  60     int (*control)(struct vf_instance *vf,
  61         int request, void* data);
  62     int (*query_format)(struct vf_instance *vf,
  63         unsigned int fmt);
  64     void (*get_image)(struct vf_instance *vf,
  65         mp_image_t *mpi);
  66     int (*put_image)(struct vf_instance *vf,
  67         mp_image_t *mpi, double pts);
  68     void (*start_slice)(struct vf_instance *vf,
  69         mp_image_t *mpi);
  70     void (*draw_slice)(struct vf_instance *vf,
  71         unsigned char** src, int* stride, int w,int h, int x, int y);
  72     void (*uninit)(struct vf_instance *vf);
  73
  74     int (*continue_buffered_image)(struct vf_instance *vf);
  75     // caps:
  76     unsigned int default_caps; // used by default query_format()
  77     unsigned int default_reqs; // used by default config()
  78     // data:
  79     int w, h;
  80     vf_image_context_t imgctx;
  81     vf_format_context_t fmt;
  82     struct vf_instance *next;
  83     mp_image_t *dmpi;
  84     struct vf_priv_s* priv;
  85     struct MPOpts *opts;
  86 } vf_instance_t;
  87
  88 // control codes:
  89 #include "mpc_info.h"
  90
  91 typedef struct vf_seteq_s
  92 {
  93     const char *item;
  94     int value;
  95 } vf_equalizer_t;
  96
  97 #define VFCTRL_QUERY_MAX_PP_LEVEL 4 /* test for postprocessing support (max level) */
  98 #define VFCTRL_SET_PP_LEVEL 5 /* set postprocessing level */
  99 #define VFCTRL_SET_EQUALIZER 6 /* set color options (brightness,contrast etc) */
 100 #define VFCTRL_GET_EQUALIZER 8 /* gset color options (brightness,contrast etc) */
 101 #define VFCTRL_DRAW_OSD 7
 102 #define VFCTRL_CHANGE_RECTANGLE 9 /* Change the rectangle boundaries */
 103 #define VFCTRL_DUPLICATE_FRAME 11 /* For encoding - encode zero-change frame */
 104 #define VFCTRL_SKIP_NEXT_FRAME 12 /* For encoding - drop the next frame that passes thru */
 105 #define VFCTRL_FLUSH_FRAMES    13 /* For encoding - flush delayed frames */
 106 #define VFCTRL_SCREENSHOT      14 /* Make a screenshot */
 107 #define VFCTRL_INIT_EOSD       15 /* Select EOSD renderer */
 108 #define VFCTRL_DRAW_EOSD       16 /* Render EOSD */
 109 #define VFCTRL_SET_DEINTERLACE 18 /* Set deinterlacing status */
 110 #define VFCTRL_GET_DEINTERLACE 19 /* Get deinterlacing status */
 111 /* Hack to make the OSD state object available to vf_expand and vf_ass which
 112  * access OSD/subtitle state outside of normal OSD draw time. */
 113 #define VFCTRL_SET_OSD_OBJ 20
 114 #define VFCTRL_REDRAW_OSD  21 /* Change user-visible OSD immediately */
 115 #define VFCTRL_SET_YUV_COLORSPACE 22
 116 #define VFCTRL_GET_YUV_COLORSPACE 23
 117
 118 #include "vfcap.h"
 119
 120 // functions:
 121 void vf_mpi_clear(mp_image_t* mpi,int x0,int y0,int w,int h);
 122 mp_image_t* vf_get_image(vf_instance_t* vf, unsigned int outfmt, int mp_imgtype, int mp_imgflag, int w, int h);
 123
 124 vf_instance_t* vf_open_plugin(struct MPOpts *opts, const vf_info_t* const* filter_list, vf_instance_t* next, const char *name, char **args);
 125 struct vf_instance *vf_open_plugin_noerr(struct MPOpts *opts,
 126                                          const vf_info_t * const *filter_list,
 127                                          vf_instance_t *next, const char *name,
 128                                          char **args, int *retcode);
 129 vf_instance_t* vf_open_filter(struct MPOpts *opts, vf_instance_t* next, const char *name, char **args);
 130 vf_instance_t* vf_add_before_vo(vf_instance_t **vf, char *name, char **args);
 131 vf_instance_t* vf_open_encoder(struct MPOpts *opts, vf_instance_t* next, const char *name, char *args);
 132
 133 unsigned int vf_match_csp(vf_instance_t** vfp,const unsigned int* list,unsigned int preferred);
 134 void vf_clone_mpi_attributes(mp_image_t* dst, mp_image_t* src);
 135 void vf_queue_frame(vf_instance_t *vf, int (*)(vf_instance_t *));
 136 int vf_output_queued_frame(vf_instance_t *vf);
 137
 138 // default wrappers:
 139 int vf_next_config(struct vf_instance *vf,
 140         int width, int height, int d_width, int d_height,
 141         unsigned int flags, unsigned int outfmt);
 142 int vf_next_control(struct vf_instance *vf, int request, void* data);
 143 int vf_next_query_format(struct vf_instance *vf, unsigned int fmt);
 144 int vf_next_put_image(struct vf_instance *vf,mp_image_t *mpi, double pts);
 145 void vf_next_draw_slice (struct vf_instance *vf, unsigned char** src, int* stride, int w,int h, int x, int y);
 146
 147 struct m_obj_settings;
 148 vf_instance_t* append_filters(vf_instance_t* last, struct m_obj_settings *vf_settings);
 149
 150 void vf_uninit_filter(vf_instance_t* vf);
 151 void vf_uninit_filter_chain(vf_instance_t* vf);
 152
 153 int vf_config_wrapper(struct vf_instance *vf,
 154                       int width, int height, int d_width, int d_height,
 155                       unsigned int flags, unsigned int outfmt);
 156
 157 static inline int norm_qscale(int qscale, int type)
 158 {
 159     switch (type) {
 160     case 0: // MPEG-1
 161         return qscale;
 162     case 1: // MPEG-2
 163         return qscale >> 1;
 164     case 2: // H264
 165         return qscale >> 2;
 166     case 3: // VP56
 167         return (63 - qscale + 2) >> 2;
 168     }
 169     return qscale;
 170 }
 171
 172 #endif /* MPLAYER_VF_H */