1010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles)/* Copyright (c) 2014 The Chromium Authors. All rights reserved. 2010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Use of this source code is governed by a BSD-style license that can be 3010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * found in the LICENSE file. 4010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 5010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 6010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles)/** 7010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * This file defines the <code>PPB_VideoDecoder</code> interface. 8010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 9010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 10010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles)[generate_thunk] 11010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 12010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles)label Chrome { 131320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci /** Though not labeled 'channel=dev', 0.1 is a still a 'Dev' only API. */ 141320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci M36 = 0.1, 151320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci M39 = 0.2 16010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles)}; 17010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 18010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles)/** 19010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Video decoder interface. 20010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 21010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Typical usage: 22010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * - Call Create() to create a new video decoder resource. 23010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * - Call Initialize() to initialize it with a 3d graphics context and the 24010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * desired codec profile. 25010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * - Call Decode() continuously (waiting for each previous call to complete) to 26010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * push bitstream buffers to the decoder. 27010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * - Call GetPicture() continuously (waiting for each previous call to complete) 28010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * to pull decoded pictures from the decoder. 29010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * - Call Flush() to signal end of stream to the decoder and perform shutdown 30010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * when it completes. 31010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * - Call Reset() to quickly stop the decoder (e.g. to implement Seek) and wait 32010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * for the callback before restarting decoding at another point. 33010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * - To destroy the decoder, the plugin should release all of its references to 34010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * it. Any pending callbacks will abort before the decoder is destroyed. 35010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 36010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Available video codecs vary by platform. 37010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * All: theora, vorbis, vp8. 38010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Chrome and ChromeOS: aac, h264. 39010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * ChromeOS: mpeg4. 40010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 41010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles)interface PPB_VideoDecoder { 42010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) /** 43010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Creates a new video decoder resource. 44010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 45010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] instance A <code>PP_Instance</code> identifying the instance 46010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * with the video decoder. 47010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 48010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @return A <code>PP_Resource</code> corresponding to a video decoder if 49010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * successful or 0 otherwise. 50010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 51010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) PP_Resource Create( 52010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_Instance instance); 53010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 54010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) /** 55010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Determines if the given resource is a video decoder. 56010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 57010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] resource A <code>PP_Resource</code> identifying a resource. 58010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 59010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @return <code>PP_TRUE</code> if the resource is a 60010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * <code>PPB_VideoDecoder</code>, <code>PP_FALSE</code> if the resource is 61010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * invalid or some other type. 62010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 63010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) PP_Bool IsVideoDecoder( 64010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_Resource resource); 65010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 66010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) /** 67010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Initializes a video decoder resource. This should be called after Create() 68010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * and before any other functions. 69010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 70010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] video_decoder A <code>PP_Resource</code> identifying the video 71010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * decoder. 72010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] graphics3d_context A <code>PPB_Graphics3D</code> resource to use 73010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * during decoding. 74010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] profile A <code>PP_VideoProfile</code> specifying the video 75010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * codec profile. 76010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] allow_software_fallback A <code>PP_Bool</code> specifying 77010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * whether the decoder can fall back to software decoding if a suitable 78010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * hardware decoder isn't available. 79010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon 80010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * completion. 81010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 82010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @return An int32_t containing an error code from <code>pp_errors.h</code>. 83010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Returns PP_ERROR_NOTSUPPORTED if video decoding is not available, or the 84010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * requested profile is not supported. In this case, the client may call 85010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Initialize() again with different parameters to find a good configuration. 86010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 87010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) int32_t Initialize( 88010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_Resource video_decoder, 89010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_Resource graphics3d_context, 90010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_VideoProfile profile, 91010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_Bool allow_software_fallback, 92010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_CompletionCallback callback); 93010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 94010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) /** 951320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * Initializes a video decoder resource. This should be called after Create() 961320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * and before any other functions. 971320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * 981320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * @param[in] video_decoder A <code>PP_Resource</code> identifying the video 991320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * decoder. 1001320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * @param[in] graphics3d_context A <code>PPB_Graphics3D</code> resource to use 1011320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * during decoding. 1021320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * @param[in] profile A <code>PP_VideoProfile</code> specifying the video 1031320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * codec profile. 1041320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * @param[in] acceleration A <code>PP_HardwareAcceleration</code> specifying 1051320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * whether to use a hardware accelerated or a software implementation. 1061320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon 1071320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * completion. 1081320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * 1091320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * @return An int32_t containing an error code from <code>pp_errors.h</code>. 1101320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * Returns PP_ERROR_NOTSUPPORTED if video decoding is not available, or the 1111320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * requested profile is not supported. In this case, the client may call 1121320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci * Initialize() again with different parameters to find a good configuration. 1131320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci */ 1141320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci [version = 0.2] 1151320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci int32_t Initialize( 1161320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci [in] PP_Resource video_decoder, 1171320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci [in] PP_Resource graphics3d_context, 1181320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci [in] PP_VideoProfile profile, 1191320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci [in] PP_HardwareAcceleration acceleration, 1201320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci [in] PP_CompletionCallback callback); 1211320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci 1221320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci /** 123010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Decodes a bitstream buffer. Copies |size| bytes of data from the plugin's 124cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * |buffer|. The plugin should wait until the decoder signals completion by 125cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * returning PP_OK or by running |callback| before calling Decode() again. 126010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 127010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * In general, each bitstream buffer should contain a demuxed bitstream frame 128010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * for the selected video codec. For example, H264 decoders expect to receive 129010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * one AnnexB NAL unit, including the 4 byte start code prefix, while VP8 130010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * decoders expect to receive a bitstream frame without the IVF frame header. 131010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 132010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * If the call to Decode() eventually results in a picture, the |decode_id| 133010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * parameter is copied into the returned picture. The plugin can use this to 134010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * associate decoded pictures with Decode() calls (e.g. to assign timestamps 135010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * or frame numbers to pictures.) This value is opaque to the API so the 136010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * plugin is free to pass any value. 137010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 138010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] video_decoder A <code>PP_Resource</code> identifying the video 139010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * decoder. 140010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] decode_id An optional value, chosen by the plugin, that can be 141010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * used to associate calls to Decode() with decoded pictures returned by 142010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * GetPicture(). 143010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] size Buffer size in bytes. 144010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] buffer Starting address of buffer. 145010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] callback A <code>PP_CompletionCallback</code> to be called on 146010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * completion. 147010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 148010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @return An int32_t containing an error code from <code>pp_errors.h</code>. 149cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * Returns PP_ERROR_FAILED if the decoder isn't initialized or if a Flush() 150cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * or Reset() call is pending. 151cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * Returns PP_ERROR_INPROGRESS if there is another Decode() call pending. 152cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * Returns PP_ERROR_NOMEMORY if a bitstream buffer can't be created. 153cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * Returns PP_ERROR_ABORTED when Reset() is called while Decode() is pending. 154010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 155010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) int32_t Decode( 156010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_Resource video_decoder, 157010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] uint32_t decode_id, 158010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] uint32_t size, 159010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] mem_t buffer, 160010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_CompletionCallback callback); 161010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 162010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) /** 163010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Gets the next picture from the decoder. The picture is valid after the 164010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * decoder signals completion by returning PP_OK or running |callback|. The 165010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * plugin can call GetPicture() again after the decoder signals completion. 166010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * When the plugin is finished using the picture, it should return it to the 167010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * system by calling RecyclePicture(). 168010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 169010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] video_decoder A <code>PP_Resource</code> identifying the video 170010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * decoder. 171010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[out] picture A <code>PP_VideoPicture</code> to hold the decoded 172010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * picture. 173010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] callback A <code>PP_CompletionCallback</code> to be called on 174010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * completion. 175010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 176010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @return An int32_t containing an error code from <code>pp_errors.h</code>. 177cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * Returns PP_ERROR_FAILED if the decoder isn't initialized or if a Reset() 178cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * call is pending. 179cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * Returns PP_ERROR_INPROGRESS if there is another GetPicture() call pending. 180010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Returns PP_ERROR_ABORTED when Reset() is called, or if a call to Flush() 181010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * completes while GetPicture() is pending. 182010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 183010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) int32_t GetPicture( 184010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_Resource video_decoder, 185010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [out] PP_VideoPicture picture, 186010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_CompletionCallback callback); 187010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 188010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) /** 189010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Recycles a picture that the plugin has received from the decoder. 190010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * The plugin should call this as soon as it has finished using the texture so 191010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * the decoder can decode more pictures. 192010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 193010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] video_decoder A <code>PP_Resource</code> identifying the video 194010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * decoder. 195010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] picture A <code>PP_VideoPicture</code> to return to 196010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * the decoder. 197010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 198010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) void RecyclePicture( 199010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_Resource video_decoder, 200010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_VideoPicture picture); 201010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 202010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) /** 203cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * Flushes the decoder. The plugin should call Flush() when it reaches the 204cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * end of its video stream in order to stop cleanly. The decoder will run any 205cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * pending Decode() call to completion. The plugin should make no further 206cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * calls to the decoder other than GetPicture() and RecyclePicture() until 207cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * the decoder signals completion by running |callback|. Just before 208cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * completion, any pending GetPicture() call will complete by running its 209cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * callback with result PP_ERROR_ABORTED to signal that no more pictures are 210116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch * available. Any pictures held by the plugin remain valid during and after 211116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch * the flush and should be recycled back to the decoder. 212010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 213010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] video_decoder A <code>PP_Resource</code> identifying the video 214010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * decoder. 215010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] callback A <code>PP_CompletionCallback</code> to be called on 216010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * completion. 217010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 218010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @return An int32_t containing an error code from <code>pp_errors.h</code>. 219cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * Returns PP_ERROR_FAILED if the decoder isn't initialized. 220010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 221010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) int32_t Flush( 222010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_Resource video_decoder, 223010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_CompletionCallback callback); 224010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) 225010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) /** 226010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * Resets the decoder as quickly as possible. The plugin can call Reset() to 227cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * skip to another position in the video stream. After Reset() returns, any 228cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * pending calls to Decode() and GetPicture()) abort, causing their callbacks 229cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * to run with PP_ERROR_ABORTED. The plugin should not make further calls to 230116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch * the decoder other than RecyclePicture() until the decoder signals 231116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch * completion by running |callback|. Any pictures held by the plugin remain 232116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch * valid during and after the reset and should be recycled back to the 233116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch * decoder. 234010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 235010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] video_decoder A <code>PP_Resource</code> identifying the video 236010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * decoder. 237010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @param[in] callback A <code>PP_CompletionCallback</code> to be called on 238010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * completion. 239010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * 240010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) * @return An int32_t containing an error code from <code>pp_errors.h</code>. 241cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) * Returns PP_ERROR_FAILED if the decoder isn't initialized. 242010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) */ 243010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) int32_t Reset( 244010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_Resource video_decoder, 245010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles) [in] PP_CompletionCallback callback); 246010d83a9304c5a91596085d917d248abff47903aTorne (Richard Coles)}; 247