git.sesse.net Git - ffmpeg/blob - libavfilter/buffersrc.h

   1 /*
   2  *
   3  * This file is part of Libav.
   4  *
   5  * Libav is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2.1 of the License, or (at your option) any later version.
   9  *
  10  * Libav is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with Libav; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  18  */
  19
  20 #ifndef AVFILTER_BUFFERSRC_H
  21 #define AVFILTER_BUFFERSRC_H
  22
  23 /**
  24  * @file
  25  * Memory buffer source API.
  26  */
  27
  28 #include "avfilter.h"
  29
  30 enum {
  31
  32     /**
  33      * Do not check for format changes.
  34      */
  35     AV_BUFFERSRC_FLAG_NO_CHECK_FORMAT = 1,
  36
  37     /**
  38      * Do not copy buffer data.
  39      */
  40     AV_BUFFERSRC_FLAG_NO_COPY = 2,
  41
  42 };
  43
  44 /**
  45  * Add buffer data in picref to buffer_src.
  46  *
  47  * @param buffer_src  pointer to a buffer source context
  48  * @param picref      a buffer reference, or NULL to mark EOF
  49  * @param flags       a combination of AV_BUFFERSRC_FLAG_*
  50  * @return            >= 0 in case of success, a negative AVERROR code
  51  *                    in case of failure
  52  */
  53 int av_buffersrc_add_ref(AVFilterContext *buffer_src,
  54                          AVFilterBufferRef *picref, int flags);
  55
  56 /**
  57  * Get the number of failed requests.
  58  *
  59  * A failed request is when the request_frame method is called while no
  60  * frame is present in the buffer.
  61  * The number is reset when a frame is added.
  62  */
  63 unsigned av_buffersrc_get_nb_failed_requests(AVFilterContext *buffer_src);
  64
  65 /**
  66  * Add a buffer to the filtergraph s.
  67  *
  68  * @param buf buffer containing frame data to be passed down the filtergraph.
  69  * This function will take ownership of buf, the user must not free it.
  70  * A NULL buf signals EOF -- i.e. no more frames will be sent to this filter.
  71  */
  72 int av_buffersrc_buffer(AVFilterContext *s, AVFilterBufferRef *buf);
  73
  74 /**
  75  * Add a frame to the buffer source.
  76  *
  77  * @param s an instance of the buffersrc filter.
  78  * @param frame frame to be added.
  79  *
  80  * @warning frame data will be memcpy()ed, which may be a big performance
  81  *          hit. Use av_buffersrc_buffer() to avoid copying the data.
  82  */
  83 int av_buffersrc_write_frame(AVFilterContext *s, AVFrame *frame);
  84
  85 #endif /* AVFILTER_BUFFERSRC_H */