GdPictureImaging.GifSetFrameDisposal Method

Before saving using the GifSaveMultiFrameToFile() function, sets the "Frame disposal method" of a frame of an editable multiframe gif image.

This defines what to do with the logical canvas area after displaying this image.

public GdPictureStatus GifSetFrameDisposal(
    int ImageID, 
    int Frame, 
    int FrameDisposal
);

Visual Basic

Public Function GifSetFrameDisposal(
    ByVal ImageID As Integer, 
    ByVal Frame As Integer, 
    ByVal FrameDisposal As Integer
) As GdPictureStatus

Parameters

Parameters	Description
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.

Returns

A member of the GdPictureStatus enumeration.

Remarks

This function works only with editable multiframe gif images.