//
// The MIT License (MIT)
//
// Copyright (c) 2013 Backelite
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.

#import <UIKit/UIKit.h>

/**
 * Object to customize blurry background
 */
@interface BKTBlurParameters : NSObject
/**
 *  Property to customize background view alpha.
 */
@property (assign, nonatomic) CGFloat alpha;
/**
 *  Property to customize background view blur radius.
 */
@property (assign, nonatomic) CGFloat radius;
/**
 *  Property to customize background view blur saturation factor.
 *  A value of 1.0 is neutral. Below it is desaturated and above it is more saturated.
 */
@property (assign, nonatomic) CGFloat saturationDeltaFactor;
/**
 *  Property to customize blur tint color. Default is clear color.
 */
@property (strong, nonatomic) UIColor *tintColor;

@end

/**
 *  Transition styles available when presenting popin view controllers.
 *  @since v1.0
 */
typedef NS_ENUM(NSInteger, BKTPopinTransitionStyle) {
    /**
     *  When the view controller is presented, its view slide in the parent view controller and slide out on dismiss
     */
    BKTPopinTransitionStyleSlide,
    /**
     *  When the view controller is presented, its view fade in and fade out on dismiss. Transition direction is ignored for this kind of transition.
     */
    BKTPopinTransitionStyleCrossDissolve,
    /**
     *  When the view controller is presented, its view fade in with a zoom out effect and fade out with a zoom in effect on dismiss. Transition direction is ignored for this kind of transition.
     */
    BKTPopinTransitionStyleZoom,
    /**
     *  When the view controller is presented, its view slide in with a bounce effect and slide out on dismiss.
     */
    BKTPopinTransitionStyleSpringySlide,
    /**
     *  When the view controller is presented, its view zoom and fade in with a bounce effect. Transition direction is ignored for this kind of transition.
     */
    BKTPopinTransitionStyleSpringyZoom,
    /**
     *  When the view controller is presented, its view has a undefined behavior.
     */
    //UIDynamics transition styles
    BKTPopinTransitionStyleSnap,
    /**
     *  When the view controller is presented, its view has a custom animation.
     */
    BKTPopinTransitionStyleCustom
};

/**
 *  Transition direction when presenting popins. Default is BKTPopinTransitionDirectionBottom.
 *  @since v1.0
 */
typedef NS_ENUM(NSInteger, BKTPopinTransitionDirection) {
    /**
     *  Presentation transition will start from the bottom of the parent view. Respectively, dismiss transition will end to the bottom of the parent view.
     */
    BKTPopinTransitionDirectionBottom = 0,
    /**
     *  Presentation transition will start from the top of the parent view. Respectively, dismiss transition will end to the top of the parent view.
     */
    BKTPopinTransitionDirectionTop,
    /**
     *  Presentation transition will start from the left of the parent view. Respectively, dismiss transition will end to the left of the parent view.
     */
    BKTPopinTransitionDirectionLeft,
    /**
     *  Presentation transition will start from the right of the parent view. Respectively, dismiss transition will end to the right of the parent view.
     */
    BKTPopinTransitionDirectionRight
};

/**
 *  Options to configure popin behavior to user related events. The following options are compoundables.
 *  @since v1.0
 */
typedef NS_OPTIONS(NSUInteger, BKTPopinOption) {
    /**
     *  Default behaviour
     */
    BKTPopinDefault = 0,
    /**
     *  Disable popin reaction to keyboard notifications
     */
    BKTPopinIgnoreKeyboardNotification = 1 << 0,
    /**
     *  Disable auto dismiss when touching outside of the popin view
     */
    BKTPopinDisableAutoDismiss = 1 << 1,
    /**
     *  Takes a screenshot of presenting view, blurs it and uses it as dimming view. Available only on ios 7.x.
     */
    BKTPopinBlurryDimmingView = 1 << 2,
    /**
     *  Disable parallax effect on iOS7
     */
    BKTPopinDisableParallaxEffect = 1 << 3,
    /**
     *  Set a background dimming view with a clear color. Default is a semi-transparent black background
     */
    BKTPopinDimmingViewStyleNone = 1 << 16,
};

/**
 *  Options to quickly configure popin alignment in its container. Default is centered.
 *  @see -popinAlignement
 *  @since v1.3
 */
typedef NS_ENUM(NSInteger, BKTPopinAlignementOption) {
    /**
     *  Popin will be centered in container
     */
    BKTPopinAlignementOptionCentered = 0,
    /**
     *  Popin will be stuck to top in container
     */
    BKTPopinAlignementOptionUp       = 1,
    /**
     *  Popin will be left-aligned in container
     */
    BKTPopinAlignementOptionLeft     = 2,
    /**
     *  Default will be stuck to bottom in container
     */
    BKTPopinAlignementOptionDown     = 3,
    /**
     *  Popin will be right-aligned in container
     */
    BKTPopinAlignementOptionRight    = 4
};

/**
 * `MaryPopin` is a category allowing modal-like presentation of view controllers but with more configuration options.
 * Configuration options include popin size, transition style, transition direction, response to keyboard notifications and auto dismiss.
 * @since v1.0
 */
@interface UIViewController (MaryPopin) <UIDynamicAnimatorDelegate>

///---------------------
/// @name Presentation and dismiss
///---------------------

/**
 *  Present a popin controller as a child of the receiver. By default the popin keep its size when presented. If it is bigger than parent controller, the popin is resized to fit inside its parent.
 *
 *  @param popinController The controller to present as a popin.
 *  @param animated        Pass `YES` to animate the presentation. Otherwise, pass `NO`.
 *  @param completion      A completion handler, or `NULL`.
 *  @see -presentPopinController:fromRect:animated:completion:
 *  @since v1.0
 */
- (void)presentPopinController:(UIViewController *)popinController animated:(BOOL)animated
                    completion:(void(^)(void))completion;

/**
 *  Present a popin controller as a child of the receiver, centered inside an arbitrary rect.
 *
 *  @param popinController The controller to present as a popin.
 *  @param rect            An arbitrary rect in which the popin should be centered.
 *  @param animated        Pass `YES` to animate the presentation. Otherwise, pass `NO`.
 *  @param completion      A completion handler, or `NULL`.
 *  @since v1.0
 */
- (void)presentPopinController:(UIViewController *)popinController fromRect:(CGRect)rect animated:(BOOL)animated
                    completion:(void(^)(void))completion;

/**
 *  Dismiss the visible popin if any.
 *
 *  @param animated Pass `YES` to animate the dismiss. Otherwise, pass `NO`.
 *  @see dismissCurrentPopinControllerAnimated:completion:
 *  @since v1.0
 */
- (void)dismissCurrentPopinControllerAnimated:(BOOL)animated;

/**
 *  Dismiss the visible popin if any.
 *
 *  @param animated   Pass `YES` to animate the dismiss. Otherwise, pass `NO`.
 *  @param completion A completion handler, or `NULL`.
 *  @since v1.0
 */
- (void)dismissCurrentPopinControllerAnimated:(BOOL)animated completion:(void(^)(void))completion;

///---------------------
/// @name Properties accessors
///---------------------

/**
 *  A reference to the popin presented as a child controller.
 *
 *  @return The controller presented as a popin or `nil`.
 *  @see -presentingPopinViewController
 *  @since v1.0
 */
- (UIViewController *)presentedPopinViewController;

/**
 *  A reference to the parent presenting the popin.
 *
 *  @return The controller presenting the popin, or `nil`.
 *  @see -presentedPopinViewController
 *  @since v1.0
 */
- (UIViewController *)presentingPopinViewController;

/**
 *  Get desired size for popin.
 *
 *  @return The desired size for this controller when presented as a popin. Or `CGSizeZero` if not set.
 *  @see -setPreferedPopinContentSize:
 *  @since v1.0
 */
- (CGSize)preferedPopinContentSize;

/**
 *  Set the desired size for popin. This value may not be respected if popin is bigger than the presenting controller view.
 *  If not set, the default size will be the controller view size.
 *
 *  @param preferredSize The desired size for this controller when presented as a popin.
 *  @since v1.0
 */
- (void)setPreferedPopinContentSize:(CGSize)preferredSize;

/**
 *  The transition style to use when presenting a popin. Default value is `BKTPopinTransitionStyleSlide`.
 *
 *  @return A BKTPopinTransitionStyle value.
 *  @see -setPopinTransitionStyle:
 *  @since v1.0
 */
- (BKTPopinTransitionStyle)popinTransitionStyle;

/**
 *  The transition style to use when presenting a popin. For a list of possible transition style, see `BKTPopinTransitionStyle`.
 *
 *  @param transitionStyle A BKTPopinTransitionStyle value.
 *  @since v1.0
 */
- (void)setPopinTransitionStyle:(BKTPopinTransitionStyle)transitionStyle;

/**
 *  The transition direction to use when presenting a popin. Default value is `BKTPopinTransitionDirectionBottom`.
 *
 *  @return A BKTPopinTransitionDirection value.
 *  @see -setPopinTransitionDirection:
 *  @since v1.0
 */
- (BKTPopinTransitionDirection)popinTransitionDirection;

/**
 *  The transition direction to use when presenting a popin. For a list of possible transition direction, see BKTPopinTransitionDirection
 *
 *  @param transitionDirection A BKTPopinTransitionDirection value.
 *  @since v1.0
 */
- (void)setPopinTransitionDirection:(BKTPopinTransitionDirection)transitionDirection;

/**
 *  The options to apply to the popin. Default value is `BKTPopinDefault`.
 *
 *  @return The BKTPopinOption values as a bit field.
 *  @see -setPopinOptions:
 *  @since v1.0
 */
- (BKTPopinOption)popinOptions;

/**
 *  The options to apply to the popin. For a list of possible options, see BKTPopinOption
 *
 *  @param popinOptions The BKTPopinOption values separated by | character.
 *  @since v1.0
 */
- (void)setPopinOptions:(BKTPopinOption)popinOptions;


/**
 *  Get the custom in animation block. Default value is nil.
 *
 *  @return The In animation block.
 *  @see -setPopinCustomInAnimation:
 *  @since v1.3
 */
- (void (^)(UIViewController * popinController,CGRect initialFrame,CGRect finalFrame))popinCustomInAnimation;

/**
 *  The popinCustomAnimation let you pass an custom in animation. The popInController frame must be the finalFrame in the end of the animation.
 *
 *  @param customInAnimation The Block with animation.
 *  @since v1.3
 */
- (void)setPopinCustomInAnimation:(void (^)(UIViewController * popinController,CGRect initialFrame,CGRect finalFrame))customInAnimation;

/**
 *  Get the custom out animation block. Default value is nil.
 *
 *  @return The Out animation block.
 *  @see -setPopinCustomOutAnimation:
 *  @since v1.3
 */
- (void (^)(UIViewController * popinController,CGRect initialFrame,CGRect finalFrame))popinCustomOutAnimation;

/**
 *  The popinCustomOutAnimation let's you pass an custom out animation. The popInController frame must be the finalFrame in the end of the animation.
 *
 *  @param customOutAnimation The Block with animation.
 *  @since v1.3
 */
- (void)setPopinCustomOutAnimation:(void (^)(UIViewController * popinController,CGRect initialFrame,CGRect finalFrame))customOutAnimation;

/**
 *  The options to apply to the popin. Default value is `BKTPopinAlignementOptionCentered`.
 *
 *  @return The BKTPopinAlignementOption values as a bit field.
 *  @see -setPopinAlignement:
 *  @since v1.3
 */
- (BKTPopinAlignementOption)popinAlignment;

/**
 *  The options to apply to the popin. For a list of possible options, see BKTPopinAlignementOption
 *
 *  @param popinAlignement The BKTPopinAlignementOption values separated by | character.
 *  @since v1.3
 */
- (void)setPopinAlignment:(BKTPopinAlignementOption)popinAlignment;

/**
 *  An object used to configure the blurred background.
 *
 *  @return The blur parameters object.
 *  @see -setBlurParameters:
 *  @since v1.4
 */
- (BKTBlurParameters *)blurParameters;

/**
 *  An object used to configure the blurred background.
 *
 *  @param blurParameters The blur parameters object.
 *  @sicne v1.4
 */
- (void)setBlurParameters:(BKTBlurParameters *)blurParameters;

@end
// 版权属于原作者
// http://code4app.com (cn) http://code4app.net (en)
// 发布代码于最专业的源码分享网站: Code4App.com// 版权属于原作者
// http://code4app.com (cn) http://code4app.net (en)
// 发布代码于最专业的源码分享网站: Code4App.com// 版权属于原作者
// http://code4app.com (cn) http://code4app.net (en)
// 发布代码于最专业的源码分享网站: Code4App.com