Implement 3-stage minimize animation for Panels on OSX.

chrome/browser/ui/panels/panel_window_controller_cocoa.mm

 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #include "chrome/browser/ui/panels/panel_window_controller_cocoa.h"
 
 #import <Cocoa/Cocoa.h>
 
 #include "base/logging.h"
 #include "base/mac/mac_util.h"
@@ skipping 410 matching lines @@
   [[[[self window] contentView] superview]
       addTrackingArea:windowTrackingArea_.get()];
 
   if (!animateOnBoundsChange_) {
     [[self window] setFrame:frame display:YES animate:NO];
     return;
   }
   // Will be enabled back in animationDidEnd callback.
   [self disableTabContentsViewAutosizing];
 
+  // Terminate previous animation, if it is still playing.
+  [self terminateBoundsAnimation];
+
   NSDictionary *windowResize = [NSDictionary dictionaryWithObjectsAndKeys:
       [self window], NSViewAnimationTargetKey,
       [NSValue valueWithRect:frame], NSViewAnimationEndFrameKey, nil];
 
   NSArray *animations = [NSArray arrayWithObjects:windowResize, nil];
 
-  // Terminate previous animation, if it is still playing.
-  [self terminateBoundsAnimation];
   boundsAnimation_ =
       [[NSViewAnimation alloc] initWithViewAnimations:animations];
   [boundsAnimation_ setDelegate:self];
 
-  [boundsAnimation_ setAnimationBlockingMode: NSAnimationNonblocking];
-
   NSRect currentFrame = [[self window] frame];
   // Compute duration. We use constant speed of animation, however if the change
   // is too large, we clip the duration (effectively increasing speed) to
   // limit total duration of animation. This makes 'small' transitions fast.
   // 'distance' is the max travel between 4 potentially traveling corners.
   double distanceX = std::max(abs(NSMinX(currentFrame) - NSMinX(frame)),
                               abs(NSMaxX(currentFrame) - NSMaxX(frame)));
   double distanceY = std::max(abs(NSMinY(currentFrame) - NSMinY(frame)),
                               abs(NSMaxY(currentFrame) - NSMaxY(frame)));
   double distance = std::max(distanceX, distanceY);
   double duration = std::min(distance / kBoundsAnimationSpeedPixelsPerSecond,
                              kBoundsAnimationMaxDurationSeconds);
+  // Detect animation that happens when expansion state is set to MINIMIZED
+  // and there is relatively big portion of the panel to hide from view.
+  // Initialize animation differently in this case, using fast-pause-slow
+  // method, see below for more details.
+  if (windowShim_->panel()->expansion_state() == Panel::MINIMIZED) {
+    float titlebarToFrameProportion =
+        (windowShim_->TitleOnlyHeight() - NSHeight(frame)) / distanceY;

[jianli, 2011/12/02 06:18:32]

Is NSHeight(frame) for the height of the expanded panel? If so,
titlebarToFrameProportion seens to be a negative value.

[Dmitry Titov, 2011/12/02 06:47:10]

The |frame| here is a new frame, since we are minimizing it's 4-px one. The
|currentFrame| is the previous one.

I need to subtract the new frame to obtain exact ratio when stopped animation
would only show the titlebar. Updated name of variable in hope to be more
descriptive.

+    if (titlebarToFrameProportion < 0.3) {  // Relatively big movement.
+      playingMinimizeAnimation_ = YES;
+      animationSpeedThreshold_ = 1.0 - titlebarToFrameProportion;
+      duration = 1.5;
+    }
+  }
   [boundsAnimation_ setDuration: duration];
+  [boundsAnimation_ setFrameRate:0.0];
+  [boundsAnimation_ setAnimationBlockingMode: NSAnimationNonblocking];
   [boundsAnimation_ startAnimation];
 }
 
+- (float)animation:(NSAnimation*)animation
+  valueForProgress:(NSAnimationProgress)progress {
+  if (!playingMinimizeAnimation_) {
+    // Cubic easing out.
+    float value = 1.0 - progress;
+    return 1.0 - value * value * value;
+  }
+
+  // Minimize animation:
+  // 1. Quickly (0 -> 0.15) make only titlebar visible.
+  // 2. Stay a little bit (0.15->0.6) in place, just showing titlebar.
+  // 3. Slowly minimize to thin strip (0.6->1.0)
+  const float kAnimationStopAfterQuickDecrease = 0.15;
+  const float kAnimationStopAfterShowingTitlebar = 0.6;
+  float value;
+  if (progress <= kAnimationStopAfterQuickDecrease)

[jianli, 2011/12/02 06:18:32]

nit: better to add brackets.

[Dmitry Titov, 2011/12/02 06:47:10]

Done.

+    value =
+        progress * animationSpeedThreshold_ / kAnimationStopAfterQuickDecrease;
+  else if (progress <= kAnimationStopAfterShowingTitlebar)
+    value = animationSpeedThreshold_;
+  else
+    value = animationSpeedThreshold_ +
+        (progress - kAnimationStopAfterShowingTitlebar) *
+        (1.0 - animationSpeedThreshold_) /
+        (1.0 - kAnimationStopAfterShowingTitlebar);
+  return value;
+}
+
 - (void)animationDidEnd:(NSAnimation*)animation {
+  playingMinimizeAnimation_ = NO;
   if (windowShim_->panel()->expansion_state() == Panel::EXPANDED)
     [self enableTabContentsViewAutosizing];
 
   content::NotificationService::current()->Notify(
       chrome::NOTIFICATION_PANEL_BOUNDS_ANIMATIONS_FINISHED,
       content::Source<Panel>(windowShim_->panel()),
       content::NotificationService::NoDetails());
 }
 
 - (void)terminateBoundsAnimation {
@@ skipping 97 matching lines @@
 - (BOOL)canBecomeKeyWindow {
   // Panel can only gain focus if it is expanded. Minimized panels do not
   // participate in Cmd-~ rotation.
   // TODO(dimich): If it will be ever desired to expand/focus the Panel on
   // keyboard navigation or via main menu, the care should be taken to avoid
   // cases when minimized Panel is getting keyboard input, invisibly.
   return windowShim_->panel()->expansion_state() == Panel::EXPANDED;
 }
 
 @end