BmpImage
BmpImage constructor (1 of 9)
Start using the BmpImage class effortlessly with this constructor that initializes a new instance. Perfect for developers who want to get up and running with BmpImage
objects quickly and efficiently.
public BmpImage(string path)
Parameter | Type | Description |
---|---|---|
path | String | The path to load image from and initialize pixel and palette data with. |
Exceptions
exception | condition |
---|---|
ArgumentNullException | The raster image is null. |
BmpImageException | The height must be positive. |
ArgumentException | Palette must be specified for images with 8 bits per pixel or less. |
Examples
The example shows how to load a BmpImage from a file.
[C#]
string dir = "c:\\temp\\";
// Load a BMP image from a file.
// The source pixels will be converted to 32-bpp format if required.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(dir + "sample.bmp"))
{
// Do some image processing.
// Save to another BMP file.
bmpImage.Save(dir + "sample.output.32bpp.bmp");
}
See Also
- class BmpImage
- namespace Aspose.Imaging.FileFormats.Bmp
- assembly Aspose.Imaging
BmpImage constructor (2 of 9)
Effortlessly create a new instance of the BmpImage
class with this constructor, using specified parameters like path, bitsPerPixel, and compression. Ideal for developers looking to initialize BmpImage objects quickly and efficiently, with precise control over image characteristics.
public BmpImage(string path, ushort bitsPerPixel, BitmapCompression compression,
double horizontalResolution, double verticalResolution)
Parameter | Type | Description |
---|---|---|
path | String | The path to load image from and initialize pixel and palette data with. |
bitsPerPixel | UInt16 | The bits per pixel. |
compression | BitmapCompression | The compression to use. |
horizontalResolution | Double | The horizontal resolution. Note due to the rounding the resulting resolution may slightly differ from the passed. |
verticalResolution | Double | The vertical resolution. Note due to the rounding the resulting resolution may slightly differ from the passed. |
Exceptions
exception | condition |
---|---|
ArgumentNullException | The raster image is null. |
BmpImageException | The height must be positive. |
ArgumentException | Palette must be specified for images with 8 bits per pixel or less. |
Examples
The example shows how to load a BmpImage from a file with the specified bit depth and resolution.
[C#]
string dir = "c:\\temp\\";
// Load a BMP image from a file.
// The source pixels will be converted to 24-bpp format if required.
// The resolution will be set to 96 dpi.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage =
new Aspose.Imaging.FileFormats.Bmp.BmpImage(dir + "sample.bmp", 24, Aspose.Imaging.FileFormats.Bmp.BitmapCompression.Rgb, 96.0, 96.0))
{
// Do some image processing.
// Save to another BMP file.
bmpImage.Save(dir + "sample.output.24bpp.96dpi.bmp");
}
See Also
- enum BitmapCompression
- class BmpImage
- namespace Aspose.Imaging.FileFormats.Bmp
- assembly Aspose.Imaging
BmpImage constructor (3 of 9)
Begin using the BmpImage
class effortlessly by initializing a new instance with this constructor, using a stream as input. Perfect for developers seeking a convenient way to work with BmpImage objects from various data sources, ensuring flexibility and ease of integration.
public BmpImage(Stream stream)
Parameter | Type | Description |
---|---|---|
stream | Stream | The stream to load image from and initialize pixel and palette data with. |
Exceptions
exception | condition |
---|---|
ArgumentNullException | The raster image is null. |
BmpImageException | The height must be positive. |
ArgumentException | Palette must be specified for images with 8 bits per pixel or less. |
Examples
The example shows how to load a BmpImage from a file stream.
[C#]
string dir = "c:\\temp\\";
// Load a BMP image from a file stream.
// The source pixels will be converted to 32-bpp format if required.
using (System.IO.Stream stream = System.IO.File.OpenRead(dir + "sample.bmp"))
{
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(stream))
{
// Do some image processing.
// Save to another BMP file.
bmpImage.Save(dir + "sample.output.32bpp.bmp");
}
}
See Also
- class BmpImage
- namespace Aspose.Imaging.FileFormats.Bmp
- assembly Aspose.Imaging
BmpImage constructor (4 of 9)
Start working with the BmpImage
class seamlessly by creating a new instance using a stream, along with specified parameters like bitsPerPixel and compression. Perfect for developers seeking a straightforward way to handle BmpImage objects, ensuring flexibility and efficiency in their projects.
public BmpImage(Stream stream, ushort bitsPerPixel, BitmapCompression compression,
double horizontalResolution, double verticalResolution)
Parameter | Type | Description |
---|---|---|
stream | Stream | The stream to load image from and initialize pixel and palette data with. |
bitsPerPixel | UInt16 | The bits per pixel. |
compression | BitmapCompression | The compression to use. |
horizontalResolution | Double | The horizontal resolution. Note due to the rounding the resulting resolution may slightly differ from the passed. |
verticalResolution | Double | The vertical resolution. Note due to the rounding the resulting resolution may slightly differ from the passed. |
Exceptions
exception | condition |
---|---|
ArgumentNullException | The raster image is null. |
BmpImageException | The height must be positive. |
ArgumentException | Palette must be specified for images with 8 bits per pixel or less. |
Examples
The example shows how to load a BmpImage from a file stream with the specified bit depth and resolution.
[C#]
string dir = "c:\\temp\\";
// Load a BMP image from a file stream.
// The source pixels will be converted to 24-bpp format if required.
// The resolution will be set to 96 dpi.
using (System.IO.Stream stream = System.IO.File.OpenRead(dir + "sample.bmp"))
{
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage =
new Aspose.Imaging.FileFormats.Bmp.BmpImage(stream, 24, Aspose.Imaging.FileFormats.Bmp.BitmapCompression.Rgb, 96.0, 96.0))
{
// Do some image processing.
// Save to another BMP file.
bmpImage.Save(dir + "sample.output.24bpp.96dpi.bmp");
}
}
See Also
- enum BitmapCompression
- class BmpImage
- namespace Aspose.Imaging.FileFormats.Bmp
- assembly Aspose.Imaging
BmpImage constructor (5 of 9)
Effortlessly create a new instance of the BmpImage
class by initializing it with a RasterImage object. Perfect for developers looking to seamlessly convert existing raster images to the BmpImage format, ensuring compatibility and ease of integration into their projects.
public BmpImage(RasterImage rasterImage)
Parameter | Type | Description |
---|---|---|
rasterImage | RasterImage | The image to initialize pixel and palette data with. |
Exceptions
exception | condition |
---|---|
ArgumentNullException | The raster image is null. |
BmpImageException | The height must be positive. |
ArgumentException | Palette must be specified for images with 8 bits per pixel or less. |
Examples
The example shows how to load a BmpImage from another instance of RasterImage.
[C#]
string dir = "c:\\temp\\";
// Create a new PNG image.
Aspose.Imaging.ImageOptions.PngOptions createOptions = new Aspose.Imaging.ImageOptions.PngOptions();
createOptions.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
using (Aspose.Imaging.RasterImage rasterImage = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(createOptions, 100, 100))
{
// Fill the entire PNG image in red.
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(rasterImage);
Aspose.Imaging.Brushes.SolidBrush brush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red);
gr.FillRectangle(brush, rasterImage.Bounds);
// Create a BMP image based on the PNG image.
// The source pixels will be converted to 32-bpp format if required.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(rasterImage))
{
// Save to a BMP file
bmpImage.Save(dir + "output.32bpp.bmp");
}
}
See Also
- class RasterImage
- class BmpImage
- namespace Aspose.Imaging.FileFormats.Bmp
- assembly Aspose.Imaging
BmpImage constructor (6 of 9)
Start working with the BmpImage
class seamlessly by creating a new instance using a rasterImage along with specified parameters like bitsPerPixel and compression. Perfect for developers seeking a straightforward way to handle BmpImage objects, ensuring flexibility and efficiency in their projects.
public BmpImage(RasterImage rasterImage, ushort bitsPerPixel, BitmapCompression compression,
double horizontalResolution, double verticalResolution)
Parameter | Type | Description |
---|---|---|
rasterImage | RasterImage | The image to initialize pixel and palette data with. |
bitsPerPixel | UInt16 | The bits per pixel. |
compression | BitmapCompression | The compression to use. |
horizontalResolution | Double | The horizontal resolution. Note due to the rounding the resulting resolution may slightly differ from the passed. |
verticalResolution | Double | The vertical resolution. Note due to the rounding the resulting resolution may slightly differ from the passed. |
Exceptions
exception | condition |
---|---|
ArgumentNullException | The raster image is null. |
BmpImageException | The height must be positive. |
ArgumentException | Palette must be specified for images with 8 bits per pixel or less. |
Examples
The example shows how to load a BmpImage from another instance of RasterImage with the specified bit depth and compression.
[C#]
string dir = "c:\\temp\\";
// Create a new PNG image.
Aspose.Imaging.ImageOptions.PngOptions createOptions = new Aspose.Imaging.ImageOptions.PngOptions();
createOptions.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
using (Aspose.Imaging.RasterImage rasterImage = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(createOptions, 100, 100))
{
// Fill the entire PNG image in red.
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(rasterImage);
Aspose.Imaging.Brushes.SolidBrush brush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red);
gr.FillRectangle(brush, rasterImage.Bounds);
// Create a BMP image based on the PNG image.
// The source pixels will be converted to 24-bpp format if required.
// The resolution will be set to 96 dpi.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(rasterImage, 24, Aspose.Imaging.FileFormats.Bmp.BitmapCompression.Rgb, 96.0, 96.0))
{
// Save to a BMP file
bmpImage.Save(dir + "output.24bpp.96dpi.bmp");
}
}
See Also
- class RasterImage
- enum BitmapCompression
- class BmpImage
- namespace Aspose.Imaging.FileFormats.Bmp
- assembly Aspose.Imaging
BmpImage constructor (7 of 9)
Start using the BmpImage
class effortlessly by creating a new instance with specified width and height parameters. Ideal for developers seeking a convenient way to generate BmpImage objects of custom dimensions, ensuring flexibility and ease of integration into their projects.
public BmpImage(int width, int height)
Parameter | Type | Description |
---|---|---|
width | Int32 | The image width. |
height | Int32 | The image height. |
Exceptions
exception | condition |
---|---|
BmpImageException | The height must be positive. |
ArgumentException | Palette must be specified for images with 8 bits per pixel or less. |
Examples
The example shows how to create a BmpImage of the specified size.
[C#]
string dir = "c:\\temp\\";
// Create a 32-bpp BMP image of 100 x 100 px.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(100, 100))
{
// Fill the entire image in red.
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(bmpImage);
Aspose.Imaging.Brushes.SolidBrush brush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red);
gr.FillRectangle(brush, bmpImage.Bounds);
// Save to a BMP file
bmpImage.Save(dir + "output.bmp");
}
The following example shows how to palletize a BMP image to reduce its output size.
[C#]
// Create a BMP image 100 x 100 px.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(100, 100))
{
// The linear gradient from the left-top to the right-bottom corner of the image.
Aspose.Imaging.Brushes.LinearGradientBrush brush =
new Aspose.Imaging.Brushes.LinearGradientBrush(
new Aspose.Imaging.Point(0, 0),
new Aspose.Imaging.Point(bmpImage.Width, bmpImage.Height),
Aspose.Imaging.Color.Red,
Aspose.Imaging.Color.Green);
// Fill the entire image with the linear gradient brush.
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(bmpImage);
gr.FillRectangle(brush, bmpImage.Bounds);
// Get the closest 8-bit color palette which covers as many pixels as possible, so that a palettized image
// is almost visually indistinguishable from a non-palletized one.
Aspose.Imaging.IColorPalette palette = Aspose.Imaging.ColorPaletteHelper.GetCloseImagePalette(bmpImage, 256);
// 8-bit palette contains at most 256 colors.
Aspose.Imaging.ImageOptions.BmpOptions saveOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
saveOptions.Palette = palette;
saveOptions.BitsPerPixel = 8;
using (System.IO.MemoryStream stream = new System.IO.MemoryStream())
{
bmpImage.Save(stream, saveOptions);
System.Console.WriteLine("The palettized image size is {0} bytes.", stream.Length);
}
using (System.IO.MemoryStream stream = new System.IO.MemoryStream())
{
bmpImage.Save(stream);
System.Console.WriteLine("The non-palettized image size is {0} bytes.", stream.Length);
}
}
// The output looks like this:
// The palettized image size is 11078 bytes.
// The non-palettized image size is 40054 bytes.
See Also
- class BmpImage
- namespace Aspose.Imaging.FileFormats.Bmp
- assembly Aspose.Imaging
BmpImage constructor (8 of 9)
Begin using the BmpImage
class seamlessly by initializing a new instance with parameters such as width, height, bit depth, and palette. Perfect for developers seeking a straightforward way to create BmpImage objects with custom dimensions and color configurations, ensuring flexibility and efficiency in their projects.
public BmpImage(int width, int height, ushort bitsPerPixel, IColorPalette palette)
Parameter | Type | Description |
---|---|---|
width | Int32 | The image width. |
height | Int32 | The image height. |
bitsPerPixel | UInt16 | The bits per pixel. |
palette | IColorPalette | The color palette. |
Exceptions
exception | condition |
---|---|
BmpImageException | The height must be positive. |
ArgumentException | Palette must be specified for images with 8 bits per pixel or less. |
Examples
The example shows how to create a BmpImage of the specified size with the specified palette.
[C#]
string dir = "c:\\temp\\";
Aspose.Imaging.Color[] paletterColors = new Aspose.Imaging.Color[]
{
Aspose.Imaging.Color.Red,
Aspose.Imaging.Color.Green,
};
// Create a monochrome palette which contains only red and green colors.
Aspose.Imaging.IColorPalette palette = new Aspose.Imaging.ColorPalette(paletterColors);
// Create a monochrome 1-bpp BMP image of 100 x 100 px.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(100, 100, 1, palette))
{
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(bmpImage);
// Fill the upper half of the image in red.
Aspose.Imaging.Brushes.SolidBrush redBrush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red);
gr.FillRectangle(redBrush, new Aspose.Imaging.Rectangle(0, 0, bmpImage.Width, bmpImage.Height / 2));
// Fill the lower half of the image in green.
Aspose.Imaging.Brushes.SolidBrush greenBrush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Green);
gr.FillRectangle(greenBrush, new Aspose.Imaging.Rectangle(0, bmpImage.Height / 2, bmpImage.Width, bmpImage.Height / 2));
// Save to BMP
bmpImage.Save(dir + "output.monochrome.bmp");
}
See Also
- interface IColorPalette
- class BmpImage
- namespace Aspose.Imaging.FileFormats.Bmp
- assembly Aspose.Imaging
BmpImage constructor (9 of 9)
Effortlessly create a new instance of the BmpImage
class with this constructor, specifying parameters like width, height, bitsPerPixel, and palette. Perfect for developers seeking a convenient way to generate BmpImage objects with custom dimensions and color configurations, ensuring flexibility and ease of integration into their projects.
public BmpImage(int width, int height, ushort bitsPerPixel, IColorPalette palette,
BitmapCompression compression, double horizontalResolution, double verticalResolution)
Parameter | Type | Description |
---|---|---|
width | Int32 | The image width. |
height | Int32 | The image height. |
bitsPerPixel | UInt16 | The bits per pixel. |
palette | IColorPalette | The color palette. |
compression | BitmapCompression | The compression to use. |
horizontalResolution | Double | The horizontal resolution. Note due to the rounding the resulting resolution may slightly differ from the passed. |
verticalResolution | Double | The vertical resolution. Note due to the rounding the resulting resolution may slightly differ from the passed. |
Exceptions
exception | condition |
---|---|
BmpImageException | The height must be positive. |
ArgumentException | Palette must be specified for images with 8 bits per pixel or less. |
Examples
The example shows how to create a BmpImage using various options.
[C#]
string dir = "c:\\temp\\";
Aspose.Imaging.Color[] paletterColors = new Aspose.Imaging.Color[]
{
Aspose.Imaging.Color.Red,
Aspose.Imaging.Color.Green,
};
// Create a monochrome palette which contains only red and green colors.
Aspose.Imaging.IColorPalette palette = new Aspose.Imaging.ColorPalette(paletterColors);
// Create a monochrome 1-bpp BMP image of 100 x 100 px.
// The horizontal and vertical resolution will be set to 96 dpi.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(100, 100, 1, palette, Aspose.Imaging.FileFormats.Bmp.BitmapCompression.Rgb, 96.0, 96.0))
{
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(bmpImage);
// Fill the upper half of the image in red.
Aspose.Imaging.Brushes.SolidBrush redBrush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red);
gr.FillRectangle(redBrush, new Aspose.Imaging.Rectangle(0, 0, bmpImage.Width, bmpImage.Height / 2));
// Fill the lower half of the image in green.
Aspose.Imaging.Brushes.SolidBrush greenBrush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Green);
gr.FillRectangle(greenBrush, new Aspose.Imaging.Rectangle(0, bmpImage.Height / 2, bmpImage.Width, bmpImage.Height / 2));
// Save to a BMP file
bmpImage.Save(dir + "output.monochrome.96dpi.bmp");
}
See Also
- interface IColorPalette
- enum BitmapCompression
- class BmpImage
- namespace Aspose.Imaging.FileFormats.Bmp
- assembly Aspose.Imaging