seqAdd
Top  Previous  Next

seqAdd ( integer Sequence, integer Image [ , integer Delay ] )

Use this function to add an image to the end of a sequence as a new frame. The size and format of the image to be added should correspond to those of the sequence.

Parameters
 
Sequence  
 
An integer between 1 and 116 specifying the number of the sequence. Values in the range of 100-116 correspond to hidden sequences. If no sequence or image exist at a specified location, a one-frame sequence will be created. If this parameter points to an existing static image, the image will be converted to a two-frame sequence.  
 
Image  
 
An integer between 1 and 116 specifying the number of the image to be added to the end of the sequence as a new frame. Values in the range of 100-116 correspond to hidden images.  
 
Delay  
 
An optional integer specifying the delay between the last frame of the sequence and the newly added frame, in milliseconds. If this parameter is omitted, the delay will be set to the one for the last frame of the sequence.  
 
Error flags

ERR_OK  
 
The flag set if successful.  
 
ERR_FAILED  
 
The flag set if failed.  
 
ERR_BADFORMAT  
 
The image's format differs from the sequence's format.  
 
Example

This set of statements grabs a sequence from the video device, then captures a single frame and adds it to the end of the sequence:  
 
grabSeq(1,16,100)  
grabIm (2)  
seqAdd(1,1)