blob: cade79cb74b5e3ff8bee7d55f6ba83a384bca54c [file] [log] [blame]
// Copyright 2016 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.
module media.mojom;
import "gpu/ipc/common/sync_token.mojom";
import "media/mojo/interfaces/media_types.mojom";
import "mojo/common/unguessable_token.mojom";
// Identifies a GpuCommandBufferStub. MediaGpuChannelManager is responsible
// for minting |channel_token| objects.
struct CommandBufferId {
mojo.common.mojom.UnguessableToken channel_token;
int32 route_id;
};
interface VideoDecoder {
// Initialize the decoder. This must be called before any other method.
//
// |command_buffer_id|, when present, identifies a GpuCommandBufferStub that
// the decoder can use for GL operations. Implementations that require GL will
// fail Initialize() if |command_buffer_id| is not provided.
//
// |decoder_buffer_pipe| will be used to transfer encoded data for each
// DecoderBuffer.
//
// TODO(sandersd): Rename to Initialize() if/when
// media::VideoDecoder::Initialize() is renamed to Configure().
Construct(associated VideoDecoderClient client,
handle<data_pipe_consumer> decoder_buffer_pipe,
CommandBufferId? command_buffer_id);
// Configure (or reconfigure) the decoder. This must be called before decoding
// any frames, and must not be called while there are pending Initialize(),
// Decode(), or Reset() requests.
//
// If |low_delay| is true, the decoder must output frames as soon as possible;
// in particular, it must not wait for another Decode() request, except as
// required for frame reordering. Implementations must fail initialization if
// they cannot satisfy this requirement.
//
// On completion, the callback also includes |needs_bitstream_conversion|,
// indicating whether decode buffers need bitstream conversion, and
// |max_decode_requests|, the maximum number of concurrent Decode() requests
// the implementation supports.
Initialize(VideoDecoderConfig config, bool low_delay) =>
(bool success, bool needs_bitstream_conversion,
int32 max_decode_requests);
// Request decoding of exactly one frame or an EOS buffer. This must not be
// called while there are pending Initialize(), Reset(), or Decode(EOS)
// requests.
//
// Implementations must eventually execute the callback, even if Decode() is
// not called again. It is not required that the decode status match the
// actual result of decoding the buffer, only that decode errors are
// eventually reported (such as at EOS).
//
// If |buffer| is an EOS buffer, implementations must execute all other
// pending Decode() callbacks and output all pending frames before executing
// the Decode(EOS) callback. (That is, they must flush.)
Decode(DecoderBuffer buffer) => (DecodeStatus status);
// Reset the decoder. All ongoing Decode() requests must be completed or
// aborted before executing the callback. This must not be called while there
// is a pending Initialize() request.
Reset() => ();
// Inform the decoder that the client is finished with a frame.
// |release_sync_token| is a (possibly empty) sync point after which the
// frame's backing textures will be safe to overwrite.
OnReleaseMailbox(mojo.common.mojom.UnguessableToken release_token,
gpu.mojom.SyncToken release_sync_token);
};
interface VideoDecoderClient {
// Output a decoded frame. Frames must be output in presentation order. If
// |release_token| is provided, the client should call OnReleaseMailbox() when
// it is finished with the frame.
OnVideoFrameDecoded(VideoFrame frame,
mojo.common.mojom.UnguessableToken? release_token);
};