/core/externals/google-toolbox-for-mac/AppKit/GTMNSAnimation+Duration.h
http://macfuse.googlecode.com/ · C++ Header · 83 lines · 23 code · 14 blank · 46 comment · 0 complexity · b47127fc312146e55fab1b8337721780 MD5 · raw file
- //
- // GTMNSAnimation+Duration.h
- //
- // Copyright 2009 Google Inc.
- //
- // Licensed under the Apache License, Version 2.0 (the "License"); you may not
- // use this file except in compliance with the License. You may obtain a copy
- // of the License at
- //
- // http://www.apache.org/licenses/LICENSE-2.0
- //
- // Unless required by applicable law or agreed to in writing, software
- // distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
- // WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
- // License for the specific language governing permissions and limitations under
- // the License.
- //
- #import <AppKit/AppKit.h>
- #import "GTMDefines.h"
- // Given a "normal" duration for an animation, return what it should be based
- // on the current system state. For example, holding down the shift and/or
- // control keys modifies the normal duration for an animation making it slower.
- // Currently only modifies the duration if the current event is masked by
- // eventMask and only the control and/or shift modifiers are down.
- // The shift modifier is ignored if it is applied to a Tab key down.
- // Tab and shift-tab are often used for navigating around UI elements,
- // and in the majority of cases slowing down the animations while navigating
- // around UI elements is not desired.
- NSTimeInterval GTMModifyDurationBasedOnCurrentState(NSTimeInterval duration,
- NSUInteger eventMask);
- // The standard eventmask that you want for the methods in this file. Some apps
- // (eg Chrome) may not want to have animations fire on key strokes, so will use
- // just NSLeftMouseUpMask instead.
- extern const NSUInteger kGTMLeftMouseUpAndKeyDownMask;
- // Categories for changing the duration of an animation based on the current
- // event. Right now they track the state of the shift and control keys to slow
- // down animations similar to how minimize window animations occur.
- @interface NSAnimation (GTMNSAnimationDurationAdditions)
- // Note that using this initializer will set the duration of the animation
- // based on the current event when the animation is created. If the animation
- // is to be reused, the duration for the event should be reset with
- // gtm_setDuration each time the animation is started.
- // See notes for GTMModifyDurationBasedOnCurrentState for more info.
- - (id)gtm_initWithDuration:(NSTimeInterval)duration
- eventMask:(NSUInteger)eventMask
- animationCurve:(NSAnimationCurve)animationCurve;
- // Sets the duration by taking the duration passed in and calling
- // GTMModifyDurationBasedOnCurrentState to calculate the real duration.
- // See notes for GTMModifyDurationBasedOnCurrentState for more info.
- - (void)gtm_setDuration:(NSTimeInterval)duration
- eventMask:(NSUInteger)eventMask;
- @end
- #if MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_5
- #import <QuartzCore/QuartzCore.h>
- @interface NSAnimationContext (GTMNSAnimationDurationAdditions)
- // Sets the duration by taking the duration passed in and calling
- // GTMModifyDurationBasedOnCurrentState to calculate the real duration.
- // See notes for GTMModifyDurationBasedOnCurrentState for more info.
- - (void)gtm_setDuration:(NSTimeInterval)duration
- eventMask:(NSUInteger)eventMask;
- @end
- @interface CAAnimation (GTMCAAnimationDurationAdditions)
- // Sets the duration by taking the duration passed in and calling
- // GTMModifyDurationBasedOnCurrentState to calculate the real duration.
- // See notes for GTMModifyDurationBasedOnCurrentState for more info.
- - (void)gtm_setDuration:(CFTimeInterval)duration
- eventMask:(NSUInteger)events;
- @end
- #endif // MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_5