The IDLffMJPEG2000::ReleaseSequentialData procedure method releases a frame from the frame buffer during animation playback. After calling GetSequentialData, which reads the frame from the frame buffer, call this method to release the frame and make the frame buffer slot available to the next frame being decompressed.
The StartSequentialReading, GetSequentialData, ReleaseSequentialData and StopSequentialReading methods are typically used with a timer mechanism to create a sequential playback.
Note: Always use a widget timer or IDLitWindow timer mechanism to control the playback rate. Avoid using the WAIT procedure with sequential playback methods as the interaction between the procedure and the background processing thread will cause adverse side effects on UNIX platforms.
This method will throw an error if the release fails. A CATCH statement can be used to trap these errors.
This long value is typically returned by the IDLffMJPEG2000::GetSequentialData method. If the Frame_Index is -1, it is ignored. If the Frame_Index is less than 0 or greater than the FRAME_BUFFER_LENGTH property, it is ignored.
See the Examples section of IDLffMJPEG2000::GetSequentialData for a simple example that uses the four sequential playback methods.