| Flutter Impeller |

Public Member Functions | List of all members
impeller::ImpellerMetalCaptureManager Class Reference

Creates and manages a Metal capture scope that supports frame capture when using the FlutterMetalLayer backed drawable. More...

`#include <context_mtl.h>`

## Public Member Functions
| ImpellerMetalCaptureManager (id< MTLDevice > device)
| Construct a new capture manager from the provided Metal device. More...
| ~ImpellerMetalCaptureManager ()=default
bool | CaptureScopeActive () const
void | StartCapture ()
| Begin a new capture scope, no-op if the scope has already started. More...
void | FinishCapture ()
| End the current capture scope. More...

## Detailed Description

Creates and manages a Metal capture scope that supports frame capture when using the FlutterMetalLayer backed drawable.

Definition at line 37 of file context_mtl.h.

## Constructor & Destructor Documentation

## ◆ ImpellerMetalCaptureManager()

impeller::ImpellerMetalCaptureManager::ImpellerMetalCaptureManager | ( | id< MTLDevice > | device | ) |
| explicit

Construct a new capture manager from the provided Metal device.

Definition at line 473 of file context_mtl.mm.

473 {
474 current_capture_scope_ = [[MTLCaptureManager sharedCaptureManager]
475 newCaptureScopeWithDevice:device];
476 [current_capture_scope_ setLabel:@"Impeller Frame"];
477 }

## ◆ ~ImpellerMetalCaptureManager()

impeller::ImpellerMetalCaptureManager::~ImpellerMetalCaptureManager | ( |  | ) |
| default

## Member Function Documentation

## ◆ CaptureScopeActive()

bool impeller::ImpellerMetalCaptureManager::CaptureScopeActive | ( |  | ) | const

Whether or not the Impeller capture scope is active.

This is distinct from whether or not there is a session recording the capture. That can be checked with `[[MTLCaptureManager sharedCaptureManager] isCapturing].`

Definition at line 479 of file context_mtl.mm.

479 {
480 return scope_active_;
481 }

## ◆ FinishCapture()

void impeller::ImpellerMetalCaptureManager::FinishCapture | ( |  | ) |

End the current capture scope.

Definition at line 491 of file context_mtl.mm.

491 {
492 FML_DCHECK(scope_active_);
493 [current_capture_scope_ endScope];
494 scope_active_ = false;
495 }

## ◆ StartCapture()

void impeller::ImpellerMetalCaptureManager::StartCapture | ( |  | ) |

Begin a new capture scope, no-op if the scope has already started.

Definition at line 483 of file context_mtl.mm.

483 {
484 if (scope_active_) {
485 return;
486 }
487 scope_active_ = true;
488 [current_capture_scope_ beginScope];
489 }

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

- impeller/renderer/backend/metal/context_mtl.h
- impeller/renderer/backend/metal/context_mtl.mm