| /*! \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. | |
| */ |