engine/src/flutter/lib/gpu/texture.h

// Copyright 2013 The Flutter 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 FLUTTER_LIB_GPU_TEXTURE_H_
#define FLUTTER_LIB_GPU_TEXTURE_H_

#include "flutter/lib/gpu/context.h"
#include "flutter/lib/gpu/export.h"
#include "flutter/lib/ui/dart_wrapper.h"
#include "impeller/core/formats.h"
#include "third_party/tonic/typed_data/dart_byte_data.h"

namespace flutter {
namespace gpu {

class Texture : public RefCountedDartWrappable<Texture> {
  DEFINE_WRAPPERTYPEINFO();
  FML_FRIEND_MAKE_REF_COUNTED(Texture);

 public:
  explicit Texture(std::shared_ptr<impeller::Texture> texture);

  ~Texture() override;

  std::shared_ptr<impeller::Texture> GetTexture();

  bool Overwrite(Context& gpu_context,
                 const tonic::DartByteData& source_bytes,
                 uint32_t mip_level,
                 uint32_t slice);

  Dart_Handle AsImage() const;

 private:
  std::shared_ptr<impeller::Texture> texture_;

  FML_DISALLOW_COPY_AND_ASSIGN(Texture);
};

}  // namespace gpu
}  // namespace flutter

//----------------------------------------------------------------------------
/// Exports
///

extern "C" {

FLUTTER_GPU_EXPORT
extern bool InternalFlutterGpu_Texture_Initialize(
    Dart_Handle wrapper,
    flutter::gpu::Context* gpu_context,
    int storage_mode,
    int format,
    int width,
    int height,
    int sample_count,
    int texture_type,
    bool enable_render_target_usage,
    bool enable_shader_read_usage,
    bool enable_shader_write_usage,
    int mip_level_count);

FLUTTER_GPU_EXPORT
extern bool InternalFlutterGpu_Texture_Overwrite(
    flutter::gpu::Texture* wrapper,
    flutter::gpu::Context* gpu_context,
    Dart_Handle source_byte_data,
    int mip_level,
    int slice);

FLUTTER_GPU_EXPORT
extern Dart_Handle InternalFlutterGpu_Texture_AsImage(
    flutter::gpu::Texture* wrapper);

// Returns an Int32List describing the texture that backs the given ui.Image,
// or an empty list if the image is not backed by a Flutter GPU compatible
// texture. See the Dart `Texture.fromImage` for the field layout.
FLUTTER_GPU_EXPORT
extern Dart_Handle InternalFlutterGpu_Texture_ImageTextureInfo(
    flutter::gpu::Context* gpu_context,
    Dart_Handle image_wrapper);

// Associates `wrapper` with the impeller texture that backs the given
// ui.Image, without copying. Returns false if the image is not backed by a
// Flutter GPU compatible texture.
FLUTTER_GPU_EXPORT
extern bool InternalFlutterGpu_Texture_InitializeFromImage(
    Dart_Handle wrapper,
    flutter::gpu::Context* gpu_context,
    Dart_Handle image_wrapper);

}  // extern "C"

#endif  // FLUTTER_LIB_GPU_TEXTURE_H_