Image.Create

Create(ImageOptionsBase, int, int)

Creates a new image using the specified create options.

public static Image Create(ImageOptionsBase imageOptions, int width, int height)

Parameter	Type	Description
imageOptions	ImageOptionsBase	The image options.
width	Int32	The width.
height	Int32	The height.

Return Value

The newly created image.

Examples

This example creates a new Image file at some disk location as specified by Source property of the BmpOptions instance. Several properties for BmpOptions instance are set before creating the actual image. Especially the Source property, that refers to the actual disk location in this case.

[C#]

//Create an instance of BmpOptions and set its various properties
Aspose.Imaging.ImageOptions.BmpOptions bmpOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
bmpOptions.BitsPerPixel = 24;

//Create an instance of FileCreateSource and assign it as Source for the instance of BmpOptions
//Second Boolean parameter determines if the file to be created IsTemporal or not
bmpOptions.Source = new Aspose.Imaging.Sources.FileCreateSource(@"C:\temp\output.bmp", false);

//Create an instance of Image and initialize it with instance of BmpOptions by calling Create method
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(bmpOptions, 500, 500))
{
    //do some image processing

    // save all changes
    image.Save();
}

See Also

• class ImageOptionsBase
• class Image
• namespace Aspose.Imaging
• assembly Aspose.Imaging

---

Create(ImageOptionsBase, int, int, int[])

Creates a RasterImage instance from the provided pixel array. Validates that the specified width and height match the dimensions of the pixel data. This method can only be used when the library is in Licensed mode.

public static Image Create(ImageOptionsBase imageOptions, int width, int height, int[] pixels)

Parameter	Type	Description
imageOptions	ImageOptionsBase	The options used to create the RasterImage.
width	Int32	The width of the RasterImage.
height	Int32	The height of the RasterImage.
pixels	Int32[]	The array of pixel values used to populate the image.

Return Value

A RasterImage populated with the provided pixel data.

Exceptions

exception	condition
ImageCreateException	Thrown if the image dimensions do not match the size of the pixel array, if the image creation fails due to the specified imageOptions, or if the method is called when the library is not in Licensed mode.

See Also

• class ImageOptionsBase
• class Image
• namespace Aspose.Imaging
• assembly Aspose.Imaging

---

Create(Image[])

Creates a new image using the specified images as pages

public static Image Create(Image[] images)

Parameter	Type	Description
images	Image[]	The images.

Return Value

The Image as IMultipageImage

See Also

• class Image
• namespace Aspose.Imaging
• assembly Aspose.Imaging

---

Create(MultipageCreateOptions)

Creates the specified multipage create options.

public static Image Create(MultipageCreateOptions multipageCreateOptions)

Parameter	Type	Description
multipageCreateOptions	MultipageCreateOptions	The multipage create options.

Return Value

The multipage image

See Also

• class MultipageCreateOptions
• class Image
• namespace Aspose.Imaging
• assembly Aspose.Imaging

---

Create(string[], bool)

Creates the multipage image containing the specified files.

public static Image Create(string[] files, bool throwExceptionOnLoadError)

Parameter	Type	Description
files	String[]	The files.
throwExceptionOnLoadError	Boolean	if set to true [throw exception on load error].

Return Value

The multipage image

See Also

• class Image
• namespace Aspose.Imaging
• assembly Aspose.Imaging

---

Create(string[])

Creates the multipage image containing the specified files.

public static Image Create(string[] files)

Parameter	Type	Description
files	String[]	The files.

Return Value

The multipage image

See Also

• class Image
• namespace Aspose.Imaging
• assembly Aspose.Imaging

---

Create(Image[], bool)

Creates a new image the specified images as pages.

public static Image Create(Image[] images, bool disposeImages)

Parameter	Type	Description
images	Image[]	The images.
disposeImages	Boolean	if set to true [dispose images].

Return Value

The Image as IMultipageImage

See Also

• class Image
• namespace Aspose.Imaging
• assembly Aspose.Imaging