comparison avcodec.h @ 8890:21e7e2e89379 libavcodec

Another attempt to clarify draw_horiz_band() usage.

8889:b4838c71d52a

    /**
     * If non NULL, 'draw_horiz_band' is called by the libavcodec
     * decoder to draw a horizontal band. It improves cache usage. Not
     * all codecs can do that. You must check the codec capabilities
     * beforehand.
     * The functino is also used by hardware acceleration APIs as a callback
     * to pass specific (partially decoded) data to the calling application
     * so that the data can be passed to the rendering hardware.
     * In that mode all relevant function parameters are inside a special
     * structure passed by AVFrame in place of the pixel data.
     * The exact structure depends on the acceleration API.
     * The application is allowed to make changes in the structure.
     * - encoding: unused
     * - decoding: Set by user.
     * @param height the height of the slice
     * @param y the y position of the slice
     * @param type 1->top field, 2->bottom field, 3->frame

8890:21e7e2e89379

    /**
     * If non NULL, 'draw_horiz_band' is called by the libavcodec
     * decoder to draw a horizontal band. It improves cache usage. Not
     * all codecs can do that. You must check the codec capabilities
     * beforehand.
     * The function is also used by hardware acceleration APIs.
     * It is called at least once during frame decoding to pass
     * the data needed for hardware render.
     * In that mode instead of pixel data, AVFrame points to
     * a structure specific to the acceleration API. The application
     * reads the structure and can change some fields to indicate progress
     * or mark state.
     * - encoding: unused
     * - decoding: Set by user.
     * @param height the height of the slice
     * @param y the y position of the slice
     * @param type 1->top field, 2->bottom field, 3->frame