Adds a specified frame to the file specified using the specified parameters. Use this method to save selected frames from an image to a multiple-frame image.

Namespace:  FreeImageAPI
Assembly:  FreeImageNET (in FreeImageNET.dll)

Syntax

C#
public static void SaveAdd(
	string filename,
	FreeImageBitmap bitmap,
	int insertPosition,
	FREE_IMAGE_FORMAT format,
	FREE_IMAGE_LOAD_FLAGS loadFlags,
	FREE_IMAGE_SAVE_FLAGS saveFlags
)
Visual Basic (Declaration)
Public Shared Sub SaveAdd ( _
	filename As String, _
	bitmap As FreeImageBitmap, _
	insertPosition As Integer, _
	format As FREE_IMAGE_FORMAT, _
	loadFlags As FREE_IMAGE_LOAD_FLAGS, _
	saveFlags As FREE_IMAGE_SAVE_FLAGS _
)
Visual C++
public:
static void SaveAdd(
	String^ filename, 
	FreeImageBitmap^ bitmap, 
	int insertPosition, 
	FREE_IMAGE_FORMAT format, 
	FREE_IMAGE_LOAD_FLAGS loadFlags, 
	FREE_IMAGE_SAVE_FLAGS saveFlags
)

Parameters

filename
Type: System..::.String
File to add this frame to.
bitmap
Type: FreeImageAPI..::.FreeImageBitmap
A FreeImageBitmap that contains the frame to add.
insertPosition
Type: System..::.Int32
The position of the inserted frame.
format
Type: FreeImageAPI..::.FREE_IMAGE_FORMAT
Format of the image.
loadFlags
Type: FreeImageAPI..::.FREE_IMAGE_LOAD_FLAGS
Flags to enable or disable plugin-features.
saveFlags
Type: FreeImageAPI..::.FREE_IMAGE_SAVE_FLAGS
Flags to enable or disable plugin-features.

Exceptions

ExceptionCondition
System..::.ArgumentNullException filename or bitmap is null.
System.IO..::.FileNotFoundException filename does not exist.
System..::.ExceptionSaving the image failed.
System..::.ArgumentOutOfRangeException insertPosition is out of range.

Version Information

FreeImage.NET

Supported in: 3.12.0, 3.13.0, 3.13.1

See Also