device_buffer_gles.h

Go to the documentation of this file.

// 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_IMPELLER_RENDERER_BACKEND_GLES_DEVICE_BUFFER_GLES_H_
#define FLUTTER_IMPELLER_RENDERER_BACKEND_GLES_DEVICE_BUFFER_GLES_H_
 
#include <cstdint>
#include <memory>
 
#include "impeller/base/allocation.h"
#include "impeller/base/backend_cast.h"
#include "impeller/base/thread.h"
#include "impeller/core/device_buffer.h"
#include "impeller/renderer/backend/gles/reactor_gles.h"
 
namespace impeller {
 
class DeviceBufferGLES final
    : public DeviceBuffer,
      public BackendCast<DeviceBufferGLES, DeviceBuffer> {
 public:
  DeviceBufferGLES(DeviceBufferDescriptor desc,
                   std::shared_ptr<ReactorGLES> reactor,
                   std::unique_ptr<Allocation> backing_store);
 
  // |DeviceBuffer|
  ~DeviceBufferGLES() override;
 
  const uint8_t* GetBufferData() const;
 
  void UpdateBufferData(
      const std::function<void(uint8_t*, size_t length)>& update_buffer_data);
 
  enum class BindingType {
    kArrayBuffer,
    kElementArrayBuffer,
    kUniformBuffer,
  };
 
  [[nodiscard]] bool BindAndUploadDataIfNecessary(BindingType type) const;
 
  void Flush(std::optional<Range> range = std::nullopt) const override;
 
  std::optional<GLuint> GetHandle() const;
 
 private:
  std::shared_ptr<ReactorGLES> reactor_;
  std::optional<std::string> label_;
  // Mutable for lazy evaluation.
  mutable std::optional<HandleGLES> handle_;
  mutable std::unique_ptr<Allocation> backing_store_;
  // Guards dirty_range_. Flush() merges ranges from writer threads (e.g. the
  // UI thread for flutter_gpu host-visible buffers) while
  // BindAndUploadDataIfNecessary() consumes the range on a reactor thread.
  mutable Mutex dirty_range_mutex_;
  mutable std::optional<Range> dirty_range_
      IPLR_GUARDED_BY(dirty_range_mutex_) = std::nullopt;
  mutable bool initialized_ = false;
 
  // |DeviceBuffer|
  uint8_t* OnGetContents() const override;
 
  // |DeviceBuffer|
  bool OnCopyHostBuffer(const uint8_t* source,
                        Range source_range,
                        size_t offset) override;
 
  // |DeviceBuffer|
  bool SetLabel(std::string_view label) override;
 
  // |DeviceBuffer|
  bool SetLabel(std::string_view label, Range range) override;
 
  DeviceBufferGLES(const DeviceBufferGLES&) = delete;
 
  DeviceBufferGLES& operator=(const DeviceBufferGLES&) = delete;
};
 
}  // namespace impeller
 
#endif  // FLUTTER_IMPELLER_RENDERER_BACKEND_GLES_DEVICE_BUFFER_GLES_H_