Lines Matching +full:unused +full:- +full:function
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
97 * - Set up and open the AVCodecContext as usual.
98 * - Send valid input:
99 * - For decoding, call avcodec_send_packet() to give the decoder raw
101 * - For encoding, call avcodec_send_frame() to give the encoder an AVFrame
108 * - Receive output in a loop. Periodically call one of the avcodec_receive_*()
110 * - For decoding, call avcodec_receive_frame(). On success, it will return
112 * - For encoding, call avcodec_receive_packet(). On success, it will return
126 * In theory, sending input can result in EAGAIN - this should happen only if
134 * performance or out of necessity (consider B-frames).
136 * - Instead of valid input, send NULL to the avcodec_send_packet() (decoding)
139 * - Call avcodec_receive_frame() (decoding) or avcodec_receive_packet()
142 * - Before decoding can be resumed again, the codec has to be reset with
166 * to influence it. Some timing-dependent behavior might still be deemed
169 * avoided that the current state is "unstable" and can "flip-flop" between
281 * H.263 advanced intra coding / MPEG-4 AC prediction
392 * - set by avcodec_alloc_context3
402 * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
411 * - encoding: Set by user, if not then the default based on codec_id will be used.
412 * - decoding: Set by user, will be converted to uppercase by libavcodec during init.
421 * Unlike priv_data, this is not codec-specific. It is used in general
428 * - encoding: Set by user.
429 * - decoding: Set by user.
435 * - encoding: Set by user; unused for constant quantizer encoding.
436 * - decoding: Set by user, may be overwritten by libavcodec
444 * - encoding: Set by user; unused for constant quantizer encoding.
445 * - decoding: unused
451 * This should be proportional to MPEG-1/2/4 qscale.
452 * - encoding: Set by user.
453 * - decoding: unused
458 * - encoding: Set by user.
459 * - decoding: unused
462 #define FF_COMPRESSION_DEFAULT -1
466 * - encoding: Set by user.
467 * - decoding: Set by user.
473 * - encoding: Set by user.
474 * - decoding: Set by user.
482 * MPEG-4: global headers (they can be in the bitstream or here)
487 * - encoding: Set/allocated/freed by libavcodec.
488 * - decoding: Set/allocated/freed by user.
495 * of which frame timestamps are represented. For fixed-fps content,
504 * As example of such codec time base see ISO/IEC 14496-2:2001(E)
508 * - encoding: MUST be set by user.
509 * - decoding: the use of this field for decoding is deprecated.
516 * Most notably, H.264 and MPEG-2 specify time_base as half of frame duration
519 * Set to time_base ticks per frame. Default 1, e.g., H.264/MPEG-2 set it to 2.
536 * For encoding, this field is unused (see initial_padding).
542 * - encoding: Set by libavcodec.
543 * - decoding: Set by libavcodec.
556 * - encoding: MUST be set by user.
557 * - decoding: May be set by the user before opening the decoder if known e.g.
572 * - encoding: unused
573 * - decoding: May be set by the user before opening the decoder if known
581 * - encoding: Set by user.
582 * - decoding: unused
595 * - encoding: Set by user.
596 * - decoding: Set by user if known, overridden by libavcodec while
610 * The function is also used by hardware acceleration APIs.
617 * - encoding: unused
618 * - decoding: Set by user.
621 * @param type 1->top field, 2->bottom field, 3->frame
645 * multi-threaded, but not from more than one thread simultaneously.
656 * maximum number of B-frames between non-B-frames
658 * - encoding: Set by user.
659 * - decoding: unused
664 * qscale factor between IP and B-frames
665 * If > 0 then the last P-frame quantizer will be used (q= lastp_q*factor+offset).
666 * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
667 * - encoding: Set by user.
668 * - decoding: unused
673 * qscale offset between IP and B-frames
674 * - encoding: Set by user.
675 * - decoding: unused
681 * For MPEG-2 it is 1 IPB or 0 low delay IP.
682 * - encoding: Set by libavcodec.
683 * - decoding: Set by libavcodec.
688 * qscale factor between P- and I-frames
689 * If > 0 then the last P-frame quantizer will be used (q = lastp_q * factor + offset).
690 * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
691 * - encoding: Set by user.
692 * - decoding: unused
697 * qscale offset between P and I-frames
698 * - encoding: Set by user.
699 * - decoding: unused
704 * luminance masking (0-> disabled)
705 * - encoding: Set by user.
706 * - decoding: unused
711 * temporary complexity masking (0-> disabled)
712 * - encoding: Set by user.
713 * - decoding: unused
718 * spatial complexity masking (0-> disabled)
719 * - encoding: Set by user.
720 * - decoding: unused
725 * p block masking (0-> disabled)
726 * - encoding: Set by user.
727 * - decoding: unused
732 * darkness masking (0-> disabled)
733 * - encoding: Set by user.
734 * - decoding: unused
740 * - encoding: Set by libavcodec.
741 * - decoding: Set by user (or 0).
747 * - encoding: Set/allocated by libavcodec.
748 * - decoding: Set/allocated by user (or NULL).
756 * - encoding: Set by user.
757 * - decoding: Set by libavcodec.
762 * motion estimation comparison function
763 * - encoding: Set by user.
764 * - decoding: unused
768 * subpixel motion estimation comparison function
769 * - encoding: Set by user.
770 * - decoding: unused
774 * macroblock comparison function (not supported yet)
775 * - encoding: Set by user.
776 * - decoding: unused
780 * interlaced DCT comparison function
781 * - encoding: Set by user.
782 * - decoding: unused
805 * - encoding: Set by user.
806 * - decoding: unused
812 * - encoding: Set by user.
813 * - decoding: unused
818 * motion estimation prepass comparison function
819 * - encoding: Set by user.
820 * - decoding: unused
826 * - encoding: Set by user.
827 * - decoding: unused
833 * - encoding: Set by user.
834 * - decoding: unused
842 * - encoding: Set by user.
843 * - decoding: unused
849 * - encoding: unused
850 * - decoding: Set by user.
854 #define SLICE_FLAG_ALLOW_FIELD 0x0002 ///< allow draw_horiz_band() with field slices (MPEG-2 fie…
859 * - encoding: Set by user.
860 * - decoding: unused
871 * - encoding: Set/allocated by user, freed by libavcodec. Can be NULL.
872 * - decoding: Set/allocated/freed by libavcodec.
880 * - encoding: Set/allocated by user, freed by libavcodec. Can be NULL.
881 * - decoding: Set/allocated/freed by libavcodec.
886 * precision of the intra DC coefficient - 8
887 * - encoding: Set by user.
888 * - decoding: Set by libavcodec
894 * - encoding: unused
895 * - decoding: Set by user.
901 * - encoding: unused
902 * - decoding: Set by user.
908 * - encoding: Set by user.
909 * - decoding: unused
915 * - encoding: Set by user.
916 * - decoding: unused
921 * - encoding: Set by user.
922 * - decoding: unused
928 * - encoding: Set by user.
929 * - decoding: unused
935 * - encoding: Set by user.
936 * - decoding: Set by lavc.
941 * Note: Value depends upon the compare function used for fullpel ME.
942 * - encoding: Set by user.
943 * - decoding: unused
949 * - encoding: Set by user
950 * - decoding: Set by libavcodec
956 * - encoding: Set by user
957 * - decoding: Set by libavcodec
963 * - encoding: Set by user
964 * - decoding: Set by libavcodec
970 * - encoding: Set by user
971 * - decoding: Set by libavcodec
977 * - encoding: Set by user
978 * - decoding: Set by libavcodec
986 * - encoding: Set by user
987 * - decoding: unused
992 * - encoding: set by libavcodec
993 * - decoding: Set by user.
1011 * - encoding: Set by user.
1012 * - decoding: Set by libavcodec.
1020 * - encoding: set by libavcodec in avcodec_open2(). Each submitted frame
1024 * - decoding: may be set by some decoders to indicate constant frame size
1031 * - decoding: total number of frames returned from the decoder so far.
1032 * - encoding: total number of frames passed to the encoder so far.
1047 * - encoding: Set by user.
1048 * - decoding: unused
1055 * - encoding: set by user.
1056 * - decoding: set by user, may be overwritten by libavcodec.
1064 * - encoding: unused
1065 * - decoding: Set by user.
1074 * - encoding: Set by user.
1075 * - decoding: Set by libavcodec.
1081 * - encoding: Not used.
1082 * - decoding: Set by user.
1092 * Each buffer must be reference-counted using the AVBuffer API (see description
1097 * - format
1098 * - width, height (video only)
1099 * - sample_rate, channel_layout, nb_samples (audio only)
1105 * - data[]
1106 * - linesize[]
1107 * - extended_data:
1114 * - buf[] must contain one or more pointers to AVBufferRef structures. Each of
1119 * - extended_buf and nb_extended_buf must be allocated with av_malloc() by
1164 * - encoding: unused
1165 * - decoding: Set by libavcodec, user can override.
1169 /* - encoding parameters */
1170 float qcompress; ///< amount of qscale change between easy & hard scenes (0.0-1.0)
1171 float qblur; ///< amount of qscale smoothing over time (0.0-1.0)
1175 * - encoding: Set by user.
1176 * - decoding: unused
1182 * - encoding: Set by user.
1183 * - decoding: unused
1189 * - encoding: Set by user.
1190 * - decoding: unused
1196 * - encoding: Set by user.
1197 * - decoding: unused
1203 * - encoding: Allocated/set/freed by user.
1204 * - decoding: unused
1211 * - encoding: Set by user.
1212 * - decoding: Set by user, may be overwritten by libavcodec.
1218 * - encoding: Set by user.
1219 * - decoding: unused
1225 * - encoding: Set by user.
1226 * - decoding: unused.
1232 * - encoding: Set by user.
1233 * - decoding: unused.
1239 * - encoding: Set by user.
1240 * - decoding: unused
1246 * - encoding: Set by user.
1247 * - decoding: unused
1253 * - encoding: Set by libavcodec.
1254 * - decoding: unused
1261 * - encoding: Allocated/set/freed by user.
1262 * - decoding: unused
1268 * - encoding: Set by user
1269 * - decoding: Set by user
1289 * strictly follow the standard (MPEG-4, ...).
1290 * - encoding: Set by user.
1291 * - decoding: Set by user.
1295 * spec-compliant decoders. Decoders don't differentiate between normal,
1304 #define FF_COMPLIANCE_UNOFFICIAL -1 ///< Allow unofficial extensions
1305 #define FF_COMPLIANCE_EXPERIMENTAL -2 ///< Allow nonstandardized experimental things.
1309 * - encoding: unused
1310 * - decoding: Set by user.
1319 * - encoding: Set by user.
1320 * - decoding: Set by user.
1341 * - encoding: Set by user.
1342 * - decoding: Set by user.
1364 * opaque 64-bit number (generally a PTS) that will be reordered and
1366 * - encoding: Set by libavcodec to the reordered_opaque of the input
1370 * - decoding: Set by user.
1376 * - encoding: unused.
1377 * - decoding: Set by libavcodec
1384 * provided by the user. In that case, this holds display-dependent
1387 * - encoding: unused
1388 * - decoding: Set by user
1394 * - encoding: Set by libavcodec if flags & AV_CODEC_FLAG_PSNR.
1395 * - decoding: unused
1401 * - encoding: Set by user.
1402 * - decoding: unused
1414 * - encoding: Set by user.
1415 * - decoding: Set by user.
1438 * - encoding: Set by libavcodec.
1439 * - decoding: Set by user.
1445 * - encoding: set by user.
1446 * - decoding: set by libavcodec.
1451 * low resolution decoding, 1-> 1/2 size, 2->1/4 size
1452 * - encoding: unused
1453 * - decoding: Set by user.
1460 * - encoding: Set by user.
1461 * - decoding: Set by user.
1470 * - encoding: Set by user, otherwise the default is used.
1471 * - decoding: Set by user, otherwise the default is used.
1479 * - encoding: Set by libavcodec.
1480 * - decoding: Set by libavcodec.
1490 * - encoding: Set by user.
1491 * - decoding: Set by user.
1494 * thread-safe. Thread-unsafe get_buffer2() implementations will be
1511 * - encoding: Set by libavcodec, user can override.
1512 * - decoding: Set by libavcodec, user can override.
1525 * @param func function that will be called count times, with jobnr from 0 to count-1.
1526 * threadnr will be in the range 0 to c->thread_count-1 < MAX_THREADS and so that no
1530 * - encoding: Set by libavcodec, user can override.
1531 * - decoding: Set by libavcodec, user can override.
1536 * noise vs. sse weight for the nsse comparison function
1537 * - encoding: Set by user.
1538 * - decoding: unused
1544 * - encoding: Set by user.
1545 * - decoding: Set by libavcodec.
1548 #define FF_PROFILE_UNKNOWN -99
1549 #define FF_PROFILE_RESERVED -100
1670 * - encoding: Set by user.
1671 * - decoding: Set by libavcodec.
1674 #define FF_LEVEL_UNKNOWN -99
1678 * - encoding: unused
1679 * - decoding: Set by user.
1685 * - encoding: unused
1686 * - decoding: Set by user.
1692 * - encoding: unused
1693 * - decoding: Set by user.
1702 * - encoding: Set/allocated/freed by user (before avcodec_open2())
1703 * - decoding: Set/allocated/freed by libavcodec (by avcodec_open2())
1714 * - decoding: unused
1715 * - encoding: Set by libavcodec. The timestamps on the output packets are
1721 * -initial_padding.
1726 * - decoding: For codecs that store a framerate value in the compressed
1729 * - encoding: May be used to signal the framerate of CFR content to an
1736 * - encoding: unused.
1737 * - decoding: Set by libavcodec before calling get_format()
1743 * - encoding unused.
1744 * - decoding set by user.
1750 * - encoding: unused.
1751 * - decoding: set by libavcodec.
1757 * - decoding: maintained and used by libavcodec, not intended to be used by user apps
1758 * - encoding: unused
1767 * - decoding: set by user
1768 * - encoding: unused
1775 * - decoding: set by libavcodec
1776 * - encoding: unused
1779 …efine FF_SUB_CHARENC_MODE_DO_NOTHING -1 ///< do nothing (demuxer outputs a stream supposed to be…
1781 #define FF_SUB_CHARENC_MODE_PRE_DECODER 1 ///< the AVPacket data needs to be recoded to UTF-8 bef…
1782 …SUB_CHARENC_MODE_IGNORE 2 ///< neither convert the subtitles, nor check them for valid UTF-8
1786 * Note that if the format uses pre-multiplied alpha (common with VP6,
1788 * the image will look as if alpha-blended onto a black background.
1789 * However for formats that do not use pre-multiplied alpha
1791 * assumes pre-multiplied alpha anyway).
1793 * - decoding: set by user
1794 * - encoding: unused
1800 * - decoding: unused
1801 * - encoding: set by libavcodec
1807 * @deprecated unused
1818 * - encoding: Set by user, can be NULL.
1819 * - decoding: unused.
1826 * - encoding: Set by user.
1827 * - decoding: Set by user.
1834 * - encoding: unused
1835 * - decoding: set by user
1841 * - encoding: unused
1842 * - decoding: set by libavcodec
1852 * - decoding: unused
1853 * - encoding: may be set by libavcodec after avcodec_open2().
1861 * afterwards owned (and freed) by libavcodec - it should never be read by
1864 * - decoding: This field should be set by the caller from the get_format()
1872 * - encoding: For hardware encoders configured to use a hwaccel pixel
1884 * @deprecated unused
1897 * - decoding: unused
1898 * - encoding: unused
1905 * - decoding: set by user
1906 * - encoding: set by user
1927 * order to support hw_frames_ctx at all - in that case, all frames
1935 * - encoding: unused
1936 * - decoding: Set by user (either before avcodec_open2(), or in the
1943 * only a sub-rectangle of the decoded frame is intended for display. This
1985 * - decoding: set by user
1986 * - encoding: unused
1993 * - decoding: set by user
1994 * - encoding: set by user
2003 * - decoding: set by user
2004 * - encoding: set by user
2014 * - size
2023 * - data: alignment requirements for AVPacket apply, if any. Some architectures and
2025 * - buf: must contain a pointer to an AVBufferRef structure. The packet's
2040 * This callback must be thread-safe, as when frame threading is used, it may
2045 * - encoding: Set by libavcodec, user can override.
2046 * - decoding: unused
2052 * - encoding: must be set by the caller, to one of AVCodec.ch_layouts.
2053 * - decoding: may be set by the caller if known e.g. from the container.
2119 * be parsed at this point. This function is mandatory.
2149 * be parsed at this point. This function is mandatory.
2162 * to the hardware accelerator. This function is mandatory.
2170 * Size of per-frame hardware accelerator private data.
2212 * that avctx->hwaccel_priv_data is invalid.
2229 * reason not to, as hardware tends to under-report supported levels.
2244 * streams in hardware - it will often succeed, because many streams marked
2293 char *text; ///< 0 terminated plain UTF-8 text
2320 * Return the libavcodec build-time configuration.
2333 * @param codec if non-NULL, allocate private data and initialize defaults
2336 * If NULL, then the codec-specific defaults won't be initialized,
2360 * @deprecated This function should not be used.
2397 * function the context has to be allocated with avcodec_alloc_context3().
2403 * @note Always call this function before using decoding routines (such as
2419 * @param codec The codec to open this context for. If a non-NULL codec has been
2423 * @param options A dictionary filled with AVCodecContext and codec-private options.
2436 * Calling this function on an AVCodecContext that hasn't been opened will free
2437 * the codec-specific data allocated in avcodec_alloc_context3() with a non-NULL
2440 * @note Do not use this function. Use avcodec_free_context() to destroy a
2442 * multiple times is not supported anymore -- use multiple codec contexts
2531 * all the decoded data. Flushing is done by calling this function with packets
2532 * with avpkt->data set to NULL and avpkt->size set to 0 until it stops
2553 * influence decoding per-packet, and apply them when the packet is actually
2555 * decoder to drop the frame contained by the packet sent with this function.)
2557 * @warning The input buffer, avpkt->data must be AV_INPUT_BUFFER_PADDING_SIZE
2570 * not reference-counted).
2584 * AVERROR(EAGAIN): input is not accepted in the current state - user
2601 * @param frame This will be set to a reference-counted video or audio
2603 * decoder. Note that the function will always call
2608 * AVERROR(EAGAIN): output is not available in this state - user must try
2629 * not reference-counted).
2640 * If it is not set, frame->nb_samples must be equal to
2641 * avctx->frame_size for all frames except the last.
2642 * The final frame may be smaller than avctx->frame_size.
2644 * AVERROR(EAGAIN): input is not accepted in the current state - user
2660 * @param avpkt This will be set to a reference-counted packet allocated by the
2661 * encoder. Note that the function will always call
2664 * AVERROR(EAGAIN): output is not available in the current state - user
2682 * Calling this function is not a requirement, but makes it simpler to avoid
2687 * it unnecessary to call this function or having to care about
2690 * There are a number of requirements for calling this function:
2692 * - It must be called from get_format with the same avctx parameter that was
2695 * - The function is not always supported (see description of return values).
2696 * Even if this function returns successfully, hwaccel initialization could
2700 * - The hw_pix_fmt must be one of the choices suggested by get_format. If the
2701 * user decides to use a AVHWFramesContext prepared with this API function,
2703 * - The device_ref passed to this function must support the given hw_pix_fmt.
2704 * - After calling this API function, it is the user's responsibility to
2709 * - The AVHWFramesContext parameters may change every time time get_format is
2713 * - It is perfectly possible to call this function without actually using
2714 * the resulting AVHWFramesContext. One use-case might be trying to reuse a
2715 * previously initialized AVHWFramesContext, and calling this API function
2717 * - Fields that use dynamically allocated values of any kind must not be set
2724 * The function will set at least the following fields on AVHWFramesContext
2727 * - All fields set by av_hwframe_ctx_alloc().
2728 * - Set the format field to hw_pix_fmt.
2729 * - Set the sw_format field to the most suited and most versatile format. (An
2732 * - Set the width/height fields to the coded frame size, rounded up to the
2733 * API-specific minimum alignment.
2734 * - Only _if_ the hwaccel requires a pre-allocated pool: set the initial_pool_size
2738 * by frame threading. If the hwaccel does not require pre-allocation, the
2741 * - Possibly AVHWFramesContext.hwctx fields, depending on the underlying
2747 * The function is stateless, and does not change the AVCodecContext or the
2833 * Set by parser to 1 for key frames and 0 for non-key frames.
2834 * It is initialized to -1, so if the parser doesn't set this flag,
2835 * old-style fallback using AV_PICTURE_TYPE_I picture type as key frames
2856 * Set to INT_MIN when dts_sync_point unused. Otherwise, it must
2870 * Set to INT_MIN when dts_sync_point unused. Otherwise, it must
2871 * contain valid non-negative timestamp delta (presentation time of a frame
2999 * in_len -= len;
3071 * @return The best pixel format to convert to or -1 if none was found.
3100 * frame->nb_samples must be set prior to calling the
3101 * function. This function fills in frame->data,
3102 * frame->extended_data, frame->linesize[0].
3120 * @note for decoders, this function just releases any references the decoder
3123 * @note for encoders, this function will only do something if the encoder
3125 * will drain any remaining packets, and can then be re-used for a different
3149 * be 0-initialized so that no uninitialized data will ever appear.
3155 * be 0-initialized after call.