|
| 1 | +# Panel Functions |
| 2 | + |
| 3 | +## Cycle |
| 4 | + |
| 5 | +{ width="240" } |
| 6 | + |
| 7 | +Click to apply a 'Cycle' loop. These are loops that will repeat the animation from the beginning. |
| 8 | + |
| 9 | +```jsx |
| 10 | +loopOut(); |
| 11 | +``` |
| 12 | + |
| 13 | +!!! info "Note" |
| 14 | + |
| 15 | + This is the default loop type, so no parameter is needed in the `loopIn()` or `loopOut()` expression. |
| 16 | + |
| 17 | +## Ping Pong |
| 18 | + |
| 19 | +{ width="240" } |
| 20 | + |
| 21 | +Click to apply a 'Ping Pong' loop. These are loops that will run in reverse before repeating from the beginning. |
| 22 | + |
| 23 | +```jsx |
| 24 | +loopOut("pingpong"); |
| 25 | +``` |
| 26 | + |
| 27 | +## Offset |
| 28 | + |
| 29 | +{ width="240" } |
| 30 | + |
| 31 | +Click to apply an 'Offset' loop. These are loops that will increment in value each time they repeat. |
| 32 | + |
| 33 | +```jsx |
| 34 | +loopOut("offset"); |
| 35 | +``` |
| 36 | + |
| 37 | +## Continue |
| 38 | + |
| 39 | +{ width="240" } |
| 40 | + |
| 41 | +Click to apply a 'Continue' loop. These are loops that will continue the movement of the animation at the speed of the last keyframe. |
| 42 | + |
| 43 | +```jsx |
| 44 | +loopOut("continue"); |
| 45 | +``` |
| 46 | + |
| 47 | +## Time Remap |
| 48 | + |
| 49 | +{ width="240" } |
| 50 | + |
| 51 | +Alt/Option-click this button to apply time remapping to a layer without a loop expression. This is useful for when you've trimmed a layer and want to quickly create Time Remap keyframes at the In and Out points of the layer. |
| 52 | + |
| 53 | +## Change Loop Direction |
| 54 | + |
| 55 | +{ width="240" } |
| 56 | + |
| 57 | +Click to set the direction of the loop applied by the buttons above. Toggle between: Loop In; Loop Out; Loop In + Loop Out. |
| 58 | + |
| 59 | +## Keyframe Modifier |
| 60 | + |
| 61 | +{ width="240" } |
| 62 | + |
| 63 | +When set to a value greater than zero, a parameter is added to the loop expression to limit the loop to this number of keyframes before the last (or after the first, for a Loop In). |
| 64 | + |
| 65 | +```jsx |
| 66 | +loopOut("cycle", 3); |
| 67 | +``` |
| 68 | + |
| 69 | +For example, if this value were set to 3, and the property has 10 keyframes, when applying Loop Out, the animation will loop between the 7th and 10th keyframes. |
| 70 | + |
| 71 | + |
| 72 | + |
| 73 | +If this value is set to zero, it is ignored and the keyframe modifier is not added to the expression. |
| 74 | + |
| 75 | +Alt/Option-click to reset the value to zero. |
| 76 | + |
| 77 | +## Limit Keyframe Modifier |
| 78 | + |
| 79 | +{ width="240" } |
| 80 | + |
| 81 | +When active, the value set in the Keyframe Modifier field will be modified before being used in the loop expression. It will ensure that the value used is no greater than the highest valid value for a property. |
| 82 | + |
| 83 | +For example, if the Keyframe Modifier value is 10, but the selected property only has five keyframes, this would cause an error. With this toggle active, the Keyframe Modifier value will be adjusted to 4 before being used in the expression. |
| 84 | + |
| 85 | +```jsx |
| 86 | +loopOut("cycle", 4); // With 5 keyframes, this is valid |
| 87 | +``` |
| 88 | + |
| 89 | +When inactive, the value set in the Keyframe Modifier field will be used as-is. In some versions of After Effects, this may result in an expression error if this value greater than the highest valid value on a property; in later versions, the animation will simply loop between the first and last keyframes. This might be desirable if you are applying loop expressions to properties that you will later add sufficient keyframes to. |
| 90 | + |
| 91 | +```jsx |
| 92 | +loopOut("cycle", 10); |
| 93 | +/* With 5 keyframes, this is invalid and will loop between |
| 94 | + all keyframes, or possibly throw an expression error */ |
| 95 | +``` |
| 96 | + |
| 97 | +## Keep Expressions |
| 98 | + |
| 99 | +{ width="240" } |
| 100 | + |
| 101 | +When active, any existing expression on a property will be retained and commented out below the new loop expression. |
| 102 | + |
| 103 | +When inactive, any existing expressions are removed before applying the loop expression. |
| 104 | + |
| 105 | +```jsx |
| 106 | +loopOut("pingpong"); |
| 107 | + |
| 108 | +// == PREVIOUS EXPRESSION: == |
| 109 | +// |
| 110 | +// value * 360 |
| 111 | +``` |
| 112 | + |
| 113 | +## Information Panel |
| 114 | + |
| 115 | +{ width="240" } |
| 116 | + |
| 117 | +Click to open the Information panel. This panel contains: |
| 118 | + |
| 119 | +- Version details of the script |
| 120 | +- Link to support on the aescripts website |
| 121 | +- Instructions on how to use Loopy |
| 122 | +- Licence registration information |
| 123 | +- Option and button to check for script updates |
| 124 | +- Licence the script, or deactivate your licence |
| 125 | +- Reset the Loopy panel to the default state. |
0 commit comments