chromium/ui/base/cocoa/remote_layer_api.h

// Copyright 2014 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef UI_BASE_COCOA_REMOTE_LAYER_API_H_
#define UI_BASE_COCOA_REMOTE_LAYER_API_H_

#include <stdint.h>

#include "base/component_export.h"
#include "build/build_config.h"

#if defined(__OBJC__)
#import <Foundation/Foundation.h>
#import <QuartzCore/QuartzCore.h>
#endif  // __OBJC__

#if BUILDFLAG(IS_MAC)

// The CGSConnectionID is used to create the CAContext in the process that is
// going to share the CALayers that it is rendering to another process to
// display.
extern "C" {
typedef uint32_t CGSConnectionID;
CGSConnectionID CGSMainConnectionID(void);
}

#endif  // BUILDFLAG(IS_MAC)

// The CAContextID type identifies a CAContext across processes. This is the
// token that is passed from the process that is sharing the CALayer that it is
// rendering to the process that will be displaying that CALayer.
typedef uint32_t CAContextID;

#if defined(__OBJC__)

// The CAContext has a static CAContextID which can be sent to another process.
// When a CALayerHost is created using that CAContextID in another process, the
// content displayed by that CALayerHost will be the content of the CALayer
// that is set as the |layer| property on the CAContext.
@interface CAContext : NSObject
#if BUILDFLAG(IS_MAC)
+ (instancetype)contextWithCGSConnection:(CAContextID)contextId
                                 options:(NSDictionary*)optionsDict;
#endif  // BUILDFLAG(IS_MAC)
#if BUILDFLAG(IS_IOS)
+ (instancetype)remoteContextWithOptions:(NSDictionary*)optionsDict;
#endif  // BUILDFLAG(IS_IOS)
@property(readonly) CAContextID contextId;
@property(retain) CALayer *layer;
@end

// The CALayerHost is created in the process that will display the content
// being rendered by another process. Setting the |contextId| property on
// an object of this class will make this layer display the content of the
// CALayer that is set to the CAContext with that CAContextID in the layer
// sharing process.
@interface CALayerHost : CALayer
@property CAContextID contextId;
@end

#if BUILDFLAG(IS_IOS)

extern NSString* const kCAContextDisplayId;
extern NSString* const kCAContextIgnoresHitTest;

#endif  // BUILDFLAG(IS_IOS)

#endif  // __OBJC__

namespace ui {

// This function will check if all of the interfaces listed above are supported
// on the system, and return true if they are.
bool COMPONENT_EXPORT(UI_BASE) RemoteLayerAPISupported();

}  // namespace ui

#endif  // UI_BASE_COCOA_REMOTE_LAYER_API_H_