GifImage

GifImage class

Ein GIF-Bild.

public sealed class GifImage : RasterCachedMultipageImage, IMultipageImageExt

Konstrukteure

NameBeschreibung
GifImage(GifFrameBlock)Initialisiert eine neue Instanz vonGifImage Klasse.
GifImage(GifFrameBlock, IColorPalette)Initialisiert eine neue Instanz vonGifImage Klasse.
GifImage(GifFrameBlock, IColorPalette, bool, byte, byte, byte, bool)Initialisiert eine neue Instanz vonGifImage Klasse.

Eigenschaften

NameBeschreibung
ActiveFrame { get; set; }Ruft den aktiven Frame ab oder setzt ihn.
AutoAdjustPalette { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Palette automatisch angepasst wird.
override BackgroundColor { get; set; }Ruft die Hintergrundfarbe ab oder legt sie fest.
BackgroundColorIndex { get; set; }Ruft den Index der Hintergrundfarbe ab oder legt ihn fest.
override BitsPerPixel { get; }Ruft die Anzahl der Bildbits pro Pixel ab.
Blocks { get; }Ruft die GIF-Blöcke ab.
Bounds { get; }Ruft die Bildgrenzen ab.
BufferSizeHint { get; set; }Ruft den Puffergrößenhinweis ab oder legt ihn fest, der als maximal zulässige Größe für alle internen Puffer definiert ist.
Container { get; }Ruft die abImage Container.
DataStreamContainer { get; }Ruft den Datenstrom des Objekts ab.
Disposed { get; }Ruft einen Wert ab, der angibt, ob diese Instanz verworfen wird.
override FileFormat { get; }Ruft einen Wert von Dateiformat ab
override HasAlpha { get; }Ruft einen Wert ab, der angibt, ob diese Instanz alpha hat.
override HasBackgroundColor { get; }Ruft einen Wert ab, der angibt, ob das Bild eine Hintergrundfarbe hat.
HasTrailer { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob GIF einen Trailer hat.
override HasTransparentColor { get; set; }Ruft einen Wert ab, der angibt, ob der aktive Rahmen eine transparente Farbe hat.
override Height { get; }Ruft die Bildhöhe ab.
virtual HorizontalResolution { get; set; }Ermittelt oder setzt die horizontale Auflösung davon in Pixel pro ZollRasterImage .
override ImageOpacity { get; }Ermittelt die Deckkraft dieses Bildes (aktiver Rahmen).
InterruptMonitor { get; set; }Holt oder setzt den Interrupt-Monitor.
IsCached { get; }Ruft einen Wert ab, der angibt, ob Bilddaten derzeit zwischengespeichert werden.
IsInterlaced { get; }Ruft einen Wert ab, der angibt, ob diese Bildinstanz interlaced ist.
IsPaletteSorted { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Palette sortiert ist.
IsRawDataAvailable { get; }Ruft einen Wert ab, der angibt, ob das Laden von Rohdaten verfügbar ist.
LoopsCount { get; set; }Ruft die Schleifenanzahl ab (wenn das gif-Bild Informationen über Schleifen enthält)
override PageCount { get; }Ruft die Seitenanzahl ab.
override PageExportingAction { get; set; }Ruft die Aktion zum Exportieren der Seite ab oder legt sie fest. Bitte beachten Sie, dass das Festlegen dieser Methode automatisch Seitenressourcen freigibt, nachdem sie ausgeführt wurde. Sie wird unmittelbar vor dem Speichern jeder Seite ausgeführt.
override Pages { get; }Ruft die Seiten ab.
Palette { get; set; }Ruft die Farbpalette ab oder legt sie fest. Die Farbpalette wird nicht verwendet, wenn Pixel direkt dargestellt werden.
PaletteColorResolutionBits { get; set; }Ruft die Farbauflösungsbits der Palette ab oder setzt sie.
PixelAspectRatio { get; set; }Ruft das Pixel-Seitenverhältnis ab oder legt es fest.
virtual PremultiplyComponents { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Bildkomponenten vormultipliziert werden müssen.
RawCustomColorConverter { get; set; }Ruft den benutzerdefinierten Farbkonverter ab oder legt ihn fest
virtual RawDataFormat { get; }Ruft das Rohdatenformat ab.
RawDataSettings { get; }Ruft die aktuellen Rohdateneinstellungen ab. Beachten Sie, dass bei Verwendung dieser Einstellungen die Daten ohne Konvertierung geladen werden.
RawFallbackIndex { get; set; }Ruft den Fallback-Index ab oder legt ihn fest, der verwendet werden soll, wenn der Palettenindex außerhalb der Grenzen liegt
RawIndexedColorConverter { get; set; }Holt oder setzt den indizierten Farbkonverter
virtual RawLineSize { get; }Ruft die rohe Zeilengröße in Bytes ab.
Size { get; }Ruft die Bildgröße ab.
override TransparentColor { get; }Ruft die transparente Farbe des aktiven Rahmens ab.
virtual UpdateXmpData { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die XMP-Metadaten aktualisiert werden sollen.
override UsePalette { get; }Ruft einen Wert ab, der angibt, ob die Bildpalette verwendet wird.
virtual UseRawData { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Laden von Rohdaten verwendet werden soll, wenn das Laden von Rohdaten verfügbar ist.
virtual VerticalResolution { get; set; }Ermittelt oder setzt die vertikale Auflösung davon in Pixel pro ZollRasterImage .
override Width { get; }Ruft die Bildbreite ab.
override XmpData { get; set; }Ruft die XMP-Metadaten ab oder legt sie fest.

Methoden

NameBeschreibung
AddBlock(IGifBlock)Fügt einen neuen GIF-Block hinzu.
AddPage(RasterImage)Fügt dem Bild eine Seite hinzu.
override AdjustBrightness(int)Anpassen von abrightness für Bild.
override AdjustContrast(float)Passt den Kontrast an.
override AdjustGamma(float)Gamma-Korrektur eines Bildes.
override AdjustGamma(float, float, float)Gamma-Korrektur eines Bildes.
override BinarizeBradley(double)Binarisierung eines Bildes mit Bradleys adaptivem Schwellenwertalgorithmus unter Verwendung des integralen Bildschwellenwerts
override BinarizeBradley(double, int)Binarisierung eines Bildes mit Bradleys adaptivem Schwellenwertalgorithmus unter Verwendung des integralen Bildschwellenwerts
override BinarizeFixed(byte)Binarisierung eines Bildes mit vordefiniertem Schwellwert
override BinarizeOtsu()Binarisierung eines Bildes mit Otsu-Thresholding
override CacheData()Speichert die Daten privat.
CanSave(ImageOptionsBase)Legt fest, ob das Bild in dem angegebenen Dateiformat gespeichert werden kann, das durch die übergebenen Speicheroptionen repräsentiert wird.
ClearBlocks()Löscht alle GIF-Blöcke.
override Crop(Rectangle)Bild zuschneiden.
override Crop(int, int, int, int)Bild mit Verschiebungen zuschneiden.
Dispose()Verwirft die aktuelle Instanz.
Dither(DitheringMethod, int)Führt Dithering auf dem aktuellen Bild durch.
override Dither(DitheringMethod, int, IColorPalette)Führt Dithering auf dem aktuellen Bild durch.
override Filter(Rectangle, FilterOptionsBase)Filtert das angegebene Rechteck.
GetArgb32Pixel(int, int)Ruft ein 32-Bit-ARGB-Pixelbild ab.
GetDefaultArgb32Pixels(Rectangle)Ruft das standardmäßige 32-Bit-ARGB-Pixel-Array ab.
virtual GetDefaultOptions(object[])Ruft die Standardoptionen ab.
GetDefaultPixels(Rectangle, IPartialArgb32PixelLoader)Ruft das Standard-Pixel-Array mit partiellem Pixel-Loader ab.
GetDefaultRawData(Rectangle, RawDataSettings)Ruft das Standard-Rohdatenarray ab.
GetDefaultRawData(Rectangle, IPartialRawDataLoader, RawDataSettings)Ruft das Standard-Rohdaten-Array mit partiellem Pixel-Loader ab.
virtual GetModifyDate(bool)Ruft das Datum und die Uhrzeit ab, zu der das Ressourcenbild zuletzt geändert wurde.
override GetOriginalOptions()Ruft die Optionen basierend auf den ursprünglichen Dateieinstellungen ab. Dies kann hilfreich sein, um die Bittiefe und andere Parameter des Originalbildes unverändert zu lassen. Zum Beispiel, wenn wir ein schwarz-weißes PNG-Bild mit 1 Bit pro Pixel laden und dann Speichern Sie es mit the Save -Methode wird das ausgegebene PNG-Bild mit 8 Bit pro Pixel erzeugt. Um dies zu vermeiden und das PNG-Bild mit 1 Bit pro Pixel zu speichern, verwenden Sie diese Methode, um entsprechende Speicheroptionen zu erhalten, und übergeben Sie sie an dieSave Methode als zweiten Parameter.
GetPixel(int, int)Ruft ein Bildpixel ab.
GetSkewAngle()Ruft den Schräglaufwinkel ab. Diese Methode ist auf gescannte Textdokumente anwendbar, um den Schräglaufwinkel beim Scannen zu bestimmen.
override Grayscale()Transformation eines Bildes in seine Graustufendarstellung
InsertBlock(int, IGifBlock)Fügt einen neuen GIF-Block hinzu.
LoadArgb32Pixels(Rectangle)Lädt 32-Bit-ARGB-Pixel.
LoadArgb64Pixels(Rectangle)Lädt 64-Bit-ARGB-Pixel.
LoadCmyk32Pixels(Rectangle)Lädt Pixel im CMYK-Format.
LoadPartialArgb32Pixels(Rectangle, IPartialArgb32PixelLoader)Lädt 32-Bit-ARGB-Pixel teilweise nach Paketen.
LoadPartialPixels(Rectangle, IPartialPixelLoader)Lädt Pixel teilweise nach Paketen.
LoadPixels(Rectangle)Lädt Pixel.
LoadRawData(Rectangle, RawDataSettings, IPartialRawDataLoader)Lädt Rohdaten.
LoadRawData(Rectangle, Rectangle, RawDataSettings, IPartialRawDataLoader)Lädt Rohdaten.
NormalizeAngle()Normalisiert den Winkel. Diese Methode ist auf gescannte Textdokumente anwendbar, um den schiefen Scan zu beseitigen. Diese Methode verwendetGetSkewAngle undRotate Methoden.
override NormalizeAngle(bool, Color)Normalisiert den Winkel. Diese Methode ist auf gescannte Textdokumente anwendbar, um den schiefen Scan zu beseitigen. Diese Methode verwendet!:GetSkewAngle undRotate Methoden.
OrderBlocks()Ordnet die GIF-Blöcke gemäß der GIF-Spezifikation an. EtwasGifGraphicsControlBlock kann für ein korrektes GIF-Layout entfernt werden.
ReadArgb32ScanLine(int)Liest die gesamte Scanzeile mit dem angegebenen Scanzeilenindex.
ReadScanLine(int)Liest die gesamte Scanzeile mit dem angegebenen Scanzeilenindex.
RemoveBlock(IGifBlock)Entfernt den GIF-Block.
ReplaceColor(Color, byte, Color)Ersetzt eine Farbe durch eine andere mit zulässigem Unterschied und behält den ursprünglichen Alpha-Wert bei, um glatte Kanten zu erhalten.
override ReplaceColor(int, byte, int)Ersetzt eine Farbe durch eine andere mit zulässigem Unterschied und behält den ursprünglichen Alpha-Wert bei, um glatte Kanten zu erhalten.
ReplaceNonTransparentColors(Color)Ersetzt alle nicht transparenten Farben durch neue Farben und behält den ursprünglichen Alpha-Wert bei, um glatte Kanten zu erhalten. Hinweis: Wenn Sie es auf Bildern ohne Transparenz verwenden, werden alle Farben durch eine einzige ersetzt.
override ReplaceNonTransparentColors(int)Ersetzt alle nicht transparenten Farben durch neue Farben und behält den ursprünglichen Alpha-Wert bei, um glatte Kanten zu erhalten. Hinweis: Wenn Sie es auf Bildern ohne Transparenz verwenden, werden alle Farben durch eine einzige ersetzt.
Resize(int, int)Ändert die Bildgröße. Der StandardNearestNeighbourResample wird verwendet.
override Resize(int, int, ImageResizeSettings)Ändert die Bildgröße.
override Resize(int, int, ResizeType)Ändert die Bildgröße.
ResizeFullFrame(int, int, ResizeType)Ändert die Größe des Bildes unter Verwendung von Vollbildern für jede GIF-Seite. Erforderlich, um mögliche Artefakte zu vermeiden.
ResizeHeightProportionally(int)Ändert die Höhe proportional. Der StandardNearestNeighbourResample wird verwendet.
virtual ResizeHeightProportionally(int, ImageResizeSettings)Ändert die Höhe proportional.
override ResizeHeightProportionally(int, ResizeType)Ändert die Breite proportional.
ResizeProportional(int, int, ResizeType)Führt eine proportionale Größenänderung des Bildes durch. Die proportionale Größenänderung ändert die Größe jedes Frames gemäß dem Verhältnis vonnewWidth/Breite undnewHeight /Höhe.
ResizeWidthProportionally(int)Ändert die Breite proportional. Der StandardNearestNeighbourResample wird verwendet.
virtual ResizeWidthProportionally(int, ImageResizeSettings)Ändert die Breite proportional.
override ResizeWidthProportionally(int, ResizeType)Ändert die Breite proportional.
virtual Rotate(float)Bild um die Mitte drehen.
override Rotate(float, bool, Color)!:RasterCahcedMultipageImage.Rotate Bild um die Mitte.
override RotateFlip(RotateFlipType)Rotiert, kippt oder dreht und kippt nur den aktiven Rahmen.
Save()Speichert die Bilddaten im zugrunde liegenden Stream.
Save(Stream)Speichert die Daten des Objekts im angegebenen Stream.
override Save(string)Speichert das Bild am angegebenen Dateispeicherort.
Save(Stream, ImageOptionsBase)Speichert die Bilddaten gemäß den Speicheroptionen im angegebenen Stream im angegebenen Dateiformat.
virtual Save(string, bool)Speichert die Daten des Objekts am angegebenen Dateispeicherort.
virtual Save(string, ImageOptionsBase)Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.
override Save(Stream, ImageOptionsBase, Rectangle)Speichert die Bilddaten gemäß den Speicheroptionen im angegebenen Stream im angegebenen Dateiformat.
virtual Save(string, ImageOptionsBase, Rectangle)Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.
SaveArgb32Pixels(Rectangle, int[])Speichert die 32-Bit-ARGB-Pixel.
SaveCmyk32Pixels(Rectangle, int[])Speichert die Pixel.
SavePixels(Rectangle, Color[])Speichert die Pixel.
SaveRawData(byte[], int, Rectangle, RawDataSettings)Speichert die Rohdaten.
SetArgb32Pixel(int, int, int)Legt ein 32-Bit-ARGB-Bildpixel für die angegebene Position fest.
SetFrameTime(ushort)Legt die Dauer aller Frames in Millisekunden fest. Durch Ändern dieses Werts wird die Verzögerung für alle Frames zurückgesetzt.
override SetPalette(IColorPalette, bool)Legt die Bildpalette fest.
SetPixel(int, int, Color)Setzt ein Bildpixel für die angegebene Position.
virtual SetResolution(double, double)Legt die Auflösung dafür festRasterImage .
virtual ToBitmap()Konvertiert Rasterbild in Bitmap.
WriteArgb32ScanLine(int, int[])Schreibt die gesamte Scanzeile in den angegebenen Scanzeilenindex.
WriteScanLine(int, Color[])Schreibt die gesamte Scanzeile in den angegebenen Scanzeilenindex.

Beispiele

Export eines Teils der Animation aus dem GIF-Bild basierend auf dem Zeitintervall.

[C#]

using (var image = Image.Load("Animation.gif"))
{
    var options = new GifOptions
    {
        FullFrame = true,
        MultiPageOptions = new MultiPageOptions
        {
            Mode = MultiPageMode.TimeInterval,
            TimeInterval = new TimeInterval(0, 400)
        }
    };

    image.Save("PartOfAnimation.gif", options);
}

Dieses Beispiel zeigt, wie ein GIF-Bild erstellt und in einer Datei gespeichert wird.

[C#]

string dir = "c:\\temp\\";

// Erstellen Sie einen GIF-Frame-Block von 100 x 100 Pixel.
using (Aspose.Imaging.FileFormats.Gif.Blocks.GifFrameBlock firstBlock = new Aspose.Imaging.FileFormats.Gif.Blocks.GifFrameBlock(100, 100))
{
    // Den gesamten Block rot füllen.
    Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(firstBlock);
    Aspose.Imaging.Brushes.SolidBrush brush = new Aspose.Imaging.Brushes.SolidBrush(Aspose.Imaging.Color.Red);
    gr.FillRectangle(brush, firstBlock.Bounds);

    using (Aspose.Imaging.FileFormats.Gif.GifImage gifImage = new Aspose.Imaging.FileFormats.Gif.GifImage(firstBlock))
    {
        gifImage.Save(dir + "output.gif");
    }
}

Erstellen Sie ein mehrseitiges GIF-Bild mit einseitigen Rasterbildern.

[C#]

static void Main(string[] args)
{
    // Frames laden
    var frames = LoadFrames("Animation frames").ToArray();

    // GIF-Bild mit dem ersten Frame erstellen
    using (var image = new GifImage(new GifFrameBlock(frames[0])))
    {
        // Rahmen zum GIF-Bild mit der AddPage-Methode hinzufügen
        for (var index = 1; index < frames.Length; index++)
        {
            image.AddPage(frames[index]);
        }

        // GIF-Bild speichern
        image.Save("Multipage.gif");
    }
}

private static IEnumerable<RasterImage> LoadFrames(string directory)
{
    foreach (var filePath in Directory.GetFiles(directory))
    {
        yield return (RasterImage)Image.Load(filePath);
    }
}

Siehe auch