impeller::EntityPassTarget Class Reference

#include <entity_pass_target.h>

Public Member Functions
	EntityPassTarget (const RenderTarget &render_target, bool supports_read_from_resolve, bool supports_implicit_msaa)
std::shared_ptr< Texture >	Flip (const ContentContext &renderer)
	Flips the backdrop and returns a readable texture that can be bound/sampled to restore the previous pass. More...
RenderTarget &	GetRenderTarget ()
void	RemoveSecondary ()
	Remove the cached secondary color texture. More...
bool	IsValid () const

Detailed Description

Definition at line 15 of file entity_pass_target.h.

Constructor & Destructor Documentation

EntityPassTarget()

impeller::EntityPassTarget::EntityPassTarget ( const RenderTarget &  render_target, bool  supports_read_from_resolve, bool  supports_implicit_msaa  )

explicit

Definition at line 13 of file entity_pass_target.cc.

    : target_(render_target),
      supports_read_from_resolve_(supports_read_from_resolve),
      supports_implicit_msaa_(supports_implicit_msaa) {}

Member Function Documentation

Flip()

std::shared_ptr< Texture > impeller::EntityPassTarget::Flip

(

const ContentContext &

renderer

)

Flips the backdrop and returns a readable texture that can be bound/sampled to restore the previous pass.

After this method is called, a new RenderPass that attaches the result of GetRenderTarget is guaranteed to be able to read the previous pass's backdrop texture (which is returned by this method).

Definition at line 20 of file entity_pass_target.cc.

                                    {
  ColorAttachment color0 = target_.GetColorAttachment(0);
  if (!color0.resolve_texture) {
    VALIDATION_LOG << "EntityPassTarget Flip should never be called for a "
                      "non-MSAA target.";
    // ...because there is never a circumstance where doing so would be
    // necessary. Unlike MSAA passes, non-MSAA passes can be trivially loaded
    // with `LoadAction::kLoad`.
    return color0.texture;
  }
 
  if (supports_read_from_resolve_) {
    // Just return the current resolve texture, which is safe to read in the
    // next render pass that'll resolve to `target_`.
    //
    // Note that this can only be done when MSAA is being used.
    return color0.resolve_texture;
  }
 
  if (!secondary_color_texture_) {
    // The second texture is allocated lazily to avoid unused allocations.
    TextureDescriptor new_descriptor =
        color0.resolve_texture->GetTextureDescriptor();
    RenderTarget target = renderer.GetRenderTargetCache()->CreateOffscreenMSAA(
        *renderer.GetContext(), new_descriptor.size, 1);
    secondary_color_texture_ = target.GetRenderTargetTexture();
 
    if (!secondary_color_texture_) {
      return nullptr;
    }
  }
 
  // If the color0 resolve texture is the same as the texture, then we're
  // running on the GLES backend with implicit resolve.
  if (supports_implicit_msaa_) {
    auto new_secondary = color0.resolve_texture;
    color0.resolve_texture = secondary_color_texture_;
    color0.texture = secondary_color_texture_;
    secondary_color_texture_ = new_secondary;
  } else {
    std::swap(color0.resolve_texture, secondary_color_texture_);
  }
 
  target_.SetColorAttachment(color0, 0);
 
  // Return the previous backdrop texture, which is safe to read in the next
  // render pass that attaches `target_`.
  return secondary_color_texture_;
}

References impeller::RenderTarget::GetColorAttachment(), impeller::ContentContext::GetContext(), impeller::ContentContext::GetRenderTargetCache(), impeller::RenderTarget::GetRenderTargetTexture(), impeller::Attachment::resolve_texture, impeller::RenderTarget::SetColorAttachment(), impeller::TextureDescriptor::size, impeller::Attachment::texture, and VALIDATION_LOG.

Referenced by impeller::InlinePassContext::GetRenderPass().

GetRenderTarget()

RenderTarget & impeller::EntityPassTarget::GetRenderTarget

(

)

Definition at line 71 of file entity_pass_target.cc.

                                                {
  return target_;
}

Referenced by impeller::InlinePassContext::EndPass(), impeller::InlinePassContext::GetRenderPass(), and impeller::InlinePassContext::GetTexture().

IsValid()

bool impeller::EntityPassTarget::IsValid

(

)

const

Definition at line 75 of file entity_pass_target.cc.

                                     {
  return target_.IsValid();
}

References impeller::RenderTarget::IsValid().

Referenced by impeller::InlinePassContext::IsValid().

RemoveSecondary()

void impeller::EntityPassTarget::RemoveSecondary

(

)

Remove the cached secondary color texture.

Definition at line 79 of file entity_pass_target.cc.

                                       {
  secondary_color_texture_ = nullptr;
}

---

The documentation for this class was generated from the following files:

• impeller/entity/entity_pass_target.h
• impeller/entity/entity_pass_target.cc