ApngImage

ApngImage class

Das animierte PNG-Bild.

public sealed class ApngImage : RasterCachedMultipageImage, IMultipageImageExt

Konstrukteure

NameBeschreibung
ApngImage(ApngOptions, int, int)Initialisiert eine neue Instanz vonApngImage Klasse.

Eigenschaften

NameBeschreibung
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 einen Wert für die Hintergrundfarbe ab oder legt ihn fest.
override BitsPerPixel { get; }Ruft die Anzahl der Bildbits pro Pixel 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.
DefaultFrameTime { get; set; }Ruft die Standard-Frame-Dauer ab oder legt sie fest. Wird beim Erstellen neuer Frames verwendet.
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.
virtual HasBackgroundColor { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Bild eine Hintergrundfarbe hat.
override HasTransparentColor { get; }Ruft einen Wert ab, der angibt, ob das Bild 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; }Ruft die Deckkraft dieses Bildes ab.
Interlaced { get; }Ruft einen Wert ab, der angibt, ob diesPngImage ist interlaced.
InterruptMonitor { get; set; }Holt oder setzt den Interrupt-Monitor.
IsCached { get; }Ruft einen Wert ab, der angibt, ob Bilddaten derzeit zwischengespeichert werden.
IsRawDataAvailable { get; }Ruft einen Wert ab, der angibt, ob das Laden von Rohdaten verfügbar ist.
NumPlays { get; set; }Ruft ab oder legt fest, wie oft die Animation wiederholt werden soll. 0 bedeutet Endlosschleife.
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.
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.
virtual TransparentColor { get; set; }Ruft die transparente Farbe des Bildes 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
AddFrame()Fügt einen neuen Rahmen am Ende der eigenen Rahmensammlung hinzu. Ein neuer Rahmen wird entsprechend der Größe des aktuellen Bildes erstellt.
AddFrame(RasterImage)Fügt einen neuen Rahmen am Ende der eigenen Rahmensammlung hinzu. Der Inhalt des neuen Rahmens wird aus dem angegebenen Bild gefüllt.
AddFrame(RasterImage, uint)Fügt einen neuen Rahmen am Ende der eigenen Rahmensammlung hinzu. Der Inhalt des neuen Rahmens wird aus dem angegebenen Bild gefüllt.
AddPage(RasterImage)Fügt dem Bild eine Seite hinzu.
override AdjustBrightness(int)Anpassen von abrightness für Bild.
override AdjustContrast(float)Image kontrastierend
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.
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.
override 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.
override 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
InsertFrame(int)Fügt einen neuen Rahmen in die eigene Rahmensammlung am angegebenen Index ein. Ein neuer Rahmen wird entsprechend der Größe des aktuellen Bildes erstellt.
InsertFrame(int, RasterImage)Fügt einen neuen Rahmen in die eigene Rahmensammlung am angegebenen Index ein. Der Inhalt des neuen Rahmens wird aus dem angegebenen Bild gefüllt.
InsertFrame(int, RasterImage, uint)Fügt einen neuen Rahmen in die eigene Rahmensammlung am angegebenen Index ein. Der Inhalt des neuen Rahmens wird aus dem angegebenen Bild gefüllt.
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.
PopFrameAt(int)Entfernt den Frame und gibt ihn am angegebenen Index der eigenen Frame-Sammlung zurück.
ReadArgb32ScanLine(int)Liest die gesamte Scanzeile mit dem angegebenen Scanzeilenindex.
ReadScanLine(int)Liest die gesamte Scanzeile mit dem angegebenen Scanzeilenindex.
RemoveAllFrames()Entfernt alle Frames aus der eigenen Frame-Sammlung.
RemoveFrameAt(int)Entfernt den Frame am angegebenen Index aus der eigenen Frame-Sammlung. Der zu löschende Frame wird verworfen.
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.
ResetDefaultImage()Löscht ein zuvor gesetztes Standardbild. Danach ist das Standardbild das erste Bild in der eigenen Rahmensammlung (es kann mit dieser Methode nicht gelöscht werden).
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.
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.
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.
SetDefaultImage(RasterImage)Legt das angegebene Rasterbild als Standardbild der aktuellen Animation fest.
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

Das folgende Beispiel zeigt, wie das Dateiformat apng APNG aus einem anderen nicht animierten mehrseitigen Format exportiert wird.

[C#]

using Aspose.Imaging;
using Aspose.Imaging.ImageOptions;

using (Image image = Image.Load("img4.tif")) {
    // Festlegen der Standard-Frame-Dauer
    image.Save("img4.tif.500ms.png", new ApngOptions() { DefaultFrameTime = 500 }); // 500 ms
    image.Save("img4.tif.250ms.png", new ApngOptions() { DefaultFrameTime = 250 }); // 250 ms
}

Das folgende Beispiel zeigt, wie Sie in das APNG-Dateiformat exportieren.

[C#]

using Aspose.Imaging;
using Aspose.Imaging.ImageOptions;

using (Image image = Image.Load("Animation1.webp")) {
    // Export in APNG-Animation mit unbegrenzten Animationszyklen als Standard
    image.Save("Animation1.webp.png", new ApngOptions());
    // Animationszyklen einrichten
    image.Save("Animation2.webp.png", new ApngOptions() { NumPlays = 5 }); // 5 Zyklen
}

Das folgende Beispiel zeigt, wie Sie ein APNG-Bild aus einem anderen einseitigen Rasterbild erstellen.

[C#]

using Aspose.Imaging;
using Aspose.Imaging.ImageOptions;
using Aspose.Imaging.FileFormats.Apng;

const int AnimationDuration = 1000; // 1 Sek
const int FrameDuration = 70; // 70 ms
using (RasterImage sourceImage = (RasterImage)Image.Load("not_animated.png"))
{
    ApngOptions createOptions = new ApngOptions
    {
        Source = new FileCreateSource("raster_animation.png", false),
        DefaultFrameTime = (uint)FrameDuration,
        ColorType = PngColorType.TruecolorWithAlpha,
    };

    using (ApngImage apngImage = (ApngImage)Image.Create(
        createOptions,
        sourceImage.Width,
        sourceImage.Height))
    {
        // Es ist möglich, dort die Standard-Frame-Zeit des Bildes einzustellen: apngImage.DefaultFrameTime = (uint)FrameDuration;

        int numOfFrames = AnimationDuration / FrameDuration;
        int numOfFrames2 = numOfFrames / 2;

        // Bereinigen, da das Bild standardmäßig einen Frame enthält
        apngImage.RemoveAllFrames();

        // ersten Frame hinzufügen
        apngImage.AddFrame(sourceImage);

        // Zwischenframes hinzufügen
        for (int frameIndex = 1; frameIndex < numOfFrames - 1; ++frameIndex)
        {
            apngImage.AddFrame(sourceImage);
            ApngFrame lastFrame = (ApngFrame)apngImage.Pages[apngImage.PageCount - 1];
            float gamma = frameIndex >= numOfFrames2 ? numOfFrames - frameIndex - 1 : frameIndex;
            lastFrame.AdjustGamma(gamma);
        }

        // letzten Frame hinzufügen
        apngImage.AddFrame(sourceImage);

        apngImage.Save();
    }
}

Siehe auch