Class GifOptions
Nombre del espacio: Aspose.Imaging.ImageOptions Asamblea: Aspose.Imaging.dll (25.4.0)
La API para el formato de intercambio gráfico (GIF) ofrece la creación de archivos de imagen rasterDesarrolladores de opciones completas para generar imágenes GIF con precisiónCon características para definir el color de fondo, la paleta de colores, la resolución,tipo interligado, color transparente, contenedor de metadatos XMP, y imagenCompresión, esta API garantiza flexibilidad y eficiencia en la creación optimizaday GIFs visualmente atractivos adaptados a los requisitos de aplicación específicos.
[JsonObject(MemberSerialization.OptIn)]
public class GifOptions : ImageOptionsBase, IDisposable, IHasXmpData, IHasMetadata, ICloneableInheritance
object ← DisposableObject ← ImageOptionsBase ← GifOptions
Implements
IDisposable ,y, IHasXmpData ,y, IHasMetadata ,y, ICloneable
Miembros heredados
ImageOptionsBase.Clone() ,y, ImageOptionsBase.ReleaseManagedResources() ,y, ImageOptionsBase.KeepMetadata ,y, ImageOptionsBase.XmpData ,y, ImageOptionsBase.Source ,y, ImageOptionsBase.Palette ,y, ImageOptionsBase.ResolutionSettings ,y, ImageOptionsBase.VectorRasterizationOptions ,y, ImageOptionsBase.BufferSizeHint ,y, ImageOptionsBase.MultiPageOptions ,y, ImageOptionsBase.FullFrame ,y, ImageOptionsBase.ProgressEventHandler ,y, DisposableObject.Dispose() ,y, DisposableObject.ReleaseManagedResources() ,y, DisposableObject.ReleaseUnmanagedResources() ,y, DisposableObject.VerifyNotDisposed() ,y, DisposableObject.Disposed ,y, object.GetType() ,y, object.MemberwiseClone() ,y, object.ToString() ,y, object.Equals(object?) ,y, object.Equals(object?, object?) ,y, object.ReferenceEquals(object?, object?) ,y, object.GetHashCode()
Examples
Este ejemplo demuestra el uso de diferentes clases de SaveOptions Namespace para fines de exportación.Una imagen de tipo Gif se carga en una instancia de imagen y luego se exporta a varios formatos.
string dir = "c:\\temp\\";
//Load an existing image (of type Gif) in an instance of Image class
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.gif"))
{
//Export to BMP file format using the default options
image.Save(dir + "output.bmp", new Aspose.Imaging.ImageOptions.BmpOptions());
//Export to JPEG file format using the default options
image.Save(dir + "output.jpg", new Aspose.Imaging.ImageOptions.JpegOptions());
//Export to PNG file format using the default options
image.Save(dir + "output.png", new Aspose.Imaging.ImageOptions.PngOptions());
//Export to TIFF file format using the default options
image.Save(dir + "output.tif", new Aspose.Imaging.ImageOptions.TiffOptions(Aspose.Imaging.FileFormats.Tiff.Enums.TiffExpectedFormat.Default));
}El siguiente ejemplo muestra cómo convertir una imagen de vector multipágina en formato GIF de forma general sin referirse a un tipo de imagen específico.
string dir = "C:\\aspose.imaging\\net\\misc\\ImagingReleaseQATester\\Tests\\testdata\\2548";
string inputFilePath = System.IO.Path.Combine(dir, "Multipage.cdr");
string outputFilePath = System.IO.Path.Combine(dir, "Multipage.cdr.gif");
Aspose.Imaging.ImageOptionsBase exportOptions = new Aspose.Imaging.ImageOptions.GifOptions();
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(inputFilePath))
{
exportOptions.MultiPageOptions = null;
// Export only first two pages. These pages will be presented as animated frames in the output GIF.
Aspose.Imaging.IMultipageImage multipageImage = image as Aspose.Imaging.IMultipageImage;
if (multipageImage != null && (multipageImage.Pages != null && multipageImage.PageCount > 2))
{
exportOptions.MultiPageOptions = new Aspose.Imaging.ImageOptions.MultiPageOptions(new Aspose.Imaging.IntRange(0, 2));
}
if (image is Aspose.Imaging.VectorImage)
{
exportOptions.VectorRasterizationOptions = (Aspose.Imaging.ImageOptions.VectorRasterizationOptions)image.GetDefaultOptions(new object[] { Aspose.Imaging.Color.White, image.Width, image.Height });
exportOptions.VectorRasterizationOptions.TextRenderingHint = Aspose.Imaging.TextRenderingHint.SingleBitPerPixel;
exportOptions.VectorRasterizationOptions.SmoothingMode = Aspose.Imaging.SmoothingMode.None;
}
image.Save(outputFilePath, exportOptions);
}Este ejemplo muestra cómo cargar la información de Pixel en un Array de tipo de color, manipula el array y la ponga de vuelta a la imagen. Para realizar estas operaciones, este ejemplo crea un nuevo archivo de imagen (en formato GIF) uisng Objeto MemoryStream.
//Create an instance of MemoryStream
using (System.IO.MemoryStream stream = new System.IO.MemoryStream())
{
//Create an instance of GifOptions and set its various properties including the Source property
Aspose.Imaging.ImageOptions.GifOptions gifOptions = new Aspose.Imaging.ImageOptions.GifOptions();
gifOptions.Source = new Aspose.Imaging.Sources.StreamSource(stream);
//Create an instance of Image
using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(gifOptions, 500, 500))
{
//Get the pixels of image by specifying the area as image boundary
Aspose.Imaging.Color[] pixels = image.LoadPixels(image.Bounds);
//Loop over the Array and sets color of alrenative indexed pixel
for (int index = 0; index < pixels.Length; index++)
{
if (index % 2 == 0)
{
//Set the indexed pixel color to yellow
pixels[index] = Aspose.Imaging.Color.Yellow;
}
else
{
//Set the indexed pixel color to blue
pixels[index] = Aspose.Imaging.Color.Blue;
}
}
//Apply the pixel changes to the image
image.SavePixels(image.Bounds, pixels);
// save all changes.
image.Save();
}
// Write MemoryStream to File
using (System.IO.FileStream fileStream = new System.IO.FileStream(@"C:\temp\output.gif", System.IO.FileMode.Create))
{
stream.WriteTo(fileStream);
}
}Constructors
GifOptions()
Inicia una nueva instancia de la clase Aspose.Imaging.ImageOptions.GifOptions.
[JsonConstructor]
public GifOptions()GifOptions(GifOptions)
Inicia una nueva instancia de la clase Aspose.Imaging.ImageOptions.GifOptions.
public GifOptions(GifOptions gifOptions)Parameters
gifOptions GifOptions
Las opciones de GIF.
Properties
BackgroundColor
Obtenga o establece el color de fondo.
[JsonProperty]
public Color BackgroundColor { get; set; }Valor de la propiedad
BackgroundColorIndex
Obtenga o establece el índice de color de fondo GIF.
public byte BackgroundColorIndex { get; set; }Valor de la propiedad
ColorResolution
Obtenga o establece la resolución de color GIF.
public byte ColorResolution { get; set; }Valor de la propiedad
Examples
Este ejemplo muestra cómo guardar una imagen BMP en formato GIF utilizando varias opciones.
string dir = "c:\\temp\\";
using (Aspose.Imaging.Image bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(1000, 1000))
{
// Fill the entire image with the blue-yellow gradient.
Aspose.Imaging.Brushes.LinearGradientBrush gradientBrush = new Aspose.Imaging.Brushes.LinearGradientBrush(
new Aspose.Imaging.Point(0, 0),
new Aspose.Imaging.Point(bmpImage.Width, bmpImage.Height),
Aspose.Imaging.Color.Blue,
Aspose.Imaging.Color.Yellow);
Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(bmpImage);
graphics.FillRectangle(gradientBrush, bmpImage.Bounds);
Aspose.Imaging.ImageOptions.GifOptions saveOptions = new Aspose.Imaging.ImageOptions.GifOptions();
// The number of bits required to store a color, minus 1.
saveOptions.ColorResolution = 7;
// Palette correction means that whenever image is exported to GIF the source image colors will be analyzed
// in order to build the best matching palette (in case image Palette does not exist or not specified in the options)
saveOptions.DoPaletteCorrection = true;
// Load a GIF image in a progressive way.
// An interlaced GIF doesn't display its scanlines linearly from top to bottom, but instead reorders it
// so the content of the GIF becomes clear even before it finishes loading.
saveOptions.Interlaced = true;
// Save as a lossless GIF.
using (System.IO.Stream stream = System.IO.File.OpenWrite(dir + "output.gif"))
{
bmpImage.Save(stream, saveOptions);
System.Console.WriteLine("The size of the lossless GIF: {0} bytes.", stream.Length);
}
// Set the maximum allowed pixel difference. If greater than zero, lossy compression will be used.
// The recommended value for optimal lossy compression is 80. 30 is very light compression, 200 is heavy.
saveOptions.MaxDiff = 80;
// Save as a lossy GIF.
using (System.IO.Stream stream = System.IO.File.OpenWrite(dir + "output.lossy.gif"))
{
bmpImage.Save(stream, saveOptions);
System.Console.WriteLine("The size of the lossy GIF: {0} bytes.", stream.Length);
}
}
//The output may look like this:
//The size of the lossless GIF: 212816 bytes.
//The size of the lossy GIF: 89726 bytes.Remarks
Resolución de color - Número de bits por color primario disponiblea la imagen original, minus 1.Este valor representa el tamaño detoda la paleta de la que los colores en el gráfico eranseleccionado, no el número de colores realmente utilizados en el gráfico.Por ejemplo, si el valor en este campo es 3, entonces la paleta deLa imagen original tenía 4 bits por color primario disponibles para crearEste valor debe ser establecido para indicar la riqueza dela paleta original, incluso si no todos los colores delLa paleta está disponible en la máquina de fuente.
DoPaletteCorrection
Recibe o establece un valor que indica si se aplica la corrección de paleta.
public bool DoPaletteCorrection { get; set; }Valor de la propiedad
Examples
Este ejemplo muestra cómo guardar una imagen BMP en formato GIF utilizando varias opciones.
string dir = "c:\\temp\\";
using (Aspose.Imaging.Image bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(1000, 1000))
{
// Fill the entire image with the blue-yellow gradient.
Aspose.Imaging.Brushes.LinearGradientBrush gradientBrush = new Aspose.Imaging.Brushes.LinearGradientBrush(
new Aspose.Imaging.Point(0, 0),
new Aspose.Imaging.Point(bmpImage.Width, bmpImage.Height),
Aspose.Imaging.Color.Blue,
Aspose.Imaging.Color.Yellow);
Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(bmpImage);
graphics.FillRectangle(gradientBrush, bmpImage.Bounds);
Aspose.Imaging.ImageOptions.GifOptions saveOptions = new Aspose.Imaging.ImageOptions.GifOptions();
// The number of bits required to store a color, minus 1.
saveOptions.ColorResolution = 7;
// Palette correction means that whenever image is exported to GIF the source image colors will be analyzed
// in order to build the best matching palette (in case image Palette does not exist or not specified in the options)
saveOptions.DoPaletteCorrection = true;
// Load a GIF image in a progressive way.
// An interlaced GIF doesn't display its scanlines linearly from top to bottom, but instead reorders it
// so the content of the GIF becomes clear even before it finishes loading.
saveOptions.Interlaced = true;
// Save as a lossless GIF.
using (System.IO.Stream stream = System.IO.File.OpenWrite(dir + "output.gif"))
{
bmpImage.Save(stream, saveOptions);
System.Console.WriteLine("The size of the lossless GIF: {0} bytes.", stream.Length);
}
// Set the maximum allowed pixel difference. If greater than zero, lossy compression will be used.
// The recommended value for optimal lossy compression is 80. 30 is very light compression, 200 is heavy.
saveOptions.MaxDiff = 80;
// Save as a lossy GIF.
using (System.IO.Stream stream = System.IO.File.OpenWrite(dir + "output.lossy.gif"))
{
bmpImage.Save(stream, saveOptions);
System.Console.WriteLine("The size of the lossy GIF: {0} bytes.", stream.Length);
}
}
//The output may look like this:
//The size of the lossless GIF: 212816 bytes.
//The size of the lossy GIF: 89726 bytes.Remarks
Corrección de paletas significa que cada vez que la imagen se exporta a GIF, los colores de la imagen de fuente se analizarán.para construir la mejor paleta de ajuste (en el caso de que la paleta de imagen no existe o no se especifique en las opciones).El proceso de análisis toma un poco de tiempo sin embargo, la imagen de salida tendrá la mejor paleta de color que se ajusta y el resultado es visualmente mejor.
HasTrailer
Obtenga o establece un valor que indica si el GIF tiene un trailer.
public bool HasTrailer { get; set; }Valor de la propiedad
HasTransparentColor
Obtenga o establece un valor que indica si una imagen GIF tiene un color transparente.Si el valor de retorno es Nula, esta propiedad está superada por el contexto de la imagen de fuente.
[JsonProperty]
public bool? HasTransparentColor { get; set; }Valor de la propiedad
bool ?
Interlaced
Es cierto si la imagen debe ser interligada.
public bool Interlaced { get; set; }Valor de la propiedad
Examples
Este ejemplo muestra cómo guardar una imagen BMP en formato GIF utilizando varias opciones.
string dir = "c:\\temp\\";
using (Aspose.Imaging.Image bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(1000, 1000))
{
// Fill the entire image with the blue-yellow gradient.
Aspose.Imaging.Brushes.LinearGradientBrush gradientBrush = new Aspose.Imaging.Brushes.LinearGradientBrush(
new Aspose.Imaging.Point(0, 0),
new Aspose.Imaging.Point(bmpImage.Width, bmpImage.Height),
Aspose.Imaging.Color.Blue,
Aspose.Imaging.Color.Yellow);
Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(bmpImage);
graphics.FillRectangle(gradientBrush, bmpImage.Bounds);
Aspose.Imaging.ImageOptions.GifOptions saveOptions = new Aspose.Imaging.ImageOptions.GifOptions();
// The number of bits required to store a color, minus 1.
saveOptions.ColorResolution = 7;
// Palette correction means that whenever image is exported to GIF the source image colors will be analyzed
// in order to build the best matching palette (in case image Palette does not exist or not specified in the options)
saveOptions.DoPaletteCorrection = true;
// Load a GIF image in a progressive way.
// An interlaced GIF doesn't display its scanlines linearly from top to bottom, but instead reorders it
// so the content of the GIF becomes clear even before it finishes loading.
saveOptions.Interlaced = true;
// Save as a lossless GIF.
using (System.IO.Stream stream = System.IO.File.OpenWrite(dir + "output.gif"))
{
bmpImage.Save(stream, saveOptions);
System.Console.WriteLine("The size of the lossless GIF: {0} bytes.", stream.Length);
}
// Set the maximum allowed pixel difference. If greater than zero, lossy compression will be used.
// The recommended value for optimal lossy compression is 80. 30 is very light compression, 200 is heavy.
saveOptions.MaxDiff = 80;
// Save as a lossy GIF.
using (System.IO.Stream stream = System.IO.File.OpenWrite(dir + "output.lossy.gif"))
{
bmpImage.Save(stream, saveOptions);
System.Console.WriteLine("The size of the lossy GIF: {0} bytes.", stream.Length);
}
}
//The output may look like this:
//The size of the lossless GIF: 212816 bytes.
//The size of the lossy GIF: 89726 bytes.IsPaletteSorted
Recibe o establece un valor que indica si las entradas de paleta se clasifican.
public bool IsPaletteSorted { get; set; }Valor de la propiedad
LoopsCount
Obtenga o establezca el número de golpes (default 1 golpes)
public int LoopsCount { get; set; }Valor de la propiedad
MaxDiff
Obtenga o establece la diferencia de píxeles máxima permitida.Si es mayor que cero, se utilizará la composición de pérdida.El valor recomendado para la compresión de pérdida óptima es 80. 30 es muy ligera compresión, 200 es pesada.Funciona mejor cuando se introduce sólo una pequeña pérdida, y debido a la limitación del algoritmo de compresión, los niveles de pérdida muy altos no darán tanta ganancia.El rango de valores permitidos es [0, 1000].
public int MaxDiff { get; set; }Valor de la propiedad
Examples
Este ejemplo muestra cómo guardar una imagen BMP en formato GIF utilizando varias opciones.
string dir = "c:\\temp\\";
using (Aspose.Imaging.Image bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(1000, 1000))
{
// Fill the entire image with the blue-yellow gradient.
Aspose.Imaging.Brushes.LinearGradientBrush gradientBrush = new Aspose.Imaging.Brushes.LinearGradientBrush(
new Aspose.Imaging.Point(0, 0),
new Aspose.Imaging.Point(bmpImage.Width, bmpImage.Height),
Aspose.Imaging.Color.Blue,
Aspose.Imaging.Color.Yellow);
Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(bmpImage);
graphics.FillRectangle(gradientBrush, bmpImage.Bounds);
Aspose.Imaging.ImageOptions.GifOptions saveOptions = new Aspose.Imaging.ImageOptions.GifOptions();
// The number of bits required to store a color, minus 1.
saveOptions.ColorResolution = 7;
// Palette correction means that whenever image is exported to GIF the source image colors will be analyzed
// in order to build the best matching palette (in case image Palette does not exist or not specified in the options)
saveOptions.DoPaletteCorrection = true;
// Load a GIF image in a progressive way.
// An interlaced GIF doesn't display its scanlines linearly from top to bottom, but instead reorders it
// so the content of the GIF becomes clear even before it finishes loading.
saveOptions.Interlaced = true;
// Save as a lossless GIF.
using (System.IO.Stream stream = System.IO.File.OpenWrite(dir + "output.gif"))
{
bmpImage.Save(stream, saveOptions);
System.Console.WriteLine("The size of the lossless GIF: {0} bytes.", stream.Length);
}
// Set the maximum allowed pixel difference. If greater than zero, lossy compression will be used.
// The recommended value for optimal lossy compression is 80. 30 is very light compression, 200 is heavy.
saveOptions.MaxDiff = 80;
// Save as a lossy GIF.
using (System.IO.Stream stream = System.IO.File.OpenWrite(dir + "output.lossy.gif"))
{
bmpImage.Save(stream, saveOptions);
System.Console.WriteLine("The size of the lossy GIF: {0} bytes.", stream.Length);
}
}
//The output may look like this:
//The size of the lossless GIF: 212816 bytes.
//The size of the lossy GIF: 89726 bytes.PixelAspectRatio
Obtenga o establece la relación de aspecto de los píxeles GIF.
public byte PixelAspectRatio { get; set; }Valor de la propiedad
Remarks
Pixel Aspect Ratio - Factor utilizado para calcular una aproximaciónde la relación de aspecto del pixel en la imagen original. si elel valor del campo no es 0, esta aproximación de la relación de aspectoSe calcula con base en la fórmula:Ratio de aspecto = (Pixel Aspect Ratio + 15) / 64El Pixel Aspect Ratio se define como el cociente del Pixel.la amplitud por encima de su altura. el rango de valor en este campo permiteespecificación del pixel más amplio de 4:1 hasta el pixel más alto de1:4 en incrementos de 1/64.Los valores :0 - No se proporciona información de relación de aspecto.1..255 - Valor utilizado en la computación.
