mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-04 03:40:45 +00:00
465abb1ded
* [License] Simplify the Texture license to be pure Apache 2 (removing ASDK-Licenses) With permission of the Facebook Open Source team, we are simplifying the Texture license so that clients can rely on the Apache 2 terms that most of Texture is already covered by. This means that code originally forked from AsyncDisplayKit will be re-licensed from "BSD 3-clause + PATENTS v2" to Apache 2 without a PATENTS file. After getting confirmation that the updates to these core files look good, we'll propagate this new license header to all files (in this same PR) and get sign-off from all parties before landing. * [License] Update all Texture source files to be pure Apache 2. * Changelog entry for Apache 2 license update. * Revert "[License] Update all Texture source files to be pure Apache 2." This reverts commit ffa0fbbba9717d871dd16c4b07539f2f8208fc2b. * [License] Update all Texture source files to be pure Apache 2, maintaining copyrights. * [License] Update CONTRIBUTING, README, Podspec & Dangerfile.
121 lines
4.0 KiB
Objective-C
121 lines
4.0 KiB
Objective-C
//
|
|
// ASPageTable.h
|
|
// Texture
|
|
//
|
|
// Copyright (c) Pinterest, Inc. All rights reserved.
|
|
// Licensed under Apache 2.0: http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
|
|
#import <Foundation/Foundation.h>
|
|
#import <UIKit/UIKit.h>
|
|
#import <AsyncDisplayKit/ASAssert.h>
|
|
#import <AsyncDisplayKit/ASBaseDefines.h>
|
|
|
|
@class ASCollectionElement;
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/**
|
|
* Represents x and y coordinates of a page.
|
|
*/
|
|
typedef uintptr_t ASPageCoordinate;
|
|
|
|
/**
|
|
* Returns a page coordinate with the given x and y values. Both of them must be less than 65,535.
|
|
*/
|
|
AS_EXTERN ASPageCoordinate ASPageCoordinateMake(uint16_t x, uint16_t y) AS_WARN_UNUSED_RESULT;
|
|
|
|
/**
|
|
* Returns coordinate of the page that contains the specified point.
|
|
* Similar to CGRectContainsPoint, a point is considered inside a page if its lie inside the page or on the minimum X or minimum Y edge.
|
|
*
|
|
* @param point The point that the page at the returned should contain. Any negative of the point will be corrected to 0.0
|
|
*
|
|
* @param pageSize The size of each page.
|
|
*/
|
|
AS_EXTERN ASPageCoordinate ASPageCoordinateForPageThatContainsPoint(CGPoint point, CGSize pageSize) AS_WARN_UNUSED_RESULT;
|
|
|
|
AS_EXTERN uint16_t ASPageCoordinateGetX(ASPageCoordinate pageCoordinate) AS_WARN_UNUSED_RESULT;
|
|
|
|
AS_EXTERN uint16_t ASPageCoordinateGetY(ASPageCoordinate pageCoordinate) AS_WARN_UNUSED_RESULT;
|
|
|
|
AS_EXTERN CGRect ASPageCoordinateGetPageRect(ASPageCoordinate pageCoordinate, CGSize pageSize) AS_WARN_UNUSED_RESULT;
|
|
|
|
/**
|
|
* Returns coordinate pointers for pages that intersect the specified rect. For each pointer, use ASPageCoordinateFromPointer() to get the original coordinate.
|
|
* The specified rect is restricted to the bounds of a content rect that has an origin of {0, 0} and a size of the given contentSize.
|
|
*
|
|
* @param rect The rect intersecting the target pages.
|
|
*
|
|
* @param contentSize The combined size of all pages.
|
|
*
|
|
* @param pageSize The size of each page.
|
|
*/
|
|
AS_EXTERN NSPointerArray * _Nullable ASPageCoordinatesForPagesThatIntersectRect(CGRect rect, CGSize contentSize, CGSize pageSize) AS_WARN_UNUSED_RESULT;
|
|
|
|
/**
|
|
* An alias for an NSMapTable created to store objects using ASPageCoordinates as keys.
|
|
*
|
|
* You should not call -objectForKey:, -setObject:forKey:, or -removeObjectForKey:
|
|
* on these objects.
|
|
*/
|
|
typedef NSMapTable ASPageTable;
|
|
|
|
/**
|
|
* A page to array of layout attributes table.
|
|
*/
|
|
typedef ASPageTable<id, NSMutableArray<UICollectionViewLayoutAttributes *> *> ASPageToLayoutAttributesTable;
|
|
|
|
/**
|
|
* A category for creating & using map tables meant for storing objects using ASPage as keys.
|
|
*/
|
|
@interface NSMapTable<id, ObjectType> (ASPageTableMethods)
|
|
|
|
/**
|
|
* Creates a new page table with (NSMapTableStrongMemory | NSMapTableObjectPointerPersonality) for values.
|
|
*/
|
|
+ (ASPageTable *)pageTableForStrongObjectPointers NS_RETURNS_RETAINED;
|
|
|
|
/**
|
|
* Creates a new page table with (NSMapTableWeakMemory | NSMapTableObjectPointerPersonality) for values.
|
|
*/
|
|
+ (ASPageTable *)pageTableForWeakObjectPointers NS_RETURNS_RETAINED;
|
|
|
|
/**
|
|
* Builds a new page to layout attributes from the given layout attributes.
|
|
*
|
|
* @param layoutAttributesEnumerator The layout attributes to build from
|
|
*
|
|
* @param contentSize The combined size of all pages.
|
|
*
|
|
* @param pageSize The size of each page.
|
|
*/
|
|
+ (ASPageToLayoutAttributesTable *)pageTableWithLayoutAttributes:(id<NSFastEnumeration>)layoutAttributesEnumerator contentSize:(CGSize)contentSize pageSize:(CGSize)pageSize NS_RETURNS_RETAINED;
|
|
|
|
/**
|
|
* Retrieves the object for a given page, or nil if the page is not found.
|
|
*
|
|
* @param page A page to lookup the object for.
|
|
*/
|
|
- (nullable ObjectType)objectForPage:(ASPageCoordinate)page;
|
|
|
|
/**
|
|
* Sets the given object for the associated page.
|
|
*
|
|
* @param object The object to store as value.
|
|
*
|
|
* @param page The page to use for the rect.
|
|
*/
|
|
- (void)setObject:(ObjectType)object forPage:(ASPageCoordinate)page;
|
|
|
|
/**
|
|
* Removes the object for the given page, if one exists.
|
|
*
|
|
* @param page The page to remove.
|
|
*/
|
|
- (void)removeObjectForPage:(ASPageCoordinate)page;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|