Class JpegImage
Nome do espaço: Aspose.Imaging.FileFormats.Jpeg Assembleia: Aspose.Imaging.dll (25.4.0)
Manipular eficientemente imagens de raster JPEG com a nossa API, oferecendo suportepara diferentes perfis de cores, como RGB e CMYK, bits personalizáveis por pixelResolução e processamento de EXIF, JFIF e XMP metadados.Aproveite a rotação automatizada com base em dados de orientação e escolha entre diferentesNíveis de compressão, incluindo JPEG sem perda, para alcançar a qualidade da imagem idealFaça um balanço de tamanho para seus projetos.
[JsonObject(MemberSerialization.OptIn)]
public sealed class JpegImage : RasterCachedImage, IDisposable, IObjectWithBounds, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IHasXmpData, IHasJpegExifData, IHasExifData, IHasMetadataInheritance
object ← DisposableObject ← DataStreamSupporter ← Image ← RasterImage ← RasterCachedImage ← JpegImage
Implements
IDisposable , IObjectWithBounds , IRasterImageArgb32PixelLoader , IRasterImageRawDataLoader , IHasXmpData , IHasJpegExifData , IHasExifData , IHasMetadata
Membros herdados
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.IsCached , 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.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 , 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.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.CacheData() , DataStreamSupporter.Save() , DataStreamSupporter.Save(Stream) , DataStreamSupporter.Save(string) , DataStreamSupporter.Save(string, bool) , DataStreamSupporter.DataStreamContainer , DataStreamSupporter.IsCached , DisposableObject.Dispose() , DisposableObject.Disposed , object.GetType() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Examples
Acessar as notas do fabricante de câmera em imagem Jpeg.
using (var image = (JpegImage)Image.Load("Sample.jpg"))
{
foreach (var makerNote in image.ExifData.MakerNotes)
{
Console.WriteLine("Name = {0}, Value = {1}", makerNote.Name, makerNote.Value);
}
}O exemplo mostra como carregar um JpegImage de um arquivo.
string dir = "c:\\temp\\";
// Load a JPEG image from a file.
using (Aspose.Imaging.FileFormats.Jpeg.JpegImage jpegImage = new Aspose.Imaging.FileFormats.Jpeg.JpegImage(dir + "sample.jpg"))
{
// Do some image processing.
// Save to another JPEG file.
jpegImage.Save(dir + "sample.output.jpg");
}Constructors
JpegImage(Redação)
A classe Aspose.Imaging.FileFormats.Jpeg.JpegImage inicia sem esforço, invocando a suaConstructor com o parâmetro do caminho especificado. este Constructor permite semcriação de imagens JPEG, garantindo integração rápida em seus projetos com facilidade.
public JpegImage(string path)Parameters
path string
O caminho para carregar a imagem e iniciar os dados de pixel e paleta com.
Examples
O exemplo mostra como carregar um JpegImage de um arquivo.
string dir = "c:\\temp\\";
// Load a JPEG image from a file.
using (Aspose.Imaging.FileFormats.Jpeg.JpegImage jpegImage = new Aspose.Imaging.FileFormats.Jpeg.JpegImage(dir + "sample.jpg"))
{
// Do some image processing.
// Save to another JPEG file.
jpegImage.Save(dir + "sample.output.jpg");
}JpegImage(Stream)
Iniciar um objeto de imagem JPEG com a classe Aspose.Imaging.FileFormats.Jpeg.JpegImage usando umaEste construtor simplifica o processo de trabalho com JPEGimagens, oferecendo uma abordagem simples para integrá-las em seus projetossem esforço.
public JpegImage(Stream stream)Parameters
stream Stream
O fluxo para carregar a imagem e iniciar os dados de pixel e paleta com.
Examples
O exemplo mostra como carregar um JpegImage de um fluxo de arquivo.
string dir = "c:\\temp\\";
// Load a JPEG image from a file stream.
using (System.IO.Stream stream = System.IO.File.OpenRead(dir + "sample.jpg"))
{
using (Aspose.Imaging.FileFormats.Jpeg.JpegImage jpegImage = new Aspose.Imaging.FileFormats.Jpeg.JpegImage(stream))
{
// Do some image processing.
// Save to another JPEG file.
jpegImage.Save(dir + "sample.output.jpg");
}
}JpegImage(RasterImage)
Iniciar uma nova instância da classe Aspose.Imaging.FileFormats.Jpeg.JpegImage com uma imagem de rasterEste construtor fornece uma maneira conveniente de criar imagens JPEGdiretamente das imagens raster, simplificando o fluxo de trabalho para trabalhar com imagens JPEGem suas aplicações.
public JpegImage(RasterImage rasterImage)Parameters
rasterImage RasterImage
A imagem para iniciar o pixel e os dados de paleta com.
Examples
O exemplo mostra como carregar um JpegImage de outro RasterImage.
string dir = "c:\\temp\\";
// Load a JPEG image from another raster image.
// First, create a temporal PNG image that will be a foundation for building a JPEG image.
// You can also load PNG image from a file or use an image of any other raster format.
Aspose.Imaging.ImageOptions.PngOptions createOptions = new Aspose.Imaging.ImageOptions.PngOptions();
createOptions.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), false);
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 graphics = new Aspose.Imaging.Graphics(rasterImage);
Aspose.Imaging.Brushes.SolidBrush brush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red);
graphics.FillRectangle(brush, rasterImage.Bounds);
// Create a JPEG image based on the PNG image.
using (Aspose.Imaging.FileFormats.Jpeg.JpegImage jpegImage = new Aspose.Imaging.FileFormats.Jpeg.JpegImage(rasterImage))
{
// Save to a JPEG file
jpegImage.Save(dir + "output.jpg");
}
}JpegImage(Int, Int)
Crie uma nova instância da classe Aspose.Imaging.FileFormats.Jpeg.JpegImage com a largura especificadaEste construtor permite que você crie imagens JPEG comdimensões personalizadas, dando-lhe flexibilidade na gestão de tamanhos de imagem em sua aplicação.
public JpegImage(int width, int height)Parameters
width int
A imagem de largura.
height int
A altura da imagem.
Examples
O exemplo a seguir mostra como criar uma imagem JPEG do tamanho especificado.
string dir = "c:\\temp\\";
// Create a JPEG image of 100x100 px.
using (Aspose.Imaging.FileFormats.Jpeg.JpegImage jpegImage = new Aspose.Imaging.FileFormats.Jpeg.JpegImage(100, 100))
{
// Do some image processing.
// Save to a file.
jpegImage.Save(dir + "output.jpg");
}O exemplo a seguir carrega uma imagem BMP e a salva para JPEG usando várias opções de armazenamento.
string dir = "c:\\temp\\";
// Load a BMP image from a file.
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.bmp"))
{
// Do some image processing.
// Use additional options to specify the desired image parameters.
Aspose.Imaging.ImageOptions.JpegOptions saveOptions = new Aspose.Imaging.ImageOptions.JpegOptions();
// The number of bits per channel is 8.
// When a palette is used, the color index is stored in the image data instead of the color itself.
saveOptions.BitsPerChannel = 8;
// Set the progressive type of compression.
saveOptions.CompressionType = Aspose.Imaging.FileFormats.Jpeg.JpegCompressionMode.Progressive;
// Set the image quality. It is a value between 1 and 100.
saveOptions.Quality = 100;
// Set the horizontal/vertical resolution to 96 dots per inch.
saveOptions.ResolutionSettings = new Aspose.Imaging.ResolutionSetting(96.0, 96.0);
saveOptions.ResolutionUnit = Aspose.Imaging.ResolutionUnit.Inch;
// If the source image is colored, it will be converted to grayscaled.
saveOptions.ColorType = Aspose.Imaging.FileFormats.Jpeg.JpegCompressionColorMode.Grayscale;
// Use a palette to reduce the output size.
saveOptions.Palette = Aspose.Imaging.ColorPaletteHelper.Create8BitGrayscale(false);
image.Save(dir + "sample.palettized.jpg", saveOptions);
}JpegImage(JpegOpções, int, int)
Iniciar um novo Objeto Aspose.Imaging.FileFormats.Jpeg.JpegImage com as opções JPEG fornecidas.Este construtor permite que você ajuste várias configurações para a imagem JPEG, tais como:como nível de compressão, qualidade e parâmetros adicionais, dando controle precisosobre o formato de imagem resultante.
public JpegImage(JpegOptions jpegOptions, int width, int height)Parameters
jpegOptions JpegOptions
As opções do JPEG.
width int
Imagem de largura.
height int
altura da imagem.
Examples
O exemplo a seguir carrega uma imagem BMP e a salva para JPEG usando várias opções de armazenamento.
string dir = "c:\\temp\\";
// Load a BMP image from a file.
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.bmp"))
{
// Do some image processing.
// Use additional options to specify the desired image parameters.
Aspose.Imaging.ImageOptions.JpegOptions saveOptions = new Aspose.Imaging.ImageOptions.JpegOptions();
// The number of bits per channel is 8.
// When a palette is used, the color index is stored in the image data instead of the color itself.
saveOptions.BitsPerChannel = 8;
// Set the progressive type of compression.
saveOptions.CompressionType = Aspose.Imaging.FileFormats.Jpeg.JpegCompressionMode.Progressive;
// Set the image quality. It is a value between 1 and 100.
saveOptions.Quality = 100;
// Set the horizontal/vertical resolution to 96 dots per inch.
saveOptions.ResolutionSettings = new Aspose.Imaging.ResolutionSetting(96.0, 96.0);
saveOptions.ResolutionUnit = Aspose.Imaging.ResolutionUnit.Inch;
// If the source image is colored, it will be converted to grayscaled.
saveOptions.ColorType = Aspose.Imaging.FileFormats.Jpeg.JpegCompressionColorMode.Grayscale;
// Use a palette to reduce the output size.
saveOptions.Palette = Aspose.Imaging.ColorPaletteHelper.Create8BitGrayscale(false);
image.Save(dir + "sample.palettized.jpg", saveOptions);
}O exemplo a seguir mostra como criar uma imagem JPEG do tamanho especificado com os parâmetros especificados.
string dir = "c:\\temp\\";
// Create a JPEG image of 100x100 px.
// Use additional options to specify the desired image parameters.
Aspose.Imaging.ImageOptions.JpegOptions createOptions = new Aspose.Imaging.ImageOptions.JpegOptions();
// The number of bits per channel is 8, 8, 8 for Y, Cr, Cb components accordingly.
createOptions.BitsPerChannel = 8;
// Set the progressive type of compression.
createOptions.CompressionType = Aspose.Imaging.FileFormats.Jpeg.JpegCompressionMode.Progressive;
// Set the image quality. It is a value between 1 and 100.
createOptions.Quality = 100;
// Set the horizontal/vertical resolution to 96 dots per inch.
createOptions.ResolutionSettings = new Aspose.Imaging.ResolutionSetting(96.0, 96.0);
createOptions.ResolutionUnit = Aspose.Imaging.ResolutionUnit.Inch;
// This is a standard option for JPEG images.
// Two chroma components (Cb and Cr) can be bandwidth-reduced, subsampled, compressed.
createOptions.ColorType = Aspose.Imaging.FileFormats.Jpeg.JpegCompressionColorMode.YCbCr;
using (Aspose.Imaging.FileFormats.Jpeg.JpegImage jpegImage = new Aspose.Imaging.FileFormats.Jpeg.JpegImage(createOptions, 100, 100))
{
Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(jpegImage);
Aspose.Imaging.Brushes.LinearGradientBrush gradientBrush = new Aspose.Imaging.Brushes.LinearGradientBrush(
new Aspose.Imaging.Point(0, 0),
new Aspose.Imaging.Point(jpegImage.Width, jpegImage.Height),
Aspose.Imaging.Color.Yellow,
Aspose.Imaging.Color.Blue);
// Fill the image with a grayscale gradient
graphics.FillRectangle(gradientBrush, jpegImage.Bounds);
// Save to a file.
jpegImage.Save(dir + "output.explicitoptions.jpg");
}Properties
BitsPerPixel
Retire a profundidade do pixel da imagem sem esforço com esta propriedade, oferecendocompreensão da riqueza da cor ou representação de escalas cinzas.uma fotografia vibrante ou uma ilustração monocroma, esta propriedade fornece uminformações sobre a complexidade visual da imagem.
public override int BitsPerPixel { get; }Valor da propriedade
CmykColorProfile
O perfil de cor CMYK associado com imagens CMYK e YCCK JPEG garante precisãoconversão de cores e fidelidade. funciona em conjunto com o RGBColorProfile paraGarantir a exata representação de cores em vários dispositivos e aplicações.Esta paragem é crucial para manter a consistência na renderização de cores eObtenha a melhor qualidade de imagem.
public StreamSource CmykColorProfile { get; set; }Valor da propriedade
Examples
O exemplo a seguir carrega PNG e o salva para CMYK JPEG usando o perfil ICC personalizado. Em seguida, carrega CMYK JPEG e o salva de volta para PNG. A conversão de cores de RGB para CMYK e de CMYK para RGB é realizada usando perfis ICC personalizados.
string dir = "c:\\temp\\";
// Load PNG and save it to CMYK JPEG
using (Aspose.Imaging.FileFormats.Png.PngImage image = (Aspose.Imaging.FileFormats.Png.PngImage)Image.Load(dir + "sample.png"))
{
using (System.IO.Stream rgbProfileStream = System.IO.File.OpenRead(dir + "eciRGB_v2.icc"))
using (System.IO.Stream cmykProfileStream = System.IO.File.OpenRead(dir + "ISOcoated_v2_FullGamut4.icc"))
{
Aspose.Imaging.ImageOptions.JpegOptions saveOptions = new Aspose.Imaging.ImageOptions.JpegOptions();
saveOptions.ColorType = Aspose.Imaging.FileFormats.Jpeg.JpegCompressionColorMode.Cmyk;
// Use custom ICC profiles
saveOptions.RgbColorProfile = new Aspose.Imaging.Sources.StreamSource(rgbProfileStream);
saveOptions.CmykColorProfile = new Aspose.Imaging.Sources.StreamSource(cmykProfileStream);
image.Save(dir + "output.cmyk.jpg", saveOptions);
}
}
// Load CMYK JPEG and save it to PNG
using (Aspose.Imaging.FileFormats.Jpeg.JpegImage image = (Aspose.Imaging.FileFormats.Jpeg.JpegImage)Image.Load(dir + "output.cmyk.jpg"))
{
using (System.IO.Stream rgbProfileStream = System.IO.File.OpenRead(dir + "eciRGB_v2.icc"))
using (System.IO.Stream cmykProfileStream = System.IO.File.OpenRead(dir + "ISOcoated_v2_FullGamut4.icc"))
{
// Use custom ICC profiles
image.RgbColorProfile = new Aspose.Imaging.Sources.StreamSource(rgbProfileStream);
image.CmykColorProfile = new Aspose.Imaging.Sources.StreamSource(cmykProfileStream);
Aspose.Imaging.ImageOptions.PngOptions saveOptions = new Aspose.Imaging.ImageOptions.PngOptions();
image.Save(dir + "output.rgb.png", saveOptions);
}
}Comment
Gerenciar comentários de arquivo JPEG com esta propriedade, permitindo que você adicione ou recebaanotações descritivas associadas à imagem. se é etiquetar imagens commetadados ou apontando um contexto adicional, esta propriedade oferece flexibilidade emOrganizar e categorizar seus arquivos JPEG.
public string Comment { get; set; }Valor da propriedade
DestinationCmykColorProfile
O perfil de cor CMYK é vital para a conversão de cor precisa de CMYK e YCCKImagens JPEG durante o processo de poupança. funciona em tandem com o RGBColorProfilepara garantir a representação correto da cor, mantendo a consistência e a qualidade em todo odiferentes dispositivos e software. esta sincronização é crucial para alcançarrenderização de cor precisa e confiável nas imagens salvas finais.
public StreamSource DestinationCmykColorProfile { get; set; }Valor da propriedade
DestinationRgbColorProfile
O RGBColorProfile é essencial para a conversão de cor precisa de CMYK e YCCKImagens JPEG durante o processo de poupança.Quando parado com o CMYKColorProfile,Assegura que as cores são renderizadas corretamente e mantém a consistência entrediferentes dispositivos e aplicações. esta combinação é crucial para preservar orepresentação de cores pretendidas e alcançar a produção de imagem de alta qualidade.
public StreamSource DestinationRgbColorProfile { get; set; }Valor da propriedade
ExifData
Gerenciar dados EXIF com esta propriedade, permitindo que você adicione ou receba metadadosrelacionado com a imagem. se é extrair informações sobre a câmeraconfigurações ou modificação de metadados existentes, esta propriedade oferece flexibilidade emGestão do Conteúdo de Dados EXIF.
public JpegExifData ExifData { get; set; }Valor da propriedade
Examples
O exemplo a seguir mostra como extrair tags EXIF de uma imagem JPEG.
string dir = "c:\\temp\\";
using (Aspose.Imaging.FileFormats.Jpeg.JpegImage image = (Aspose.Imaging.FileFormats.Jpeg.JpegImage)Image.Load(dir + "original.jpg"))
{
Aspose.Imaging.Exif.ExifData exifData = image.ExifData;
System.Console.WriteLine("The general EXIF data");
System.Console.WriteLine("------------------------------------------");
if (exifData != null)
{
System.Console.WriteLine("The EXIF version: {0}", exifData.ExifVersion);
System.Console.WriteLine("The camera serial number: {0}", exifData.BodySerialNumber);
System.Console.WriteLine("The color space: {0}", exifData.ColorSpace);
System.Console.WriteLine("The brightness: {0}", exifData.BrightnessValue);
System.Console.WriteLine("The contrast: {0}", exifData.Contrast);
System.Console.WriteLine("The gamma: {0}", exifData.Gamma);
System.Console.WriteLine("The sharpness: {0}", exifData.Sharpness);
System.Console.WriteLine("The aperture: {0}", exifData.ApertureValue);
System.Console.WriteLine("The exposure mode: {0}", exifData.ExposureMode);
System.Console.WriteLine("The exposure bias: {0}", exifData.ExposureBiasValue);
System.Console.WriteLine("The exposure time: {0}", exifData.ExposureTime);
System.Console.WriteLine("The focal length: {0}", exifData.FocalLength);
System.Console.WriteLine("The focal plane resolution unit: {0}", exifData.FocalPlaneResolutionUnit);
System.Console.WriteLine("The lens model: {0}", exifData.LensModel);
System.Console.WriteLine("The shutter speed: {0}", exifData.ShutterSpeedValue);
}
System.Console.WriteLine("The JPEG EXIF data");
System.Console.WriteLine("------------------------------------------");
Aspose.Imaging.Exif.JpegExifData jpegExifData = image.ExifData as Aspose.Imaging.Exif.JpegExifData;
if (jpegExifData != null)
{
System.Console.WriteLine("The camera manufacturer: {0}", jpegExifData.Make);
System.Console.WriteLine("The camera model: {0}", jpegExifData.Model);
System.Console.WriteLine("The photometric interpretation: {0}", jpegExifData.PhotometricInterpretation);
System.Console.WriteLine("The artist: {0}", jpegExifData.Artist);
System.Console.WriteLine("The copyright: {0}", jpegExifData.Copyright);
System.Console.WriteLine("The image description: {0}", jpegExifData.ImageDescription);
System.Console.WriteLine("The orientation: {0}", jpegExifData.Orientation);
System.Console.WriteLine("The software: {0}", jpegExifData.Software);
}
}
//The output looks like this:
//The general EXIF data
//------------------------------------------
//The EXIF version: System.Byte[]
//The camera serial number: 7100536
//The color space: SRgb
//The brightness:
//The contrast: Normal
//The gamma:
//The sharpness: 0
//The aperture: 4.64(4643856 / 1000000)
//The exposure mode: Manual
//The exposure bias: 0.67(4 / 6)
//The exposure time: 0.01(1 / 160)
//The focal length: 145.00(1450 / 10)
//The focal plane resolution unit: Cm
//The lens model: 70.0 - 200.0 mm f/ 4.0
//The shutter speed: 7.32(7321928 / 1000000)
//The JPEG EXIF data
//------------------------------------------
//The camera manufacturer: NIKON CORPORATION
//The camera model: NIKON D5
//The photometric interpretation: 0
//The artist:
//The copyright:
//The image description:
//The orientation: TopLeft
//The software: Adobe Photoshop Camera Raw 9.9(Macintosh)FileFormat
Retirar o formato da imagem sem esforço com esta propriedade.uma visão valiosa do formato de arquivo, ajudando na integração sem fundo eVerificação de compatibilidade em várias plataformas e aplicações.
public override FileFormat FileFormat { get; }Valor da propriedade
Height
Retire a altura da imagem sem esforço com esta propriedade.acesso à dimensão vertical da imagem, permitindo que vocêdeterminar o seu tamanho e o seu aspecto sem a necessidade de cálculos complexos oumétodos adicionais.
public override int Height { get; }Valor da propriedade
HorizontalResolution
Esta propriedade permite-lhe o acesso à resolução horizontal doAspose.Imaging.RasterImage, medido em pixels por polegada.Este valor, você pode controlar com precisão a resolução da imagem, garantindo-asatisfaz os seus requisitos específicos de qualidade e clareza.
public override double HorizontalResolution { get; set; }Valor da propriedade
Examples
O exemplo a seguir mostra como definir a resolução horizontal/vertical de uma imagem JPEG.
string dir = "c:\\temp\\";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.jpg"))
{
Aspose.Imaging.FileFormats.Jpeg.JpegImage jpegImage = (Aspose.Imaging.FileFormats.Jpeg.JpegImage)image;
// Get horizontal and vertical resolution of the BmpImage
double horizontalResolution = jpegImage.HorizontalResolution;
double verticalResolution = jpegImage.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");
jpegImage.SetResolution(96.0, 96.0);
System.Console.WriteLine("The horizontal resolution, in pixels per inch: {0}", jpegImage.HorizontalResolution);
System.Console.WriteLine("The vertical resolution, in pixels per inch: {0}", jpegImage.VerticalResolution);
}
// The output may look like this:
// The horizontal resolution, in pixels per inch: 300
// The vertical resolution, in pixels per inch: 300
// Set resolution values to 96 dpi
// The horizontal resolution, in pixels per inch: 96
// The vertical resolution, in pixels per inch: 96
}Remarks
Nota por padrão este valor é sempre 96 porque diferentes plataformas não podem devolver a resolução da tela. Você pode considerar usar o método SetResolution para atualizar ambos os valores de resolução em uma única chamada.
IgnoreEmbeddedColorProfile
Retira ou altera a bandeira indicando se o perfil de cor incorporado éAo configurar esta bandeira, os usuários podem especificar se a cor padrãoO perfil deve ser usado em vez do incorporado. esta opção garante maiorcontrole sobre a gestão de cores, facilitando ajustes para a consistência eCompatibilidade em várias plataformas e aplicações.
public bool IgnoreEmbeddedColorProfile { get; set; }Valor da propriedade
Jfif
Esta propriedade permite que você acesse ou modifique o JFIF (JPEG File Interchange)formato) dados associados à imagem JPEG. JFIF é um formato padrão paratroca de imagens compressas JPEG entre computadores e outros dispositivos.ou configurar esta propriedade, você pode interagir com os dados JFIF, que podem incluirInformações como a resolução da imagem, a proporção de aspecto e o detalhe.
public JFIFData Jfif { get; set; }Valor da propriedade
JpegOptions
Obtenha acesso às opções JPEG empregadas durante a criação ou carregamento desteAspose.Imaging.FileFormats.Jpeg.JpegImage instância com facilidade. esta propriedade oferece detalhes valiosossobre as configurações específicas utilizadas, permitindo aos usuários compreender e replicarprocessamento de imagem fluxos de trabalho efetivamente. se é níveis de compressão, qualidadeconfigurações, ou outros parâmetros, esta propriedade fornece insights essenciais paramanipulação de imagem.
public JpegOptions JpegOptions { get; }Valor da propriedade
Examples
O exemplo a seguir mostra como extrair as informações do cabeçalho de uma imagem JPEG.
string dir = "c:\\temp\\";
using (Aspose.Imaging.FileFormats.Jpeg.JpegImage image = (Aspose.Imaging.FileFormats.Jpeg.JpegImage)Image.Load(dir + "original.jpg"))
{
Aspose.Imaging.ImageOptions.JpegOptions jpegOptions = image.JpegOptions;
System.Console.WriteLine("The number of bits per channel: {0}", jpegOptions.BitsPerChannel);
System.Console.WriteLine("The max allowed size for all internal buffers: {0}", jpegOptions.BufferSizeHint);
System.Console.WriteLine("The color type: {0}", jpegOptions.ColorType);
System.Console.WriteLine("The compression type: {0}", jpegOptions.CompressionType);
System.Console.WriteLine("The image quality: {0}", jpegOptions.Quality);
if (jpegOptions.ResolutionSettings != null)
{
System.Console.WriteLine("The horizontal resolution: {0}", jpegOptions.ResolutionSettings.HorizontalResolution);
System.Console.WriteLine("The vertical resolution: {0}", jpegOptions.ResolutionSettings.VerticalResolution);
}
for (int i = 0; i < jpegOptions.HorizontalSampling.Length; i++)
{
System.Console.WriteLine("The sampling for component {0}: {1}x{2}", i, jpegOptions.HorizontalSampling[i], jpegOptions.VerticalSampling[i]);
}
}
//The output looks like this:
//The number of bits per channel: 8
//The max allowed size for all internal buffers: 0
//The color type: YCbCr
//The compression type: Baseline
//The image quality: 75
//The sampling for component 0: 1x1
//The sampling for component 1: 1x1
//The sampling for component 2: 1x1RawDataFormat
Esta propriedade recebe o formato de dados raízes da imagem, que indica como odados de imagem é estruturado e codificado. compreender o formato de dados crus éessencial para o processamento ou manipulação efetiva dos dados da imagem.a representação subjacente da imagem, como seComprimido, codificado em um espaço de cor específico, ou armazenado em um arquivo específicoO acesso a esta propriedade permite que você obtenha informações valiosas sobreestrutura de dados da imagem, permitindo que você execute várias operações ou otimizaçõesadaptada ao seu formato específico.
public override PixelDataFormat RawDataFormat { get; }Valor da propriedade
RgbColorProfile
O perfil de cor RGB para imagens CMYK e YCCK JPEG garante a cor precisaconversão e representação. deve ser parado com o CMYKColorProfile paramanter a consistência e fidelidade na renderização de cores. este par é essencial paraAplicações que exigem gestão de cor precisa e reprodução de imagens,Garantir que os dados RGB sejam corretamente interpretados e exibidos.
public StreamSource RgbColorProfile { get; set; }Valor da propriedade
Examples
O exemplo a seguir carrega PNG e o salva para CMYK JPEG usando o perfil ICC personalizado. Em seguida, carrega CMYK JPEG e o salva de volta para PNG. A conversão de cores de RGB para CMYK e de CMYK para RGB é realizada usando perfis ICC personalizados.
string dir = "c:\\temp\\";
// Load PNG and save it to CMYK JPEG
using (Aspose.Imaging.FileFormats.Png.PngImage image = (Aspose.Imaging.FileFormats.Png.PngImage)Image.Load(dir + "sample.png"))
{
using (System.IO.Stream rgbProfileStream = System.IO.File.OpenRead(dir + "eciRGB_v2.icc"))
using (System.IO.Stream cmykProfileStream = System.IO.File.OpenRead(dir + "ISOcoated_v2_FullGamut4.icc"))
{
Aspose.Imaging.ImageOptions.JpegOptions saveOptions = new Aspose.Imaging.ImageOptions.JpegOptions();
saveOptions.ColorType = Aspose.Imaging.FileFormats.Jpeg.JpegCompressionColorMode.Cmyk;
// Use custom ICC profiles
saveOptions.RgbColorProfile = new Aspose.Imaging.Sources.StreamSource(rgbProfileStream);
saveOptions.CmykColorProfile = new Aspose.Imaging.Sources.StreamSource(cmykProfileStream);
image.Save(dir + "output.cmyk.jpg", saveOptions);
}
}
// Load CMYK JPEG and save it to PNG
using (Aspose.Imaging.FileFormats.Jpeg.JpegImage image = (Aspose.Imaging.FileFormats.Jpeg.JpegImage)Image.Load(dir + "output.cmyk.jpg"))
{
using (System.IO.Stream rgbProfileStream = System.IO.File.OpenRead(dir + "eciRGB_v2.icc"))
using (System.IO.Stream cmykProfileStream = System.IO.File.OpenRead(dir + "ISOcoated_v2_FullGamut4.icc"))
{
// Use custom ICC profiles
image.RgbColorProfile = new Aspose.Imaging.Sources.StreamSource(rgbProfileStream);
image.CmykColorProfile = new Aspose.Imaging.Sources.StreamSource(cmykProfileStream);
Aspose.Imaging.ImageOptions.PngOptions saveOptions = new Aspose.Imaging.ImageOptions.PngOptions();
image.Save(dir + "output.rgb.png", saveOptions);
}
}VerticalResolution
Esta propriedade gerencia a resolução vertical, expressa em pixels por polegada, parao associado Aspose.Imaging.RasterImage. Ajustando esta resolução afeta otamanho e qualidade da imagem quando impresso ou exibido em tamanho físico fixo.Ao configurar esta propriedade, você controla a densidade dos pixels da imagem embalados.verticalmente, afetando a sua acidez e clareza geral.
public override double VerticalResolution { get; set; }Valor da propriedade
Examples
O exemplo a seguir mostra como definir a resolução horizontal/vertical de uma imagem JPEG.
string dir = "c:\\temp\\";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.jpg"))
{
Aspose.Imaging.FileFormats.Jpeg.JpegImage jpegImage = (Aspose.Imaging.FileFormats.Jpeg.JpegImage)image;
// Get horizontal and vertical resolution of the BmpImage
double horizontalResolution = jpegImage.HorizontalResolution;
double verticalResolution = jpegImage.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");
jpegImage.SetResolution(96.0, 96.0);
System.Console.WriteLine("The horizontal resolution, in pixels per inch: {0}", jpegImage.HorizontalResolution);
System.Console.WriteLine("The vertical resolution, in pixels per inch: {0}", jpegImage.VerticalResolution);
}
// The output may look like this:
// The horizontal resolution, in pixels per inch: 300
// The vertical resolution, in pixels per inch: 300
// Set resolution values to 96 dpi
// The horizontal resolution, in pixels per inch: 96
// The vertical resolution, in pixels per inch: 96
}Remarks
Nota por padrão este valor é sempre 72 porque diferentes plataformas não podem devolver a resolução da tela. Você pode considerar usar o método SetResolution para atualizar ambos os valores de resolução em uma única chamada.
Width
Esta propriedade recebe a largura da imagem, expressa em pixels.informações essenciais sobre as dimensões da imagem, permitindo renderização precisa,manipulação ou exibição dos dados da imagem.
public override int Width { get; }Valor da propriedade
XmpData
Recebe ou coleta metadados XMP, permitindo a integração sem fundo deinformações descritivas para o arquivo de imagem. se você está extraindo um XMP existentemetadados ou atualizá-los com novas informações, esta propriedade simplifica agerenciamento de metadados extensos, assegurando a compatibilidade com várias aplicaçõese os fluxos de trabalho.
public override XmpPacketWrapper XmpData { get; set; }Valor da propriedade
Methods
AutoRotate()
Rote automaticamente a imagem com base em dados de orientação extraídos do ExifEste método garante que as imagens são exibidas na direção correta,melhorar a experiência do usuário e eliminar a necessidade de ajustes manuais.analisando as informações do Exif, a imagem é rotada de acordo, proporcionando umaexperiência de visualização em diferentes plataformas e dispositivos. esta rotação automatizadaO processo simplifica a manipulação da imagem e melhora a usabilidade geral, especialmente quandoTrabalhar com grandes lotes de imagens com diferentes orientações.
public void AutoRotate()Exceptions
O valor de ‘Orientação’ do ‘JpegExifData’ está fora do alcance permitido [1…8], portanto, a rotação automática não pode ser aplicada.
GetModifyDate(Bolha)
Retira a data e a hora em que a imagem da fonte passou por sua últimaEste método fornece metadados valiosos, permitindo que os usuários rastreem egerenciar atualizações para o arquivo de imagem efetivamente. ao acessar essas informações, os usuáriospode garantir a integridade e a moeda dos seus ativos de imagem, facilitando aDecisão sobre uso e manutenção da imagem.
public override DateTime GetModifyDate(bool useDefault)Parameters
useDefault bool
Se configurado para “verdadeiro”, use as informações do FileInfo como valor padrão.
Returns
A data e a hora da imagem da fonte foi modificada pela última vez.
ReleaseManagedResources()
Assegure-se de que os recursos não gerenciados não sejam liberados aqui, uma vez que eles podem já ter sido liberados.
protected override void ReleaseManagedResources()RemoveMetadata()
Remova estes metadados de instância da imagem ao configurar estes valores Aspose.Imaging.Xmp.IHasXMPData.xmpDato e Wl17.Exif.IHasexifDatato. Nula.
public override void RemoveMetadata()SaveData(Stream)
Salve os dados.
protected override void SaveData(Stream stream)Parameters
stream Stream
O fluxo para salvar dados para.
SetResolution(duplo, duplo)
Estabelece a resolução para o Aspose.Imaging.RasterImage especificado, garantindoCapacidades de escalagem e impressão precisas. este método permite aos usuários ajustara resolução da imagem para atender aos seus requisitos específicos, seja para o digitalexibição ou reprodução física. Ao configurar a resolução, os usuários podem otimizarQualidade da imagem e garantia de compatibilidade com vários dispositivos de saída e médios;melhorar a experiência visual geral e a usabilidade da imagem.
public override void SetResolution(double dpiX, double dpiY)Parameters
dpiX double
A resolução horizontal, em pontos por polegada, do Aspose.Imaging.RasterImage.
dpiY double
A resolução vertical, em pontos por polegada, do Aspose.Imaging.RasterImage.
Examples
O exemplo a seguir mostra como definir a resolução horizontal/vertical de uma imagem JPEG.
string dir = "c:\\temp\\";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.jpg"))
{
Aspose.Imaging.FileFormats.Jpeg.JpegImage jpegImage = (Aspose.Imaging.FileFormats.Jpeg.JpegImage)image;
// Get horizontal and vertical resolution of the BmpImage
double horizontalResolution = jpegImage.HorizontalResolution;
double verticalResolution = jpegImage.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");
jpegImage.SetResolution(96.0, 96.0);
System.Console.WriteLine("The horizontal resolution, in pixels per inch: {0}", jpegImage.HorizontalResolution);
System.Console.WriteLine("The vertical resolution, in pixels per inch: {0}", jpegImage.VerticalResolution);
}
// The output may look like this:
// The horizontal resolution, in pixels per inch: 300
// The vertical resolution, in pixels per inch: 300
// Set resolution values to 96 dpi
// The horizontal resolution, in pixels per inch: 96
// The vertical resolution, in pixels per inch: 96
}UpdateDimensions(Int, Int)
Atualiza as dimensões da imagem.
protected override void UpdateDimensions(int newWidth, int newHeight)Parameters
newWidth int
A nova imagem de largura.
newHeight int
O novo tamanho da imagem.
UpdateMetadata()
Atualiza os metadados da imagem.
protected override void UpdateMetadata()
