#include <FlutterDarwinContextMetalSkia.h>

Inheritance diagram for FlutterDarwinContextMetalSkia:

Instance Methods
(instancetype)	- initWithDefaultMTLDevice

(instancetype)	- initWithMTLDevice:commandQueue:

(FlutterDarwinExternalTextureMetal *)	- createExternalTextureWithIdentifier:texture:

Class Methods
(sk_sp< GrDirectContext >)	+ createGrContext:commandQueue:

Properties
id< MTLDevice >	device

id< MTLCommandQueue >	commandQueue

sk_sp< GrDirectContext >	mainContext

sk_sp< GrDirectContext >	resourceContext

CVMetalTextureCacheRef	textureCache

Detailed Description

Provides skia GrContexts that are shared between iOS and macOS embeddings.

Definition at line 23 of file FlutterDarwinContextMetalSkia.h.

Method Documentation

◆ createExternalTextureWithIdentifier:texture:

- (FlutterDarwinExternalTextureMetal *) createExternalTextureWithIdentifier:	(int64_t)	textureID
texture:	(NSObject<FlutterTexture>*)	texture

Creates an external texture with the specified ID and contents.

Definition at line 18 of file FlutterDarwinContextMetalSkia.mm.

                                       :(int64_t)textureID
                                texture:(NSObject<FlutterTexture>*)texture {
  return [[FlutterDarwinExternalTextureMetal alloc] initWithTextureCache:_textureCache
                                                               textureID:textureID
                                                                 texture:texture
                                                          enableImpeller:NO];
}

◆ createGrContext:commandQueue:

+ (sk_sp< GrDirectContext >) createGrContext:	(id<MTLDevice>)	device
commandQueue:	(id<MTLCommandQueue>)	commandQueue

Creates a GrDirectContext with the provided MTLDevice and MTLCommandQueue.

Definition at line 18 of file FlutterDarwinContextMetalSkia.mm.

                                         :(id<MTLDevice>)device
                             commandQueue:(id<MTLCommandQueue>)commandQueue {
  const auto contextOptions =
      flutter::MakeDefaultContextOptions(flutter::ContextType::kRender, GrBackendApi::kMetal);
  GrMtlBackendContext backendContext = {};
  // Skia expect arguments to `MakeMetal` transfer ownership of the reference in for release later
  // when the GrDirectContext is collected.
  backendContext.fDevice.retain((__bridge void*)device);
  backendContext.fQueue.retain((__bridge void*)commandQueue);
  return GrDirectContexts::MakeMetal(backendContext, contextOptions);
}

◆ initWithDefaultMTLDevice

- (instancetype) initWithDefaultMTLDevice

Initial value:

{

fml::CFRef<CVMetalTextureCacheRef> _textureCache

fml::CFRef

Definition cf_utils.h:27

Initializes a FlutterDarwinContextMetalSkia with the system default MTLDevice and a new MTLCommandQueue.

Definition at line 18 of file FlutterDarwinContextMetalSkia.mm.

                                         {
  id<MTLDevice> device = MTLCreateSystemDefaultDevice();
  return [self initWithMTLDevice:device commandQueue:[device newCommandQueue]];
}

◆ initWithMTLDevice:commandQueue:

- (instancetype) initWithMTLDevice:	(id<MTLDevice>)	device
commandQueue:	(id<MTLCommandQueue>)	commandQueue

Initializes a FlutterDarwinContextMetalSkia with provided MTLDevice and MTLCommandQueue.

Definition at line 18 of file FlutterDarwinContextMetalSkia.mm.

                                 :(id<MTLDevice>)device
                     commandQueue:(id<MTLCommandQueue>)commandQueue {
  self = [super init];
  if (self != nil) {
    _device = device;
 
    if (!_device) {
      FML_DLOG(ERROR) << "Could not acquire Metal device.";
      return nil;
    }
 
    _commandQueue = commandQueue;
 
    if (!_commandQueue) {
      FML_DLOG(ERROR) << "Could not create Metal command queue.";
      return nil;
    }
 
    [_commandQueue setLabel:@"Flutter Main Queue"];
 
    {
      CVMetalTextureCacheRef cache = nullptr;
      CVReturn cvReturn = CVMetalTextureCacheCreate(kCFAllocatorDefault,  // allocator
                                                    nil,      // cache attributes (nil default)
                                                    _device,  // metal device
                                                    nil,      // texture attributes (nil default)
                                                    &cache    // [out] cache
      );
      _textureCache.Reset(cache);
      if (cvReturn != kCVReturnSuccess) {
        FML_DLOG(ERROR) << "Could not create Metal texture cache.";
        return nil;
      }
    }
 
    // The devices are in the same "sharegroup" because they share the same device and command
    // queues for now. When the resource context gets its own transfer queue, this will have to be
    // refactored.
    _mainContext = [self createGrContext];
    _resourceContext = [self createGrContext];
 
    if (!_mainContext || !_resourceContext) {
      FML_DLOG(ERROR) << "Could not create Skia Metal contexts.";
      return nil;
    }
 
    // Only log this message on iOS where the default is Impeller. On macOS
    // desktop, Skia is still the default and this log is unecessary.
#if defined(FML_OS_IOS) || defined(FML_OS_IOS_SIM)
    FML_LOG(IMPORTANT) << "Using the Skia rendering backend (Metal).";
#endif  // defined(FML_OS_IOS) || defined(FML_OS_IOS_SIM)
 
    _resourceContext->setResourceCacheLimit(0u);
  }
  return self;
}