//
//  UICollisionBehavior.h
//  UIKit
//
//  Copyright (c) 2012-2015 Apple Inc. All rights reserved.
//

#import <Foundation/Foundation.h>
#import <UIKit/UIView.h>
#import <UIKit/UIBezierPath.h>
#import <UIKit/UIDynamicBehavior.h>

NS_ASSUME_NONNULL_BEGIN

@class UICollisionBehavior;

// 碰撞的模式（碰撞邊緣的類型）
typedef NS_OPTIONS(NSUInteger, UICollisionBehaviorMode) {
    UICollisionBehaviorModeItems        = 1 << 0,           // items 相互碰撞两残，沒有指定碰撞的邊界
    UICollisionBehaviorModeBoundaries   = 1 << 1,          // 指定了碰撞的邊界檐盟，沒有 items 的相互碰撞
    UICollisionBehaviorModeEverything   = NSUIntegerMax    // 指定了碰撞邊界 和 items 的相互碰撞 （這個(gè)是默認(rèn)值）
} NS_ENUM_AVAILABLE_IOS(7_0);



// 碰撞行為的代理
@protocol UICollisionBehaviorDelegate <NSObject>
@optional

// 處理 items 之間的碰撞
- (void)collisionBehavior:(UICollisionBehavior *)behavior beganContactForItem:(id <UIDynamicItem>)item1 withItem:(id <UIDynamicItem>)item2 atPoint:(CGPoint)p;
- (void)collisionBehavior:(UICollisionBehavior *)behavior endedContactForItem:(id <UIDynamicItem>)item1 withItem:(id <UIDynamicItem>)item2;


//  items 和   boundary 之間的碰撞
// The identifier of a boundary created with translatesReferenceBoundsIntoBoundary or setTranslatesReferenceBoundsIntoBoundaryWithInsets is nil
// 通過 translatesReferenceBoundsIntoBoundary 和 setTranslatesReferenceBoundsIntoBoundaryWithInsets 創(chuàng)建的碰撞邊界的標(biāo)識(shí)是 nil 
- (void)collisionBehavior:(UICollisionBehavior*)behavior beganContactForItem:(id <UIDynamicItem>)item withBoundaryIdentifier:(nullable id <NSCopying>)identifier atPoint:(CGPoint)p;
- (void)collisionBehavior:(UICollisionBehavior*)behavior endedContactForItem:(id <UIDynamicItem>)item withBoundaryIdentifier:(nullable id <NSCopying>)identifier;

@end

    


// 碰撞行為
NS_CLASS_AVAILABLE_IOS(7_0) @interface UICollisionBehavior : UIDynamicBehavior

// 通過一個(gè) items 數(shù)組來實(shí)例化一個(gè) 碰撞行為
- (instancetype)initWithItems:(NSArray<id <UIDynamicItem>> *)items NS_DESIGNATED_INITIALIZER;

// 在實(shí)例化碰撞行為對象后 添加 items
- (void)addItem:(id <UIDynamicItem>)item;

// 移除已經(jīng)存在的 items
- (void)removeItem:(id <UIDynamicItem>)item;

// 獲取所有的 items
@property (nonatomic, readonly, copy) NSArray<id <UIDynamicItem>> *items;

// 碰撞行為的模式 （默認(rèn)值 UICollisionBehaviorModeEverything ）
@property (nonatomic, readwrite) UICollisionBehaviorMode collisionMode;

// 轉(zhuǎn)換 animator 引用的 View 的 bounds 作為碰撞的 bounds 爹耗。做的是一個(gè)簡單的 激活操作
@property (nonatomic, readwrite) BOOL translatesReferenceBoundsIntoBoundary;

//  轉(zhuǎn)換 animator 引用的 View 的 bounds 作為碰撞的 bounds , 并根據(jù) View 的 bounds 設(shè)置內(nèi)邊距朴爬。（和上面的屬性是一個(gè)效果峻呕，多了一個(gè)設(shè)置內(nèi)邊距的效果）
/*
使用這個(gè)方法會(huì)產(chǎn)生的影響：
1. animator 引用的 View 的 bounds, 碰撞范圍是引用 view 的 bounds。
2. animator 引用的 collection view 的 bounds， collection view layout 的引用的 bounds
3. 引用的 item 的時(shí)候，是沒有碰撞邊距的若贮。
*/
- (void)setTranslatesReferenceBoundsIntoBoundaryWithInsets:(UIEdgeInsets)insets;


// 通過指定一個(gè)貝塞爾路徑的方式來添加碰撞邊界
/*
*      * identifier：   碰撞邊界的范圍省有。
*      * bezierPath： 碰撞邊界的路徑
*      路徑的原點(diǎn)和坐標(biāo)系依靠的是實(shí)例化的 animator 
*/
- (void)addBoundaryWithIdentifier:(id <NSCopying>)identifier forPath:(UIBezierPath *)bezierPath;

// 通過兩個(gè)點(diǎn)來確定碰撞邊界 （這是一個(gè)方便的方法基于addBoundaryWithIdentifier:forPath:方法痒留。）
/*
*     * fromPoint :  開始的點(diǎn)
*     * toPoint ： 結(jié)束點(diǎn)
*/
- (void)addBoundaryWithIdentifier:(id <NSCopying>)identifier fromPoint:(CGPoint)p1 toPoint:(CGPoint)p2;

// 通過一個(gè) 標(biāo)識(shí)來獲取邊界的貝塞爾路徑
- (nullable UIBezierPath *)boundaryWithIdentifier:(id <NSCopying>)identifier;

// 通過標(biāo)識(shí)來移除貝塞爾路徑
- (void)removeBoundaryWithIdentifier:(id <NSCopying>)identifier;

// 獲取所有的碰撞路徑的標(biāo)識(shí)
@property (nullable, nonatomic, readonly, copy) NSArray<id <NSCopying>> *boundaryIdentifiers;

// 移除所有的碰撞路徑
- (void)removeAllBoundaries;


// 碰撞路徑的代理
@property (nullable, nonatomic, weak, readwrite) id <UICollisionBehaviorDelegate> collisionDelegate;

@end

NS_ASSUME_NONNULL_END