Add 'submodules/AsyncDisplayKit/' from commit '02bedc12816e251ad71777f9d2578329b6d2bef6'

git-subtree-dir: submodules/AsyncDisplayKit
git-subtree-mainline: d06f423e0e
git-subtree-split: 02bedc1281

submodules/AsyncDisplayKit/Source/Private/TextExperiment/Component/ASTextDebugOption.h

@@ -0,0 +1,92 @@
+//
+//  ASTextDebugOption.h
+//  Texture
+//
+//  Copyright (c) Pinterest, Inc.  All rights reserved.
+//  Licensed under Apache 2.0: http://www.apache.org/licenses/LICENSE-2.0
+//
+
+#import <UIKit/UIKit.h>
+
+@class ASTextDebugOption;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ The ASTextDebugTarget protocol defines the method a debug target should implement.
+ A debug target can be add to the global container to receive the shared debug
+ option changed notification.
+ */
+@protocol ASTextDebugTarget <NSObject>
+
+@required
+/**
+ When the shared debug option changed, this method would be called on main thread.
+ It should return as quickly as possible. The option's property should not be changed
+ in this method.
+ 
+ @param option  The shared debug option.
+ */
+- (void)setDebugOption:(nullable ASTextDebugOption *)option;
+@end
+
+
+
+/**
+ The debug option for ASText.
+ */
+@interface ASTextDebugOption : NSObject <NSCopying>
+@property (nullable, nonatomic) UIColor *baselineColor;      ///< baseline color
+@property (nullable, nonatomic) UIColor *CTFrameBorderColor; ///< CTFrame path border color
+@property (nullable, nonatomic) UIColor *CTFrameFillColor;   ///< CTFrame path fill color
+@property (nullable, nonatomic) UIColor *CTLineBorderColor;  ///< CTLine bounds border color
+@property (nullable, nonatomic) UIColor *CTLineFillColor;    ///< CTLine bounds fill color
+@property (nullable, nonatomic) UIColor *CTLineNumberColor;  ///< CTLine line number color
+@property (nullable, nonatomic) UIColor *CTRunBorderColor;   ///< CTRun bounds border color
+@property (nullable, nonatomic) UIColor *CTRunFillColor;     ///< CTRun bounds fill color
+@property (nullable, nonatomic) UIColor *CTRunNumberColor;   ///< CTRun number color
+@property (nullable, nonatomic) UIColor *CGGlyphBorderColor; ///< CGGlyph bounds border color
+@property (nullable, nonatomic) UIColor *CGGlyphFillColor;   ///< CGGlyph bounds fill color
+
+- (BOOL)needDrawDebug; ///< `YES`: at least one debug color is visible. `NO`: all debug color is invisible/nil.
+- (void)clear; ///< Set all debug color to nil.
+
+/**
+ Add a debug target.
+ 
+ @discussion When `setSharedDebugOption:` is called, all added debug target will
+ receive `setDebugOption:` in main thread. It maintains an unsafe_unretained
+ reference to this target. The target must to removed before dealloc.
+ 
+ @param target A debug target.
+ */
++ (void)addDebugTarget:(id<ASTextDebugTarget>)target;
+
+/**
+ Remove a debug target which is added by `addDebugTarget:`.
+ 
+ @param target A debug target.
+ */
++ (void)removeDebugTarget:(id<ASTextDebugTarget>)target;
+
+/**
+ Returns the shared debug option.
+ 
+ @return The shared debug option, default is nil.
+ */
++ (nullable ASTextDebugOption *)sharedDebugOption;
+
+/**
+ Set a debug option as shared debug option.
+ This method must be called on main thread.
+ 
+ @discussion When call this method, the new option will set to all debug target
+ which is added by `addDebugTarget:`.
+ 
+ @param option  A new debug option (nil is valid).
+ */
++ (void)setSharedDebugOption:(nullable ASTextDebugOption *)option;
+
+@end
+
+NS_ASSUME_NONNULL_END