Class PngImage
Nom dels espais: Aspose.Imaging.FileFormats.Png Assemblea: Aspose.Imaging.dll (25.4.0)
Manipular les imatges de rastres de la Xarxa Portable Graphics (PNG) amb la nostra API versàtil,amb suport per a nivells de compressió i diferents profunditats de color, incloent-hiGrayscale, Color Indexat, TrueColor, i canals alfa. Tractament sinistre de metadades XMP,Permetre una gestió completa de metadades d’imatge, mentre que fàcilment carregar imatges PNG,realitzar diverses manipulacions, aplicar filtres i convertir imatges a altres arxiusFormats per a la versatilitat i la personalització òptima.
[JsonObject(MemberSerialization.OptIn)]
public class PngImage : RasterCachedImage, IDisposable, IObjectWithBounds, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IHasXmpData, IHasMetadataInheritance
object ← DisposableObject ← DataStreamSupporter ← Image ← RasterImage ← RasterCachedImage ← PngImage
Implements
IDisposable , IObjectWithBounds , IRasterImageArgb32PixelLoader , IRasterImageRawDataLoader , IHasXmpData , IHasMetadata
Membres heretats
RasterCachedImage.CacheData() , RasterCachedImage.Blend(Point, RasterImage, Rectangle, byte) , RasterCachedImage.Resize(int, int, ResizeType) , RasterCachedImage.Resize(int, int, ImageResizeSettings) , RasterCachedImage.RotateFlip(RotateFlipType) , RasterCachedImage.Rotate(float, bool, Color) , RasterCachedImage.Crop(Rectangle) , RasterCachedImage.Dither(DitheringMethod, int, IColorPalette) , RasterCachedImage.Grayscale() , RasterCachedImage.NormalizeHistogram() , RasterCachedImage.BinarizeFixed(byte) , RasterCachedImage.BinarizeOtsu() , RasterCachedImage.BinarizeBradley(double, int) , RasterCachedImage.BinarizeBradley(double) , RasterCachedImage.AdjustBrightness(int) , RasterCachedImage.AdjustContrast(float) , RasterCachedImage.AdjustGamma(float, float, float) , RasterCachedImage.AdjustGamma(float) , RasterCachedImage.OnCached() , RasterCachedImage.OnPaletteChanged(IColorPalette, IColorPalette) , RasterCachedImage.IsCached , RasterImage.xmpData , RasterImage.RemoveMetadata() , RasterImage.Save(Stream, ImageOptionsBase, Rectangle) , RasterImage.GetModifyDate(bool) , RasterImage.Dither(DitheringMethod, int) , RasterImage.Dither(DitheringMethod, int, IColorPalette) , RasterImage.GetDefaultPixels(Rectangle, IPartialArgb32PixelLoader) , RasterImage.GetDefaultRawData(Rectangle, IPartialRawDataLoader, RawDataSettings) , RasterImage.GetDefaultArgb32Pixels(Rectangle) , RasterImage.GetDefaultRawData(Rectangle, RawDataSettings) , RasterImage.GetArgb32Pixel(int, int) , RasterImage.GetPixel(int, int) , RasterImage.SetArgb32Pixel(int, int, int) , RasterImage.SetPixel(int, int, Color) , RasterImage.ReadScanLine(int) , RasterImage.ReadArgb32ScanLine(int) , RasterImage.WriteScanLine(int, Color[]) , RasterImage.WriteArgb32ScanLine(int, int[]) , RasterImage.LoadPartialArgb32Pixels(Rectangle, IPartialArgb32PixelLoader) , RasterImage.LoadPartialPixels(Rectangle, IPartialPixelLoader) , RasterImage.LoadArgb32Pixels(Rectangle) , RasterImage.LoadArgb64Pixels(Rectangle) , RasterImage.LoadPartialArgb64Pixels(Rectangle, IPartialArgb64PixelLoader) , RasterImage.LoadPixels(Rectangle) , RasterImage.LoadCmykPixels(Rectangle) , RasterImage.LoadCmyk32Pixels(Rectangle) , RasterImage.LoadRawData(Rectangle, RawDataSettings, IPartialRawDataLoader) , RasterImage.LoadRawData(Rectangle, Rectangle, RawDataSettings, IPartialRawDataLoader) , RasterImage.SaveRawData(byte[], int, Rectangle, RawDataSettings) , RasterImage.SaveArgb32Pixels(Rectangle, int[]) , RasterImage.SavePixels(Rectangle, Color[]) , RasterImage.SaveCmykPixels(Rectangle, CmykColor[]) , RasterImage.SaveCmyk32Pixels(Rectangle, int[]) , RasterImage.SetResolution(double, double) , RasterImage.SetPalette(IColorPalette, bool) , RasterImage.Resize(int, int, ImageResizeSettings) , RasterImage.Rotate(float, bool, Color) , RasterImage.Rotate(float) , RasterImage.BinarizeFixed(byte) , RasterImage.BinarizeOtsu() , RasterImage.BinarizeBradley(double) , RasterImage.BinarizeBradley(double, int) , RasterImage.Blend(Point, RasterImage, Rectangle, byte) , RasterImage.Blend(Point, RasterImage, byte) , RasterImage.Grayscale() , RasterImage.NormalizeHistogram() , RasterImage.AdjustBrightness(int) , RasterImage.AdjustContrast(float) , RasterImage.AdjustGamma(float, float, float) , RasterImage.AdjustGamma(float) , RasterImage.GetSkewAngle() , RasterImage.NormalizeAngle() , RasterImage.NormalizeAngle(bool, Color) , RasterImage.Filter(Rectangle, FilterOptionsBase) , RasterImage.ReplaceColor(Color, byte, Color) , RasterImage.ReplaceColor(int, byte, int) , RasterImage.ReplaceNonTransparentColors(Color) , RasterImage.ReplaceNonTransparentColors(int) , RasterImage.ToBitmap() , RasterImage.ReleaseManagedResources() , RasterImage.UpdateMetadata() , RasterImage.UpdateDimensions(int, int) , RasterImage.PremultiplyComponents , RasterImage.UseRawData , RasterImage.UpdateXmpData , RasterImage.XmpData , RasterImage.RawIndexedColorConverter , RasterImage.RawCustomColorConverter , RasterImage.RawFallbackIndex , RasterImage.RawDataSettings , RasterImage.UsePalette , RasterImage.RawDataFormat , RasterImage.RawLineSize , RasterImage.IsRawDataAvailable , RasterImage.HorizontalResolution , RasterImage.VerticalResolution , RasterImage.HasTransparentColor , RasterImage.HasAlpha , RasterImage.TransparentColor , RasterImage.ImageOpacity , RasterImage.DataLoader , Image.CanLoad(string) , Image.CanLoad(string, LoadOptions) , Image.CanLoad(Stream) , Image.CanLoad(Stream, LoadOptions) , Image.Create(ImageOptionsBase, int, int) , Image.Create(Image[]) , Image.Create(MultipageCreateOptions) , Image.Create(string[], bool) , Image.Create(string[]) , Image.Create(Image[], bool) , Image.GetFileFormat(string) , Image.GetFileFormat(Stream) , Image.GetFittingRectangle(Rectangle, int, int) , Image.GetFittingRectangle(Rectangle, int[], int, int) , Image.Load(string, LoadOptions) , Image.Load(string) , Image.Load(Stream, LoadOptions) , Image.Load(Stream) , Image.GetProportionalWidth(int, int, int) , Image.GetProportionalHeight(int, int, int) , Image.RemoveMetadata() , Image.CanSave(ImageOptionsBase) , Image.Resize(int, int) , Image.Resize(int, int, ResizeType) , Image.Resize(int, int, ImageResizeSettings) , Image.GetDefaultOptions(object[]) , Image.GetOriginalOptions() , Image.ResizeWidthProportionally(int) , Image.ResizeHeightProportionally(int) , Image.ResizeWidthProportionally(int, ResizeType) , Image.ResizeHeightProportionally(int, ResizeType) , Image.ResizeWidthProportionally(int, ImageResizeSettings) , Image.ResizeHeightProportionally(int, ImageResizeSettings) , Image.RotateFlip(RotateFlipType) , Image.Rotate(float) , Image.Crop(Rectangle) , Image.Crop(int, int, int, int) , Image.Save() , Image.Save(string) , Image.Save(string, ImageOptionsBase) , Image.Save(string, ImageOptionsBase, Rectangle) , Image.Save(Stream, ImageOptionsBase) , Image.Save(Stream, ImageOptionsBase, Rectangle) , Image.GetSerializedStream(ImageOptionsBase, Rectangle, out int) , Image.SetPalette(IColorPalette, bool) , Image.UpdateContainer(Image) , Image.GetCanNotSaveMessage(ImageOptionsBase) , Image.GetFitRectangle(Rectangle) , Image.GetImage2Export(ImageOptionsBase, Rectangle, IImageExporter) , Image.GetFitRectangle(Rectangle, int[]) , Image.OnPaletteChanged(IColorPalette, IColorPalette) , Image.OnPaletteChanging(IColorPalette, IColorPalette) , Image.ReleaseManagedResources() , Image.BitsPerPixel , Image.Bounds , Image.Container , Image.Height , Image.Palette , Image.UsePalette , Image.Size , Image.Width , Image.InterruptMonitor , Image.BufferSizeHint , Image.AutoAdjustPalette , Image.HasBackgroundColor , Image.FileFormat , Image.BackgroundColor , DataStreamSupporter.timeout , DataStreamSupporter.CacheData() , DataStreamSupporter.Save() , DataStreamSupporter.Save(Stream) , DataStreamSupporter.Save(string) , DataStreamSupporter.Save(string, bool) , DataStreamSupporter.SaveData(Stream) , DataStreamSupporter.ReleaseManagedResources() , DataStreamSupporter.OnDataStreamContainerChanging(StreamContainer) , DataStreamSupporter.DataStreamContainer , DataStreamSupporter.IsCached , DisposableObject.Dispose() , DisposableObject.ReleaseManagedResources() , DisposableObject.ReleaseUnmanagedResources() , DisposableObject.VerifyNotDisposed() , DisposableObject.Disposed , object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Examples
Aquest exemple mostra com carregar una imatge PNG d’un fitxer.
string dir = "c:\\temp\\";
// Load a PNG image from a file.
using (Aspose.Imaging.FileFormats.Png.PngImage pngImage = new Aspose.Imaging.FileFormats.Png.PngImage(dir + "sample.png"))
{
// Transform the image to grayscale representation
pngImage.Grayscale();
// Save to a file.
pngImage.Save(dir + "sample.grayscale.png");
}Constructors
PngImage(Int, Int)
Iniciar un nou objecte de la classe Aspose.Imaging.FileFormats.Png.pngImage proporcionant elParàmetres d’amplada i altitud. Aquest constructor simplifica la creació de PNGimatges per permetre als desenvolupadors especificar directament les dimensions, facilitantGestió eficaç de les dades d’imatge PNG dins les seves aplicacions.
public PngImage(int width, int height)Parameters
width int
La seva amplada.
height int
La seva alçada.
Examples
Aquest exemple mostra com crear una imatge PNG de la mida especificada, omplir-la amb un color sòlid i salvar-lo a un fitxer.
string dir = "c:\\temp\\";
// Create a PNG image of 100x100 px.
using (Aspose.Imaging.FileFormats.Png.PngImage pngImage = new Aspose.Imaging.FileFormats.Png.PngImage(100, 100))
{
// Do some image processing, e.g. fill the entire image in red.
Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(pngImage);
Aspose.Imaging.Brushes.SolidBrush brush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red);
graphics.FillRectangle(brush, pngImage.Bounds);
// Save to a file.
pngImage.Save(dir + "output.png");
}PngImage(Tàrrega)
Construeix una nova instància de la classe Aspose.Imaging.FileFormats.Png. PngImage utilitzant el camíparàmetre per especificar la ubicació del fitxer d’imatge per carregar.permet als desenvolupadors crear fàcilment imatges PNG carregant-les d’un fitxer,simplificar el procés de treballar amb imatges PNG en les seves aplicacions.
public PngImage(string path)Parameters
path string
El camí per carregar una imatge.
Examples
Aquest exemple mostra com carregar una imatge PNG d’un fitxer.
string dir = "c:\\temp\\";
// Load a PNG image from a file.
using (Aspose.Imaging.FileFormats.Png.PngImage pngImage = new Aspose.Imaging.FileFormats.Png.PngImage(dir + "sample.png"))
{
// Transform the image to grayscale representation
pngImage.Grayscale();
// Save to a file.
pngImage.Save(dir + "sample.grayscale.png");
}PngImage(RasterImage)
Crea una nova instància de la classe Aspose.Imaging.FileFormats.Png. PngImage proporcionant un rasterimatge com a paràmetre. aquest constructor permet als desenvolupadors iniciar directament unaObjectes d’imatge PNG utilitzant una imatge de raster existent, simplificant el procés detreballar amb imatges PNG en les seves aplicacions.
public PngImage(RasterImage rasterImage)Parameters
rasterImage RasterImage
Imatge del raster.
Examples
Aquest exemple mostra com carregar la imatge PNG d’una imatge BMP.
string dir = "c:\\temp\\";
// Load a TrueColor PNG image from a BMP image.
// First, create a temporal BMP image that will be a foundation for building a PNG image.
// You can also load BMP image from a file or use an image of any other raster format.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(100, 100))
{
// Fill the entire BMP 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);
using (Aspose.Imaging.FileFormats.Png.PngImage pngImage = new Aspose.Imaging.FileFormats.Png.PngImage(bmpImage))
{
System.Console.WriteLine("The PNG color type: {0}", pngImage.GetOriginalOptions());
pngImage.Save(dir + "output.png");
}
}PngImage(Llistat, PngColorType)
Inicialitza una nova instància de la classe Aspose.Imaging.FileFormats.Png. PngImage especificant lacamí al fitxer d’imatge i el tipus de color. Aquest constructor permet convenientCreació d’imatges PNG de fitxers amb diferents tipus de color, proporcionantFlexibilitat en el tractament de diferents formats d’imatge.
public PngImage(string path, PngColorType colorType)Parameters
path string
El camí per carregar una imatge.
colorType PngColorType
El tipus de color.
Examples
Aquest exemple mostra com carregar una imatge PNG d’un arxiu amb el tipus de color especificat.
string dir = "c:\\temp\\";
// Load a PNG image from a file.
// Note that the colorful image will be converted to grayscale automatically.
using (Aspose.Imaging.FileFormats.Png.PngImage pngImage = new Aspose.Imaging.FileFormats.Png.PngImage(dir + "sample.png", Aspose.Imaging.FileFormats.Png.PngColorType.Grayscale))
{
// Save to a file.
pngImage.Save(dir + "sample.grayscale.png");
}Exceptions
PngImage(Tècnic, PngColorType)
Crea una nova instància de la classe Aspose.Imaging.FileFormats.Png.pngImage especificant unimatge de raster i un tipus de color. Aquest constructor permet als desenvolupadors directamentConvertir imatges de raster en format PNG mentre especifica el tipus de color desitjat,Oferir flexibilitat en la representació de colors.
public PngImage(RasterImage rasterImage, PngColorType colorType)Parameters
rasterImage RasterImage
Imatge del raster.
colorType PngColorType
El tipus de color.
Examples
Aquest exemple mostra com carregar la imatge PNG d’una imatge BMP amb el tipus de color especificat.
string dir = "c:\\temp\\";
// Load a grayscale PNG image from a colored BMP image.
// First, create a temporal BMP image that will be a foundation for building a PNG image.
// You can also load BMP image from a file or use an image of any other raster format.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(100, 100))
{
// Fill the entire BMP 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);
// The colors of the image pixels will be converted to their grayscale counterparts.
using (Aspose.Imaging.FileFormats.Png.PngImage pngImage = new Aspose.Imaging.FileFormats.Png.PngImage(bmpImage, Aspose.Imaging.FileFormats.Png.PngColorType.Grayscale))
{
pngImage.Save(dir + "output.grayscale.png");
}
}PngImage(Stream)
Crea una nova instància de la classe Aspose.Imaging.FileFormats.Png. PngImage iniciant-laAquest constructor permet als desenvolupadors carregar imatges PNG directamentdes d’un flux, proporcionant flexibilitat en la recuperació de la imatge de diferents fonts.
public PngImage(Stream stream)Parameters
stream Stream
El corrent per carregar una imatge.
Examples
Aquest exemple mostra com carregar una imatge PNG d’un fitxer o un flux de fitxers.
string dir = "c:\\temp\\";
// Load a PNG image from a file stream.
using (System.IO.Stream stream = System.IO.File.OpenRead(dir + "sample.png"))
{
using (Aspose.Imaging.FileFormats.Png.PngImage pngImage = new Aspose.Imaging.FileFormats.Png.PngImage(stream))
{
// Transform the image to grayscale representation
pngImage.Grayscale();
// Save to a file.
pngImage.Save(dir + "sample.grayscale.png");
}
}PngImage(Int, int, PngColorType)
Instantar una nova instància de la classe Aspose.Imaging.FileFormats.Png.pngImage, especificantla amplada, l’alçada i els paràmetres de tipus de color desitjats. aquest constructor permetCreació ràpida d’imatges PNG amb dimensions ajustades i configuracions de color,Facilitar la generació d’imatges estrictades per a diverses aplicacions i fluxos de treball.
public PngImage(int width, int height, PngColorType colorType)Parameters
width int
La seva amplada.
height int
La seva alçada.
colorType PngColorType
El tipus de color.
Examples
Aquest exemple mostra com crear una imatge PNG de la mida especificada amb el tipus de color especificat, omplir-la amb un color sòlid i guardar-lo en un fitxer.
string dir = "c:\\temp\\";
// Create a grayscale PNG image of 100x100 px.
// All colors will be automatically converted to the grayscale format.
using (Aspose.Imaging.FileFormats.Png.PngImage pngImage = new Aspose.Imaging.FileFormats.Png.PngImage(100, 100, Aspose.Imaging.FileFormats.Png.PngColorType.Grayscale))
{
// Do some image processing, e.g. fill the entire image in red.
Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(pngImage);
Aspose.Imaging.Brushes.SolidBrush brush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red);
graphics.FillRectangle(brush, pngImage.Bounds);
// Save to a file.
pngImage.Save(dir + "output.grayscale.png");
}PngImage(PngOptions, int i int)
Iniciar una nova instància de la classe Aspose.Imaging.FileFormats.Png. PngImage, incorporantOpcions PNG al costat de les paràmetres d’amplada i altitud. Aquest constructor permetdesenvolupadors per crear imatges PNG amb configuracions i dimensions personalitzables,Oferir flexibilitat en la generació d’imatge per a diversos casos d’ús.
public PngImage(PngOptions pngOptions, int width, int height)Parameters
pngOptions PngOptions
Les opcions de PNG.
width int
La seva amplada.
height int
La seva alçada.
Examples
Aquest exemple mostra com crear una imatge PNG amb les opcions especificades, omplir-la amb un color gradient lineal i salvar-lo en un fitxer.
string dir = "c:\\temp\\";
Aspose.Imaging.ImageOptions.PngOptions createOptions = new Aspose.Imaging.ImageOptions.PngOptions();
// The number of bits per color channel
createOptions.BitDepth = 8;
// Each pixel is a (red, green, blue) triple followed by the alpha component.
createOptions.ColorType = Imaging.FileFormats.Png.PngColorType.TruecolorWithAlpha;
// The maximum level of compression.
createOptions.CompressionLevel = 9;
// Usage of filters allows to compress continuous tonal images more effectively.
createOptions.FilterType = Aspose.Imaging.FileFormats.Png.PngFilterType.Sub;
// Use progressive loading
createOptions.Progressive = true;
// Create a PNG image with custom parameters.
using (Aspose.Imaging.FileFormats.Png.PngImage pngImage = new Aspose.Imaging.FileFormats.Png.PngImage(createOptions, 100, 100))
{
Aspose.Imaging.Brushes.LinearGradientBrush gradientBrush = new Aspose.Imaging.Brushes.LinearGradientBrush(
new Aspose.Imaging.Point(0, 0),
new Aspose.Imaging.Point(pngImage.Width, pngImage.Height),
Aspose.Imaging.Color.Blue,
Aspose.Imaging.Color.Transparent);
Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(pngImage);
// Fill the image with a semi-transparent gradient.
graphics.FillRectangle(gradientBrush, pngImage.Bounds);
// Save to a file.
pngImage.Save(dir + "output.explicitoptions.png");
}Properties
BackgroundColor
Retreu el color de fons de la imatge, si s’especifica.És útil per a aplicacions que necessiten identificar i potencialment manipular.El color de fons d’una imatge.
public override Color BackgroundColor { get; set; }Valor de la propietat
Examples
L’exemple següent mostra com configurar colors completament transparents per a una part d’una imatge TrueColor PNG que no suporta el canal alfa.
Aspose.Imaging.ImageOptions.PngOptions createOptions = new Aspose.Imaging.ImageOptions.PngOptions();
createOptions.Source = new Aspose.Imaging.Sources.FileCreateSource("c:\\temp\\transparent.png", false);
createOptions.ColorType = Aspose.Imaging.FileFormats.Png.PngColorType.Truecolor;
// Create a TrueColor PNG image of 100x100 px.
using (Aspose.Imaging.Image image = Image.Create(createOptions, 100, 100))
{
Aspose.Imaging.FileFormats.Png.PngImage pngImage = (Aspose.Imaging.FileFormats.Png.PngImage)image;
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(pngImage);
// All red pixels will be considered as fully transparent.
pngImage.TransparentColor = Aspose.Imaging.Color.Red;
pngImage.HasTransparentColor = true;
// All transparent pixels will have a background color.
pngImage.BackgroundColor = Aspose.Imaging.Color.Green;
pngImage.HasBackgroundColor = true;
// Fill the entire image with white color.
gr.FillRectangle(new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.White), pngImage.Bounds);
// Fill the top-left quarter of the image with the transparent color.
// This makes the top-left quarter colored in the background color.
Rectangle rect = new Rectangle(0, 0, pngImage.Width / 2, pngImage.Height / 2);
gr.FillRectangle(new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red), rect);
pngImage.Save();
}BitsPerPixel
Retirar els bits per pixel valor per a la imatge. aquesta propietat proporciona crucialinformació sobre la profunditat de color de la imatge, que permet als desenvolupadorsEntendre el nivell de detall i precisió del color present en les dades d’imatge.
public override int BitsPerPixel { get; }Valor de la propietat
FileFormat
Retreu el format del fitxer associat amb l’instància d’imatge.La propietat proporciona informació essencial sobre el tipus de fitxer, que permetGestió i processament eficients basats en els requisits específics del format.
public override FileFormat FileFormat { get; }Valor de la propietat
HasAlpha
Retorna un valor booleà que indica si l’imatge té un canal alfa,que determina la seva transparència. Aquesta propietat és útil per a les aplicacionsla necessitat de gestionar la transparència, permetent als desenvolupadors determinar siEs requereix un processament addicional per gestionar àrees transparents de la imatge.
public override bool HasAlpha { get; }Valor de la propietat
Examples
L’exemple següent mostra com comprovar si una imatge PNG suporta un canal alfa.
// Get all supported PNG color types.
System.Array colorTypes = System.Enum.GetValues(typeof(Aspose.Imaging.FileFormats.Png.PngColorType));
foreach (Aspose.Imaging.FileFormats.Png.PngColorType colorType in colorTypes)
{
Aspose.Imaging.ImageOptions.PngOptions createOptions = new Aspose.Imaging.ImageOptions.PngOptions();
createOptions.Source = new Sources.StreamSource(new System.IO.MemoryStream());
createOptions.ColorType = colorType;
using (Aspose.Imaging.Image image = Image.Create(createOptions, 100, 100))
{
Aspose.Imaging.FileFormats.Png.PngImage pngImage = (Aspose.Imaging.FileFormats.Png.PngImage)image;
if (pngImage.HasAlpha)
{
System.Console.WriteLine("A {0} PNG image supports alpha channel", createOptions.ColorType);
}
else
{
System.Console.WriteLine("A {0} PNG image doesn't support alpha channel", createOptions.ColorType);
}
}
}
// The output looks like this:
// A Grayscale PNG image doesn't support alpha channel
// A Truecolor PNG image doesn't support alpha channel
// A IndexedColor PNG image doesn't support alpha channel
// A GrayscaleWithAlpha PNG image supports alpha channel
// A TruecolorWithAlpha PNG image supports alpha channelHasBackgroundColor
Retreu un valor booleà que indica si la imatge té un color de fons.Aquesta propietat és útil per a les aplicacions que necessiten determinar si una imatgeinclou un color de fons, que pot ser important per a diferents processamentstasques com la composició, el rendiment o l’exportació.
public override bool HasBackgroundColor { get; set; }Valor de la propietat
Examples
L’exemple següent mostra com configurar colors completament transparents per a una part d’una imatge TrueColor PNG que no suporta el canal alfa.
Aspose.Imaging.ImageOptions.PngOptions createOptions = new Aspose.Imaging.ImageOptions.PngOptions();
createOptions.Source = new Aspose.Imaging.Sources.FileCreateSource("c:\\temp\\transparent.png", false);
createOptions.ColorType = Aspose.Imaging.FileFormats.Png.PngColorType.Truecolor;
// Create a TrueColor PNG image of 100x100 px.
using (Aspose.Imaging.Image image = Image.Create(createOptions, 100, 100))
{
Aspose.Imaging.FileFormats.Png.PngImage pngImage = (Aspose.Imaging.FileFormats.Png.PngImage)image;
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(pngImage);
// All red pixels will be considered as fully transparent.
pngImage.TransparentColor = Aspose.Imaging.Color.Red;
pngImage.HasTransparentColor = true;
// All transparent pixels will have a background color.
pngImage.BackgroundColor = Aspose.Imaging.Color.Green;
pngImage.HasBackgroundColor = true;
// Fill the entire image with white color.
gr.FillRectangle(new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.White), pngImage.Bounds);
// Fill the top-left quarter of the image with the transparent color.
// This makes the top-left quarter colored in the background color.
Rectangle rect = new Rectangle(0, 0, pngImage.Width / 2, pngImage.Height / 2);
gr.FillRectangle(new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red), rect);
pngImage.Save();
}HasTransparentColor
Proporciona un valor booleà que indiqui si la imatge conté una transparènciacolor. aquesta propietat és crucial per a les aplicacions que necessiten gestionartransparència, que permet als desenvolupadors determinar si el processament addicional ésnecessària per gestionar regions transparents en la imatge.
public override bool HasTransparentColor { get; set; }Valor de la propietat
Examples
L’exemple següent mostra com configurar colors completament transparents per a una part d’una imatge TrueColor PNG que no suporta el canal alfa.
Aspose.Imaging.ImageOptions.PngOptions createOptions = new Aspose.Imaging.ImageOptions.PngOptions();
createOptions.Source = new Aspose.Imaging.Sources.FileCreateSource("c:\\temp\\transparent.png", false);
createOptions.ColorType = Aspose.Imaging.FileFormats.Png.PngColorType.Truecolor;
// Create a TrueColor PNG image of 100x100 px.
using (Aspose.Imaging.Image image = Image.Create(createOptions, 100, 100))
{
Aspose.Imaging.FileFormats.Png.PngImage pngImage = (Aspose.Imaging.FileFormats.Png.PngImage)image;
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(pngImage);
// All red pixels will be considered as fully transparent.
pngImage.TransparentColor = Aspose.Imaging.Color.Red;
pngImage.HasTransparentColor = true;
// All transparent pixels will have a background color.
pngImage.BackgroundColor = Aspose.Imaging.Color.Green;
pngImage.HasBackgroundColor = true;
// Fill the entire image with white color.
gr.FillRectangle(new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.White), pngImage.Bounds);
// Fill the top-left quarter of the image with the transparent color.
// This makes the top-left quarter colored in the background color.
Rectangle rect = new Rectangle(0, 0, pngImage.Width / 2, pngImage.Height / 2);
gr.FillRectangle(new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red), rect);
pngImage.Save();
}Height
Obtenir l’alçada de la imatge. Aquesta propietat torna la dimensió vertical dela imatge, que permet als desenvolupadors determinar la seva mida en píxels al llarg de laAxiu vertical.
public override int Height { get; }Valor de la propietat
HorizontalResolution
Retirar o modificar la resolució horitzontal de la imatge.representa el nombre de píxels per centímetre al llarg de l’eix horitzontal delAdaptació d’aquesta resolució pot afectar la mida física de la imatge quanImprimida o exposada.
public override double HorizontalResolution { get; set; }Valor de la propietat
Examples
L’exemple següent mostra com configurar la resolució horitzontal/vertical d’una imatge PNG.
string dir = "c:\\temp\\";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.png"))
{
Aspose.Imaging.FileFormats.Png.PngImage pngImage = (Aspose.Imaging.FileFormats.Png.PngImage)image;
// Get horizontal and vertical resolution of the PngImage.
double horizontalResolution = pngImage.HorizontalResolution;
double verticalResolution = pngImage.VerticalResolution;
System.Console.WriteLine("The horizontal resolution, in pixels per inch: {0}", horizontalResolution);
System.Console.WriteLine("The vertical resolution, in pixels per inch: {0}", verticalResolution);
if (horizontalResolution != 96.0 || verticalResolution != 96.0)
{
// Use the SetResolution method for updating both resolution values in a single call.
System.Console.WriteLine("Set resolution values to 96 dpi");
pngImage.SetResolution(96.0, 96.0);
System.Console.WriteLine("The horizontal resolution, in pixels per inch: {0}", pngImage.HorizontalResolution);
System.Console.WriteLine("The vertical resolution, in pixels per inch: {0}", pngImage.VerticalResolution);
}
}Interlaced
Retreu un valor booleà que indica si el Aspose.Imaging.FileFormats.Png.pngImage ésinterlaced, que determina si les dades d’imatge s’emmagatzemen en unamanera per a una càrrega o transmissió més ràpida.
public bool Interlaced { get; }Valor de la propietat
IsInterlaced
Retorna un valor booleà que indica si la instància d’imatge està interligada.La propietat és crucial per optimitzar les estratègies de càrrega i garantir l’eficiènciarendiment durant el processament d’imatge o les tasques de presentació.
public bool IsInterlaced { get; }Valor de la propietat
RawDataFormat
Accedeix al format de dades greus de la imatge. Aquesta propietat proporciona una visió deCom s’estructuren les dades d’imatge internament, que poden ser útils per als avançatstasques de processament d’imatge o conversió de format.
public override PixelDataFormat RawDataFormat { get; }Valor de la propietat
Examples
L’exemple següent carrega imatges PNG i imprimeix informació sobre el format de dades primeres i el canal alfa.
// The PNG images to load.
string[] fileNames = new string[]
{
@"c:\temp\sample.png",
@"c:\temp\alpha.png",
};
foreach (string fileName in fileNames)
{
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(fileName))
{
Aspose.Imaging.FileFormats.Png.PngImage pngImage = (Aspose.Imaging.FileFormats.Png.PngImage)image;
System.Console.WriteLine("ImageFile={0}, FileFormat={1}, HasAlpha={2}", fileName, pngImage.RawDataFormat, pngImage.HasAlpha);
}
}
// The output may look like this:
// ImageFile=c:\temp\sample.png, FileFormat=Rgb24Bpp, used channels: 8,8,8, HasAlpha=False
// ImageFile=c:\temp\alpha.png, FileFormat=RGBA32Bpp, used channels: 8,8,8,8, HasAlpha=TrueTransparentColor
Retreu el color transparent de la imatge, si existeix.Valorable per a les aplicacions que requereixen una gestió precisa de zones transparentsdins de les imatges, que permeten als desenvolupadors accedir i manipular elcolor transparent utilitzat.
public override Color TransparentColor { get; set; }Valor de la propietat
Examples
L’exemple següent mostra com configurar colors completament transparents per a una part d’una imatge TrueColor PNG que no suporta el canal alfa.
Aspose.Imaging.ImageOptions.PngOptions createOptions = new Aspose.Imaging.ImageOptions.PngOptions();
createOptions.Source = new Aspose.Imaging.Sources.FileCreateSource("c:\\temp\\transparent.png", false);
createOptions.ColorType = Aspose.Imaging.FileFormats.Png.PngColorType.Truecolor;
// Create a TrueColor PNG image of 100x100 px.
using (Aspose.Imaging.Image image = Image.Create(createOptions, 100, 100))
{
Aspose.Imaging.FileFormats.Png.PngImage pngImage = (Aspose.Imaging.FileFormats.Png.PngImage)image;
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(pngImage);
// All red pixels will be considered as fully transparent.
pngImage.TransparentColor = Aspose.Imaging.Color.Red;
pngImage.HasTransparentColor = true;
// All transparent pixels will have a background color.
pngImage.BackgroundColor = Aspose.Imaging.Color.Green;
pngImage.HasBackgroundColor = true;
// Fill the entire image with white color.
gr.FillRectangle(new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.White), pngImage.Bounds);
// Fill the top-left quarter of the image with the transparent color.
// This makes the top-left quarter colored in the background color.
Rectangle rect = new Rectangle(0, 0, pngImage.Width / 2, pngImage.Height / 2);
gr.FillRectangle(new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red), rect);
pngImage.Save();
}VerticalResolution
Proporciona accés a la resolució vertical de la imatge. els desenvolupadors poden utilitzaraquesta propietat per recuperar o modificar l’establiment de resolució, que indica laNúmero de píxels per pols (PPI) al llarg de l’eix vertical de la imatge.
public override double VerticalResolution { get; set; }Valor de la propietat
Examples
L’exemple següent mostra com configurar la resolució horitzontal/vertical d’una imatge PNG.
string dir = "c:\\temp\\";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.png"))
{
Aspose.Imaging.FileFormats.Png.PngImage pngImage = (Aspose.Imaging.FileFormats.Png.PngImage)image;
// Get horizontal and vertical resolution of the PngImage.
double horizontalResolution = pngImage.HorizontalResolution;
double verticalResolution = pngImage.VerticalResolution;
System.Console.WriteLine("The horizontal resolution, in pixels per inch: {0}", horizontalResolution);
System.Console.WriteLine("The vertical resolution, in pixels per inch: {0}", verticalResolution);
if (horizontalResolution != 96.0 || verticalResolution != 96.0)
{
// Use the SetResolution method for updating both resolution values in a single call.
System.Console.WriteLine("Set resolution values to 96 dpi");
pngImage.SetResolution(96.0, 96.0);
System.Console.WriteLine("The horizontal resolution, in pixels per inch: {0}", pngImage.HorizontalResolution);
System.Console.WriteLine("The vertical resolution, in pixels per inch: {0}", pngImage.VerticalResolution);
}
}Width
Permet la recuperació de l’amplada de la imatge, proporcionant informació essencialAquesta propietat és freqüentment utilitzada pels desenvolupadors perdeterminar l’amplada de la imatge, permetent-los realitzar diverses operacions basades enEn la seva grandària
public override int Width { get; }Valor de la propietat
XmpData
Accedeix o modifica els metadats associats a la Plataforma de Metadades Extensibles (XMP)Aquesta propietat facilita l’extracció, la modificació, oAddició de metadades, que permet una gestió integral de la informació relacionada amb la imatge.
public override XmpPacketWrapper XmpData { get; set; }Valor de la propietat
Methods
GetDefaultOptions(Objecte[])
Obtenir les opcions de default.
public override ImageOptionsBase GetDefaultOptions(object[] args)Parameters
args object
[]
Els arguments .
Returns
Opcions de default
GetModifyDate(La botiga)
Retreu l’estamp horari que indica la modificació més recent de la fontAquest mètode proporciona accés a metadades vitals, permetent que les aplicacionsdeterminar quan l’imatge va ser modificada per últim cop, facilitant el seguiment de la versió iGestió del contingut.
public override DateTime GetModifyDate(bool useDefault)Parameters
useDefault bool
si s’estableix a ’true’ utilitza la informació de FileInfo com a valor estàndard.
Returns
La data i l’hora de la imatge de recursos es va modificar per última vegada.
GetOriginalOptions()
Obté les opcions basades en la configuració original del fitxer.Això pot ser útil per mantenir la profunditat de bit i altres paràmetres de la imatge original sense canvis.Per exemple, si carregem una imatge PNG de blanc i negre amb 1 bit per píxel i llavors l’emmagatzememàvem utilitzant elAspose.Imaging.DataStreamSupporter.Save(System.String) mètode, la imatge PNG de sortida amb 8 bits per píxel es produirà.Per evitar-ho i salvar la imatge PNG amb 1 bit per píxel, utilitzeu aquest mètode per obtenir les opcions d’estalvi corresponents i passar-losEl mètode Aspose.Imaging.Image.Save (System.String,_Wl17.ImagineOptionsBase) és el segon paràmetre.
public override ImageOptionsBase GetOriginalOptions()Returns
Les opcions basades en la configuració original del fitxer.
OnPaletteChanged(Col·lecció IColorPalette)
Es diu quan es canvia la paleta.
protected override void OnPaletteChanged(IColorPalette oldPalette, IColorPalette newPalette)Parameters
oldPalette IColorPalette
La vella paleta.
newPalette IColorPalette
La nova paleta.
SaveData(Stream)
El salvatge de dades.
protected override void SaveData(Stream stream)Parameters
stream Stream
El corrent.
UpdateDimensions(Int, Int)
Les dimensions actualitzades.
protected override void UpdateDimensions(int newWidth, int newHeight)Parameters
newWidth int
La nova amplada.
newHeight int
La nova alçada.
UpdateMetadata()
Actualitza la imatge data i hora de l’última modificació.
protected override void UpdateMetadata()
