ANIMATE

9.0, PLBCMP GUI Only

The ANIMATE instruction defines an object variable that displays an AVI clip. To define an ANIMATE object, use one of the following statement formats:

(1)	[label]	ANIMATE	[%]
(2)	[label]	ANIMATE	(arraysize)
(3)	[label]	ANIMATE	^
(4)	[label]	ANIMATE	^,{target}
(5)	[label]	ANIMATE	^(arraysize)
(6)	[label]	ANIMATE	^(arraysize),({target}),...,({target})

Where:

label

Optional. A Data Label.

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

An AVI clip is a series of bitmap frames like a movie.
ANIMATE objects can only display AVI clips that do not contain audio.
You can specify whether to center the video in the control by using the Center property. When the Center property is set to False, the control automatically sizes itself at run time to the size of the video.
When the Center property is set to True, the control does not resize itself. Instead, the video is displayed in the center of the area defined by the control. If the area defined by the control is smaller than the video, the edges of the video are clipped.
The ANIMATE object is not supported for Windows CE.
Multi-dimension arrays of ANIMATEs are supported up to a maximum of fourteen dimensions.
The ^ denotes a Pointer Variable to a ANIMATE object.
Although a ANIMATE may be defined as Global, it is DESTROYed during a CHAIN instruction.
When the runtimes are used with a Windows manifest file, the ANIMATE may not be repainted by the Windows. This issue is caused by the manifest usage beyond the control of the Sunbelt runtimes.
This object is not available when using the PL/B Web Server.