mirror of
https://github.com/TextureGroup/Texture.git
synced 2026-04-07 19:17:39 +00:00
Greg Bolsinga
a8540029e8
Build a test that fires up 2000 threads to instantiate `ASTextKitContext` both with and without the global lock. Both pass down to iOS10 in the simulator. See #1455 for more.
66 lines
2.6 KiB
Objective-C
66 lines
2.6 KiB
Objective-C
//
|
|
// ASTextKitContext.h
|
|
// Texture
|
|
//
|
|
// Copyright (c) Facebook, Inc. and its affiliates. All rights reserved.
|
|
// Changes after 4/13/2017 are: Copyright (c) Pinterest, Inc. All rights reserved.
|
|
// Licensed under Apache 2.0: http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
|
|
#import <UIKit/UIKit.h>
|
|
|
|
#import <AsyncDisplayKit/ASAvailability.h>
|
|
|
|
#if AS_ENABLE_TEXTNODE
|
|
|
|
#import <AsyncDisplayKit/ASBaseDefines.h>
|
|
|
|
/**
|
|
A threadsafe container for the TextKit components that ASTextKit uses to lay out and truncate its text.
|
|
|
|
This container is the sole owner and manager of the TextKit classes. This is an important model because of major
|
|
thread safety issues inside vanilla TextKit. It provides a central locking location for accessing TextKit methods.
|
|
*/
|
|
AS_SUBCLASSING_RESTRICTED
|
|
@interface ASTextKitContext : NSObject
|
|
|
|
/**
|
|
Initializes a context and its associated TextKit components.
|
|
|
|
Initialization of TextKit components is a globally locking operation so be careful of bottlenecks with this class.
|
|
*/
|
|
- (instancetype)initWithAttributedString:(NSAttributedString *)attributedString
|
|
tintColor:(UIColor *)tintColor
|
|
lineBreakMode:(NSLineBreakMode)lineBreakMode
|
|
maximumNumberOfLines:(NSUInteger)maximumNumberOfLines
|
|
exclusionPaths:(NSArray *)exclusionPaths
|
|
constrainedSize:(CGSize)constrainedSize;
|
|
|
|
/**
|
|
Exposed for testing purposes only.
|
|
*/
|
|
- (instancetype)initWithAttributedString:(NSAttributedString *)attributedString
|
|
tintColor:(UIColor *)tintColor
|
|
lineBreakMode:(NSLineBreakMode)lineBreakMode
|
|
maximumNumberOfLines:(NSUInteger)maximumNumberOfLines
|
|
exclusionPaths:(NSArray *)exclusionPaths
|
|
constrainedSize:(CGSize)constrainedSize
|
|
enableGlobalLock:(BOOL)enableGlobalLock;
|
|
|
|
/**
|
|
All operations on TextKit values MUST occur within this locked context. Simultaneous access (even non-mutative) to
|
|
TextKit components may cause crashes.
|
|
|
|
The block provided MUST not call out to client code from within its scope or it is possible for this to cause deadlocks
|
|
in your application. Use with EXTREME care.
|
|
|
|
Callers MUST NOT keep a ref to these internal objects and use them later. This WILL cause crashes in your application.
|
|
*/
|
|
- (void)performBlockWithLockedTextKitComponents:(AS_NOESCAPE void (^)(NSLayoutManager *layoutManager,
|
|
NSTextStorage *textStorage,
|
|
NSTextContainer *textContainer))block;
|
|
|
|
@end
|
|
|
|
#endif
|