blob: 62fd14f20fd45d682f28c08b2141a88882485c54 [file] [log] [blame]
// Copyright 2018 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.
#include <stddef.h>
#include <stdint.h>
#include <memory>
#include <vector>
#include "base/callback.h"
#include "base/containers/span.h"
#include "third_party/skia/include/core/SkImageInfo.h"
namespace gfx {
class Size;
} // namespace gfx
namespace gpu {
// An ImageDecodeAcceleratorWorker handles the actual hardware-accelerated
// decode of an image of a specific type (e.g., JPEG, WebP, etc.).
class ImageDecodeAcceleratorWorker {
virtual ~ImageDecodeAcceleratorWorker() {}
// Encapsulates the result of a decode request giving implementations the
// chance to do custom resource management (e.g., some resources may need to
// be released when the decoded data is no longer needed). Implementations
// should not assume that destruction happens on a specific thread.
class DecodeResult {
virtual ~DecodeResult() {}
virtual base::span<const uint8_t> GetData() const = 0;
virtual size_t GetStride() const = 0;
virtual SkImageInfo GetImageInfo() const = 0;
using CompletedDecodeCB =
// Enqueue a decode of |encoded_data|. The |decode_cb| is called
// asynchronously when the decode completes passing as parameter DecodeResult
// containing the decoded image. For a successful decode, implementations must
// guarantee that:
// 1) GetImageInfo().width() == |output_size|.width().
// 2) GetImageInfo().height() == |output_size|.height().
// 3) GetStride() >= GetImageInfo().minRowBytes().
// 4) GetData().size() >= GetImageInfo().computeByteSize(stride()).
// If the decode fails, |decode_cb| is called asynchronously with nullptr.
// Callbacks should be called in the order that this method is called.
virtual void Decode(std::vector<uint8_t> encoded_data,
const gfx::Size& output_size,
CompletedDecodeCB decode_cb) = 0;
} // namespace gpu