changeset 8890:21e7e2e89379 libavcodec

Another attempt to clarify draw_horiz_band() usage.
author iive
date Sat, 14 Feb 2009 22:22:55 +0000
parents b4838c71d52a
children 0b4d9fa01b59
files avcodec.h
diffstat 1 files changed, 7 insertions(+), 7 deletions(-) [+]
line wrap: on
line diff
--- a/avcodec.h	Sat Feb 14 22:21:17 2009 +0000
+++ b/avcodec.h	Sat Feb 14 22:22:55 2009 +0000
@@ -960,13 +960,13 @@
      * 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.
+     * 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