render_pass.h File Reference

#include <map>
#include <memory>
#include "flutter/lib/gpu/command_buffer.h"
#include "flutter/lib/gpu/export.h"
#include "flutter/lib/ui/dart_wrapper.h"
#include "fml/memory/ref_ptr.h"
#include "impeller/core/formats.h"
#include "impeller/core/vertex_buffer.h"
#include "impeller/renderer/command.h"
#include "impeller/renderer/render_pass.h"
#include "impeller/renderer/render_target.h"
#include "lib/gpu/device_buffer.h"
#include "lib/gpu/host_buffer.h"
#include "lib/gpu/render_pipeline.h"
#include "lib/gpu/texture.h"

Go to the source code of this file.

Classes
class	flutter::gpu::RenderPass

Namespaces
namespace	flutter
namespace	flutter::gpu

Functions
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_Initialize (Dart_Handle wrapper)
FLUTTER_GPU_EXPORT Dart_Handle	InternalFlutterGpu_RenderPass_SetColorAttachment (flutter::gpu::RenderPass *wrapper, int color_attachment_index, int load_action, int store_action, int clear_color, flutter::gpu::Texture *texture, Dart_Handle resolve_texture_wrapper)
FLUTTER_GPU_EXPORT Dart_Handle	InternalFlutterGpu_RenderPass_SetDepthStencilAttachment (flutter::gpu::RenderPass *wrapper, int depth_load_action, int depth_store_action, float depth_clear_value, int stencil_load_action, int stencil_store_action, int stencil_clear_value, flutter::gpu::Texture *texture)
FLUTTER_GPU_EXPORT Dart_Handle	InternalFlutterGpu_RenderPass_Begin (flutter::gpu::RenderPass *wrapper, flutter::gpu::CommandBuffer *command_buffer)
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_BindPipeline (flutter::gpu::RenderPass *wrapper, flutter::gpu::RenderPipeline *pipeline)
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_BindVertexBufferDevice (flutter::gpu::RenderPass *wrapper, flutter::gpu::DeviceBuffer *device_buffer, int offset_in_bytes, int length_in_bytes, int vertex_count)
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_BindVertexBufferHost (flutter::gpu::RenderPass *wrapper, flutter::gpu::HostBuffer *host_buffer, int offset_in_bytes, int length_in_bytes, int vertex_count)
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_BindIndexBufferDevice (flutter::gpu::RenderPass *wrapper, flutter::gpu::DeviceBuffer *device_buffer, int offset_in_bytes, int length_in_bytes, int index_type, int index_count)
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_BindIndexBufferHost (flutter::gpu::RenderPass *wrapper, flutter::gpu::HostBuffer *host_buffer, int offset_in_bytes, int length_in_bytes, int index_type, int index_count)
FLUTTER_GPU_EXPORT bool	InternalFlutterGpu_RenderPass_BindUniformDevice (flutter::gpu::RenderPass *wrapper, flutter::gpu::Shader *shader, Dart_Handle uniform_name_handle, flutter::gpu::DeviceBuffer *device_buffer, int offset_in_bytes, int length_in_bytes)
FLUTTER_GPU_EXPORT bool	InternalFlutterGpu_RenderPass_BindUniformHost (flutter::gpu::RenderPass *wrapper, flutter::gpu::Shader *shader, Dart_Handle uniform_name_handle, flutter::gpu::HostBuffer *host_buffer, int offset_in_bytes, int length_in_bytes)
FLUTTER_GPU_EXPORT bool	InternalFlutterGpu_RenderPass_BindTexture (flutter::gpu::RenderPass *wrapper, flutter::gpu::Shader *shader, Dart_Handle uniform_name_handle, flutter::gpu::Texture *texture, int min_filter, int mag_filter, int mip_filter, int width_address_mode, int height_address_mode)
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_ClearBindings (flutter::gpu::RenderPass *wrapper)
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_SetColorBlendEnable (flutter::gpu::RenderPass *wrapper, int color_attachment_index, bool enable)
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_SetColorBlendEquation (flutter::gpu::RenderPass *wrapper, int color_attachment_index, int color_blend_operation, int source_color_blend_factor, int destination_color_blend_factor, int alpha_blend_operation, int source_alpha_blend_factor, int destination_alpha_blend_factor)
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_SetDepthWriteEnable (flutter::gpu::RenderPass *wrapper, bool enable)
FLUTTER_GPU_EXPORT void	InternalFlutterGpu_RenderPass_SetDepthCompareOperation (flutter::gpu::RenderPass *wrapper, int compare_operation)
FLUTTER_GPU_EXPORT bool	InternalFlutterGpu_RenderPass_Draw (flutter::gpu::RenderPass *wrapper)

Function Documentation

InternalFlutterGpu_RenderPass_Begin()

FLUTTER_GPU_EXPORT Dart_Handle InternalFlutterGpu_RenderPass_Begin	(	flutter::gpu::RenderPass *	wrapper,
		flutter::gpu::CommandBuffer *	command_buffer
	)

Definition at line 252 of file render_pass.cc.

                                             {
  if (!wrapper->Begin(*command_buffer)) {
    return tonic::ToDart("Failed to begin RenderPass");
  }
  return Dart_Null();
}

InternalFlutterGpu_RenderPass_BindIndexBufferDevice()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_BindIndexBufferDevice	(	flutter::gpu::RenderPass *	wrapper,
		flutter::gpu::DeviceBuffer *	device_buffer,
		int	offset_in_bytes,
		int	length_in_bytes,
		int	index_type,
		int	index_count
	)

Definition at line 336 of file render_pass.cc.

                     {
  BindIndexBuffer(wrapper, device_buffer->GetBuffer(), offset_in_bytes,
                  length_in_bytes, index_type, index_count);
}

InternalFlutterGpu_RenderPass_BindIndexBufferHost()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_BindIndexBufferHost	(	flutter::gpu::RenderPass *	wrapper,
		flutter::gpu::HostBuffer *	host_buffer,
		int	offset_in_bytes,
		int	length_in_bytes,
		int	index_type,
		int	index_count
	)

Definition at line 347 of file render_pass.cc.

                     {
  auto view = host_buffer->GetBufferViewForOffset(offset_in_bytes);
  if (!view.has_value()) {
    FML_LOG(ERROR)
        << "Failed to bind index buffer due to invalid HostBuffer offset: "
        << offset_in_bytes;
    return;
  }
  BindIndexBuffer(wrapper, view->buffer, view->range.offset, view->range.length,
                  index_type, index_count);
}

InternalFlutterGpu_RenderPass_BindPipeline()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_BindPipeline	(	flutter::gpu::RenderPass *	wrapper,
		flutter::gpu::RenderPipeline *	pipeline
	)

Definition at line 261 of file render_pass.cc.

                                        {
  auto ref = fml::RefPtr<flutter::gpu::RenderPipeline>(pipeline);
  wrapper->SetPipeline(std::move(ref));
}

InternalFlutterGpu_RenderPass_BindTexture()

FLUTTER_GPU_EXPORT bool InternalFlutterGpu_RenderPass_BindTexture	(	flutter::gpu::RenderPass *	wrapper,
		flutter::gpu::Shader *	shader,
		Dart_Handle	uniform_name_handle,
		flutter::gpu::Texture *	texture,
		int	min_filter,
		int	mag_filter,
		int	mip_filter,
		int	width_address_mode,
		int	height_address_mode
	)

Definition at line 422 of file render_pass.cc.

                             {
  auto& command = wrapper->GetCommand();
 
  auto uniform_name = tonic::StdStringFromDart(uniform_name_handle);
  const impeller::SampledImageSlot* image_slot =
      shader->GetUniformTexture(uniform_name);
  // TODO(bdero): Return an error string stating that no uniform texture with
  //              this name exists and throw an exception.
  if (!image_slot) {
    return false;
  }
 
  impeller::SamplerDescriptor sampler_desc;
  sampler_desc.min_filter = flutter::gpu::ToImpellerMinMagFilter(min_filter);
  sampler_desc.mag_filter = flutter::gpu::ToImpellerMinMagFilter(mag_filter);
  sampler_desc.mip_filter = flutter::gpu::ToImpellerMipFilter(mip_filter);
  sampler_desc.width_address_mode =
      flutter::gpu::ToImpellerSamplerAddressMode(width_address_mode);
  sampler_desc.height_address_mode =
      flutter::gpu::ToImpellerSamplerAddressMode(height_address_mode);
  const std::unique_ptr<const impeller::Sampler>& sampler =
      wrapper->GetContext()->GetSamplerLibrary()->GetSampler(sampler_desc);
 
  return command.BindResource(
      shader->GetShaderStage(), impeller::DescriptorType::kSampledImage,
      *image_slot, impeller::ShaderMetadata{}, texture->GetTexture(), sampler);
}

InternalFlutterGpu_RenderPass_BindUniformDevice()

FLUTTER_GPU_EXPORT bool InternalFlutterGpu_RenderPass_BindUniformDevice	(	flutter::gpu::RenderPass *	wrapper,
		flutter::gpu::Shader *	shader,
		Dart_Handle	uniform_name_handle,
		flutter::gpu::DeviceBuffer *	device_buffer,
		int	offset_in_bytes,
		int	length_in_bytes
	)

Definition at line 392 of file render_pass.cc.

                         {
  return BindUniform(wrapper, shader, uniform_name_handle,
                     device_buffer->GetBuffer(), offset_in_bytes,
                     length_in_bytes);
}

InternalFlutterGpu_RenderPass_BindUniformHost()

FLUTTER_GPU_EXPORT bool InternalFlutterGpu_RenderPass_BindUniformHost	(	flutter::gpu::RenderPass *	wrapper,
		flutter::gpu::Shader *	shader,
		Dart_Handle	uniform_name_handle,
		flutter::gpu::HostBuffer *	host_buffer,
		int	offset_in_bytes,
		int	length_in_bytes
	)

Definition at line 404 of file render_pass.cc.

                         {
  auto view = host_buffer->GetBufferViewForOffset(offset_in_bytes);
  if (!view.has_value()) {
    FML_LOG(ERROR)
        << "Failed to bind index buffer due to invalid HostBuffer offset: "
        << offset_in_bytes;
    return false;
  }
  return BindUniform(wrapper, shader, uniform_name_handle, view->buffer,
                     view->range.offset, view->range.length);
}

InternalFlutterGpu_RenderPass_BindVertexBufferDevice()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_BindVertexBufferDevice	(	flutter::gpu::RenderPass *	wrapper,
		flutter::gpu::DeviceBuffer *	device_buffer,
		int	offset_in_bytes,
		int	length_in_bytes,
		int	vertex_count
	)

Definition at line 292 of file render_pass.cc.

                      {
  BindVertexBuffer(wrapper, device_buffer->GetBuffer(), offset_in_bytes,
                   length_in_bytes, vertex_count);
}

InternalFlutterGpu_RenderPass_BindVertexBufferHost()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_BindVertexBufferHost	(	flutter::gpu::RenderPass *	wrapper,
		flutter::gpu::HostBuffer *	host_buffer,
		int	offset_in_bytes,
		int	length_in_bytes,
		int	vertex_count
	)

Definition at line 302 of file render_pass.cc.

                      {
  std::optional<impeller::BufferView> view =
      host_buffer->GetBufferViewForOffset(offset_in_bytes);
  if (!view.has_value()) {
    FML_LOG(ERROR)
        << "Failed to bind vertex buffer due to invalid HostBuffer offset: "
        << offset_in_bytes;
    return;
  }
  BindVertexBuffer(wrapper, view->buffer, view->range.offset,
                   view->range.length, vertex_count);
}

InternalFlutterGpu_RenderPass_ClearBindings()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_ClearBindings

(

flutter::gpu::RenderPass *

wrapper

)

Definition at line 459 of file render_pass.cc.

                                   {
  auto& command = wrapper->GetCommand();
  command.vertex_buffer = {};
  command.vertex_bindings = {};
  command.fragment_bindings = {};
}

InternalFlutterGpu_RenderPass_Draw()

FLUTTER_GPU_EXPORT bool InternalFlutterGpu_RenderPass_Draw

(

flutter::gpu::RenderPass *

wrapper

)

Definition at line 514 of file render_pass.cc.

                                                                       {
  return wrapper->Draw();
}

InternalFlutterGpu_RenderPass_Initialize()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_Initialize

(

Dart_Handle

wrapper

)

Exports

Definition at line 194 of file render_pass.cc.

                                                                   {
  auto res = fml::MakeRefCounted<flutter::gpu::RenderPass>();
  res->AssociateWithDartWrapper(wrapper);
}

InternalFlutterGpu_RenderPass_SetColorAttachment()

FLUTTER_GPU_EXPORT Dart_Handle InternalFlutterGpu_RenderPass_SetColorAttachment	(	flutter::gpu::RenderPass *	wrapper,
		int	color_attachment_index,
		int	load_action,
		int	store_action,
		int	clear_color,
		flutter::gpu::Texture *	texture,
		Dart_Handle	resolve_texture_wrapper
	)

Definition at line 199 of file render_pass.cc.

                                         {
  impeller::ColorAttachment desc;
  desc.load_action = flutter::gpu::ToImpellerLoadAction(load_action);
  desc.store_action = flutter::gpu::ToImpellerStoreAction(store_action);
  desc.clear_color = ToImpellerColor(static_cast<uint32_t>(clear_color));
  desc.texture = texture->GetTexture();
  if (!Dart_IsNull(resolve_texture_wrapper)) {
    flutter::gpu::Texture* resolve_texture =
        tonic::DartConverter<flutter::gpu::Texture*>::FromDart(
            resolve_texture_wrapper);
    desc.resolve_texture = resolve_texture->GetTexture();
  }
  wrapper->GetRenderTarget().SetColorAttachment(desc, color_attachment_index);
  return Dart_Null();
}

InternalFlutterGpu_RenderPass_SetColorBlendEnable()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_SetColorBlendEnable	(	flutter::gpu::RenderPass *	wrapper,
		int	color_attachment_index,
		bool	enable
	)

Definition at line 467 of file render_pass.cc.

                 {
  auto& color = wrapper->GetColorAttachmentDescriptor(color_attachment_index);
  color.blending_enabled = enable;
}

InternalFlutterGpu_RenderPass_SetColorBlendEquation()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_SetColorBlendEquation	(	flutter::gpu::RenderPass *	wrapper,
		int	color_attachment_index,
		int	color_blend_operation,
		int	source_color_blend_factor,
		int	destination_color_blend_factor,
		int	alpha_blend_operation,
		int	source_alpha_blend_factor,
		int	destination_alpha_blend_factor
	)

Definition at line 475 of file render_pass.cc.

                                        {
  auto& color = wrapper->GetColorAttachmentDescriptor(color_attachment_index);
  color.color_blend_op =
      flutter::gpu::ToImpellerBlendOperation(color_blend_operation);
  color.src_color_blend_factor =
      flutter::gpu::ToImpellerBlendFactor(source_color_blend_factor);
  color.dst_color_blend_factor =
      flutter::gpu::ToImpellerBlendFactor(destination_color_blend_factor);
  color.alpha_blend_op =
      flutter::gpu::ToImpellerBlendOperation(alpha_blend_operation);
  color.src_alpha_blend_factor =
      flutter::gpu::ToImpellerBlendFactor(source_alpha_blend_factor);
  color.dst_alpha_blend_factor =
      flutter::gpu::ToImpellerBlendFactor(destination_alpha_blend_factor);
}

InternalFlutterGpu_RenderPass_SetDepthCompareOperation()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_SetDepthCompareOperation	(	flutter::gpu::RenderPass *	wrapper,
		int	compare_operation
	)

Definition at line 506 of file render_pass.cc.

                           {
  auto& depth = wrapper->GetDepthAttachmentDescriptor();
  depth.depth_compare =
      flutter::gpu::ToImpellerCompareFunction(compare_operation);
}

InternalFlutterGpu_RenderPass_SetDepthStencilAttachment()

FLUTTER_GPU_EXPORT Dart_Handle InternalFlutterGpu_RenderPass_SetDepthStencilAttachment	(	flutter::gpu::RenderPass *	wrapper,
		int	depth_load_action,
		int	depth_store_action,
		float	depth_clear_value,
		int	stencil_load_action,
		int	stencil_store_action,
		int	stencil_clear_value,
		flutter::gpu::Texture *	texture
	)

Definition at line 222 of file render_pass.cc.

                                {
  {
    impeller::DepthAttachment desc;
    desc.load_action = flutter::gpu::ToImpellerLoadAction(depth_load_action);
    desc.store_action = flutter::gpu::ToImpellerStoreAction(depth_store_action);
    desc.clear_depth = depth_clear_value;
    desc.texture = texture->GetTexture();
    wrapper->GetRenderTarget().SetDepthAttachment(desc);
  }
  {
    impeller::StencilAttachment desc;
    desc.load_action = flutter::gpu::ToImpellerLoadAction(stencil_load_action);
    desc.store_action =
        flutter::gpu::ToImpellerStoreAction(stencil_store_action);
    desc.clear_stencil = stencil_clear_value;
    desc.texture = texture->GetTexture();
    wrapper->GetRenderTarget().SetStencilAttachment(desc);
  }
 
  return Dart_Null();
}

InternalFlutterGpu_RenderPass_SetDepthWriteEnable()

FLUTTER_GPU_EXPORT void InternalFlutterGpu_RenderPass_SetDepthWriteEnable	(	flutter::gpu::RenderPass *	wrapper,
		bool	enable
	)

Definition at line 499 of file render_pass.cc.

                 {
  auto& depth = wrapper->GetDepthAttachmentDescriptor();
  depth.depth_write_enabled = true;
}