diff options
Diffstat (limited to 'ppapi/c/dev/ppb_video_decoder_dev.h')
-rw-r--r-- | ppapi/c/dev/ppb_video_decoder_dev.h | 86 |
1 files changed, 86 insertions, 0 deletions
diff --git a/ppapi/c/dev/ppb_video_decoder_dev.h b/ppapi/c/dev/ppb_video_decoder_dev.h new file mode 100644 index 0000000..33274de --- /dev/null +++ b/ppapi/c/dev/ppb_video_decoder_dev.h @@ -0,0 +1,86 @@ +// Copyright (c) 2010 The Chromium Authors. All rights reserved. +// Use of this source code is governed by a BSD-style license that can be +// found in the LICENSE file. + +#ifndef PPAPI_C_DEV_PPB_VIDEO_DECODER_DEV_H_ +#define PPAPI_C_DEV_PPB_VIDEO_DECODER_DEV_H_ + +#include "ppapi/c/dev/pp_video_dev.h" +#include "ppapi/c/pp_module.h" +#include "ppapi/c/pp_resource.h" +#include "ppapi/c/pp_stdint.h" +#include "ppapi/c/pp_completion_callback.h" + +#define PPB_VIDEODECODER_DEV_INTERFACE "PPB_VideoDecoder(Dev);0.1" + +struct PPB_VideoDecoder_Dev { + // Queries capability of the decoder for |codec|. + // |codec| is the requested codec id. + // |configs| is a pointer to a buffer containing |config_size| elements. + // The number of configurations is returned in |num_config|. Element 0 through + // |num_config| - 1 of |configs| are filled in with valid PP_VideoConfig's. + // No more than |config_size| PP_VideoConfig's will be returned even if more + // are available on the device. + // When this function is called with |configs| = NULL, then no configurations + // are returned, but the total number of configurations available will be + // returned in |num_config|. + // + // Returns true on success, false otherwise. + // NOTE: browser owns the memory of all PP_VideoConfig's. + bool (*GetConfig)(PP_Instance instance, + PP_VideoCodecId_Dev codec, + PP_VideoConfig_Dev* configs, + int32_t config_size, + int32_t* num_config); + + // Creates a video decoder with requested |decoder_config|. + // |input_format| in |decoder_config| specifies the format of input access + // unit, with PP_VIDEOKEY_CODECID and PP_VIDEOKEY_PAYLOADFORMAT required. + // Plugin has the option to specify codec profile/level and other + // information such as PP_VIDEOKEY_ACCELERATION, to let browser choose + // the most appropriate decoder. + // + // |output_format| in |decoder_config| specifies desired decoded frame buffer + // format, with PP_VIDEOKEY_COLORTYPE and PP_VIDEOKEY_SURFACETYPE required. + // + // |output_callback| in |decoder_config| specifies the callback function + // for decoder to deliver decoded frame buffers. Decoder shall retain it. + // + // |input_callback| in |decoder_config| specifies the callback function + // for decoder to return compressed data buffers to plugin. Decoder shall + // retain it. When plugin doesn't expect buffer recycling, it shall set + // |input_callback| to NULL. In this case, plugin shall allocate buffer via + // |MemAlloc| in PPB_Core interface, and decoder will free buffer via + // |MemFree| in the same API. + // + // |event_handler| in |decoder_config| specifies the function for decoder + // to deliver events to plugin. Decoder shall retain it. + // + // The created decoder is returned as PP_Resource. NULL means failure. + PP_Resource (*Create)(PP_Instance instance, + const struct PP_VideoDecoderConfig_Dev* decoder_config); + + // Sends bit stream in |input_buffer| to the decoder. + // This is a non-blocking call. + // The decoded frame will be returned by decoder calling |output_callback| + // provided by plugin during creation of decoder. + // The input data buffer is returned to plugin by decoder only when plugin + // provides |input_callback|. + // Returns true on decoder successfully accepting buffer, false otherwise. + // + bool (*Decode)(PP_Resource decoder, + struct PP_VideoCompressedDataBuffer_Dev* input_buffer); + + // Requests the decoder to flush its input and output buffers. Once done with + // flushing, the decode will call the |callback|. + int32_t (*Flush)(PP_Resource decoder, + PP_CompletionCallback callback); + + // Plugin sends uncompressed data buffers to the decoder. + // Returns true on decoder successfully accepting the buffer, false otherwise. + bool (*ReturnUncompressedDataBuffer)( + PP_Resource decoder, + struct PP_VideoUncompressedDataBuffer_Dev* buffer); +}; + +#endif // PPAPI_C_DEV_PPB_VIDEO_DECODER_DEV_H_ |