63 |
* 1) There must not be other place to get previous/last |
* 1) There must not be other place to get previous/last |
64 |
* VobScene. If a VobScene is saved in other place than |
* VobScene. If a VobScene is saved in other place than |
65 |
* here, it could prevent the GC to clean old VobScenes. |
* here, it could prevent the GC to clean old VobScenes. |
66 |
* By using only the correct ''previous'' VobScene |
* By using only the correct 'previous' VobScene |
67 |
* program can to get the famous ``invalid coorsys`` bug. |
* program can not get the famous 'invalid coorsys' bug. |
68 |
* |
* |
69 |
* 2) There must not be objects that call low-level animation |
* 2) There must not be objects that call low-level animation |
70 |
* interface to change animation state. This could prevent |
* interface to change animation state. This could prevent |
73 |
*/ |
*/ |
74 |
public interface AnimationAPI { |
public interface AnimationAPI { |
75 |
|
|
76 |
|
/** Set the update method in next change to be reuse of the same vobscene. |
77 |
|
* There's no animation between this and next frame, |
78 |
|
* only coordinate parameter changes are noticable. |
79 |
|
* <p> |
80 |
|
* If the update is set with another update method |
81 |
|
* before change, this method is obsoleted. |
82 |
|
*/ |
83 |
void reuseVS(String caller); |
void reuseVS(String caller); |
84 |
|
|
85 |
|
|
86 |
|
/** Set the update method in next change to be animation/interpolation between vobmatcher keys |
87 |
|
* <p> |
88 |
|
* If the update is set with another update method |
89 |
|
* before change, this method is obsoleted. |
90 |
|
* @see VobMatcher |
91 |
|
*/ |
92 |
void animate(String caller); |
void animate(String caller); |
93 |
|
|
94 |
|
|
95 |
|
/** Change to next frame instantly. |
96 |
|
*/ |
97 |
void chg(String caller); |
void chg(String caller); |
98 |
|
|
99 |
|
|
100 |
|
/** Shorthand for methods <code>reuseVS</code> and instant <code>chg</code>. |
101 |
|
*/ |
102 |
void chgReusingVS(String caller); |
void chgReusingVS(String caller); |
103 |
|
|
104 |
|
/** Shorthand for methods <code>animation</code> and instant <code>chg</code>. |
105 |
|
*/ |
106 |
void chgWithAnimation(String caller); |
void chgWithAnimation(String caller); |
107 |
|
|
108 |
|
|
109 |
|
/** Get the current visible vobscene. |
110 |
|
* While programming, you are creating vobscene |
111 |
|
* for future usually, so this returns the obivious previous vobscene. |
112 |
|
*/ |
113 |
VobScene getLastVS(); |
VobScene getLastVS(); |
114 |
} |
} |