mcs/class/System.Drawing/System.Drawing/ImageAnimator.cs

   1 //
   2 // System.Drawing.ImageAnimator.cs
   3 //
   4 // Author:
   5 //   Dennis Hayes (dennish@Raytek.com)
   6 //   Sanjay Gupta (gsanjay@novell.com)
   7 //
   8 // (C) 2002 Ximian, Inc
   9 //
  10
  11 //
  12 // Copyright (C) 2004 Novell, Inc (http://www.novell.com)
  13 //
  14 // Permission is hereby granted, free of charge, to any person obtaining
  15 // a copy of this software and associated documentation files (the
  16 // "Software"), to deal in the Software without restriction, including
  17 // without limitation the rights to use, copy, modify, merge, publish,
  18 // distribute, sublicense, and/or sell copies of the Software, and to
  19 // permit persons to whom the Software is furnished to do so, subject to
  20 // the following conditions:
  21 //
  22 // The above copyright notice and this permission notice shall be
  23 // included in all copies or substantial portions of the Software.
  24 //
  25 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  26 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  27 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  28 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  29 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  30 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  31 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  32 //
  33 using System;
  34 using System.Drawing.Imaging;
  35 using System.Threading;
  36 using System.Collections;
  37
  38 namespace System.Drawing
  39 {
  40         //AnimateEventArgs class
  41         class AnimateEventArgs : EventArgs \r
  42         {  \r
  43                 private int frameCount;\r
  44                 private int activeFrameCount = 0;\r
  45                 private Thread thread;\r
  46       \r
  47                 //Constructor.\r
  48                 //\r
  49                 public AnimateEventArgs(Image img)\r
  50                 {\r
  51                         Guid[] dimensionList = img.FrameDimensionsList;
  52                         int length = dimensionList.Length;
  53                         for (int i=0; i<length; i++) {
  54                                 if (dimensionList [i].Equals(FrameDimension.Time.Guid))\r
  55                                         this.frameCount = img.GetFrameCount (FrameDimension.Time);
  56                         }                       \r
  57                 }\r
  58       \r
  59                 public int FrameCount {     \r
  60                         get { \r
  61                                 return frameCount;\r
  62                         }      \r
  63                 }\r
  64       \r
  65                 public int ActiveFrameCount {\r
  66                         get {\r
  67                                 return activeFrameCount;\r
  68                         }\r
  69 \r
  70                         set {\r
  71                                 activeFrameCount = value;\r
  72                         }\r
  73                 }\r
  74 \r
  75                 public Thread RunThread{\r
  76                         get {\r
  77                                 return thread;\r
  78                         }\r
  79 \r
  80                         set {\r
  81                                 thread = value;\r
  82                         }\r
  83                 }\r
  84         }\r
  85
  86         /// <summary>
  87         /// Summary description for ImageAnimator.
  88         /// </summary>
  89         ///
  90
  91         public sealed class ImageAnimator
  92         {
  93                 static Hashtable ht = new Hashtable ();
  94
  95                 private ImageAnimator ()
  96                 {
  97                         //
  98                         // TODO: Add constructor logic here
  99                         //
 100                 }
 101
 102                 public static void Animate (Image img, EventHandler onFrameChangeHandler)
 103                 {
 104                         if (img == null)
 105                                 throw new System.NullReferenceException ("Object reference not set to an instance of an object.");
 106
 107                         if (!ht.ContainsKey (img)) {
 108                                 AnimateEventArgs evtArgs = new AnimateEventArgs (img);
 109                                 WorkerThread WT = new WorkerThread(onFrameChangeHandler, evtArgs);
 110                                 ThreadStart TS = new ThreadStart(WT.LoopHandler);
 111                                 Thread thread = new Thread(TS);
 112                                 evtArgs.RunThread = thread;
 113                                 ht.Add (img, evtArgs);
 114
 115                                 thread.Start();
 116                         }
 117                 }
 118
 119                 public static bool CanAnimate (Image img)
 120                 {
 121                         //An image can animate if it has multiple frame in
 122                         //time based FrameDimension else return false
 123                         //Doubt what if the image has multiple frame in page
 124                         //based FrameDimension
 125                         if (img == null)
 126                                 return false;
 127
 128                         //Need to check whether i can do this without iterating
 129                         //within the FrameDimensionsList, ie just call GetFrameCount
 130                         //with parameter FrameDimension.Time
 131                         Guid[] dimensionList = img.FrameDimensionsList;
 132                         int length = dimensionList.Length;
 133                         int frameCount;
 134                         for (int i=0; i<length; i++) \r
 135                         {
 136                                 if (dimensionList [i].Equals(FrameDimension.Time.Guid)) \r
 137                                 {
 138                                         frameCount = img.GetFrameCount (FrameDimension.Time);
 139                                         if (frameCount > 1)
 140                                                 return true;
 141                                 }
 142                         }
 143
 144                         return false;           \r
 145                 }
 146
 147                 public static void StopAnimate (Image img, EventHandler onFrameChangeHandler)
 148                 {
 149                         if (img == null)
 150                                 throw new System.NullReferenceException ("Object reference not set to an instance of an object.");
 151
 152                         if (ht.ContainsKey (img)) {
 153                                 AnimateEventArgs evtArgs = (AnimateEventArgs) ht [img];
 154                                 evtArgs.RunThread.Abort ();
 155                                 ht.Remove (img);
 156                         }
 157                 }
 158
 159                 public static void UpdateFrames ()
 160                 {
 161                         foreach (Image img in ht.Keys) {
 162                                 UpdateFrames (img);
 163                         }
 164                 }
 165
 166                 public static void UpdateFrames (Image img)
 167                 {
 168                         if (img == null)
 169                                 throw new System.NullReferenceException ("Object reference not set to an instance of an object.");
 170
 171                         if (ht.ContainsKey (img)){
 172                                 //Need a way to get the delay during animation
 173                                 AnimateEventArgs evtArgs = (AnimateEventArgs) ht [img];
 174                                 if (evtArgs.ActiveFrameCount < evtArgs.FrameCount-1){
 175                                         evtArgs.ActiveFrameCount ++;
 176                                         img.SelectActiveFrame (FrameDimension.Time, evtArgs.ActiveFrameCount);
 177                                 } \r
 178                                 else
 179                                         evtArgs.ActiveFrameCount = 0;
 180                                 ht [img] = evtArgs;
 181                         }
 182                 }
 183         }
 184
 185         class WorkerThread
 186         {
 187                 private EventHandler frameChangeHandler;
 188                 private AnimateEventArgs animateEventArgs;
 189
 190                 public WorkerThread(EventHandler frmChgHandler, AnimateEventArgs aniEvtArgs)
 191                 {
 192                         frameChangeHandler = frmChgHandler;
 193                         animateEventArgs = aniEvtArgs;
 194                 }
 195
 196                 public void LoopHandler()
 197                 {
 198                         try
 199                         {
 200                                 while (true) {
 201                                         //Need a way to get the delay during animation
 202                                         Thread.Sleep (100);
 203                                         frameChangeHandler (null, animateEventArgs);\r
 204                                 }
 205                         }
 206                         catch(ThreadAbortException)
 207                         {
 208                                 //lets not bother ourselves with tae
 209                                 //it will be thrown anyway
 210                         }
 211                         catch(Exception er)
 212                         {
 213                                 throw er;
 214                         }
 215                 }
 216         }\r
 217 }