platform-api/src/com/intellij/util/ui/AnimatedIcon.java

   1 /*
   2  * Copyright 2000-2007 JetBrains s.r.o.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  * http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 package com.intellij.util.ui;
  18
  19 import com.intellij.openapi.Disposable;
  20
  21 import javax.swing.*;
  22 import java.awt.*;
  23
  24 public abstract class AnimatedIcon extends JComponent implements Disposable {
  25
  26   private Icon[] myIcons;
  27   private Dimension myPrefSize = new Dimension();
  28
  29   private int myCurrentIconIndex;
  30
  31   private Icon myPassiveIcon;
  32
  33   private Icon myEmptyPassiveIcon;
  34   private boolean myPaintPassive = true;
  35
  36   private boolean myRunning = true;
  37
  38   protected Animator myAnimator;
  39
  40   private final String myName;
  41
  42   private boolean myLastPaintWasRunning;
  43
  44   protected AnimatedIcon(final String name) {
  45     myName = name;
  46   }
  47
  48   protected final void init(Icon[] icons, Icon passiveIcon, int cycleLength, final int interCycleGap, final int maxRepeatCount) {
  49     myIcons = icons;
  50     myPassiveIcon = passiveIcon;
  51
  52     myPrefSize = new Dimension();
  53     for (Icon each : icons) {
  54       myPrefSize.width = Math.max(each.getIconWidth(), myPrefSize.width);
  55       myPrefSize.height = Math.max(each.getIconHeight(), myPrefSize.height);
  56     }
  57
  58     myPrefSize.width = Math.max(passiveIcon.getIconWidth(), myPrefSize.width);
  59     myPrefSize.height = Math.max(passiveIcon.getIconHeight(), myPrefSize.height);
  60
  61     UIUtil.removeQuaquaVisualMarginsIn(this);
  62
  63     myAnimator = new Animator(myName, icons.length, cycleLength, true, interCycleGap, maxRepeatCount) {
  64       public void paintNow(final float frame, final float totalFrames, final float cycle) {
  65         myCurrentIconIndex = (int)frame;
  66         paintImmediately(0, 0, getWidth(), getHeight());
  67       }
  68
  69       protected void onAnimationMaxCycleReached() throws InterruptedException {
  70         AnimatedIcon.this.onAnimationMaxCycleReached();
  71       }
  72
  73       public boolean isAnimated() {
  74         return AnimatedIcon.this.isAnimated();
  75       }
  76     };
  77
  78
  79     if (icons.length > 0) {
  80       myEmptyPassiveIcon = new EmptyIcon(icons[0]);
  81     } else {
  82       myEmptyPassiveIcon = new EmptyIcon(0);
  83     }
  84
  85     setOpaque(true);
  86   }
  87
  88   public void setPaintPassiveIcon(boolean paintPassive) {
  89     myPaintPassive = paintPassive;
  90   }
  91
  92   protected void onAnimationMaxCycleReached() throws InterruptedException {
  93
  94   }
  95
  96   public void resume() {
  97     myRunning = true;
  98     setOpaque(true);
  99     myAnimator.resume();
 100   }
 101
 102   public void addNotify() {
 103     super.addNotify();
 104     resume();
 105   }
 106
 107   public void removeNotify() {
 108     super.removeNotify();
 109     _suspend();
 110   }
 111
 112   public void suspend() {
 113     if (_suspend()) {
 114       repaint();
 115     }
 116   }
 117
 118   private boolean _suspend() {
 119     setOpaque(myPaintPassive);
 120
 121     if (myRunning || myAnimator.isRunning()) {
 122       myAnimator.suspend();
 123       myRunning = false;
 124       return true;
 125     } else {
 126       return false;
 127     }
 128   }
 129
 130   public void dispose() {
 131     myAnimator.dispose();
 132   }
 133
 134   public Dimension getPreferredSize() {
 135     final Insets insets = getInsets();
 136     return new Dimension(myPrefSize.width + insets.left + insets.right, myPrefSize.height + insets.top + insets.bottom);
 137   }
 138
 139   public Dimension getMinimumSize() {
 140     return getPreferredSize();
 141   }
 142
 143   public Dimension getMaximumSize() {
 144     return getPreferredSize();
 145   }
 146
 147   protected void paintComponent(Graphics g) {
 148     if (isOpaque() && (myAnimator.isRunning() || myPaintPassive || (myLastPaintWasRunning && !myAnimator.isRunning()))) {
 149       g.setColor(UIUtil.getBgFillColor(this));
 150       g.fillRect(0, 0, getWidth(), getHeight());
 151     }
 152
 153     Icon icon;
 154
 155     if (myAnimator.isRunning()) {
 156       icon = myIcons[myCurrentIconIndex];
 157     } else {
 158       icon = getPassiveIcon();
 159     }
 160
 161     final Dimension size = getSize();
 162     int x = (size.width - icon.getIconWidth()) / 2;
 163     int y = (size.height - icon.getIconHeight()) / 2;
 164
 165     icon.paintIcon(this, g, x, y);
 166
 167     myLastPaintWasRunning = myAnimator.isRunning();
 168   }
 169
 170   protected Icon getPassiveIcon() {
 171     return myPaintPassive ? myPassiveIcon : myEmptyPassiveIcon;
 172   }
 173
 174
 175   public boolean isAnimated() {
 176     return true;
 177   }
 178 }