summaryrefslogtreecommitdiffstats
path: root/third_party/aom/usage_dx.dox
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--third_party/aom/usage_dx.dox22
1 files changed, 22 insertions, 0 deletions
diff --git a/third_party/aom/usage_dx.dox b/third_party/aom/usage_dx.dox
new file mode 100644
index 0000000000..76dc213bf0
--- /dev/null
+++ b/third_party/aom/usage_dx.dox
@@ -0,0 +1,22 @@
+/*! \page usage_decode Decoding
+
+ The aom_codec_decode() function is at the core of the decode loop. It
+ processes packets of compressed data passed by the application, producing
+ decoded images. The decoder expects packets to comprise exactly one image
+ frame of data. Packets \ref MUST be passed in decode order. If the
+ application wishes to associate some data with the frame, the
+ <code>user_priv</code> member may be set.
+
+ \ref samples
+
+
+ \section usage_frame_iter Frame Iterator Based Decoding
+ Decoded frames are made available to the application
+ through the aom_codec_get_frame() iterator. The application initializes the
+ iterator storage (of type #aom_codec_iter_t) to NULL, then calls
+ aom_codec_get_frame repeatedly until it returns NULL, indicating that all
+ images have been returned. This process may result in zero, one, or many
+ frames that are ready for display, depending on the codec.
+
+
+*/