GdPictureImaging.GifInsertFrameFromFile Method

Inserts a new frame from file at the given position an editable multiframe gif image. Frame has to be a number smaller or equal than the current number of frames available in the multiframe gif image.

public GdPictureStatus GifInsertFrameFromFile(
    int ImageID, 
    int Position, 
    String FilePath
);

Visual Basic

Public Function GifInsertFrameFromFile(
    ByVal ImageID As Integer, 
    ByVal Position As Integer, 
    ByVal FilePath As String
) As GdPictureStatus

Parameters

Parameters	Description
ImageID	GdPicture Image Identifier. The editable multiframe gif image in which the frame will be inserted.
Position	The position to add the new frame. Must be a value from 1 to the current number of frames available in the multiframe gif image.
FilePath	The path of the image to append within the editable multiframe gif image.

Returns

A member of the GdPictureStatus enumeration.

Remarks

This function can only be used with an editable multiframe gif image.

To check if an image is an editable multiframe gif image you can use the GifIsEditableMultiFrame() function.

To save modifications brought to the multiframe gif image you need to use the GifSaveMultiFrameToFile() function.

Supported formats are RAW, PICT, BMP, DIB, RLE, ICO, EMF, WMF, GIF, ANIMATED GIF, JPEG, JPG, JPE, JFIF, PNG, TIFF, MULTIPAGE TIFF, PNM, PPM, PBM, PGM, PFM, RPPM, RPGM, RPBM, PCX, XPM, XBM, WBMP, TGA, SGI, Sun RAS, PSD, MNG, Kodak PhotoCD files, KOALA files, JP2, J2K, JNG, JBIG, IFF, HDR, Raw Fax G3, EXR, DDS and Dr. Halo files.