1/*! \page usage_decode Decoding 2 3 The aom_codec_decode() function is at the core of the decode loop. It 4 processes packets of compressed data passed by the application, producing 5 decoded images. The decoder expects packets to comprise exactly one image 6 frame of data. Packets \ref MUST be passed in decode order. If the 7 application wishes to associate some data with the frame, the 8 <code>user_priv</code> member may be set. 9 10 \ref samples 11 12 13 \section usage_frame_iter Frame Iterator Based Decoding 14 Decoded frames are made available to the application 15 through the aom_codec_get_frame() iterator. The application initializes the 16 iterator storage (of type #aom_codec_iter_t) to NULL, then calls 17 aom_codec_get_frame repeatedly until it returns NULL, indicating that all 18 images have been returned. This process may result in zero, one, or many 19 frames that are ready for display, depending on the codec. 20 21 22*/ 23