visual effect | ||||||||||||||||||||||
Type | command | |||||||||||||||||||||
Dictionary | LCS | |||||||||||||||||||||
Library | LiveCode Script | |||||||||||||||||||||
Syntax |
| |||||||||||||||||||||
Summary | Adds a visual effect transition. | |||||||||||||||||||||
Introduced | 1.0 | |||||||||||||||||||||
Changes | The ability to use QuickTime special effects was introduced in version 1.1. In previous versions, only the built-in visual effects listed in the Parameters section were available. From LiveCode version 8.1 for Mac, the use of QuickTime was deprecated with new defaults for dontUseQT and dontUseQTEffects being set to true on all systems from macOS 10.8. Additionally QuickTime does not include 64 bit support and therefore can not be supported on macOS 64-bit builds of LiveCode. Also, the Windows build of LiveCode version 8.1 deprecates all QuickTime features, so setting dontUseQT and dontUseQTEffects will have no effect. The ability to use Core Image transition effects together with the enhanced syntax for parameter passing was introduced in version 2.6. | |||||||||||||||||||||
OS | mac, windows, linux, ios, android, web | |||||||||||||||||||||
Platforms | desktop, mobile | |||||||||||||||||||||
Parameters |
| |||||||||||||||||||||
Example |
| |||||||||||||||||||||
Related | Property: alwaysBuffer, dontUseQT, dontUseQTEffects, effectRate, multiEffect Keyword: black, card, gray, white Command: answer effect, find, go, hide, lock screen, pop, show, unlock screen Object: card, player, stack Glossary: command, exit, handler, inverse, property, QuickTime | |||||||||||||||||||||
Description | Use the visual effect command to add a transition effect the next time there is a move to another card. When you issue a visual effect command, it is stored to be used the next time you navigate to another card in the same window with the go, find, or pop command. Usually, you place the visual effect command immediately before these commands in a handler, like this:
However, it is not necessary to execute the navigation command immediately; the visual effect is stored and used the next time you navigate. You can even issue a visual effect command in one handler and the navigation command in another handler. All visual effects are cleared when all pending handlers exit. The visual effect command affects only navigation within a window. If you want to create a transition effect when moving between stacks, use the go...in window form of the go command :
You can issue more than one visual effect in order to stack up several effects. All the pending visual effects are executed in the order they were issued during the card transition. This example makes the card appear to shrink and then re-expand:
The speed of visual effects is controlled by the setting of the effectRate property. To execute a visual effect without moving to another card,
lock the screen using the Visual effects do not affect the rectangle of a player whose alwaysBuffer property is set to false. For visual effects to be seen in a player's rectangle, the player's alwaysBuffer must be true. All visual effects function correctly on stacks with a deep mask. In this case, the alpha channel is taken into account and moves with the color of the pixel. For example, a Core Image ripple effect appears to ripple the actual window itself, not just its contents. If either the dontUseQT or dontUseQTEffects property is set to true, only the built-in visual effects can be used, and the additional effects generated by the answer effect command are not available. For technical information about QuickTime special effects, see Apple Computer's QuickTime developer documentation. Note: because Apple has discontinued support for QuickTime, this documentations may become unavailable in the future. The Core Image visual effects are only available on MacOS 10.4 and later. For technical information about these effects, see Apple Computer' Core Image developer documentation and CICategoryTransition Reference. The parameters used are the APIs 'Display name' (eg, Angle) rather than the parameter name (inputAngle). Each parameter is optional. The Core Image 'Time' parameter is not supported. Instead use the 'speed' parameter together with the effectRate property to affect the effect time. | |||||||||||||||||||||
Tags | multimedia |