OLD | NEW |
1 /* | 1 /* |
2 * Copyright (C) 2008 Apple Inc. All Rights Reserved. | 2 * Copyright (C) 2015 Google Inc. All rights reserved. |
3 * | 3 * |
4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
5 * modification, are permitted provided that the following conditions | 5 * modification, are permitted provided that the following conditions |
6 * are met: | 6 * are met: |
7 * 1. Redistributions of source code must retain the above copyright | 7 * 1. Redistributions of source code must retain the above copyright |
8 * notice, this list of conditions and the following disclaimer. | 8 * notice, this list of conditions and the following disclaimer. |
9 * 2. Redistributions in binary form must reproduce the above copyright | 9 * 2. Redistributions in binary form must reproduce the above copyright |
10 * notice, this list of conditions and the following disclaimer in the | 10 * notice, this list of conditions and the following disclaimer in the |
11 * documentation and/or other materials provided with the distribution. | 11 * documentation and/or other materials provided with the distribution. |
12 * | 12 * |
13 * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY | 13 * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY |
14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | 14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | 15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
16 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR | 16 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR |
17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, | 17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, |
18 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, | 18 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
19 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR | 19 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
20 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY | 20 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY |
21 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | 21 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | 22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
24 * | |
25 */ | 24 */ |
26 | 25 |
27 #ifndef ActiveDOMObject_h | 26 #ifndef ImageAnimation_h |
28 #define ActiveDOMObject_h | 27 #define ImageAnimation_h |
29 | |
30 #include "core/dom/ContextLifecycleObserver.h" | |
31 #include "wtf/Assertions.h" | |
32 | 28 |
33 namespace blink { | 29 namespace blink { |
34 | 30 |
35 class ActiveDOMObject : public ContextLifecycleObserver { | 31 // GIF and WebP support animation. The explanation below is in terms of GIF, |
36 public: | 32 // but the same constants are used for WebP, too. |
37 ActiveDOMObject(ExecutionContext*); | 33 // GIFs have an optional 16-bit unsigned loop count that describes how an |
38 | 34 // animated GIF should be cycled. If the loop count is absent, the animation |
39 // suspendIfNeeded() should be called exactly once after object construction
to synchronize | 35 // cycles once; if it is 0, the animation cycles infinitely; otherwise the |
40 // the suspend state with that in ExecutionContext. | 36 // animation plays n + 1 cycles (where n is the specified loop count). If the |
41 void suspendIfNeeded(); | 37 // GIF decoder defaults to cAnimationLoopOnce in the absence of any loop count |
42 #if ENABLE(ASSERT) | 38 // and translates an explicit "0" loop count to cAnimationLoopInfinite, then we |
43 bool suspendIfNeededCalled() const { return m_suspendIfNeededCalled; } | 39 // get a couple of nice side effects: |
44 #endif | 40 // * By making cAnimationLoopOnce be 0, we allow the animation cycling code in |
45 | 41 // BitmapImage.cpp to avoid special-casing it, and simply treat all |
46 // Should return true if there's any pending asynchronous activity, and so | 42 // non-negative loop counts identically. |
47 // this object must not be garbage collected. | 43 // * By making the other two constants negative, we avoid conflicts with any |
48 virtual bool hasPendingActivity() const; | 44 // real loop count values. |
49 | 45 const int cAnimationLoopOnce = 0; |
50 // These methods have an empty default implementation so that subclasses | 46 const int cAnimationLoopInfinite = -1; |
51 // which don't need special treatment can skip implementation. | 47 const int cAnimationNone = -2; |
52 virtual void suspend(); | |
53 virtual void resume(); | |
54 virtual void stop(); | |
55 | |
56 void didMoveToNewExecutionContext(ExecutionContext*); | |
57 | |
58 protected: | |
59 virtual ~ActiveDOMObject(); | |
60 | |
61 private: | |
62 #if ENABLE(ASSERT) | |
63 bool m_suspendIfNeededCalled; | |
64 #endif | |
65 }; | |
66 | 48 |
67 } // namespace blink | 49 } // namespace blink |
68 | 50 |
69 #endif // ActiveDOMObject_h | 51 #endif |
OLD | NEW |