GifImage Klasse

Summary: The API for Graphical Interchange Format (GIF) image file provides
developers with versatile tools for processing compressed raster images and
animated GIFs. Offering features like XMP metadata handling, color palette
settings, background and transparent color control, opacity settings, resize,
crop, filter application, gamma corrections, contrast adjustment, grayscale
transformation, and conversion to other formats. This API empowers seamless
manipulation and enhancement of GIF images for a wide range of applications.

Module: aspose.imaging.fileformats.gif

Full Name: aspose.imaging.fileformats.gif.GifImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IMultipageImage, IMultipageImageExt, RasterCachedMultipageImage

Constructors

Name	Beschreibung
GifImage(first_frame)	Das Erstellen von GIF-Bildern wird mühelos mit dem GifImage Konstruktor. Mit nur dem Parameter firstFrame betritt man eine Welt dynamischer visueller Kommunikation.
GifImage(first_frame, global_palette)	Initialisieren Sie ein neues GifImage Objekt mit den angegebenen Parametern für den ersten Frame und die globale Palette. Beginnen Sie, GIF-Bilder zügig zu verwalten, und sorgen Sie für eine genaue Darstellung mit anpassbaren Einstellungen für optimale Ergebnisse.
GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)	Starten Sie mühelos mit dem GifImage Konstruktor. Mit dieser einfachen Methode können Sie problemlos animierte GIFs erstellen. Geben Sie einfach den firstFrame, globalPalette, paletteColorResolution, aspectRatio und weitere Parameter an, und Sie sind bereit, Ihre visuellen Inhalte zum Leben zu erwecken.

Properties

Name	Type	Access	Beschreibung
active_frame	GifFrameBlock	r/w	Verwalten und manipulieren Sie Frames mit dieser Eigenschaft, die eine reibungslose Navigation und Modifikation des aktiven Frames im GIF-Bild ermöglicht.
auto_adjust_palette	bool	r/w	Liest oder setzt einen Wert, der angibt, ob die automatische Anpassung der Palette erfolgt.
background_color	Color	r/w	Verwalten Sie die Hintergrundfarbe des GIF-Bildes mit dieser Eigenschaft. Sie können die Hintergrundfarbe setzen oder abrufen, um Konsistenz zu gewährleisten und die visuelle Attraktivität zu steigern.
background_color_index	System.Byte	r/w	Steuern Sie den Hintergrundfarbindex des GIF-Bildes mit dieser Eigenschaft. Setzen oder rufen Sie den Index ab, um Konsistenz zu wahren oder gewünschte visuelle Effekte zu erzielen.
bits_per_pixel	int	r	Liest die Bit‑Pro‑Pixel‑Anzahl des Bildes.
blocks	IGifBlock[]	r	Erhalten Sie nahtlosen Zugriff auf die GIF-Blöcke mit dieser Eigenschaft, die ein einfaches Abrufen und Manipulieren der zugrunde liegenden Datenstrukturen des Bildes ermöglicht.
bounds	Rectangle	r	Liest die Objektgrenzen.
buffer_size_hint	int	r/w	Liest oder setzt den Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.
container	Image	r	Liest den Image Container.
data_stream_container	StreamContainer	r	Liest den Datenstrom des Objekts.
freigegeben	bool	r	Liest einen Wert, der angibt, ob diese Instanz freigegeben ist.
exif_data	ExifData	r/w	Liest oder setzt die Exif‑Instanz.
file_format	FileFormat	r	Rufen Sie das Dateiformat mühelos mit dieser Eigenschaft ab. Es ist Ihre zentrale Quelle zur Identifizierung des Formats Ihrer Dateien. Nahtlos in Ihren Arbeitsablauf integriert, liefert es wichtige Informationen ohne Aufwand.
has_alpha	bool	r	Gibt einen Wert zurück, der angibt, ob diese Instanz Alpha enthält.
has_background_color	bool	r/w	Diese Eigenschaft bestimmt, ob das GIF-Bild eine Hintergrundfarbe enthält. Wenn true, bedeutet dies, dass das Bild eine Hintergrundfarbe beinhaltet.
has_trailer	bool	r/w	Verwalten Sie das Vorhandensein eines Trailers in Ihren GIF-Dateien mit dieser Eigenschaft. Ob Sie prüfen müssen, ob ein Trailer existiert, oder dessen Vorhandensein festlegen, diese Eigenschaft vereinfacht den Vorgang. Halten Sie Ihre GIF-Dateien strukturiert und konform mit dieser intuitiven Funktion.
has_transparent_color	bool	r/w	Bestimmen Sie, ob der aktive Frame des GIF-Bildes eine transparente Farbe enthält. Diese Eigenschaft bietet eine praktische Möglichkeit, die Transparenz im Bild zu prüfen.
height	int	r	Liest die Bildhöhe.
horizontal_resolution	float	r/w	Liest oder setzt die horizontale Auflösung in Pixel pro Zoll dieses RasterImage.
image_opacity	float	r	Rufen Sie die Opazität des aktiven Frames im Bild ab, um Einblick in dessen Transparenzgrad zu erhalten. Diese Eigenschaft ist besonders nützlich, um das Ausmaß der Transparenz oder Undurchsichtigkeit des aktiven Frames im Bild zu verstehen.
interrupt_monitor	InterruptMonitor	r/w	Liest oder setzt den Interrupt-Monitor.
is_cached	bool	r	Liest einen Wert, der angibt, ob Bilddaten derzeit zwischengespeichert sind.
is_interlaced	bool	r	Bestimmt, ob das Bild interlaced ist, was seine Anzeige beim Laden beeinflusst. Diese Eigenschaft bietet Einblick in das Renderverhalten des Bildes, was für die Optimierung von Ladestrategien und die Verbesserung des gesamten Betrachtungserlebnisses unerlässlich ist.
is_palette_sorted	bool	r/w	Steuern Sie die Sortierung der Palette in Ihren GIF-Bildern mit dieser Eigenschaft. Ob Sie prüfen müssen, ob die Palette sortiert ist, oder das Sortierverhalten festlegen möchten, diese Eigenschaft bietet eine unkomplizierte Möglichkeit, die Palettenorganisation in Ihren GIF-Dateien zu verwalten.
is_raw_data_available	bool	r	Liest einen Wert, der angibt, ob das Laden von Rohdaten unterstützt wird.
loops_count	int	r/w	Rufen Sie die Schleifenanzahl mühelos mit dieser Eigenschaft ab. Wenn Ihr GIF-Bild Schleifeninformationen enthält, bietet Ihnen diese Eigenschaft schnellen Zugriff auf die Schleifenanzahl, sodass Sie das Schleifenverhalten in Ihren GIF-Dateien nahtlos verwalten können.
metadata	ImageMetadata	r	Liest oder setzt XMP-Daten aus dem Frame.
page_count	int	r	Ermitteln Sie die Gesamtzahl der im Bild enthaltenen Seiten mit dieser unkomplizierten Eigenschaft. Ideal, um schnell das Ausmaß des Bildinhalts zu beurteilen.
pages	Image[]	r	Erhalten Sie Zugriff auf die Seiten im Bild über diese praktische Eigenschaft, die nahtlose Navigation und Manipulation einzelner Seiten nach Bedarf ermöglicht.
palette	IColorPalette	r/w	Liest oder setzt die Farbpalette. Die Farbpalette wird nicht verwendet, wenn Pixel direkt dargestellt werden.
palette_color_resolution_bits	System.Byte	r/w	Verwalten Sie die Farbauflösung der Palette Ihrer GIF-Bilder mit dieser Eigenschaft. Passen Sie die Anzahl der Bits an, die zur Darstellung von Farben in der Palette verwendet werden, und erhalten Sie feine Kontrolle über Farbtiefe und Bildqualität.
pixel_aspect_ratio	System.Byte	r/w	Verwalten Sie das Pixel-Seitenverhältnis des GIF-Bildes mit dieser Eigenschaft. Setzen oder lesen Sie das Seitenverhältnis, um eine genaue Darstellung sicherzustellen und die visuelle Treue zu bewahren.
premultiply_components	bool	r/w	Liest oder setzt einen Wert, der angibt, ob die Bildkomponenten vormultipliziert werden müssen.
raw_custom_color_converter	IColorConverter	r/w	Liest oder setzt den benutzerdefinierten Farbkonverter
raw_data_format	PixelDataFormat	r	Liest das Rohdatenformat.
raw_data_settings	RawDataSettings	r	Liest die aktuellen Rohdateneinstellungen. Hinweis: Beim Verwenden dieser Einstellungen werden die Daten ohne Konvertierung geladen.
raw_fallback_index	int	r/w	Liest oder setzt den Rückfallindex, der verwendet wird, wenn der Palettenindex außerhalb des gültigen Bereichs liegt
raw_indexed_color_converter	IIndexedColorConverter	r/w	Liest oder setzt den indizierten Farbkonverter
raw_line_size	int	r	Liest die Rohzeilengröße in Bytes.
size	Size	r	Liest die Objektgröße.
transparent_color	Color	r/w	Rufen Sie die transparente Farbe des aktiven Frames im GIF-Bild ab. Diese Eigenschaft ermöglicht Ihnen den Zugriff auf die spezifische Farbe, die im aktuell aktiven Frame als transparent festgelegt wurde.
update_xmp_data	bool	r/w	Liest oder setzt einen Wert, der angibt, ob die XMP-Metadaten aktualisiert werden sollen.
use_palette	bool	r	Liest einen Wert, der angibt, ob die Bildpalette verwendet wird.
use_raw_data	bool	r/w	Liest oder setzt einen Wert, der angibt, ob das Laden von Rohdaten verwendet werden soll, wenn das Laden von Rohdaten verfügbar ist.
vertical_resolution	float	r/w	Liest oder setzt die vertikale Auflösung in Pixel pro Zoll dieses RasterImage.
width	int	r	Liest die Bildbreite.
xmp_data	XmpPacketWrapper	r/w	Liest oder setzt XMP-Daten.

Methods

Name	Beschreibung
add_block(block)	Das Hinzufügen eines neuen GIF-Blocks ermöglicht es Ihnen, zusätzliche Daten im Bild zu integrieren. Diese Methode erlaubt das Anhängen benutzerdefinierter Blöcke an das GIF-Bild, die verschiedene Arten von Informationen enthalten können.
add_page(page)	Integrieren Sie nahtlos eine neue Seite in das bestehende Bild, wodurch dessen Inhalt verbessert und sein Umfang erweitert wird. Diese Methode erweitert Bildsammlungen um zusätzlichen Inhalt und fördert Kreativität sowie Flexibilität bei der Bildverwaltung und -komposition.
adjust_brightness(brightness)	Passt die Helligkeit des Bildes gemäß dem angegebenen brightness-Parameter an. Diese Methode verändert die Helligkeit des gesamten Bildes einheitlich, erhöht oder verringert die Gesamthelligkeit, um den gewünschten Effekt zu erzielen.
adjust_contrast(contrast)	Passt den Kontrast des Bildes an, indem es den Unterschied in Helligkeit zwischen den Pixeln verstärkt oder reduziert. Diese Methode verändert den gesamten Tonumfang des Bildes, macht dunklere Bereiche dunkler und hellere Bereiche heller, um die visuelle Klarheit und Details zu verbessern.
adjust_gamma(gamma)	Verbessern Sie die Bildqualität durch Anwendung einer Gamma-Korrektur. Diese Methode passt das Farb-Gamma des Bildes an, um optimale visuelle Klarheit zu erreichen. Sie verändert den Gamma-Wert jedes Pixels, was zu einer verbesserten Farbwiedergabe und einem insgesamt besseren Bildauftritt führt.
adjust_gamma(gamma_red, gamma_green, gamma_blue)	Die Gamma-Korrektur eines Bildes wendet eine nichtlineare Anpassung der Pixelwerte an, die Helligkeit basierend auf den angegebenen Koeffizienten für die roten, grünen und blauen Kanäle zu erhöhen oder zu reduzieren. Diese Methode hilft, das Farbgleichgewicht und die Luminanz des Bildes fein abzustimmen, wodurch das Gesamtbild und die visuelle Qualität verbessert werden.
analyze_percentage_digital_signature(password)	Berechnet den prozentualen Ähnlichkeitsgrad zwischen den extrahierten Daten und dem ursprünglichen Passwort.
auto_brightness_contrast()	Führt eine automatische adaptive Helligkeits- und Kontrastnormalisierung für das gesamte Bild durch.
auto_rotate()	Dreht das Bild automatisch basierend auf den aus den Exif- Metadaten extrahierten Orientierungsdaten. Diese Methode stellt sicher, dass Bilder in der korrekten Ausrichtung angezeigt werden, verbessert das Benutzererlebnis und eliminiert die Notwendigkeit manueller Anpassungen. Durch Analyse der Exif-Informationen wird das Bild entsprechend gedreht, was ein nahtloses Anzeigeerlebnis über verschiedene Plattformen und Geräte hinweg ermöglicht. Dieser automatisierte Rotations Prozess vereinfacht die Bildverarbeitung und erhöht die Gesamtbenutzerfreundlichkeit, insbesondere bei großen Bildmengen mit unterschiedlichen Ausrichtungen.
binarize_bradley(brightness_difference)	Die Binarisierung eines Bildes mithilfe von Bradleys adaptivem Schwellenwertalgorithmus mit Integralbild-Schwellenwerten ist ein Verfahren, um ein Graustufenbild in ein Binärbild zu konvertieren. Dieser Algorithmus berechnet für jedes Pixel einen lokalen Schwellenwert basierend auf der durchschnittlichen Intensität der umliegenden Pixel innerhalb eines festgelegten Fensters. Durch die adaptive Anpassung des Schwellenwerts an lokale Pixelintensitäten ist Bradleys Methode effektiv im Umgang mit Beleuchtungs- und Kontrastvariationen im Bild.
binarize_bradley(brightness_difference, window_size)	Binarisierung eines Bildes mit Bradleys adaptivem Schwellenwertalgorithmus unter Verwendung der Integralbild-Schwellenwertbestimmung
binarize_fixed(threshold)	Die Binarisierung eines Bildes mit einem vordefinierten Schwellenwert wandelt ein Graustufen- oder Farbbild in ein Binärbild um, wobei jedes Pixel als schwarz oder weiß klassifiziert wird, abhängig davon, ob sein Intensitätswert einen festgelegten Schwellenwert überschreitet.
binarize_otsu()	Die Binarisierung eines Bildes mit Otsu-Schwellenwert ist ein Verfahren, das automatisch den optimalen Schwellenwert zur Umwandlung eines Graustufenbildes in ein Binärbild bestimmt. Der Otsu-Algorithmus berechnet den Schwellenwert, der die Intra-Klassen-Varianz der Pixelintensitäten in den beiden resultierenden Klassen (Vordergrund und Hintergrund) minimiert. Diese Technik ist besonders nützlich, wenn der optimale Schwellenwert unbekannt ist und adaptiv basierend auf dem Histogramm des Bildes ermittelt werden muss.
blend(origin, overlay, overlay_alpha)	Mischt diese Bildinstanz mit dem overlay-Bild.
blend(origin, overlay, overlay_area, overlay_alpha)	Mischt diese Bildinstanz mit dem overlay-Bild.
cache_data()	Zwischenspeichert die Daten privat.
can_load(file_path)	Bestimmt, ob das Bild vom angegebenen Dateipfad geladen werden kann.
can_load(file_path, load_options)	Bestimmt, ob das Bild vom angegebenen Dateipfad geladen werden kann und optional die angegebenen Öffnungsoptionen verwendet.
can_load(stream)	Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann.
can_load(stream, load_options)	Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann und optional die angegebenen loadOptions verwendet.
can_load_stream(stream)	Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann.
can_load_stream_with_options(stream, load_options)	Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann und optional die angegebenen loadOptions verwendet.
can_load_with_options(file_path, load_options)	Bestimmt, ob das Bild vom angegebenen Dateipfad geladen werden kann und optional die angegebenen Öffnungsoptionen verwendet.
can_save(options)	Bestimmt, ob das Bild im angegebenen Dateiformat, das durch die übergebenen Speicheroptionen repräsentiert wird, gespeichert werden kann.
clear_blocks()	Das Löschen aller GIF-Blöcke entfernt alle im Bild gespeicherten Daten. Dieser Vorgang setzt das Bild effektiv in einen leeren Zustand zurück und entfernt alle zuvor hinzugefügten Blöcke. Verwenden Sie diese Methode, wenn Sie mit einem sauberen Neustart ein GIF-Bild erstellen oder ändern möchten.
create(files)	Erstellt das mehrseitige Bild, das die angegebenen Dateien enthält.
create(files, throw_exception_on_load_error)	Erstellt das mehrseitige Bild, das die angegebenen Dateien enthält.
create(image_options, width, height)	Erstellt ein neues Bild mit den angegebenen Erstellungsoptionen.
create(image_options, width, height, pixels)	Erstellt eine RasterImage Instanz aus dem bereitgestellten Pixelarray. Validiert, dass die angegebene Breite und Höhe den Abmessungen der Pixeldaten entsprechen. Diese Methode kann nur verwendet werden, wenn die Bibliothek im lizenzierten Modus ist.
create(images)	Erstellt ein neues Bild, das die angegebenen Bilder als Seiten verwendet
create(images, dispose_images)	Erstellt ein neues Bild, wobei die angegebenen Bilder als Seiten verwendet werden.
create(multipage_create_options)	Erstellt die angegebenen Mehrseiten‑Erstellungsoptionen.
create_from_files(files)	Erstellt das Mehrseiten‑Bild, das die angegebenen Dateien als Lazy‑Loading‑Seiten enthält.
create_from_files(files, throw_exception_on_load_error)	Erstellt das Mehrseiten‑Bild, das die angegebenen Dateien als Lazy‑Loading‑Seiten enthält.
create_from_images(images)	Erstellt ein neues Bild, das die angegebenen Bilder als Seiten verwendet
create_from_images(images, dispose_images)	Erstellt ein neues Bild, wobei die angegebenen Bilder als Seiten verwendet werden.
crop(left_shift, right_shift, top_shift, bottom_shift)	Bild mit Verschiebungen zuschneiden.
crop(rectangle)	Beschneiden Sie das Bild mithilfe eines angegebenen Rechteckbereichs. Dieser Vorgang entfernt den äußeren Teil des Bildes und lässt nur den durch das Rechteck definierten ausgewählten Bereich übrig.
dither(dithering_method, bits_count)	Führt Dithering auf dem aktuellen Bild aus.
dither(dithering_method, bits_count, custom_palette)	Wenden Sie Dithering auf das aktuelle Bild an. Dieser Vorgang verbessert die Bildqualität, indem er Farbbänderungen reduziert und Farbübergänge verbessert, was zu einem glatteren Erscheinungsbild führt.
embed_digital_signature(password)	Betten Sie eine digitale Signatur, basierend auf dem angegebenen Passwort, in jede Seite des Bildes ein.
filter(rectangle, options)	Wenden Sie einen bestimmten Filter auf den festgelegten Bereich des Bildes an, um dessen visuelle Qualität zu verbessern oder das Aussehen nach Wunsch zu verändern. Diese Methode verarbeitet selektiv Pixel innerhalb des definierten Rechtecks, sodass gezielte Anpassungen vorgenommen werden können und gleichzeitig die Integrität der umgebenden Bilddaten erhalten bleibt.
get_argb_32_pixel(x, y)	Liefert ein 32‑Bit‑ARGB‑Pixel‑Bild.
get_default_argb_32_pixels(rectangle)	Liefert das Standard‑32‑Bit‑ARGB‑Pixel‑Array.
get_default_options(args)	Liefert die Standardoptionen.
get_default_pixels(rectangle, partial_pixel_loader)	Liefert das Standard‑Pixel‑Array mittels teilweisem Pixel‑Lader.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)	Liefert das Standard‑Rohdaten‑Array mittels teilweisem Pixel‑Lader.
get_default_raw_data(rectangle, raw_data_settings)	Liefert das Standard‑Rohdaten‑Array.
get_file_format(file_path)	Liefert das Dateiformat.
get_file_format(stream)	Liefert das Dateiformat.
get_file_format_of_stream(stream)	Liefert das Dateiformat.
get_fitting_rectangle(rectangle, pixels, width, height)	Liefert das Rechteck, das zum aktuellen Bild passt.
get_fitting_rectangle(rectangle, width, height)	Liefert das Rechteck, das zum aktuellen Bild passt.
get_modify_date(use_default)	Liefert Datum und Uhrzeit, zu der das Ressourcen‑Bild zuletzt geändert wurde.
get_original_options()	Rufen Sie die auf den ursprünglichen Dateieinstellungen basierenden Optionen ab, die für die Aufrechterhaltung von Treue und Konsistenz bei der Bildverarbeitung und -manipulation entscheidend sind. Diese Methode ermöglicht eine nahtlose Integration dateispezifischer Parameter in nachfolgende Vorgänge, wodurch eine genaue Wiedergabe und die Einhaltung der inhärenten Eigenschaften des Bildes gewährleistet wird. Dies kann hilfreich sein, um die Bit‑Tiefe 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 es anschließend mit der DataStreamSupporter.save(file_path)‑Methode speichern, wird ein PNG‑Ausgabebild mit 8 Bit pro Pixel erzeugt. Um dies zu vermeiden und ein PNG‑Bild mit 1‑Bit pro Pixel zu speichern, verwenden Sie diese Methode, um die entsprechenden Speicheroptionen zu erhalten und sie an die Image.save(file_path, options)‑Methode als zweiten Parameter zu übergeben.
get_pixel(x, y)	Liefert ein Bild‑Pixel.
get_proportional_height(width, height, new_width)	Liefert eine proportionale Höhe.
get_proportional_width(width, height, new_height)	Liefert eine proportionale Breite.
get_serialized_stream(image_options, clipping_rectangle, page_number)	Konvertiert zu aps.
get_skew_angle()	Liefert den Schrägungswinkel. Diese Methode ist auf gescannte Textdokumente anwendbar, um den Schrägungswinkel beim Scannen zu bestimmen.
grayscale()	Die Umwandlung eines Bildes in seine Graustufen‑Darstellung konvertiert das Farbbild in eine Graustufen‑Version, indem Farbinformationen entfernt werden, während die Luminanz erhalten bleibt. Dieser Vorgang vereinfacht das Bild zu Grautönen und macht es geeignet für verschiedene Anwendungen wie Druck, Dokumentenverarbeitung und Graustufen‑Analyse.
insert_block(index, block)	Das Einfügen eines neuen GIF‑Blocks ermöglicht es Ihnen, benutzerdefinierte Daten an einer bestimmten Position im Bild hinzuzufügen. Diese Methode erlaubt es, benutzerdefinierte Blöcke an einer gewünschten Stelle im GIF‑Bild zu platzieren und bietet Flexibilität beim Organisieren und Strukturieren der Bilddaten.
is_digital_signed(password, percentage_threshold)	Führt eine schnelle Prüfung durch, um festzustellen, ob das Bild digital signiert ist, wobei das bereitgestellte Passwort und der Schwellenwert verwendet werden.
load(file_path)	Lädt ein neues Bild vom angegebenen Dateipfad oder URL. Wenn filePath ein Dateipfad ist, öffnet die Methode einfach die Datei. Wenn filePath eine URL ist, lädt die Methode die Datei herunter, speichert sie temporär und öffnet sie.
load(file_path, load_options)	Lädt ein neues Bild vom angegebenen Dateipfad oder URL. Wenn filePath ein Dateipfad ist, öffnet die Methode einfach die Datei. Wenn filePath eine URL ist, lädt die Methode die Datei herunter, speichert sie temporär und öffnet sie.
load(stream)	Lädt ein neues Bild aus dem angegebenen Stream.
load(stream, load_options)	Lädt ein neues Bild aus dem angegebenen Stream.
load_argb_32_pixels(rectangle)	Lädt 32‑Bit‑ARGB‑Pixel.
load_argb_64_pixels(rectangle)	Lädt 64‑Bit‑ARGB‑Pixel.
load_cmyk_32_pixels(rectangle)	Lädt Pixel im CMYK‑Format.
load_cmyk_pixels(rectangle)	Lädt Pixel im CMYK‑Format. Diese Methode ist veraltet. Bitte verwenden Sie die effektivere Methode RasterImage.load_cmyk_32_pixels(rectangle).
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)	Lädt 32‑Bit‑ARGB‑Pixel teilweise (nach Blöcken).
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)	Lädt 64‑Bit‑ARGB‑Pixel teilweise nach Paketen.
load_partial_pixels(desired_rectangle, pixel_loader)	Lädt Pixel teilweise nach Paketen.
load_pixels(rectangle)	Lädt Pixel.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)	Lädt Rohdaten.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)	Lädt Rohdaten.
load_stream(stream)	Lädt ein neues Bild aus dem angegebenen Stream.
load_stream_with_options(stream, load_options)	Lädt ein neues Bild aus dem angegebenen Stream.
load_with_options(file_path, load_options)	Lädt ein neues Bild vom angegebenen Dateipfad oder URL. Wenn filePath ein Dateipfad ist, öffnet die Methode einfach die Datei. Wenn filePath eine URL ist, lädt die Methode die Datei herunter, speichert sie temporär und öffnet sie.
normalize_angle()	Normalisiert den Winkel. Diese Methode ist auf gescannte Textdokumente anwendbar, um die schiefe Aufnahme zu korrigieren. Diese Methode verwendet die Methoden RasterImage.get_skew_angle() und RasterImage.rotate(angle).
normalize_angle(resize_proportionally, background_color)	Normalisiert den Winkel. Diese Methode ist auf gescannte Textdokumente anwendbar, um die schiefe Aufnahme zu korrigieren. Diese Methode verwendet die Methoden RasterImage.get_skew_angle() und RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()	Normalisiert das Bildhistogramm — passt die Pixelwerte an, um den gesamten verfügbaren Bereich zu nutzen.
order_blocks()	Das Ordnen der GIF‑Blöcke gemäß der GIF‑Spezifikation stellt ein korrektes GIF‑Layout und die Einhaltung des Standards sicher. Dieser Vorgang beinhaltet das Anordnen der Blöcke in der richtigen Reihenfolge, wie in der Spezifikation definiert. Zusätzlich kann es das Entfernen bestimmter GifGraphicsControlBlock‑Instanzen umfassen, die für das endgültige Layout nicht erforderlich sind. Durch die Einhaltung der GIF‑Spezifikation wird das resultierende Bild korrekt strukturiert und ist mit GIF‑Betrachtungsanwendungen kompatibel.
read_argb_32_scan_line(scan_line_index)	Liest die gesamte Scanzeile anhand des angegebenen Scanzeilen‑Index.
read_scan_line(scan_line_index)	Liest die gesamte Scanzeile anhand des angegebenen Scanzeilen‑Index.
remove_block(block)	Das Entfernen eines GIF‑Blocks löscht bestimmte Daten aus dem Bild und bietet die Möglichkeit, die Bildstruktur zu bereinigen oder zu verändern. Diese Methode ermöglicht das Entfernen unerwünschter oder überflüssiger Blöcke, wodurch das GIF‑Bild effizienter gespeichert wird. Nutzen Sie diese Funktion, um veraltete Informationen aus dem Bild zu eliminieren, während dessen Integrität und Qualität erhalten bleiben.
remove_metadata()	Entfernt die Metadaten dieser Bildinstanz, indem der Wert von IHasXmpData.xmp_data auf None gesetzt wird.
replace_argb(old_color_argb, old_color_diff, new_color_argb)	Ersetzt eine Farbe durch eine andere mit zulässiger Differenz und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.
replace_color(old_color, old_color_diff, new_color)	Ersetzt eine Farbe durch eine andere mit zulässiger Differenz und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.
replace_color(old_color_argb, old_color_diff, new_color_argb)	Ersetzt eine Farbe durch eine andere mit zulässiger Differenz und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.
replace_non_transparent_colors(new_color)	Ersetzt alle nicht‑transparenten Farben durch eine neue Farbe und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten. Hinweis: Wenn Sie dies bei Bildern ohne Transparenz verwenden, werden alle Farben durch eine einzige ersetzt.
replace_non_transparent_colors(new_color_argb)	Ersetzt alle nicht‑transparenten Farben durch eine neue Farbe und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten. Hinweis: Wenn Sie dies bei Bildern ohne Transparenz verwenden, werden alle Farben durch eine einzige ersetzt.
resize(new_width, new_height)	Skaliert das Bild. Der Standardwert ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.
resize(new_width, new_height, resize_type)	Skaliert diese Image Instanz.
resize(new_width, new_height, settings)	Skaliert diese Image Instanz.
resize_by_settings(new_width, new_height, settings)	Skaliert das Bild.
resize_by_type(new_width, new_height, resize_type)	Skaliert das Bild.
resize_full_frame(new_width, new_height, resize_type)	Die Größenänderung des Bildes berücksichtigt dabei die vollständigen Frames jeder Seite in einem GIF, wodurch das Auftreten potenzieller Artefakte verhindert wird. Diese Methode ist wesentlich, um die Integrität und Qualität des Bildes zu bewahren, insbesondere bei animierten GIFs oder Frame‑Sequenzen.
resize_height_proportionally(new_height)	Skaliert die Höhe proportional. Der Standard ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.
resize_height_proportionally(new_height, resize_type)	Skaliert die Breite proportional.
resize_height_proportionally(new_height, settings)	Skaliert die Höhe proportional.
resize_height_proportionally_settings(new_height, settings)	Skaliert die Höhe proportional.
resize_proportional(new_width, new_height, resize_type)	Das proportionale Skalieren erhält das Seitenverhältnis des Bildes, während seine Größe angepasst wird, sodass das Bild nicht gestreckt oder verzerrt wirkt. Diese Methode skaliert das Bild proportional, indem sowohl Breite als auch Höhe mit demselben Faktor verändert werden. Die proportionale Größenänderung passt jeden Frame gemäß dem Verhältnis newWidth/width und newHeight/height an.
resize_width_proportionally(new_width)	Skaliert die Breite proportional. Der Standard ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.
resize_width_proportionally(new_width, resize_type)	Skaliert die Breite proportional.
resize_width_proportionally(new_width, settings)	Skaliert die Breite proportional.
resize_width_proportionally_settings(new_width, settings)	Skaliert die Breite proportional.
rotate(angle)	Bild um das Zentrum drehen.
rotate(angle, resize_proportionally, background_color)	Diese Methode rotiert das Bild um seinen Mittelpunkt. Durch Angabe des Rotations Winkels können Sie das Bild im Uhrzeigersinn oder gegen den Uhrzeigersinn drehen, um die gewünschte Ausrichtung zu erreichen. Diese Rotation hilft, die Darstellung oder Ausrichtung des Bildes anzupassen, ohne dessen Inhalt zu verzerren.
rotate_flip(rotate_flip_type)	Führt Rotation, Spiegelung oder beides ausschließlich am aktiven Frame aus. Dieser Vorgang wendet Transformationen nur auf den derzeit aktiven Frame des Bildes an, wobei die Integrität der anderen Frames in der Sequenz erhalten bleibt.
rotate_flip_all(rotate_flip)	Dreht das gesamte Flip.
save()	Speichert die Bilddaten in den zugrunde liegenden Stream.
save(file_path)	Speichert das Bild am angegebenen Dateipfad.
save(file_path, options)	Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.
save(file_path, options, bounds_rectangle)	Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.
save(file_path, over_write)	Speichert die Daten des Objekts am angegebenen Speicherort.
save(stream)	Speichert die Daten des Objekts in den angegebenen Stream.
save(stream, options_base)	Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.
save(stream, options_base, bounds_rectangle)	Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.
save_argb_32_pixels(rectangle, pixels)	Speichert die 32‑Bit‑ARGB‑Pixel.
save_cmyk_32_pixels(rectangle, pixels)	Speichert die Pixel.
save_cmyk_pixels(rectangle, pixels)	Speichert die Pixel. Diese Methode ist veraltet. Bitte verwenden Sie die effektivere RasterImage.save_cmyk_32_pixels(rectangle, pixels) Methode.
save_pixels(rectangle, pixels)	Speichert die Pixel intern im Hauptspeicher.
save_raw_data(data, data_offset, rectangle, raw_data_settings)	Speichert die Rohdaten.
save_to_stream(stream)	Speichert die Daten des Objekts in den angegebenen Stream.
save_to_stream_with_options(stream, options_base)	Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.
save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)	Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.
save_with_options(file_path, options)	Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.
save_with_options_rect(file_path, options, bounds_rectangle)	Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.
set_argb_32_pixel(x, y, argb_32_color)	Setzt ein 32‑Bit‑ARGB‑Pixel des Bildes für die angegebene Position.
set_frame_time(time)	Passt die Dauer jedes Frames in Millisekunden an und sorgt für eine gleichmäßige Zeitsteuerung über die gesamte Bildsequenz hinweg. Diese Methode legt die Anzeigedauer jedes Frames einheitlich fest, wodurch eine präzise Kontrolle der Animationsgeschwindigkeit ermöglicht wird. Das Ändern dieses Wertes setzt die Verzögerung für alle Frames zurück.
set_palette(palette, update_colors)	Setzt die Bildpalette.
set_pixel(x, y, color)	Setzt ein Bildpixel für die angegebene Position.
set_resolution(dpi_x, dpi_y)	Setzt die Auflösung für dieses RasterImage.
try_set_metadata(metadata)	Versucht, eine metadata-Instanz zu setzen, falls diese Image‑Instanz unterstützt und eine IImageMetadataFormat‑Instanz implementiert.
write_argb_32_scan_line(scan_line_index, argb_32_pixels)	Schreibt die gesamte Scanzeile in den angegebenen Scanzeilen‑Index.
write_scan_line(scan_line_index, pixels)	Schreibt die gesamte Scanzeile in den angegebenen Scanzeilen‑Index.

Constructor: GifImage(first_frame)

 GifImage(first_frame)

Das Erstellen von GIF-Bildern wird mühelos mit dem GifImage
Konstruktor. Mit nur dem Parameter firstFrame betritt man eine Welt dynamischer
visueller Kommunikation.

Parameters:

Parameter	Typ	Beschreibung
first_frame	GifFrameBlock	Der erste Frame, mit dem das GIF‑Bild initialisiert wird.

See also:

Example # 1: This example shows how to create a GIF image and save it to a file.

Example # 2: The following example shows how to compose an animated GIF image from individ…

Constructor: GifImage(first_frame, global_palette)

 GifImage(first_frame, global_palette)

Initialisieren Sie ein neues GifImage Objekt mit den angegebenen Parametern für den
ersten Frame und die globale Palette. Beginnen Sie, GIF-Bilder zügig zu verwalten, und sorgen Sie für
eine genaue Darstellung mit anpassbaren Einstellungen für optimale Ergebnisse.

Parameters:

Parameter	Typ	Beschreibung
first_frame	GifFrameBlock	Der erste Frame, mit dem das GIF‑Bild initialisiert wird.
global_palette	IColorPalette	Die zu verwendende globale Palette. Hinweis: Wenn sowohl firstFrame als auch globalPalette null sind, wird die Standard‑Globale Palette verwendet.

See also:

Example # 1: This example shows how to create a GIF image with a custom palette and save i…

Constructor: GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)

 GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)

Starten Sie mühelos mit dem GifImage Konstruktor. Mit dieser
einfachen Methode können Sie problemlos animierte GIFs erstellen. Geben Sie einfach den
firstFrame, globalPalette, paletteColorResolution, aspectRatio und weitere
Parameter an, und Sie sind bereit, Ihre visuellen Inhalte zum Leben zu erwecken.

Parameters:

Parameter	Typ	Beschreibung
first_frame	GifFrameBlock	Der erste Frame, mit dem das GIF‑Bild initialisiert wird.
global_palette	IColorPalette	Die zu verwendende globale Palette. Hinweis: Wenn sowohl firstFrame als auch globalPalette null sind, wird die Standard‑Globale Palette verwendet.
is_palette_sorted	bool	Wenn auf true gesetzt, wird die Palette sortiert. Hinweis: Der Parameter wird verwendet, wenn globalPalette nicht null ist.
palette_color_resolution	System.Byte	Die Farbauflösung der Palette. Hinweis: Der Parameter wird verwendet, wenn globalPalette nicht null ist.
palette_background_color_index	System.Byte	Der Index der Hintergrundfarbe der Palette.
aspect_ratio	System.Byte	Das Seitenverhältnis.
has_trailer	bool	Wenn auf true gesetzt, enthält das GIF‑Bild einen Trailer, andernfalls wird am Ende des Streams kein Trailer geschrieben.

Property: active_frame

Verwalten und manipulieren Sie Frames mit dieser Eigenschaft, die eine reibungslose Navigation und
Modifikation des aktiven Frames im GIF-Bild ermöglicht.

See also:

Example # 1: The following example shows how to remove all blocks from a GIF image.

Method: add_block(block)

 add_block(block)

Das Hinzufügen eines neuen GIF-Blocks ermöglicht es Ihnen, zusätzliche Daten im Bild zu integrieren.
Diese Methode erlaubt das Anhängen benutzerdefinierter Blöcke an das GIF-Bild, die
verschiedene Arten von Informationen enthalten können.

Parameters:

Parameter	Typ	Beschreibung
block	IGifBlock	Der hinzuzufügende GIF‑Block.

See also:

Example # 1: The following example shows how to compose an animated GIF image from individ…

Method: add_page(page)

 add_page(page)

Integrieren Sie nahtlos eine neue Seite in das bestehende Bild, wodurch dessen Inhalt verbessert
und sein Umfang erweitert wird. Diese Methode erweitert Bildsammlungen um zusätzlichen
Inhalt und fördert Kreativität sowie Flexibilität bei der Bildverwaltung und -komposition.

Parameters:

Parameter	Typ	Beschreibung
page	RasterImage	Die hinzuzufügende Seite.

See also:

Example # 1: Create multipage GIF image using single page raster images.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness)

Passt die Helligkeit des Bildes gemäß dem angegebenen
brightness-Parameter an. Diese Methode verändert die Helligkeit des
gesamten Bildes einheitlich, erhöht oder verringert die Gesamthelligkeit, um den gewünschten Effekt zu erzielen.

Parameters:

Parameter	Typ	Beschreibung
Helligkeit	int	Helligkeitswert.

See also:

Example # 1: The following example performs brightness correction of a GIF image.

Method: adjust_contrast(contrast)

 adjust_contrast(contrast)

Passt den Kontrast des Bildes an, indem es den Unterschied in
Helligkeit zwischen den Pixeln verstärkt oder reduziert. Diese Methode verändert den gesamten Tonumfang des Bildes,
macht dunklere Bereiche dunkler und hellere Bereiche heller, um die visuelle Klarheit
und Details zu verbessern.

Parameters:

Parameter	Typ	Beschreibung
Kontrast	float	Kontrastwert (im Bereich [-100; 100])

See also:

Example # 1: The following example performs contrast correction of a GIF image.

Method: adjust_gamma(gamma)

 adjust_gamma(gamma)

Verbessern Sie die Bildqualität durch Anwendung einer Gamma-Korrektur. Diese Methode passt das Farb-Gamma des Bildes an, um optimale visuelle Klarheit zu erreichen. Sie verändert den Gamma-Wert
jedes Pixels, was zu einer verbesserten Farbwiedergabe und einem insgesamt besseren Bildauftritt führt.

Parameters:

Parameter	Typ	Beschreibung
Gamma	float	Gamma‑Koeffizient für die Rot‑, Grün‑ und Blaukanäle

See also:

Example # 1: The following example performs gamma-correction of a GIF image.

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue)

Die Gamma-Korrektur eines Bildes wendet eine nichtlineare Anpassung der Pixelwerte an,
die Helligkeit basierend auf den angegebenen Koeffizienten für die roten,
grünen und blauen Kanäle zu erhöhen oder zu reduzieren. Diese Methode hilft, das Farbgleichgewicht und die
Luminanz des Bildes fein abzustimmen, wodurch das Gesamtbild und die visuelle Qualität verbessert werden.

Parameters:

Parameter	Typ	Beschreibung
gamma_red	float	Gamma‑Koeffizient für den Rotkanal
gamma_green	float	Gamma‑Koeffizient für den Grünkanal
gamma_blue	float	Gamma für den Blaukanal-Koeffizienten

See also:

Example # 1: The following example performs gamma-correction of a GIF image applying diffe…

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password)

Berechnet den prozentualen Ähnlichkeitsgrad zwischen den extrahierten Daten und dem ursprünglichen Passwort.

Parameters:

Parameter	Typ	Beschreibung
Passwort	string	Das Passwort, das zum Extrahieren der eingebetteten Daten verwendet wird.

Returns

Typ	Beschreibung
int	Der prozentuale Ähnlichkeitswert.

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference)

Die Binarisierung eines Bildes mithilfe von Bradleys adaptivem Schwellenwertalgorithmus mit
Integralbild-Schwellenwerten ist ein Verfahren, um ein Graustufenbild in ein
Binärbild zu konvertieren. Dieser Algorithmus berechnet für jedes Pixel einen lokalen Schwellenwert basierend auf
der durchschnittlichen Intensität der umliegenden Pixel innerhalb eines festgelegten Fensters. Durch
die adaptive Anpassung des Schwellenwerts an lokale Pixelintensitäten ist Bradleys
Methode effektiv im Umgang mit Beleuchtungs- und Kontrastvariationen im Bild.

Parameters:

Parameter	Typ	Beschreibung
brightness_difference	float	Der Helligkeitsunterschied zwischen dem Pixel und dem Durchschnitt eines s × s-Fensters von Pixeln, das um dieses Pixel zentriert ist.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size)

Binarisierung eines Bildes mit Bradleys adaptivem Schwellenwertalgorithmus unter Verwendung der Integralbild-Schwellenwertbestimmung

Parameters:

Parameter	Typ	Beschreibung
brightness_difference	float	Der Helligkeitsunterschied zwischen dem Pixel und dem Durchschnitt eines s x s Fensters von Pixeln das um dieses Pixel zentriert ist.
window_size	int	Die Größe des s x s Fensters von Pixeln, das um dieses Pixel zentriert ist.

Method: binarize_fixed(threshold)

 binarize_fixed(threshold)

Die Binarisierung eines Bildes mit einem vordefinierten Schwellenwert wandelt ein Graustufen- oder Farbbild
in ein Binärbild um, wobei jedes Pixel als schwarz oder weiß klassifiziert wird,
abhängig davon, ob sein Intensitätswert einen festgelegten Schwellenwert überschreitet.

Parameters:

Parameter	Typ	Beschreibung
Schwellenwert	System.Byte	Schwellenwert. Wenn der entsprechende Grauwert eines Pixels größer als der Schwellenwert ist, wird ihm der Wert 255 zugewiesen, sonst 0.

See also:

Example # 1: The following example binarizes a GIF image with the predefined threshold. Bi…

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha)

Mischt diese Bildinstanz mit dem overlay-Bild.

Parameters:

Parameter	Typ	Beschreibung
origin	Point	Der Ursprung der Hintergrundbildüberblendung.
overlay	RasterImage	Das Overlay-Bild.
overlay_alpha	System.Byte	Der Overlay‑Alpha.

Method: blend(origin, overlay, overlay_area, overlay_alpha)

 blend(origin, overlay, overlay_area, overlay_alpha)

Mischt diese Bildinstanz mit dem overlay-Bild.

Parameters:

Parameter	Typ	Beschreibung
origin	Point	Der Ursprung der Hintergrundbildüberblendung.
overlay	RasterImage	Das Overlay-Bild.
overlay_area	Rectangle	Der Overlay‑Bereich.
overlay_alpha	System.Byte	Der Overlay‑Alpha.

Method: can_load(file_path) [static]

 can_load(file_path)

Bestimmt, ob das Bild vom angegebenen Dateipfad geladen werden kann.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad.

Returns

Typ	Beschreibung
bool	true wenn das Bild aus der angegebenen Datei geladen werden kann; andernfalls false.

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options)

Bestimmt, ob das Bild vom angegebenen Dateipfad geladen werden kann und optional die angegebenen Öffnungsoptionen verwendet.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad.
load_options	LoadOptions	Die Ladeoptionen.

Returns

Typ	Beschreibung
bool	true wenn das Bild aus der angegebenen Datei geladen werden kann; andernfalls false.

Method: can_load(stream) [static]

 can_load(stream)

Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, aus dem geladen werden soll.

Returns

Typ	Beschreibung
bool	true wenn das Bild aus dem angegebenen Stream geladen werden kann; andernfalls false.

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options)

Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann und optional die angegebenen loadOptions verwendet.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, aus dem geladen werden soll.
load_options	LoadOptions	Die Ladeoptionen.

Returns

Typ	Beschreibung
bool	true wenn das Bild aus dem angegebenen Stream geladen werden kann; andernfalls false.

Method: can_load_stream(stream) [static]

 can_load_stream(stream)

Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, aus dem geladen werden soll.

Returns

Typ	Beschreibung
bool	true wenn das Bild aus dem angegebenen Stream geladen werden kann; andernfalls false.

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options)

Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann und optional die angegebenen loadOptions verwendet.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, aus dem geladen werden soll.
load_options	LoadOptions	Die Ladeoptionen.

Returns

Typ	Beschreibung
bool	true wenn das Bild aus dem angegebenen Stream geladen werden kann; andernfalls false.

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options)

Bestimmt, ob das Bild vom angegebenen Dateipfad geladen werden kann und optional die angegebenen Öffnungsoptionen verwendet.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad.
load_options	LoadOptions	Die Ladeoptionen.

Returns

Typ	Beschreibung
bool	true wenn das Bild aus der angegebenen Datei geladen werden kann; andernfalls false.

Method: can_save(options)

 can_save(options)

Bestimmt, ob das Bild im angegebenen Dateiformat, das durch die übergebenen Speicheroptionen repräsentiert wird, gespeichert werden kann.

Parameters:

Parameter	Typ	Beschreibung
options	ImageOptionsBase	Die zu verwendenden Speicheroptionen.

Returns

Typ	Beschreibung
bool	true wenn das Bild im angegebenen Dateiformat, das durch die übergebenen Speicheroptionen dargestellt wird, gespeichert werden kann; andernfalls false.

Method: create(files) [static]

 create(files)

Erstellt das mehrseitige Bild, das die angegebenen Dateien enthält.

Parameters:

Parameter	Typ	Beschreibung
Dateien	string[]	Die Dateien.

Returns

Typ	Beschreibung
Image	Das mehrseitige Bild

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error)

Erstellt das mehrseitige Bild, das die angegebenen Dateien enthält.

Parameters:

Parameter	Typ	Beschreibung
Dateien	string[]	Die Dateien.
throw_exception_on_load_error	bool	wenn auf true gesetzt [Ausnahme bei Ladefehler werfen].

Returns

Typ	Beschreibung
Image	Das mehrseitige Bild

Method: create(image_options, width, height) [static]

 create(image_options, width, height)

Erstellt ein neues Bild mit den angegebenen Erstellungsoptionen.

Parameters:

Parameter	Typ	Beschreibung
image_options	ImageOptionsBase	Die Bildoptionen.
width	int	Die Breite.
height	int	Die Höhe.

Returns

Typ	Beschreibung
Image	Das neu erstellte Bild.

Method: create(image_options, width, height, pixels) [static]

 create(image_options, width, height, pixels)

Erstellt eine RasterImage Instanz aus dem bereitgestellten Pixelarray.

Validiert, dass die angegebene Breite und Höhe den Abmessungen der Pixeldaten entsprechen.
Diese Methode kann nur verwendet werden, wenn die Bibliothek im lizenzierten Modus ist.

Parameters:

Parameter	Typ	Beschreibung
image_options	ImageOptionsBase	Die Optionen, die zum Erstellen des RasterImage verwendet werden.
width	int	Die Breite des RasterImage.
height	int	Die Höhe des RasterImage.
Pixel	int[]	Das Array von Pixelwerten, das zum Befüllen des Bildes verwendet wird.

Returns

Typ	Beschreibung
Image	Ein RasterImage gefüllt mit den bereitgestellten Pixeldaten.

Method: create(images) [static]

 create(images)

Erstellt ein neues Bild, das die angegebenen Bilder als Seiten verwendet

Parameters:

Parameter	Typ	Beschreibung
images	Image[]	Die Bilder.

Returns

Typ	Beschreibung
Image	Das Bild als IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images)

Erstellt ein neues Bild, wobei die angegebenen Bilder als Seiten verwendet werden.

Parameters:

Parameter	Typ	Beschreibung
images	Image[]	Die Bilder.
dispose_images	bool	wenn auf true gesetzt [Bilder freigeben].

Returns

Typ	Beschreibung
Image	Das Bild als IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options)

Erstellt die angegebenen Mehrseiten‑Erstellungsoptionen.

Parameters:

Parameter	Typ	Beschreibung
multipage_create_options	MultipageCreateOptions	Die Optionen zum Erstellen von mehrseitigen Bildern.

Returns

Typ	Beschreibung
Image	Das mehrseitige Bild

Method: create_from_files(files) [static]

 create_from_files(files)

Erstellt das Mehrseiten‑Bild, das die angegebenen Dateien als Lazy‑Loading‑Seiten enthält.

Parameters:

Parameter	Typ	Beschreibung
Dateien	string[]	Die Dateien.

Returns

Typ	Beschreibung
Image	Das mehrseitige Bild

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error)

Erstellt das Mehrseiten‑Bild, das die angegebenen Dateien als Lazy‑Loading‑Seiten enthält.

Parameters:

Parameter	Typ	Beschreibung
Dateien	string[]	Die Dateien.
throw_exception_on_load_error	bool	wenn auf true gesetzt, Ausnahme bei Ladefehler werfen.

Returns

Typ	Beschreibung
Image	Das mehrseitige Bild

Method: create_from_images(images) [static]

 create_from_images(images)

Erstellt ein neues Bild, das die angegebenen Bilder als Seiten verwendet

Parameters:

Parameter	Typ	Beschreibung
images	Image[]	Die Bilder.

Returns

Typ	Beschreibung
Image	Das Bild als IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images)

Erstellt ein neues Bild, wobei die angegebenen Bilder als Seiten verwendet werden.

Parameters:

Parameter	Typ	Beschreibung
images	Image[]	Die Bilder.
dispose_images	bool	wenn auf true gesetzt [Bilder freigeben].

Returns

Typ	Beschreibung
Image	Das Bild als IMultipageImage

Method: crop(left_shift, right_shift, top_shift, bottom_shift)

 crop(left_shift, right_shift, top_shift, bottom_shift)

Bild mit Verschiebungen zuschneiden.

Parameters:

Parameter	Typ	Beschreibung
left_shift	int	Die linke Verschiebung.
right_shift	int	Die rechte Verschiebung.
top_shift	int	Die obere Verschiebung.
bottom_shift	int	Die untere Verschiebung.

Method: crop(rectangle)

 crop(rectangle)

Beschneiden Sie das Bild mithilfe eines angegebenen Rechteckbereichs. Dieser Vorgang entfernt den äußeren
Teil des Bildes und lässt nur den durch das Rechteck definierten ausgewählten Bereich übrig.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck.

See also:

Example # 1: The following example crops a GIF image. The cropping area is be specified vi…

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count)

Führt Dithering auf dem aktuellen Bild aus.

Parameters:

Parameter	Typ	Beschreibung
dithering_method	DitheringMethod	Die Dithering-Methode.
bits_count	int	Die endgültige Bitanzahl für das Dithern.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette)

Wenden Sie Dithering auf das aktuelle Bild an. Dieser Vorgang verbessert die Bildqualität, indem er
Farbbänderungen reduziert und Farbübergänge verbessert, was zu einem glatteren
Erscheinungsbild führt.

Parameters:

Parameter	Typ	Beschreibung
dithering_method	DitheringMethod	Die Dithering-Methode.
bits_count	int	Die endgültige Bitanzahl für das Dithern.
custom_palette	IColorPalette	Die benutzerdefinierte Palette für das Dithern.

Method: embed_digital_signature(password)

 embed_digital_signature(password)

Betten Sie eine digitale Signatur, basierend auf dem angegebenen Passwort, in jede Seite des Bildes ein.

Parameters:

Parameter	Typ	Beschreibung
Passwort	string	Das Passwort, das zum Erzeugen digitaler Signaturdaten verwendet wird

Method: filter(rectangle, options)

 filter(rectangle, options)

Wenden Sie einen bestimmten Filter auf den festgelegten Bereich des Bildes an, um dessen visuelle
Qualität zu verbessern oder das Aussehen nach Wunsch zu verändern. Diese Methode verarbeitet selektiv
Pixel innerhalb des definierten Rechtecks, sodass gezielte Anpassungen vorgenommen werden können
und gleichzeitig die Integrität der umgebenden Bilddaten erhalten bleibt.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck.
options	FilterOptionsBase	Die Optionen.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y)

Liefert ein 32‑Bit‑ARGB‑Pixel‑Bild.

Parameters:

Parameter	Typ	Beschreibung
x	int	Die x-Position des Pixels.
y	int	Die y-Position des Pixels.

Returns

Typ	Beschreibung
int	Das 32‑Bit‑ARGB‑Pixel für die angegebene Position.

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle)

Liefert das Standard‑32‑Bit‑ARGB‑Pixel‑Array.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, für das die Pixel abgerufen werden.

Returns

Typ	Beschreibung
int[]	Das Standard‑Pixel‑Array.

Method: get_default_options(args)

 get_default_options(args)

Liefert die Standardoptionen.

Parameters:

Parameter	Typ	Beschreibung
args	System.Object	Die Argumente.

Returns

Typ	Beschreibung
ImageOptionsBase	Standardoptionen

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader)

Liefert das Standard‑Pixel‑Array mittels teilweisem Pixel‑Lader.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, für das die Pixel abgerufen werden.
partial_pixel_loader	IPartialArgb32PixelLoader	Der partielle Pixel‑Lader.

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

Liefert das Standard‑Rohdaten‑Array mittels teilweisem Pixel‑Lader.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, für das die Pixel abgerufen werden.
partial_raw_data_loader	IPartialRawDataLoader	Der partielle Rohdaten‑Lader.
raw_data_settings	RawDataSettings	Die Rohdaten‑Einstellungen.

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings)

Liefert das Standard‑Rohdaten‑Array.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, für das Rohdaten abgerufen werden.
raw_data_settings	RawDataSettings	Die Rohdaten‑Einstellungen.

Returns

Typ	Beschreibung
System.Byte	Das Standard‑Rohdaten‑Array.

Method: get_file_format(file_path) [static]

 get_file_format(file_path)

Liefert das Dateiformat.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad.

Returns

Typ	Beschreibung
FileFormat	Das ermittelte Dateiformat.

Method: get_file_format(stream) [static]

 get_file_format(stream)

Liefert das Dateiformat.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream.

Returns

Typ	Beschreibung
FileFormat	Das ermittelte Dateiformat.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream)

Liefert das Dateiformat.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream.

Returns

Typ	Beschreibung
FileFormat	Das ermittelte Dateiformat.

Method: get_fitting_rectangle(rectangle, pixels, width, height) [static]

 get_fitting_rectangle(rectangle, pixels, width, height)

Liefert das Rechteck, das zum aktuellen Bild passt.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, für das ein passendes Rechteck ermittelt werden soll.
Pixel	int[]	Die 32‑Bit‑ARGB‑Pixel.
width	int	Die Objektbreite.
height	int	Die Objekthöhe.

Returns

Typ	Beschreibung
Rectangle	Das passende Rechteck oder eine Ausnahme, wenn kein passendes Rechteck gefunden werden kann.

Method: get_fitting_rectangle(rectangle, width, height) [static]

 get_fitting_rectangle(rectangle, width, height)

Liefert das Rechteck, das zum aktuellen Bild passt.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, für das ein passendes Rechteck ermittelt werden soll.
width	int	Die Objektbreite.
height	int	Die Objekthöhe.

Returns

Typ	Beschreibung
Rectangle	Das passende Rechteck oder eine Ausnahme, wenn kein passendes Rechteck gefunden werden kann.

Method: get_modify_date(use_default)

 get_modify_date(use_default)

Liefert Datum und Uhrzeit, zu der das Ressourcen‑Bild zuletzt geändert wurde.

Parameters:

Parameter	Typ	Beschreibung
use_default	bool	Wenn auf true gesetzt, verwendet die Information aus FileInfo als Standardwert.

Returns

Typ	Beschreibung
System.DateTime	Das Datum und die Uhrzeit, zu der das Ressourcenbild zuletzt geändert wurde.

Method: get_original_options()

 get_original_options()

Rufen Sie die auf den ursprünglichen Dateieinstellungen basierenden Optionen ab, die für die Aufrechterhaltung von Treue
und Konsistenz bei der Bildverarbeitung und -manipulation entscheidend sind. Diese Methode ermöglicht eine nahtlose
Integration dateispezifischer Parameter in nachfolgende Vorgänge, wodurch eine genaue Wiedergabe und die Einhaltung der inhärenten Eigenschaften des Bildes gewährleistet wird.
Dies kann hilfreich sein, um die Bit‑Tiefe 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 es anschließend mit der
DataStreamSupporter.save(file_path)‑Methode speichern, wird ein PNG‑Ausgabebild mit 8 Bit pro Pixel erzeugt.
Um dies zu vermeiden und ein PNG‑Bild mit 1‑Bit pro Pixel zu speichern, verwenden Sie diese Methode, um die entsprechenden Speicheroptionen zu erhalten und sie
an die Image.save(file_path, options)‑Methode als zweiten Parameter zu übergeben.

Returns

Typ	Beschreibung
ImageOptionsBase	Die Optionen basierend auf den ursprünglichen Dateieinstellungen.

Method: get_pixel(x, y)

 get_pixel(x, y)

Liefert ein Bild‑Pixel.

Parameters:

Parameter	Typ	Beschreibung
x	int	Die x-Position des Pixels.
y	int	Die y-Position des Pixels.

Returns

Typ	Beschreibung
Color	Die Pixel‑Farbe für die angegebene Position.

Method: get_proportional_height(width, height, new_width) [static]

 get_proportional_height(width, height, new_width)

Liefert eine proportionale Höhe.

Parameters:

Parameter	Typ	Beschreibung
width	int	Die Breite.
height	int	Die Höhe.
new_width	int	Die neue Breite.

Returns

Typ	Beschreibung
int	Die proportionale Höhe.

Method: get_proportional_width(width, height, new_height) [static]

 get_proportional_width(width, height, new_height)

Liefert eine proportionale Breite.

Parameters:

Parameter	Typ	Beschreibung
width	int	Die Breite.
height	int	Die Höhe.
new_height	int	Die neue Höhe.

Returns

Typ	Beschreibung
int	Die proportionale Breite.

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number)

Konvertiert zu aps.

Parameters:

Parameter	Typ	Beschreibung
image_options	ImageOptionsBase	Die Bildoptionen.
clipping_rectangle	Rectangle	Das Beschneidungsrechteck.
page_number	int[]	Die Seitenzahl.

Returns

Typ	Beschreibung
_io.BufferedRandom	Der serialisierte Stream

Method: get_skew_angle()

 get_skew_angle()

Liefert den Schrägungswinkel.
Diese Methode ist auf gescannte Textdokumente anwendbar, um den Schrägungswinkel beim Scannen zu bestimmen.

Returns

Typ	Beschreibung
float	Der Schrägwinkel in Grad.

Method: insert_block(index, block)

 insert_block(index, block)

Das Einfügen eines neuen GIF‑Blocks ermöglicht es Ihnen, benutzerdefinierte Daten an einer bestimmten Position
im Bild hinzuzufügen. Diese Methode erlaubt es, benutzerdefinierte Blöcke an einer gewünschten
Stelle im GIF‑Bild zu platzieren und bietet Flexibilität beim Organisieren und Strukturieren der
Bilddaten.

Parameters:

Parameter	Typ	Beschreibung
index	int	Das nullbasierte Element, an dem der Block eingefügt wird.
block	IGifBlock	Der hinzuzufügende GIF‑Block.

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold)

Führt eine schnelle Prüfung durch, um festzustellen, ob das Bild digital signiert ist, wobei das bereitgestellte Passwort und der Schwellenwert verwendet werden.

Parameters:

Parameter	Typ	Beschreibung
Passwort	string	Das Passwort zur Überprüfung der Signatur.
percentage_threshold	int	Der Schwellenwert (in Prozent)[0-100], der bestimmt, ob das Bild als signiert gilt. Wenn nicht angegeben, wird ein Standardschwellenwert (75) verwendet.

Returns

Typ	Beschreibung
bool	Wahr, wenn das Bild signiert ist, sonst falsch.

Method: load(file_path) [static]

 load(file_path)

Lädt ein neues Bild vom angegebenen Dateipfad oder URL.
Wenn filePath ein Dateipfad ist, öffnet die Methode einfach die Datei.
Wenn filePath eine URL ist, lädt die Methode die Datei herunter, speichert sie temporär und öffnet sie.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad oder die URL, von der das Bild geladen wird.

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load(file_path, load_options) [static]

 load(file_path, load_options)

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad oder die URL, von der das Bild geladen wird.
load_options	LoadOptions	Die Ladeoptionen.

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load(stream) [static]

 load(stream)

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, von dem das Bild geladen wird.

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load(stream, load_options) [static]

 load(stream, load_options)

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, von dem das Bild geladen wird.
load_options	LoadOptions	Die Ladeoptionen.

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle)

Lädt 32‑Bit‑ARGB‑Pixel.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, aus dem Pixel geladen werden.

Returns

Typ	Beschreibung
int[]	Das geladene 32‑Bit‑ARGB‑Pixel‑Array.

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle)

Lädt 64‑Bit‑ARGB‑Pixel.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, aus dem Pixel geladen werden.

Returns

Typ	Beschreibung
int[]	Das geladene 64-bit ARGB-Pixel-Array.

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle)

Lädt Pixel im CMYK‑Format.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, aus dem Pixel geladen werden.

Returns

Typ	Beschreibung
int[]	Das geladene CMYK-Pixel-Array wird als 32-bit Integer-Werte dargestellt.

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle)

Lädt Pixel im CMYK‑Format.
Diese Methode ist veraltet. Bitte verwenden Sie die effektivere Methode RasterImage.load_cmyk_32_pixels(rectangle).

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, aus dem Pixel geladen werden.

Returns

Typ	Beschreibung
CmykColor[]	Das geladene CMYK-Pixel-Array.

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

Lädt 32‑Bit‑ARGB‑Pixel teilweise (nach Blöcken).

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, aus dem Pixel geladen werden.
partial_pixel_loader	IPartialArgb32PixelLoader	Der partielle Pixel‑Lader.

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

Lädt 64‑Bit‑ARGB‑Pixel teilweise nach Paketen.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das gewünschte Rechteck.
partial_pixel_loader	IPartialArgb64PixelLoader	Der 64-bit ARGB-Pixel-Lader.

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader)

Lädt Pixel teilweise nach Paketen.

Parameters:

Parameter	Typ	Beschreibung
desired_rectangle	Rectangle	Das gewünschte Rechteck.
pixel_loader	IPartialPixelLoader	Der Pixel-Lader.

Method: load_pixels(rectangle)

 load_pixels(rectangle)

Lädt Pixel.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, aus dem Pixel geladen werden.

Returns

Typ	Beschreibung
Color[]	Das geladene Pixel-Array.

Method: load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)

Lädt Rohdaten.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, aus dem Rohdaten geladen werden.
dest_image_bounds	Rectangle	Die Ziel-Bildgrenzen.
raw_data_settings	RawDataSettings	Die Rohdaten-Einstellungen, die für geladene Daten verwendet werden. Hinweis: Wenn Daten nicht im angegebenen Format vorliegen, wird eine Datenkonvertierung durchgeführt.
raw_data_loader	IPartialRawDataLoader	Der Rohdaten-Lader.

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader)

Lädt Rohdaten.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, aus dem Rohdaten geladen werden.
raw_data_settings	RawDataSettings	Die Rohdaten-Einstellungen, die für geladene Daten verwendet werden. Hinweis: Wenn Daten nicht im angegebenen Format vorliegen, wird eine Datenkonvertierung durchgeführt.
raw_data_loader	IPartialRawDataLoader	Der Rohdaten-Lader.

Method: load_stream(stream) [static]

 load_stream(stream)

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, von dem das Bild geladen wird.

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options)

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, von dem das Bild geladen wird.
load_options	LoadOptions	Die Ladeoptionen.

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options)

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad oder die URL, von der das Bild geladen wird.
load_options	LoadOptions	Die Ladeoptionen.

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color)

Normalisiert den Winkel.
Diese Methode ist auf gescannte Textdokumente anwendbar, um die schiefe Aufnahme zu korrigieren.
Diese Methode verwendet die Methoden RasterImage.get_skew_angle() und RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color).

Parameters:

Parameter	Typ	Beschreibung
resize_proportionally	bool	Wenn auf true gesetzt, wird die Bildgröße gemäß den Projektionen des gedrehten Rechtecks (Eckpunkte) geändert; andernfalls bleiben die Abmessungen unverändert und nur der Bildinhalt wird rotiert.
background_color	Color	Farbe des Hintergrunds.

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index)

Liest die gesamte Scanzeile anhand des angegebenen Scanzeilen‑Index.

Parameters:

Parameter	Typ	Beschreibung
scan_line_index	int	Nullbasierter Index der Scan-Zeile.

Returns

Typ	Beschreibung
int[]	Das 32-bit ARGB-Farbwert-Array der Scan-Zeile.

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index)

Liest die gesamte Scanzeile anhand des angegebenen Scanzeilen‑Index.

Parameters:

Parameter	Typ	Beschreibung
scan_line_index	int	Nullbasierter Index der Scan-Zeile.

Returns

Typ	Beschreibung
Color[]	Das Pixel-Farbwert-Array der Scan-Zeile.

Method: remove_block(block)

 remove_block(block)

Das Entfernen eines GIF‑Blocks löscht bestimmte Daten aus dem Bild und bietet die Möglichkeit,
die Bildstruktur zu bereinigen oder zu verändern. Diese Methode ermöglicht das Entfernen unerwünschter
oder überflüssiger Blöcke, wodurch das GIF‑Bild effizienter gespeichert wird. Nutzen Sie diese
Funktion, um veraltete Informationen aus dem Bild zu eliminieren, während dessen Integrität und Qualität erhalten bleiben.

Parameters:

Parameter	Typ	Beschreibung
block	IGifBlock	Der Block zum Entfernen.

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb)

Ersetzt eine Farbe durch eine andere mit zulässiger Differenz und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.

Parameters:

Parameter	Typ	Beschreibung
old_color_argb	int	Alter ARGB-Farbwert, der ersetzt werden soll.
old_color_diff	System.Byte	Erlaubte Differenz im alten Farbwert, um den ersetzten Farbton zu erweitern.
new_color_argb	int	Neuer ARGB-Farbwert, um den alten Farbwert zu ersetzen.

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color)

Ersetzt eine Farbe durch eine andere mit zulässiger Differenz und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.

Parameters:

Parameter	Typ	Beschreibung
old_color	Color
old_color_diff	System.Byte	Erlaubte Differenz im alten Farbwert, um den ersetzten Farbton zu erweitern.
new_color	Color

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb)

Ersetzt eine Farbe durch eine andere mit zulässiger Differenz und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.

Parameters:

Parameter	Typ	Beschreibung
old_color_argb	int	Alter ARGB-Farbwert, der ersetzt werden soll.
old_color_diff	System.Byte	Erlaubte Differenz im alten Farbwert, um den ersetzten Farbton zu erweitern.
new_color_argb	int	Neuer ARGB-Farbwert, um den alten Farbwert zu ersetzen.

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color)

Ersetzt alle nicht‑transparenten Farben durch eine neue Farbe und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.
Hinweis: Wenn Sie dies bei Bildern ohne Transparenz verwenden, werden alle Farben durch eine einzige ersetzt.

Parameters:

Parameter	Typ	Beschreibung
new_color	Color

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb)

Parameters:

Parameter	Typ	Beschreibung
new_color_argb	int	Neuer ARGB-Farbwert, um nicht-transparente Farben zu ersetzen.

Method: resize(new_width, new_height)

 resize(new_width, new_height)

Skaliert das Bild. Der Standardwert ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.
new_height	int	Die neue Höhe.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type)

Skaliert diese Image Instanz.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.
new_height	int	Die neue Höhe.
resize_type	ResizeType	Der Skalierungstyp.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings)

Skaliert diese Image Instanz.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.
new_height	int	Die neue Höhe.
settings	ImageResizeSettings	Die Einstellungen.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings)

Skaliert das Bild.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.
new_height	int	Die neue Höhe.
settings	ImageResizeSettings	Die Skalierungseinstellungen.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type)

Skaliert das Bild.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.
new_height	int	Die neue Höhe.
resize_type	ResizeType	Der Skalierungstyp.

Method: resize_full_frame(new_width, new_height, resize_type)

 resize_full_frame(new_width, new_height, resize_type)

Die Größenänderung des Bildes berücksichtigt dabei die vollständigen Frames jeder Seite in einem
GIF, wodurch das Auftreten potenzieller Artefakte verhindert wird. Diese Methode ist wesentlich,
um die Integrität und Qualität des Bildes zu bewahren, insbesondere bei animierten GIFs oder Frame‑Sequenzen.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.
new_height	int	Die neue Höhe.
resize_type	ResizeType	Der Skalierungstyp.

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height)

Skaliert die Höhe proportional. Der Standard ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.

Parameters:

Parameter	Typ	Beschreibung
new_height	int	Die neue Höhe.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type)

Skaliert die Breite proportional.

Parameters:

Parameter	Typ	Beschreibung
new_height	int	Die neue Höhe.
resize_type	ResizeType	Typ der Skalierung.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings)

Skaliert die Höhe proportional.

Parameters:

Parameter	Typ	Beschreibung
new_height	int	Die neue Höhe.
settings	ImageResizeSettings	Die Bildskalierungseinstellungen.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings)

Skaliert die Höhe proportional.

Parameters:

Parameter	Typ	Beschreibung
new_height	int	Die neue Höhe.
settings	ImageResizeSettings	Die Bildskalierungseinstellungen.

Method: resize_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type)

Das proportionale Skalieren erhält das Seitenverhältnis des Bildes, während seine Größe angepasst wird, sodass das Bild nicht gestreckt oder verzerrt wirkt. Diese Methode
skaliert das Bild proportional, indem sowohl Breite als auch Höhe mit demselben Faktor verändert werden.
Die proportionale Größenänderung passt jeden Frame gemäß dem Verhältnis newWidth/width und newHeight/height an.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.
new_height	int	Die neue Höhe.
resize_type	ResizeType	Der Skalierungstyp.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width)

Skaliert die Breite proportional. Der Standard ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type)

Skaliert die Breite proportional.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.
resize_type	ResizeType	Typ der Skalierung.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings)

Skaliert die Breite proportional.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.
settings	ImageResizeSettings	Die Bildskalierungseinstellungen.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings)

Skaliert die Breite proportional.

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.
settings	ImageResizeSettings	Die Bildskalierungseinstellungen.

Method: rotate(angle)

 rotate(angle)

Bild um das Zentrum drehen.

Parameters:

Parameter	Typ	Beschreibung
angle	float	Der Rotationswinkel in Grad. Positive Werte drehen im Uhrzeigersinn.

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color)

Diese Methode rotiert das Bild um seinen Mittelpunkt. Durch Angabe des Rotations
Winkels können Sie das Bild im Uhrzeigersinn oder gegen den Uhrzeigersinn drehen, um die gewünschte
Ausrichtung zu erreichen. Diese Rotation hilft, die Darstellung oder
Ausrichtung des Bildes anzupassen, ohne dessen Inhalt zu verzerren.

Parameters:

Parameter	Typ	Beschreibung
angle	float	Der Rotationswinkel in Grad. Positive Werte drehen im Uhrzeigersinn.
resize_proportionally	bool	wenn auf true gesetzt, wird die Bildgröße geändert entsprechend den Projektionen des gedrehten Rechtecks (Eckpunkte) im anderen Fall bleiben die Abmessungen unverändert und nur internal Bildinhalte werden gedreht.
background_color	Color	Farbe des Hintergrunds.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type)

Führt Rotation, Spiegelung oder beides ausschließlich am aktiven Frame aus. Dieser Vorgang
wendet Transformationen nur auf den derzeit aktiven Frame des Bildes an,
wobei die Integrität der anderen Frames in der Sequenz erhalten bleibt.

Parameters:

Parameter	Typ	Beschreibung
rotate_flip_type	RotateFlipType	Der Rotations-Flip-Typ.

See also:

Example # 1: This example loads a GIF image, rotates it by 90 degrees clockwise and option…

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip)

Dreht das gesamte Flip.

Parameters:

Parameter	Typ	Beschreibung
rotate_flip	RotateFlipType	Der Rotations-Flip.

Method: save(file_path)

 save(file_path)

Speichert das Bild am angegebenen Dateipfad.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad, in dem das Bild gespeichert wird.

Method: save(file_path, options)

 save(file_path, options)

Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad.
options	ImageOptionsBase	Die Optionen.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle)

Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad.
options	ImageOptionsBase	Die Optionen.
bounds_rectangle	Rectangle	Das Zielrechteck der Bildgrenzen. Setzen Sie das leere Rechteck, um Quellgrenzen zu verwenden.

Method: save(file_path, over_write)

 save(file_path, over_write)

Speichert die Daten des Objekts am angegebenen Speicherort.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad, in dem die Objektdaten gespeichert werden.
over_write	bool	wenn auf true gesetzt, werden die Dateiinhalte überschrieben, andernfalls wird angehängt.

Method: save(stream)

 save(stream)

Speichert die Daten des Objekts in den angegebenen Stream.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, in dem die Daten des Objekts gespeichert werden sollen.

Method: save(stream, options_base)

 save(stream, options_base)

Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, in dem die Bilddaten gespeichert werden.
options_base	ImageOptionsBase	Die Speicheroptionen.

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle)

Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, in dem die Bilddaten gespeichert werden.
options_base	ImageOptionsBase	Die Speicheroptionen.
bounds_rectangle	Rectangle	Das Zielrechteck für die Bildgrenzen. Setzen Sie das leere Rechteck, um die Quellgrenzen zu verwenden.

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels)

Speichert die 32‑Bit‑ARGB‑Pixel.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, in dem Pixel gespeichert werden.
Pixel	int[]	Das 32‑Bit‑ARGB‑Pixel‑Array.

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels)

Speichert die Pixel.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, in dem Pixel gespeichert werden.
Pixel	int[]	Die CMYK‑Pixel, dargestellt als 32‑Bit‑Ganzzahlwerte.

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels)

Speichert die Pixel.
Diese Methode ist veraltet. Bitte verwenden Sie die effektivere RasterImage.save_cmyk_32_pixels(rectangle, pixels) Methode.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck, in dem Pixel gespeichert werden.
pixels	CmykColor[]	Das CMYK‑Pixel‑Array.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels)

Speichert die Pixel intern im Hauptspeicher.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck.
pixels	Color[]	Die Pixel.

Method: save_raw_data(data, data_offset, rectangle, raw_data_settings)

 save_raw_data(data, data_offset, rectangle, raw_data_settings)

Speichert die Rohdaten.

Parameters:

Parameter	Typ	Beschreibung
Daten	System.Byte	Die Rohdaten.
data_offset	int	Der Anfangs‑Rohdaten‑Offset.
rectangle	Rectangle	Das Rohdaten‑Rechteck.
raw_data_settings	RawDataSettings	Die Rohdaten, in denen sich die Daten befinden.

Method: save_to_stream(stream)

 save_to_stream(stream)

Speichert die Daten des Objekts in den angegebenen Stream.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, in dem die Daten des Objekts gespeichert werden sollen.

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base)

Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, in dem die Bilddaten gespeichert werden.
options_base	ImageOptionsBase	Die Speicheroptionen.

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream, in dem die Bilddaten gespeichert werden.
options_base	ImageOptionsBase	Die Speicheroptionen.
bounds_rectangle	Rectangle	Das Zielrechteck für die Bildgrenzen. Setzen Sie das leere Rechteck, um die Quellgrenzen zu verwenden.

Method: save_with_options(file_path, options)

 save_with_options(file_path, options)

Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad.
options	ImageOptionsBase	Die Optionen.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle)

Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad.
options	ImageOptionsBase	Die Optionen.
bounds_rectangle	Rectangle	Das Zielrechteck der Bildgrenzen. Setzen Sie das leere Rechteck, um Quellgrenzen zu verwenden.

Method: set_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color)

Setzt ein 32‑Bit‑ARGB‑Pixel des Bildes für die angegebene Position.

Parameters:

Parameter	Typ	Beschreibung
x	int	Die x-Position des Pixels.
y	int	Die y-Position des Pixels.
argb_32_color	int	Das 32‑Bit‑ARGB‑Pixel für die angegebene Position.

Method: set_frame_time(time)

 set_frame_time(time)

Passt die Dauer jedes Frames in Millisekunden an und sorgt für eine gleichmäßige Zeitsteuerung
über die gesamte Bildsequenz hinweg. Diese Methode legt die Anzeigedauer jedes Frames einheitlich fest,
wodurch eine präzise Kontrolle der Animationsgeschwindigkeit ermöglicht wird.
Das Ändern dieses Wertes setzt die Verzögerung für alle Frames zurück.

Parameters:

Parameter	Typ	Beschreibung
Zeit	int	Die Zeit der Bilddauer in Millisekunden.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors)

Setzt die Bildpalette.

Parameters:

Parameter	Typ	Beschreibung
palette	IColorPalette	Die zu setzende Palette.
update_colors	bool	Wenn auf true gesetzt, werden die Farben gemäß der neuen Palette aktualisiert; andernfalls bleiben die Farbindizes unverändert. Hinweis: Unveränderte Indizes können das Bild beim Laden zum Absturz bringen, wenn einige Indizes keinen entsprechenden Paletteneintrag haben.

Method: set_pixel(x, y, color)

 set_pixel(x, y, color)

Setzt ein Bildpixel für die angegebene Position.

Parameters:

Parameter	Typ	Beschreibung
x	int	Die x-Position des Pixels.
y	int	Die y-Position des Pixels.
color	Color	Die Pixel‑Farbe für die angegebene Position.

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y)

Setzt die Auflösung für dieses RasterImage.

Parameters:

Parameter	Typ	Beschreibung
dpi_x	float	Die horizontale Auflösung in Punkten pro Zoll des RasterImage.
dpi_y	float	Die vertikale Auflösung in Punkten pro Zoll des RasterImage.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata)

Versucht, eine metadata-Instanz zu setzen, falls diese Image‑Instanz unterstützt und eine IImageMetadataFormat‑Instanz implementiert.

Parameters:

Parameter	Typ	Beschreibung
metadata	IImageMetadataFormat	Die Metadaten.

Returns

Typ	Beschreibung
bool	Wahr, wenn metadata nicht null ist und die Instanz von IMetadataContainer unterstützt und/oder eine Instanz von IImageMetadataFormat implementiert; andernfalls falsch.

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels)

Schreibt die gesamte Scanzeile in den angegebenen Scanzeilen‑Index.

Parameters:

Parameter	Typ	Beschreibung
scan_line_index	int	Nullbasierter Index der Scan-Zeile.
argb_32_pixels	int[]	Das 32‑Bit‑ARGB‑Farben‑Array zum Schreiben.

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels)

Schreibt die gesamte Scanzeile in den angegebenen Scanzeilen‑Index.

Parameters:

Parameter	Typ	Beschreibung
scan_line_index	int	Nullbasierter Index der Scan-Zeile.
pixels	Color[]	Das Pixel‑Farben‑Array zum Schreiben.

Examples

This example shows how to create a GIF image and save it to a file.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color


# Erstelle einen GIF‑Frame‑Block von 100 × 100 px.
with GifFrameBlock(100, 100) as firstBlock:
	# Fülle den gesamten Block mit Rot.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	with GifImage(firstBlock) as gifImage:
		gifImage.save("output.gif")

This example shows how to create a GIF image with a custom palette and save it to a file.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color, ColorPaletteHelper


# Erstelle einen GIF‑Frame‑Block von 100 × 100 px.
with GifFrameBlock(100, 100) as firstBlock:
	# Fülle den gesamten Block mit Rot.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	# Verwende eine 4‑Bit‑Palette, um die Bildgröße zu reduzieren. Die Qualität kann schlechter werden.
	palette = ColorPaletteHelper.create_4_bit()

	with GifImage(firstBlock, palette) as gifImage:
		gifImage.save("output.gif")

The following example shows how to compose an animated GIF image from individual GIF blocks.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color

# Erstellen Sie ein GIF-Bild mit 100 × 100 px.
# Der erste Block ist standardmäßig vollständig schwarz.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		# Der erste Kreis ist rot
		brush1 = SolidBrush(Color.red)

		# Der zweite Kreis ist schwarz
		brush2 = SolidBrush(Color.black)

		# Erhöhen Sie schrittweise den Winkel der roten Bogenform.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush1, block.bounds, 0, angle)
			gifImage.add_block(block)
		
		# Erhöhen Sie schrittweise den Winkel des schwarzen Bogens und entfernen Sie den roten Bogen.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush2, block.bounds, 0, angle)
			gr.fill_pie(brush1, block.bounds, angle, 360 - angle)
			gifImage.add_block(block)

		gifImage.save("animated_radar.gif")

The following example shows how to remove all blocks from a GIF image.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 

# Erstellen Sie ein GIF-Bild mit 100 × 100 px.
# Der erste Block ist standardmäßig vollständig schwarz.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

		print("Clear all the blocks")
		gifImage.clear_blocks()

		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

# Die Ausgabe sieht folgendermaßen aus:
# Aktive Frame‑Größe: { Width = 100, Height = 100}
# Alle Blöcke löschen
# Aktiver Frame ist nicht festgelegt

This example loads a GIF image, rotates it by 90 degrees clockwise and optionally flips the image horizontally and(or) vertically.


from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image, RotateFlipType
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = "c:\\temp"
rotate_flip_types = [RotateFlipType.ROTATE_90_FLIP_NONE, RotateFlipType.ROTATE_90_FLIP_X, RotateFlipType.ROTATE_90_FLIP_XY, RotateFlipType.ROTATE_90_FLIP_Y]
for rotate_flip_type in rotate_flip_types:
	# Drehen, spiegeln und in die Ausgabedatei speichern.
	with aspycore.as_of(Image.load(join(dir_, "sample.gif")), GifImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(dir_, "sample." + rotate_flip_type + ".png"), PngOptions())

The following example crops a GIF image. The cropping area is be specified via aspose.imaging.Rectangle.

import aspose.pycore as aspycore
from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.gif import GifImage
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Beschneiden Sie das Bild. Der Beschneidungsbereich ist der rechteckige zentrale Bereich des Bildes.
	area = Rectangle(gif_image.width // 4, gif_image.height // 4, gif_image.width // 2,
					 gif_image.height // 2)
	gif_image.crop(area)
	# Speichern Sie das beschnittene Bild als PNG
	gif_image.save(join(dir_, "sample.Crop.png"), PngOptions())

The following example binarizes a GIF image with the predefined threshold. Binarized images contain only 2 colors - black and white.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	djvu_image = aspycore.as_of(image, GifImage)
	# Binarisieren Sie das Bild mit einem Schwellenwert von 127.
	# Wenn ein entsprechender Grauwert eines Pixels größer als 127 ist, wird ihm der Wert 255 zugewiesen, sonst 0.
	djvu_image.binarize_fixed(127)
	djvu_image.save(join(dir_, "sample.BinarizeFixed.png"), PngOptions())

The following example performs gamma-correction of a GIF image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp\\"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Setzen Sie den Gamma‑Koeffizienten für die Rot‑, Grün‑ und Blau‑Kanäle.
	gif_image.adjust_gamma(2.5)
	gif_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs gamma-correction of a GIF image applying different coefficients for color components.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Setzen Sie individuelle Gamma‑Koeffizienten für die Rot‑, Grün‑ und Blau‑Kanäle.
	gif_image.adjust_gamma(1.5, 2.5, 3.5)
	gif_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs brightness correction of a GIF image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Setzen Sie den Helligkeitswert. Die zulässigen Helligkeitswerte liegen im Bereich [-255, 255].
	gif_image.adjust_brightness(50)
	gif_image.save(join(dir_, "sample.AdjustBrightness.png"), PngOptions())

The following example performs contrast correction of a GIF image.



import aspose.pycore as aspycore

from aspose.imaging import Image

from aspose.imaging.fileformats.gif import GifImage

from aspose.imaging.imageoptions import PngOptions

from os.path import join



dir_ = "c:\\temp"

with Image.load(join(dir_, "sample.gif")) as image:

	gif_image = aspycore.as_of(image, GifImage)

	# Setzen Sie den Kontrastwert. Die zulässigen Kontrastwerte liegen im Bereich [-100f, 100f].

	gif_image.adjust_contrast(50.0)

	gif_image.save(join(dir_, "sample.AdjustContrast.png"), PngOptions())



# ExEnd

Create multipage GIF image using single page raster images.

from aspose.imaging import Image, RasterImage
from aspose.pycore import as_of
from os import listdir
from os.path import isfile, join

def load_frames(directory):
	for f in listdir(directory):
		full_path = join(directory, f)
		if isfile(full_path):
			yield as_of(Image.load(file_path), RasterImage)


# Frames laden
frames = list(load_frames("Animation frames"))
# Erstelle ein GIF‑Bild mit dem ersten Frame
with GifImage(GifFrameBlock(frames[0])) as image:
	# Füge Frames zum GIF‑Bild hinzu, indem du die Methode AddPage verwendest
	for index in range(1, len(frames)):
		image.add_page(frames[index])

	# GIF‑Bild speichern
	image.save("Multipage.gif")
	
for it in frames:
	with it as _:
		# Bilder freigeben
		pass

Export of part of animation from GIF image based on time interval.

from aspose.imaging import Image
from aspose.imaging.imageoptions import GifOptions, MultiPageOptions, MultiPageMode, TimeInterval

with Image.load("Animation.gif") as image:
	obj_init = MultiPageOptions()
	obj_init.mode = MultiPageMode.TIME_INTERVAL
	obj_init.time_interval = TimeInterval(0, 400)
	options = GifOptions()
	options.full_frame = True
	options.multi_page_options = obj_init
	image.save("PartOfAnimation.gif", options)

GifBlocksRegistry Klasse IGifBlock Klasse