GdPicture.NET Reference Guide
GifSetFrameDisposal Method (GdPictureImaging)
Example 





GdPicture14 Namespace > GdPictureImaging Class : GifSetFrameDisposal Method
GdPicture Image Identifier. The multiframe gif image.
Frame no between 1 and frame count.
Can be:1: Leave. Will leave the image in place to be entirely or partially overdrawn by the next image.2: Background. Will blank out the area used by the frame with the background color.3: Previous. Will return the logical canvas to the previous state before the image was drawn.
Sets the "Frame disposal method" of a frame of an editable multiframe gif image. This method should be called before saving using the GifSaveMultiFrameToFile() method. This defines what to do with the logical canvas area after displaying this image.
Syntax
'Declaration
 
Public Function GifSetFrameDisposal( _
   ByVal ImageID As Integer, _
   ByVal Frame As Integer, _
   ByVal FrameDisposal As Integer _
) As GdPictureStatus
public GdPictureStatus GifSetFrameDisposal( 
   int ImageID,
   int Frame,
   int FrameDisposal
)
public function GifSetFrameDisposal( 
    ImageID: Integer;
    Frame: Integer;
    FrameDisposal: Integer
): GdPictureStatus; 
public function GifSetFrameDisposal( 
   ImageID : int,
   Frame : int,
   FrameDisposal : int
) : GdPictureStatus;
public: GdPictureStatus GifSetFrameDisposal( 
   int ImageID,
   int Frame,
   int FrameDisposal
) 
public:
GdPictureStatus GifSetFrameDisposal( 
   int ImageID,
   int Frame,
   int FrameDisposal
) 

Parameters

ImageID
GdPicture Image Identifier. The multiframe gif image.
Frame
Frame no between 1 and frame count.
FrameDisposal
Can be:1: Leave. Will leave the image in place to be entirely or partially overdrawn by the next image.2: Background. Will blank out the area used by the frame with the background color.3: Previous. Will return the logical canvas to the previous state before the image was drawn.

Return Value

A member of the GdPictureStatus enumeration.
Remarks
This method works only with editable multiframe gif images.
Example
Using GifSetFrameDisposal to leave the image in place to be entirely or partially overdrawn by the next image.
Dim oGdPictureImaging As New GdPictureImaging
Dim ImageID As Integer = oGdPictureImaging.GifCreateMultiFrameFromFile("animated.gif")
oGdPictureImaging.GifSetFrameDisposal(ImageID, 3, 1)
oGdPictureImaging.GifSaveMultiFrameToFile(ImageID,  "output.gif")
oGdPictureImaging.ReleaseGdPictureImage(ImageID)
See Also

Reference

GdPictureImaging Class
GdPictureImaging Members
GifIsEditableMultiFrame Method
GifSaveMultiFrameToFile Method