Index: media/video/video_encode_accelerator.h |
=================================================================== |
--- media/video/video_encode_accelerator.h (revision 218293) |
+++ media/video/video_encode_accelerator.h (working copy) |
@@ -1,145 +0,0 @@ |
-// Copyright 2013 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 MEDIA_VIDEO_VIDEO_ENCODE_ACCELERATOR_H_ |
-#define MEDIA_VIDEO_VIDEO_ENCODE_ACCELERATOR_H_ |
- |
-#include <vector> |
- |
-#include "base/basictypes.h" |
-#include "base/memory/ref_counted.h" |
-#include "media/base/bitstream_buffer.h" |
-#include "media/base/media_export.h" |
-#include "media/base/video_decoder_config.h" |
-#include "media/base/video_frame.h" |
- |
-namespace media { |
- |
-class BitstreamBuffer; |
-class VideoFrame; |
- |
-// Video encoder interface. |
-class MEDIA_EXPORT VideoEncodeAccelerator { |
- public: |
- virtual ~VideoEncodeAccelerator(); |
- |
- // Specification of an encoding profile supported by an encoder. |
- struct SupportedProfile { |
- VideoCodecProfile profile; |
- gfx::Size max_resolution; |
- struct { |
- uint32 numerator; |
- uint32 denominator; |
- } max_framerate; |
- }; |
- |
- // Enumeration of potential errors generated by the API. |
- enum Error { |
- // An operation was attempted during an incompatible encoder state. |
- kIllegalStateError, |
- // Invalid argument was passed to an API method. |
- kInvalidArgumentError, |
- // A failure occurred at the GPU process or one of its dependencies. |
- // Examples of such failures include GPU hardware failures, GPU driver |
- // failures, GPU library failures, GPU process programming errors, and so |
- // on. |
- kPlatformFailureError, |
- }; |
- |
- // Interface for clients that use VideoEncodeAccelerator. |
- class MEDIA_EXPORT Client { |
- public: |
- // Callback to notify client that encoder has been successfully initialized. |
- virtual void NotifyInitializeDone() = 0; |
- |
- // Callback to tell the client what size of frames and buffers to provide |
- // for input and output. The VEA disclaims use or ownership of all |
- // previously provided buffers once this callback is made. |
- // Parameters: |
- // |input_count| is the number of input VideoFrames required for encoding. |
- // The client should be prepared to feed at least this many frames into the |
- // encoder before being returned any input frames, since the encoder may |
- // need to hold onto some subset of inputs as reference pictures. |
- // |input_coded_size| is the logical size of the input frames (as reported |
- // by VideoFrame::coded_size()) to encode, in pixels. The encoder may have |
- // hardware alignment requirements that make this different from |
- // |input_visible_size|, as requested in Initialize(), in which case the |
- // input VideoFrame to Encode() should be padded appropriately. |
- // |output_buffer_size| is the required size of output buffers for this |
- // encoder in bytes. |
- virtual void RequireBitstreamBuffers(unsigned int input_count, |
- const gfx::Size& input_coded_size, |
- size_t output_buffer_size) = 0; |
- |
- // Callback to deliver encoded bitstream buffers. Ownership of the buffer |
- // is transferred back to the VEA::Client once this callback is made. |
- // Parameters: |
- // |bitstream_buffer_id| is the id of the buffer that is ready. |
- // |payload_size| is the byte size of the used portion of the buffer. |
- // |key_frame| is true if this delivered frame is a keyframe. |
- virtual void BitstreamBufferReady(int32 bitstream_buffer_id, |
- size_t payload_size, |
- bool key_frame) = 0; |
- |
- // Error notification callback. |
- virtual void NotifyError(Error error) = 0; |
- |
- protected: |
- // Clients are not owned by VEA instances and should not be deleted through |
- // these pointers. |
- virtual ~Client() {} |
- }; |
- |
- // Video encoder functions. |
- |
- // Initialize the video encoder with a specific configuration. Called once |
- // per encoder construction. |
- // Parameters: |
- // |input_format| is the frame format of the input stream (as would be |
- // reported by VideoFrame::format() for frames passed to Encode()). |
- // |input_visible_size| is the resolution of the input stream (as would be |
- // reported by VideoFrame::visible_rect().size() for frames passed to |
- // Encode()). |
- // |output_profile| is the codec profile of the encoded output stream. |
- // |initial_bitrate| is the initial bitrate of the encoded output stream, |
- // in bits per second. |
- // TODO(sheu): handle resolution changes. http://crbug.com/249944 |
- virtual void Initialize(media::VideoFrame::Format input_format, |
- const gfx::Size& input_visible_size, |
- VideoCodecProfile output_profile, |
- uint32 initial_bitrate) = 0; |
- |
- // Encodes the given frame. |
- // Parameters: |
- // |frame| is the VideoFrame that is to be encoded. |
- // |force_keyframe| forces the encoding of a keyframe for this frame. |
- virtual void Encode(const scoped_refptr<VideoFrame>& frame, |
- bool force_keyframe) = 0; |
- |
- // Send a bitstream buffer to the encoder to be used for storing future |
- // encoded output. Each call here with a given |buffer| will cause the buffer |
- // to be filled once, then returned with BitstreamBufferReady(). |
- // Parameters: |
- // |buffer| is the bitstream buffer to use for output. |
- virtual void UseOutputBitstreamBuffer(const BitstreamBuffer& buffer) = 0; |
- |
- // Request a change to the encoding parameters. This is only a request, |
- // fulfilled on a best-effort basis. |
- // Parameters: |
- // |bitrate| is the requested new bitrate, in bits per second. |
- // |framerate| is the requested new framerate, in frames per second. |
- virtual void RequestEncodingParametersChange(uint32 bitrate, |
- uint32 framerate) = 0; |
- |
- // Destroys the encoder: all pending inputs and outputs are dropped |
- // immediately and the component is freed. This call may asynchronously free |
- // system resources, but its client-visible effects are synchronous. After |
- // this method returns no more callbacks will be made on the client. Deletes |
- // |this| unconditionally, so make sure to drop all pointers to it! |
- virtual void Destroy() = 0; |
-}; |
- |
-} // namespace media |
- |
-#endif // MEDIA_VIDEO_VIDEO_ENCODE_ACCELERATOR_H_ |