PngImage‑Klasse

Summary: Manipulate Portable Network Graphics (PNG) raster images with our versatile API,
featuring support for compression levels and various color depths including
Grayscale, Indexed Color, TrueColor, and alpha channels. Seamlessly process XMP metadata,
enabling comprehensive image metadata management, while easily loading PNG images,
performing diverse manipulations, applying filters, and converting images to other file
formats for optimal versatility and customization.

Module: aspose.imaging.fileformats.png

Full Name: aspose.imaging.fileformats.png.PngImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, RasterCachedImage

Constructors

NameBeschreibung
PngImage(path)Konstruiert eine neue Instanz der PngImage‑Klasse unter Verwendung des Pfad
Parameters, um den Speicherort der zu ladenden Bilddatei anzugeben. Dieser Konstruktor
ermöglicht Entwicklern, PNG‑Bilder bequem zu erstellen, indem sie sie aus einer Datei laden,
und vereinfacht den Prozess der Arbeit mit PNG‑Bildern in ihren Anwendungen.
PngImage(path, color_type)Initialisiert eine neue Instanz der PngImage‑Klasse, indem der
Pfad zur Bilddatei und der Farbtyp angegeben werden. Dieser Konstruktor ermöglicht die bequeme
Erstellung von PNG‑Bildern aus Dateien mit unterschiedlichen Farbtypen und bietet
Flexibilität beim Umgang mit verschiedenen Bildformaten.
PngImage(png_options, width, height)Initialisiert eine neue Instanz der PngImage‑Klasse und integriert
PNG‑Optionen zusammen mit Breiten‑ und Höhenparametern. Dieser Konstruktor befähigt
Entwickler, PNG‑Bilder mit anpassbaren Einstellungen und Abmessungen zu erstellen,
und bietet Flexibilität bei der Bildgenerierung für verschiedene Anwendungsfälle.
PngImage(raster_image)Erstellt eine neue Instanz der PngImage‑Klasse, indem ein Raster‑
Bild als Parameter übergeben wird. Dieser Konstruktor ermöglicht Entwicklern, ein
PNG‑Bildobjekt direkt mit einem vorhandenen Rasterbild zu initialisieren und vereinfacht den
Prozess der Arbeit mit PNG‑Bildern in ihren Anwendungen.
PngImage(raster_image, color_type)Erstellt eine neue Instanz der PngImage‑Klasse, indem ein Raster‑
Bild und ein Farbtyp angegeben werden. Dieser Konstruktor ermöglicht Entwicklern, Rasterbilder direkt in das PNG‑Format zu konvertieren, wobei der gewünschte Farbtyp festgelegt wird, und bietet Flexibilität bei der Farbdarstellung.
PngImage(stream)Erstellt eine neue Instanz der PngImage‑Klasse, indem sie
mit einem Stream initialisiert wird. Dieser Konstruktor ermöglicht Entwicklern, PNG‑Bilder direkt
aus einem Stream zu laden und bietet Flexibilität beim Abrufen von Bildern aus verschiedenen Quellen.
PngImage(width, height)Initialisiert ein neues Objekt der PngImage‑Klasse, indem die
Breiten‑ und Höhenparameter bereitgestellt werden. Dieser Konstruktor vereinfacht die Erstellung von PNG‑
Bildern, indem er Entwicklern erlaubt, die Abmessungen direkt anzugeben, und erleichtert die effiziente Verwaltung von PNG‑Bilddaten in ihren Anwendungen.
PngImage(width, height, color_type)Instanziiert eine neue Instanz der PngImage‑Klasse, indem die gewünschten Breiten‑, Höhen‑ und Farbtyp‑Parameter angegeben werden. Dieser Konstruktor ermöglicht
die schnelle Erstellung von PNG‑Bildern mit maßgeschneiderten Abmessungen und Farbkombinationen,
und erleichtert die optimierte Bildgenerierung für verschiedene Anwendungen und Workflows.

Properties

NameTypeAccessBeschreibung
auto_adjust_paletteboolr/wLiest oder setzt einen Wert, der angibt, ob die automatische Anpassung der Palette erfolgt.
background_colorColorr/wRuft die Hintergrundfarbe des Bildes ab, falls angegeben. Diese Eigenschaft
ist nützlich für Anwendungen, die die Hintergrundfarbe eines Bildes identifizieren und ggf. manipulieren müssen.
bits_per_pixelintrRuft den Bits‑pro‑Pixel‑Wert des Bildes ab. Diese Eigenschaft liefert wichtige
Informationen zur Farbtiefe des Bildes und ermöglicht Entwicklern,
das Detail- und Farbgenauigkeitsniveau der Bilddaten zu verstehen.
boundsRectanglerLiest die Objektgrenzen.
buffer_size_hintintr/wLiest oder setzt den Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.
containerImagerLiest den Image Container.
data_stream_containerStreamContainerrLiest den Datenstrom des Objekts.
freigegebenboolrLiest einen Wert, der angibt, ob diese Instanz freigegeben ist.
exif_dataExifDatar/wLiest oder setzt die Exif‑Instanz.
file_formatFileFormatrRuft das Format der mit der Bildinstanz verknüpften Datei ab. Diese
Eigenschaft liefert wesentliche Informationen zum Dateityp und ermöglicht
eine effiziente Handhabung und Verarbeitung basierend auf den jeweiligen Formatvorgaben.
has_alphaboolrGibt einen booleschen Wert zurück, der angibt, ob das Bild einen Alpha‑Kanal besitzt,
der dessen Transparenz bestimmt. Diese Eigenschaft ist nützlich für Anwendungen,
die Transparenz verarbeiten müssen, und ermöglicht Entwicklern zu bestimmen, ob
zusätzliche Verarbeitung erforderlich ist, um transparente Bereiche im Bild zu handhaben.
has_background_colorboolr/wRuft einen booleschen Wert ab, der angibt, ob das Bild eine Hintergrundfarbe besitzt.
Diese Eigenschaft ist nützlich für Anwendungen, die feststellen müssen, ob ein Bild
eine Hintergrundfarbe enthält, was für verschiedene Verarbeitungsaufgaben wie
Komposition, Rendering oder Export wichtig sein kann.
has_transparent_colorboolr/wStellt einen booleschen Wert bereit, der angibt, ob das Bild eine transparente
Farbe enthält. Diese Eigenschaft ist entscheidend für Anwendungen, die Transparenz verarbeiten müssen, und ermöglicht Entwicklern zu bestimmen, ob zusätzliche Verarbeitung
erforderlich ist, um transparente Bereiche im Bild zu handhaben.
heightintrErmittelt die Höhe des Bildes. Diese Eigenschaft gibt die vertikale Dimension des
Bildes zurück und ermöglicht Entwicklern, seine Größe in Pixeln entlang der
Vertikalachse zu bestimmen.
horizontal_resolutionfloatr/wRuft die horizontale Auflösung des Bildes ab oder ändert sie. Diese Eigenschaft
gibt die Anzahl der Pixel pro Zoll entlang der Horizontalachse des
Bildes an. Das Anpassen dieser Auflösung kann die physische Größe des Bildes beim
Druck oder der Anzeige beeinflussen.
image_opacityfloatrLiest die Opazität dieses Bildes.
interlacedboolrRuft einen booleschen Wert ab, der angibt, ob die PngImage
interlaced ist, was bestimmt, ob die Bilddaten progressiv gespeichert werden,
um schnelleres Laden oder Übertragen zu ermöglichen.
interrupt_monitorInterruptMonitorr/wLiest oder setzt den Interrupt-Monitor.
is_cachedboolrLiest einen Wert, der angibt, ob Bilddaten derzeit zwischengespeichert sind.
is_interlacedboolrGibt einen booleschen Wert zurück, der angibt, ob die Bildinstanz interlaced ist. Diese
Eigenschaft ist entscheidend für die Optimierung von Ladestrategien und die Gewährleistung einer effizienten
Leistung während der Bildverarbeitung oder Anzeigeaufgaben.
is_raw_data_availableboolrLiest einen Wert, der angibt, ob das Laden von Rohdaten unterstützt wird.
metadataImageMetadatarGibt die Metadaten des Bildes zurück.
paletteIColorPaletter/wLiest oder setzt die Farbpalette. Die Farbpalette wird nicht verwendet, wenn Pixel direkt dargestellt werden.
premultiply_componentsboolr/wLiest oder setzt einen Wert, der angibt, ob die Bildkomponenten vormultipliziert werden müssen.
raw_custom_color_converterIColorConverterr/wLiest oder setzt den benutzerdefinierten Farbkonverter
raw_data_formatPixelDataFormatrGreift auf das Rohdatenformat des Bildes zu. Diese Eigenschaft liefert Einblick in
wie die Bilddaten intern strukturiert sind, was für fortgeschrittene
Bildverarbeitungsaufgaben oder Formatkonvertierung nützlich sein kann.
raw_data_settingsRawDataSettingsrLiest die aktuellen Rohdateneinstellungen. Hinweis: Beim Verwenden dieser Einstellungen werden die Daten ohne Konvertierung geladen.
raw_fallback_indexintr/wLiest oder setzt den Rückfallindex, der verwendet wird, wenn der Palettenindex außerhalb des gültigen Bereichs liegt
raw_indexed_color_converterIIndexedColorConverterr/wLiest oder setzt den indizierten Farbkonverter
raw_line_sizeintrLiest die Rohzeilengröße in Bytes.
sizeSizerLiest die Objektgröße.
transparent_colorColorr/wRuft die transparente Farbe des Bildes ab, falls vorhanden. Diese Eigenschaft ist
wertvoll für Anwendungen, die eine präzise Handhabung transparenter Bereiche
innerhalb von Bildern erfordern, und ermöglicht Entwicklern den Zugriff auf und die Manipulation der verwendeten
transparenten Farbe.
update_xmp_databoolr/wLiest oder setzt einen Wert, der angibt, ob die XMP-Metadaten aktualisiert werden sollen.
use_paletteboolrLiest einen Wert, der angibt, ob die Bildpalette verwendet wird.
use_raw_databoolr/wLiest oder setzt einen Wert, der angibt, ob das Laden von Rohdaten verwendet werden soll, wenn das Laden von Rohdaten verfügbar ist.
vertical_resolutionfloatr/wBietet Zugriff auf die vertikale Auflösung des Bildes. Entwickler können
diese Eigenschaft nutzen, um die Auflösungseinstellung abzurufen oder zu ändern, die die
Anzahl der Pixel pro Zoll (PPI) entlang der vertikalen Achse des Bildes angibt.
widthintrErmöglicht das Abrufen der Breite des Bildes und liefert wesentliche Informationen
über seine Abmessungen. Diese Eigenschaft wird von Entwicklern häufig verwendet, um
die Bildbreite zu bestimmen, sodass sie verschiedene Operationen basierend
auf seiner Größe ausführen können.
xmp_dataXmpPacketWrapperr/wLiest oder setzt XMP-Daten.

Methods

NameBeschreibung
adjust_brightness(brightness)Anpassung der Helligkeit für das Bild.
adjust_contrast(contrast)Bildkontrastierung
adjust_gamma(gamma)Gamma-Korrektur eines Bildes.
adjust_gamma(gamma_red, gamma_green, gamma_blue)Gamma-Korrektur eines Bildes.
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)Binarisierung eines Bildes mit Bradleys adaptivem Schwellenwertalgorithmus unter Verwendung der Integralbild-Schwellenwertbestimmung
binarize_bradley(brightness_difference, window_size)Binarisierung eines Bildes mit Bradleys adaptivem Schwellenwertalgorithmus unter Verwendung der Integralbild-Schwellenwertbestimmung
binarize_fixed(threshold)Binarisierung eines Bildes mit vordefiniertem Schwellenwert
binarize_otsu()Binarisierung eines Bildes mit Otsu-Schwellenwertbestimmung
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 und stellt sicher, dass keine zusätzlichen Datenladungen vom zugrunde liegenden DataStreamSupporter.data_stream_container durchgeführt werden.
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.
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_file_with_color_type(path, color_type)Initialisiert eine neue Instanz der Klasse PngImage.
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_image(raster_image)Initialisiert eine neue Instanz der Klasse PngImage.
create_from_image_with_color_type(raster_image, color_type)Initialisiert eine neue Instanz der Klasse PngImage.
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.
create_from_stream(stream)Initialisiert eine neue Instanz der Klasse PngImage.
create_with_width_height(width, height)Initialisiert eine neue Instanz der Klasse PngImage.
create_with_width_height_color_type(width, height, color_type)Initialisiert eine neue Instanz der Klasse PngImage.
create_with_width_height_options(png_options, width, height)Initialisiert eine neue Instanz der Klasse PngImage.
crop(left_shift, right_shift, top_shift, bottom_shift)Bild mit Verschiebungen zuschneiden.
crop(rectangle)Zuschneiden des Bildes.
dither(dithering_method, bits_count)Führt Dithering auf dem aktuellen Bild aus.
dither(dithering_method, bits_count, custom_palette)Führt Dithering auf dem aktuellen Bild aus.
embed_digital_signature(password)Digitales Siegel basierend auf dem bereitgestellten Passwort in das Bild einbetten mittels Steganographie.
filter(rectangle, options)Filtert das angegebene Rechteck.
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)Ruft den Zeitstempel ab, der die letzte Änderung der Ressourcen‑
Bildes angibt. Diese Methode bietet Zugriff auf wichtige Metadaten, sodass Anwendungen
feststellen können, wann das Bild zuletzt geändert wurde, was die Versionsverfolgung und
das Content‑Management erleichtert.
get_original_options()Liefert die Optionen basierend auf den ursprünglichen Dateieinstellungen.
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 übergeben Sie sie
an die Image.save(file_path, options)‑Methode als zweiten Parameter.
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()Transformation eines Bildes in seine Graustufen-Darstellung
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 verzerrte Aufnahme zu korrigieren.
Diese Methode verwendet die Methoden RasterImage.get_skew_angle() und RasterImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()Normalisiert das Bildhistogramm — passt die Pixelwerte an, um den gesamten verfügbaren Bereich zu nutzen.
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_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 es 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 es 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 das Bild.
resize(new_width, new_height, settings)Skaliert das Bild.
resize_by_settings(new_width, new_height, settings)Skaliert das Bild.
resize_by_type(new_width, new_height, resize_type)Skaliert das Bild.
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 Höhe 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_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)Bild um das Zentrum drehen.
rotate_flip(rotate_flip_type)Dreht, spiegelt oder dreht und spiegelt das Bild.
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)Die gespeicherten Daten.
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 Pixel (formatspezifische Methode).
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_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: PngImage(path)

 PngImage(path) 

Konstruiert eine neue Instanz der PngImage‑Klasse unter Verwendung des Pfad
Parameters, um den Speicherort der zu ladenden Bilddatei anzugeben. Dieser Konstruktor
ermöglicht Entwicklern, PNG‑Bilder bequem zu erstellen, indem sie sie aus einer Datei laden,
und vereinfacht den Prozess der Arbeit mit PNG‑Bildern in ihren Anwendungen.

Parameters:

ParameterTypBeschreibung
PfadstringDer Pfad zum Laden eines Bildes.

See also:

Example # 1: This example shows how to load a PNG image from a file.

Constructor: PngImage(path, color_type)

 PngImage(path, color_type) 

Initialisiert eine neue Instanz der PngImage‑Klasse, indem der
Pfad zur Bilddatei und der Farbtyp angegeben werden. Dieser Konstruktor ermöglicht die bequeme
Erstellung von PNG‑Bildern aus Dateien mit unterschiedlichen Farbtypen und bietet
Flexibilität beim Umgang mit verschiedenen Bildformaten.

Parameters:

ParameterTypBeschreibung
PfadstringDer Pfad zum Laden eines Bildes.
color_typePngColorTypeDer Farbtyp.

See also:

Example # 1: This example shows how to load a PNG image from a file with the specified col…

Constructor: PngImage(png_options, width, height)

 PngImage(png_options, width, height) 

Initialisiert eine neue Instanz der PngImage‑Klasse und integriert
PNG‑Optionen zusammen mit Breiten‑ und Höhenparametern. Dieser Konstruktor befähigt
Entwickler, PNG‑Bilder mit anpassbaren Einstellungen und Abmessungen zu erstellen,
und bietet Flexibilität bei der Bildgenerierung für verschiedene Anwendungsfälle.

Parameters:

ParameterTypBeschreibung
png_optionsPngOptionsDie PNG‑Optionen.
widthintDie Breite.
heightintDie Höhe.

Constructor: PngImage(raster_image)

 PngImage(raster_image) 

Erstellt eine neue Instanz der PngImage‑Klasse, indem ein Raster‑
Bild als Parameter übergeben wird. Dieser Konstruktor ermöglicht Entwicklern, ein
PNG‑Bildobjekt direkt mit einem vorhandenen Rasterbild zu initialisieren und vereinfacht den
Prozess der Arbeit mit PNG‑Bildern in ihren Anwendungen.

Parameters:

ParameterTypBeschreibung
raster_imageRasterImageDas Rasterbild.

See also:

Example # 1: This example shows how to load PNG image from a BMP image.

Constructor: PngImage(raster_image, color_type)

 PngImage(raster_image, color_type) 

Erstellt eine neue Instanz der PngImage‑Klasse, indem ein Raster‑
Bild und ein Farbtyp angegeben werden. Dieser Konstruktor ermöglicht Entwicklern, Rasterbilder direkt in das PNG‑Format zu konvertieren, wobei der gewünschte Farbtyp festgelegt wird, und bietet Flexibilität bei der Farbdarstellung.

Parameters:

ParameterTypBeschreibung
raster_imageRasterImageDas Rasterbild.
color_typePngColorTypeDer Farbtyp.

See also:

Example # 1: This example shows how to load PNG image from a BMP image with the specified …

Constructor: PngImage(stream)

 PngImage(stream) 

Erstellt eine neue Instanz der PngImage‑Klasse, indem sie
mit einem Stream initialisiert wird. Dieser Konstruktor ermöglicht Entwicklern, PNG‑Bilder direkt
aus einem Stream zu laden und bietet Flexibilität beim Abrufen von Bildern aus verschiedenen Quellen.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream zum Laden eines Bildes.

See also:

Example # 1: This example shows how to load a PNG image from a file or a file stream.

Constructor: PngImage(width, height)

 PngImage(width, height) 

Initialisiert ein neues Objekt der PngImage‑Klasse, indem die
Breiten‑ und Höhenparameter bereitgestellt werden. Dieser Konstruktor vereinfacht die Erstellung von PNG‑
Bildern, indem er Entwicklern erlaubt, die Abmessungen direkt anzugeben, und erleichtert die effiziente Verwaltung von PNG‑Bilddaten in ihren Anwendungen.

Parameters:

ParameterTypBeschreibung
widthintDie Breite.
heightintDie Höhe.

See also:

Example # 1: This example shows how to create a PNG image of the specified size, fill it w…

Constructor: PngImage(width, height, color_type)

 PngImage(width, height, color_type) 

Instanziiert eine neue Instanz der PngImage‑Klasse, indem die gewünschten Breiten‑, Höhen‑ und Farbtyp‑Parameter angegeben werden. Dieser Konstruktor ermöglicht
die schnelle Erstellung von PNG‑Bildern mit maßgeschneiderten Abmessungen und Farbkombinationen,
und erleichtert die optimierte Bildgenerierung für verschiedene Anwendungen und Workflows.

Parameters:

ParameterTypBeschreibung
widthintDie Breite.
heightintDie Höhe.
color_typePngColorTypeDer Farbtyp.

See also:

Example # 1: This example shows how to create a PNG image of the specified size with the s…

Property: has_alpha

Gibt einen booleschen Wert zurück, der angibt, ob das Bild einen Alpha‑Kanal besitzt,
der dessen Transparenz bestimmt. Diese Eigenschaft ist nützlich für Anwendungen,
die Transparenz verarbeiten müssen, und ermöglicht Entwicklern zu bestimmen, ob
zusätzliche Verarbeitung erforderlich ist, um transparente Bereiche im Bild zu handhaben.

See also:

Example # 1: The following example shows how to check if a PNG image supports alpha-channel.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Anpassung der Helligkeit für das Bild.

Parameters:

ParameterTypBeschreibung
HelligkeitintHelligkeitswert.

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Bildkontrastierung

Parameters:

ParameterTypBeschreibung
KontrastfloatKontrastwert (im Bereich [-100; 100])

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Gamma-Korrektur eines Bildes.

Parameters:

ParameterTypBeschreibung
GammafloatGamma‑Koeffizient für die Rot‑, Grün‑ und Blaukanäle

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

Gamma-Korrektur eines Bildes.

Parameters:

ParameterTypBeschreibung
gamma_redfloatGamma‑Koeffizient für den Rotkanal
gamma_greenfloatGamma‑Koeffizient für den Grünkanal
gamma_bluefloatGamma für den Blaukanal-Koeffizienten

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:

ParameterTypBeschreibung
PasswortstringDas Passwort, das zum Extrahieren der eingebetteten Daten verwendet wird.

Returns

TypBeschreibung
intDer prozentuale Ähnlichkeitswert.

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

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

Parameters:

ParameterTypBeschreibung
brightness_differencefloatDer 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:

ParameterTypBeschreibung
brightness_differencefloatDer Helligkeitsunterschied zwischen dem Pixel und dem Durchschnitt eines s × s-Fensters von Pixeln, das um dieses Pixel zentriert ist.
window_sizeintDie Größe des s x s Fensters von Pixeln, das um dieses Pixel zentriert ist.

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Binarisierung eines Bildes mit vordefiniertem Schwellenwert

Parameters:

ParameterTypBeschreibung
SchwellenwertSystem.ByteSchwellenwert. Wenn der entsprechende Grauwert eines Pixels größer als der Schwellenwert ist, wird ihm der Wert 255 zugewiesen, sonst 0.

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

Mischt diese Bildinstanz mit dem overlay-Bild.

Parameters:

ParameterTypBeschreibung
originPointDer Ursprung der Hintergrundbildüberblendung.
overlayRasterImageDas Overlay-Bild.
overlay_alphaSystem.ByteDer 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:

ParameterTypBeschreibung
originPointDer Ursprung der Hintergrundbildüberblendung.
overlayRasterImageDas Overlay-Bild.
overlay_areaRectangleDer Overlay‑Bereich.
overlay_alphaSystem.ByteDer Overlay‑Alpha.

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

ParameterTypBeschreibung
file_pathstringDer Dateipfad.

Returns

TypBeschreibung
booltrue 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:

ParameterTypBeschreibung
file_pathstringDer Dateipfad.
load_optionsLoadOptionsDie Ladeoptionen.

Returns

TypBeschreibung
booltrue 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:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, aus dem geladen werden soll.

Returns

TypBeschreibung
booltrue 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:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, aus dem geladen werden soll.
load_optionsLoadOptionsDie Ladeoptionen.

Returns

TypBeschreibung
booltrue 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:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, aus dem geladen werden soll.

Returns

TypBeschreibung
booltrue 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:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, aus dem geladen werden soll.
load_optionsLoadOptionsDie Ladeoptionen.

Returns

TypBeschreibung
booltrue 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:

ParameterTypBeschreibung
file_pathstringDer Dateipfad.
load_optionsLoadOptionsDie Ladeoptionen.

Returns

TypBeschreibung
booltrue 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:

ParameterTypBeschreibung
optionsImageOptionsBaseDie zu verwendenden Speicheroptionen.

Returns

TypBeschreibung
booltrue 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:

ParameterTypBeschreibung
Dateienstring[]Die Dateien.

Returns

TypBeschreibung
ImageDas 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:

ParameterTypBeschreibung
Dateienstring[]Die Dateien.
throw_exception_on_load_errorboolwenn auf true gesetzt [Ausnahme bei Ladefehler werfen].

Returns

TypBeschreibung
ImageDas mehrseitige Bild

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

 create(image_options, width, height) 

Erstellt ein neues Bild mit den angegebenen Erstellungsoptionen.

Parameters:

ParameterTypBeschreibung
image_optionsImageOptionsBaseDie Bildoptionen.
widthintDie Breite.
heightintDie Höhe.

Returns

TypBeschreibung
ImageDas 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:

ParameterTypBeschreibung
image_optionsImageOptionsBaseDie Optionen, die zum Erstellen des RasterImage verwendet werden.
widthintDie Breite des RasterImage.
heightintDie Höhe des RasterImage.
Pixelint[]Das Array von Pixelwerten, das zum Befüllen des Bildes verwendet wird.

Returns

TypBeschreibung
ImageEin 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:

ParameterTypBeschreibung
imagesImage[]Die Bilder.

Returns

TypBeschreibung
ImageDas 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:

ParameterTypBeschreibung
imagesImage[]Die Bilder.
dispose_imagesboolwenn auf true gesetzt [Bilder freigeben].

Returns

TypBeschreibung
ImageDas Bild als IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Erstellt die angegebenen Mehrseiten‑Erstellungsoptionen.

Parameters:

ParameterTypBeschreibung
multipage_create_optionsMultipageCreateOptionsDie Optionen zum Erstellen von mehrseitigen Bildern.

Returns

TypBeschreibung
ImageDas mehrseitige Bild

Method: create_from_file_with_color_type(path, color_type) [static]

 create_from_file_with_color_type(path, color_type) 

Initialisiert eine neue Instanz der Klasse PngImage.

Parameters:

ParameterTypBeschreibung
PfadstringDer Pfad zum Laden eines Bildes.
color_typePngColorTypeDer Farbtyp.

Returns

TypBeschreibung
PngImage

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:

ParameterTypBeschreibung
Dateienstring[]Die Dateien.

Returns

TypBeschreibung
ImageDas 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:

ParameterTypBeschreibung
Dateienstring[]Die Dateien.
throw_exception_on_load_errorboolwenn auf true gesetzt, Ausnahme bei Ladefehler werfen.

Returns

TypBeschreibung
ImageDas mehrseitige Bild

Method: create_from_image(raster_image) [static]

 create_from_image(raster_image) 

Initialisiert eine neue Instanz der Klasse PngImage.

Parameters:

ParameterTypBeschreibung
raster_imageRasterImageDas Rasterbild.

Returns

TypBeschreibung
PngImage

Method: create_from_image_with_color_type(raster_image, color_type) [static]

 create_from_image_with_color_type(raster_image, color_type) 

Initialisiert eine neue Instanz der Klasse PngImage.

Parameters:

ParameterTypBeschreibung
raster_imageRasterImageDas Rasterbild.
color_typePngColorTypeDer Farbtyp.

Returns

TypBeschreibung
PngImage

Method: create_from_images(images) [static]

 create_from_images(images) 

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

Parameters:

ParameterTypBeschreibung
imagesImage[]Die Bilder.

Returns

TypBeschreibung
ImageDas 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:

ParameterTypBeschreibung
imagesImage[]Die Bilder.
dispose_imagesboolwenn auf true gesetzt [Bilder freigeben].

Returns

TypBeschreibung
ImageDas Bild als IMultipageImage

Method: create_from_stream(stream) [static]

 create_from_stream(stream) 

Initialisiert eine neue Instanz der Klasse PngImage.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream zum Laden eines Bildes.

Returns

TypBeschreibung
PngImage

Method: create_with_width_height(width, height) [static]

 create_with_width_height(width, height) 

Initialisiert eine neue Instanz der Klasse PngImage.

Parameters:

ParameterTypBeschreibung
widthintDie Breite.
heightintDie Höhe.

Returns

TypBeschreibung
PngImage

Method: create_with_width_height_color_type(width, height, color_type) [static]

 create_with_width_height_color_type(width, height, color_type) 

Initialisiert eine neue Instanz der Klasse PngImage.

Parameters:

ParameterTypBeschreibung
widthintDie Breite.
heightintDie Höhe.
color_typePngColorTypeDer Farbtyp.

Returns

TypBeschreibung
PngImage

Method: create_with_width_height_options(png_options, width, height) [static]

 create_with_width_height_options(png_options, width, height) 

Initialisiert eine neue Instanz der Klasse PngImage.

Parameters:

ParameterTypBeschreibung
png_optionsPngOptionsDie PNG‑Optionen.
widthintDie Breite.
heightintDie Höhe.

Returns

TypBeschreibung
PngImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Bild mit Verschiebungen zuschneiden.

Parameters:

ParameterTypBeschreibung
left_shiftintDie linke Verschiebung.
right_shiftintDie rechte Verschiebung.
top_shiftintDie obere Verschiebung.
bottom_shiftintDie untere Verschiebung.

Method: crop(rectangle)

 crop(rectangle) 

Zuschneiden des Bildes.

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck.

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

Führt Dithering auf dem aktuellen Bild aus.

Parameters:

ParameterTypBeschreibung
dithering_methodDitheringMethodDie Dithering-Methode.
bits_countintDie endgültige Bitanzahl für das Dithern.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Führt Dithering auf dem aktuellen Bild aus.

Parameters:

ParameterTypBeschreibung
dithering_methodDitheringMethodDie Dithering-Methode.
bits_countintDie endgültige Bitanzahl für das Dithern.
custom_paletteIColorPaletteDie benutzerdefinierte Palette für das Dithern.

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

Digitales Siegel basierend auf dem bereitgestellten Passwort in das Bild einbetten mittels Steganographie.

Parameters:

ParameterTypBeschreibung
PasswortstringDas Passwort, das zum Erzeugen digitaler Signaturdaten verwendet wird

Method: filter(rectangle, options)

 filter(rectangle, options) 

Filtert das angegebene Rechteck.

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck.
optionsFilterOptionsBaseDie Optionen.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

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

Parameters:

ParameterTypBeschreibung
xintDie x-Position des Pixels.
yintDie y-Position des Pixels.

Returns

TypBeschreibung
intDas 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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, für das die Pixel abgerufen werden.

Returns

TypBeschreibung
int[]Das Standard‑Pixel‑Array.

Method: get_default_options(args)

 get_default_options(args) 

Liefert die Standardoptionen.

Parameters:

ParameterTypBeschreibung
argsSystem.ObjectDie Argumente.

Returns

TypBeschreibung
ImageOptionsBaseStandardoptionen

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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, für das die Pixel abgerufen werden.
partial_pixel_loaderIPartialArgb32PixelLoaderDer 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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, für das die Pixel abgerufen werden.
partial_raw_data_loaderIPartialRawDataLoaderDer partielle Rohdaten‑Lader.
raw_data_settingsRawDataSettingsDie 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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, für das Rohdaten abgerufen werden.
raw_data_settingsRawDataSettingsDie Rohdaten‑Einstellungen.

Returns

TypBeschreibung
System.ByteDas Standard‑Rohdaten‑Array.

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Liefert das Dateiformat.

Parameters:

ParameterTypBeschreibung
file_pathstringDer Dateipfad.

Returns

TypBeschreibung
FileFormatDas ermittelte Dateiformat.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Liefert das Dateiformat.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream.

Returns

TypBeschreibung
FileFormatDas ermittelte Dateiformat.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Liefert das Dateiformat.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream.

Returns

TypBeschreibung
FileFormatDas 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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, für das ein passendes Rechteck ermittelt werden soll.
Pixelint[]Die 32‑Bit‑ARGB‑Pixel.
widthintDie Objektbreite.
heightintDie Objekthöhe.

Returns

TypBeschreibung
RectangleDas 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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, für das ein passendes Rechteck ermittelt werden soll.
widthintDie Objektbreite.
heightintDie Objekthöhe.

Returns

TypBeschreibung
RectangleDas passende Rechteck oder eine Ausnahme, wenn kein passendes Rechteck gefunden werden kann.

Method: get_modify_date(use_default)

 get_modify_date(use_default) 

Ruft den Zeitstempel ab, der die letzte Änderung der Ressourcen‑
Bildes angibt. Diese Methode bietet Zugriff auf wichtige Metadaten, sodass Anwendungen
feststellen können, wann das Bild zuletzt geändert wurde, was die Versionsverfolgung und
das Content‑Management erleichtert.

Parameters:

ParameterTypBeschreibung
use_defaultboolWenn auf true gesetzt, verwendet die Information aus FileInfo als Standardwert.

Returns

TypBeschreibung
System.DateTimeDas Datum und die Uhrzeit, zu der das Ressourcenbild zuletzt geändert wurde.

Method: get_original_options()

 get_original_options() 

Liefert die Optionen basierend auf den ursprünglichen Dateieinstellungen.
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 übergeben Sie sie
an die Image.save(file_path, options)‑Methode als zweiten Parameter.

Returns

TypBeschreibung
ImageOptionsBaseDie Optionen basierend auf den ursprünglichen Dateieinstellungen.

Method: get_pixel(x, y)

 get_pixel(x, y) 

Liefert ein Bild‑Pixel.

Parameters:

ParameterTypBeschreibung
xintDie x-Position des Pixels.
yintDie y-Position des Pixels.

Returns

TypBeschreibung
ColorDie 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:

ParameterTypBeschreibung
widthintDie Breite.
heightintDie Höhe.
new_widthintDie neue Breite.

Returns

TypBeschreibung
intDie proportionale Höhe.

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

 get_proportional_width(width, height, new_height) 

Liefert eine proportionale Breite.

Parameters:

ParameterTypBeschreibung
widthintDie Breite.
heightintDie Höhe.
new_heightintDie neue Höhe.

Returns

TypBeschreibung
intDie 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:

ParameterTypBeschreibung
image_optionsImageOptionsBaseDie Bildoptionen.
clipping_rectangleRectangleDas Beschneidungsrechteck.
page_numberint[]Die Seitenzahl.

Returns

TypBeschreibung
_io.BufferedRandomDer 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

TypBeschreibung
floatDer Schrägwinkel in Grad.

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:

ParameterTypBeschreibung
PasswortstringDas Passwort zur Überprüfung der Signatur.
percentage_thresholdintDer Schwellenwert (in Prozent)[0-100], der bestimmt, ob das Bild als signiert gilt.
Wenn nicht angegeben, wird ein Standardschwellenwert (75) verwendet.

Returns

TypBeschreibung
boolWahr, 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:

ParameterTypBeschreibung
file_pathstringDer Dateipfad oder die URL, von der das Bild geladen wird.

Returns

TypBeschreibung
ImageDas geladene Bild.

Method: load(file_path, load_options) [static]

 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.

Parameters:

ParameterTypBeschreibung
file_pathstringDer Dateipfad oder die URL, von der das Bild geladen wird.
load_optionsLoadOptionsDie Ladeoptionen.

Returns

TypBeschreibung
ImageDas geladene Bild.

Method: load(stream) [static]

 load(stream) 

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, von dem das Bild geladen wird.

Returns

TypBeschreibung
ImageDas geladene Bild.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, von dem das Bild geladen wird.
load_optionsLoadOptionsDie Ladeoptionen.

Returns

TypBeschreibung
ImageDas geladene Bild.

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

Lädt 32‑Bit‑ARGB‑Pixel.

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, aus dem Pixel geladen werden.

Returns

TypBeschreibung
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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, aus dem Pixel geladen werden.

Returns

TypBeschreibung
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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, aus dem Pixel geladen werden.

Returns

TypBeschreibung
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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, aus dem Pixel geladen werden.

Returns

TypBeschreibung
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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, aus dem Pixel geladen werden.
partial_pixel_loaderIPartialArgb32PixelLoaderDer 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:

ParameterTypBeschreibung
rectangleRectangleDas gewünschte Rechteck.
partial_pixel_loaderIPartialArgb64PixelLoaderDer 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:

ParameterTypBeschreibung
desired_rectangleRectangleDas gewünschte Rechteck.
pixel_loaderIPartialPixelLoaderDer Pixel-Lader.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

Lädt Pixel.

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, aus dem Pixel geladen werden.

Returns

TypBeschreibung
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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, aus dem Rohdaten geladen werden.
dest_image_boundsRectangleDie Ziel-Bildgrenzen.
raw_data_settingsRawDataSettingsDie Rohdaten-Einstellungen, die für geladene Daten verwendet werden. Hinweis: Wenn Daten nicht im angegebenen Format vorliegen, wird eine Datenkonvertierung durchgeführt.
raw_data_loaderIPartialRawDataLoaderDer 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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, aus dem Rohdaten geladen werden.
raw_data_settingsRawDataSettingsDie Rohdaten-Einstellungen, die für geladene Daten verwendet werden. Hinweis: Wenn Daten nicht im angegebenen Format vorliegen, wird eine Datenkonvertierung durchgeführt.
raw_data_loaderIPartialRawDataLoaderDer Rohdaten-Lader.

Method: load_stream(stream) [static]

 load_stream(stream) 

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, von dem das Bild geladen wird.

Returns

TypBeschreibung
ImageDas 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:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, von dem das Bild geladen wird.
load_optionsLoadOptionsDie Ladeoptionen.

Returns

TypBeschreibung
ImageDas geladene Bild.

Method: load_with_options(file_path, load_options) [static]

 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.

Parameters:

ParameterTypBeschreibung
file_pathstringDer Dateipfad oder die URL, von der das Bild geladen wird.
load_optionsLoadOptionsDie Ladeoptionen.

Returns

TypBeschreibung
ImageDas 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 verzerrte Aufnahme zu korrigieren.
Diese Methode verwendet die Methoden RasterImage.get_skew_angle() und RasterImage.rotate(angle, resize_proportionally, background_color).

Parameters:

ParameterTypBeschreibung
resize_proportionallyboolWenn 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_colorColorFarbe 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:

ParameterTypBeschreibung
scan_line_indexintNullbasierter Index der Scan-Zeile.

Returns

TypBeschreibung
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:

ParameterTypBeschreibung
scan_line_indexintNullbasierter Index der Scan-Zeile.

Returns

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

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:

ParameterTypBeschreibung
old_color_argbintAlter ARGB-Farbwert, der ersetzt werden soll.
old_color_diffSystem.ByteErlaubte Differenz im alten Farbwert, um den ersetzten Farbton zu erweitern.
new_color_argbintNeuer 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:

ParameterTypBeschreibung
old_colorColorAlte Farbe, die ersetzt werden soll.
old_color_diffSystem.ByteErlaubte Differenz im alten Farbwert, um den ersetzten Farbton zu erweitern.
new_colorColorNeue Farbe, mit der die alte Farbe ersetzt wird.

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:

ParameterTypBeschreibung
old_color_argbintAlter ARGB-Farbwert, der ersetzt werden soll.
old_color_diffSystem.ByteErlaubte Differenz im alten Farbwert, um den ersetzten Farbton zu erweitern.
new_color_argbintNeuer 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 es bei Bildern ohne Transparenz verwenden, werden alle Farben durch eine einzige ersetzt.

Parameters:

ParameterTypBeschreibung
new_colorColorNeue Farbe, mit der nicht-transparente Farben ersetzt werden.

Method: replace_non_transparent_colors(new_color_argb)

 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 es bei Bildern ohne Transparenz verwenden, werden alle Farben durch eine einzige ersetzt.

Parameters:

ParameterTypBeschreibung
new_color_argbintNeuer 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:

ParameterTypBeschreibung
new_widthintDie neue Breite.
new_heightintDie neue Höhe.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Skaliert das Bild.

Parameters:

ParameterTypBeschreibung
new_widthintDie neue Breite.
new_heightintDie neue Höhe.
resize_typeResizeTypeDer Skalierungstyp.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Skaliert das Bild.

Parameters:

ParameterTypBeschreibung
new_widthintDie neue Breite.
new_heightintDie neue Höhe.
settingsImageResizeSettingsDie Skalierungseinstellungen.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Skaliert das Bild.

Parameters:

ParameterTypBeschreibung
new_widthintDie neue Breite.
new_heightintDie neue Höhe.
settingsImageResizeSettingsDie Skalierungseinstellungen.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

Skaliert das Bild.

Parameters:

ParameterTypBeschreibung
new_widthintDie neue Breite.
new_heightintDie neue Höhe.
resize_typeResizeTypeDer 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:

ParameterTypBeschreibung
new_heightintDie neue Höhe.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Skaliert die Höhe proportional.

Parameters:

ParameterTypBeschreibung
new_heightintDie neue Höhe.
resize_typeResizeTypeTyp der Skalierung.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Skaliert die Höhe proportional.

Parameters:

ParameterTypBeschreibung
new_heightintDie neue Höhe.
settingsImageResizeSettingsDie Bildskalierungseinstellungen.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

Skaliert die Höhe proportional.

Parameters:

ParameterTypBeschreibung
new_heightintDie neue Höhe.
settingsImageResizeSettingsDie Bildskalierungseinstellungen.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

ParameterTypBeschreibung
new_widthintDie neue Breite.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Skaliert die Breite proportional.

Parameters:

ParameterTypBeschreibung
new_widthintDie neue Breite.
resize_typeResizeTypeTyp der Skalierung.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Skaliert die Breite proportional.

Parameters:

ParameterTypBeschreibung
new_widthintDie neue Breite.
settingsImageResizeSettingsDie Bildskalierungseinstellungen.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

Skaliert die Breite proportional.

Parameters:

ParameterTypBeschreibung
new_widthintDie neue Breite.
settingsImageResizeSettingsDie Bildskalierungseinstellungen.

Method: rotate(angle)

 rotate(angle) 

Bild um das Zentrum drehen.

Parameters:

ParameterTypBeschreibung
anglefloatDer Rotationswinkel in Grad. Positive Werte drehen im Uhrzeigersinn.

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

Bild um das Zentrum drehen.

Parameters:

ParameterTypBeschreibung
anglefloatDer Rotationswinkel in Grad. Positive Werte drehen im Uhrzeigersinn.
resize_proportionallyboolWenn 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_colorColorFarbe des Hintergrunds.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Dreht, spiegelt oder dreht und spiegelt das Bild.

Parameters:

ParameterTypBeschreibung
rotate_flip_typeRotateFlipTypeDer Rotations-Flip-Typ.

Method: save(file_path)

 save(file_path) 

Speichert das Bild am angegebenen Dateipfad.

Parameters:

ParameterTypBeschreibung
file_pathstringDer 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:

ParameterTypBeschreibung
file_pathstringDer Dateipfad.
optionsImageOptionsBaseDie 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:

ParameterTypBeschreibung
file_pathstringDer Dateipfad.
optionsImageOptionsBaseDie Optionen.
bounds_rectangleRectangleDas 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:

ParameterTypBeschreibung
file_pathstringDer Dateipfad, in dem die Objektdaten gespeichert werden.
over_writeboolwenn auf true gesetzt, werden die Dateiinhalte überschrieben, andernfalls wird angehängt.

Method: save(stream)

 save(stream) 

Die gespeicherten Daten.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream.

Method: save(stream, options_base)

 save(stream, options_base) 

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

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, in dem die Bilddaten gespeichert werden.
options_baseImageOptionsBaseDie 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:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, in dem die Bilddaten gespeichert werden.
options_baseImageOptionsBaseDie Speicheroptionen.
bounds_rectangleRectangleDas 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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, in dem Pixel gespeichert werden.
Pixelint[]Das 32‑Bit‑ARGB‑Pixel‑Array.

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

Speichert die Pixel.

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, in dem Pixel gespeichert werden.
Pixelint[]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:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, in dem Pixel gespeichert werden.
pixelsCmykColor[]Das CMYK‑Pixel‑Array.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

Speichert Pixel (formatspezifische Methode).

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, in dem Pixel gespeichert werden.
pixelsColor[]Das 32‑Bit‑ARGB‑Pixel‑Array.

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:

ParameterTypBeschreibung
DatenSystem.ByteDie Rohdaten.
data_offsetintDer Anfangs‑Rohdaten‑Offset.
rectangleRectangleDas Rohdaten‑Rechteck.
raw_data_settingsRawDataSettingsDie 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:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer 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:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, in dem die Bilddaten gespeichert werden.
options_baseImageOptionsBaseDie 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:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, in dem die Bilddaten gespeichert werden.
options_baseImageOptionsBaseDie Speicheroptionen.
bounds_rectangleRectangleDas 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:

ParameterTypBeschreibung
file_pathstringDer Dateipfad.
optionsImageOptionsBaseDie 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:

ParameterTypBeschreibung
file_pathstringDer Dateipfad.
optionsImageOptionsBaseDie Optionen.
bounds_rectangleRectangleDas 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:

ParameterTypBeschreibung
xintDie x-Position des Pixels.
yintDie y-Position des Pixels.
argb_32_colorintDas 32‑Bit‑ARGB‑Pixel für die angegebene Position.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Setzt die Bildpalette.

Parameters:

ParameterTypBeschreibung
paletteIColorPaletteDie zu setzende Palette.
update_colorsboolWenn 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:

ParameterTypBeschreibung
xintDie x-Position des Pixels.
yintDie y-Position des Pixels.
colorColorDie 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:

ParameterTypBeschreibung
dpi_xfloatDie horizontale Auflösung in Punkten pro Zoll des RasterImage.
dpi_yfloatDie 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:

ParameterTypBeschreibung
metadataIImageMetadataFormatDie Metadaten.

Returns

TypBeschreibung
boolWahr, 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:

ParameterTypBeschreibung
scan_line_indexintNullbasierter Index der Scan-Zeile.
argb_32_pixelsint[]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:

ParameterTypBeschreibung
scan_line_indexintNullbasierter Index der Scan-Zeile.
pixelsColor[]Das Pixel‑Farben‑Array zum Schreiben.

Examples

This example shows how to load a PNG image from a file.


from aspose.pycore import as_of
from aspose.imaging import Image
from aspose.imaging.fileformats.png import PngImage

# Lade ein PNG‑Bild aus einer Datei.
with as_of(Image.load("sample.png"), PngImage) as pngImage:
	# Transformiere das Bild in eine Graustufen‑Darstellung
	pngImage.grayscale()
	# In einer Datei speichern.
	pngImage.save("sample.grayscale.png")

This example shows how to load a PNG image from a file with the specified color type.


import aspose.pycore as aspycore
from aspose.imaging.fileformats.png import PngImage, PngColorType
from os.path import join

dir_ = "c:\\temp"
# Lade ein PNG‑Bild aus einer Datei.
# Beachte, dass das farbige Bild automatisch in Graustufen konvertiert wird.
with PngImage(join(dir_, "sample.png"), PngColorType.GRAYSCALE) as png_image:
	# In einer Datei speichern.
	png_image.save(join(dir_, "sample.grayscale.png"))

This example shows how to load a PNG image from a file or a file stream.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.png import PngImage
from os.path import join


dir_: str = "c:\\temp"
# Lade ein PNG‑Bild aus einem Dateistream.
with open(join(dir_, "sample.png"), "rb") as stream:
	with PngImage(stream) as png_image:
		# Transformiere das Bild in eine Graustufen‑Darstellung
		png_image.grayscale()
		# In einer Datei speichern.
		png_image.save(join(dir_, "sample.grayscale.png"))

This example shows how to load PNG image from a BMP image.

from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.fileformats.png import PngImage
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
from os.path import join

dir_: str = "c:\\temp"
# Lade ein TrueColor‑PNG‑Bild aus einem BMP‑Bild.
# Erstelle zunächst ein temporäres BMP‑Bild, das die Grundlage für die Erstellung eines PNG‑Bildes bildet.
# Du kannst ein BMP‑Bild auch aus einer Datei laden oder ein Bild eines anderen Rasterformats verwenden.
with BmpImage(100, 100) as bmp_image:
	# Fülle das gesamte BMP‑Bild mit Rot.
	gr = Graphics(bmp_image)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, bmp_image.bounds)
	with PngImage(bmp_image) as png_image:
		png_image.save(join(dir_, "output.png"))

This example shows how to load PNG image from a BMP image with the specified color type.


from aspose.imaging import LoadOptions, Graphics, Color
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.fileformats.png import PngImage, PngColorType
from os.path import join as path_join


dir_ = "c:\\temp"
# Lade ein Graustufen‑PNG‑Bild aus einem farbigen BMP‑Bild.
# Erstelle zunächst ein temporäres BMP‑Bild, das die Grundlage für die Erstellung eines PNG‑Bildes bildet.
# Du kannst ein BMP‑Bild auch aus einer Datei laden oder ein Bild eines anderen Rasterformats verwenden.
with BmpImage(100, 100) as bmp_image:
	# Fülle das gesamte BMP‑Bild mit Rot.
	gr = Graphics(bmp_image)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, bmp_image.bounds)
	# Die Farben der Bildpixel werden in ihre Graustufen‑Entsprechungen konvertiert.
	with PngImage(bmp_image, PngColorType.GRAYSCALE) as png_image:
		png_image.save(path_join(dir_, "output.grayscale.png"))

This example shows how to create a PNG image of the specified size, fill it with a solid color and save it to a file.


import aspose.pycore as aspycore
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.fileformats.png import PngImage
from os.path import join


dir_ = "c:\\temp"
# Erstellen Sie ein PNG-Bild mit 100 × 100 px.
with PngImage(100, 100) as png_image:
	# Führen Sie einige Bildverarbeitungen durch, z. B. das gesamte Bild rot füllen.
	graphics = Graphics(png_image)
	brush = SolidBrush(Color.red)
	graphics.fill_rectangle(brush, png_image.bounds)
	# In einer Datei speichern.
	png_image.save(join(dir_, "output.png"))

This example shows how to create a PNG image of the specified size with the specified color type, fill it with a solid color and save it to a file.

from aspose.imaging.fileformats.png import PngImage, PngColorType
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
from os.path import join

dir_: str = "c:\\temp"
# Erstelle ein Graustufen‑PNG‑Bild mit 100 × 100 px.
# Alle Farben werden automatisch in das Graustufenformat konvertiert.
with PngImage(100, 100, PngColorType.GRAYSCALE) as png_image:
	# Führen Sie einige Bildverarbeitungen durch, z. B. das gesamte Bild rot füllen.
	graphics = Graphics(png_image)
	brush = SolidBrush(Color.red)
	graphics.fill_rectangle(brush, png_image.bounds)
	# In einer Datei speichern.
	png_image.save(join(dir_, "output.grayscale.png"))

The following example shows how to check if a PNG image supports alpha-channel.


from aspose.imaging import Image
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.png import PngColorType, PngImage


# Rufe alle unterstützten PNG‑Farbtypen ab.
color_types = [it for it in PngColorType]
for color_type in color_types:
	create_options = PngOptions()
	create_options.color_type = color_type
	with Image.create(create_options, 100, 100) as image:
		png_image = aspycore.as_of(image, PngImage)
		if png_image.has_alpha:
			print("A {0} PNG image supports alpha channel".format(create_options.color_type))
		else:
			print("A {0} PNG image doesn't support alpha channel".format(create_options.color_type))

# Die Ausgabe sieht folgendermaßen aus:
# Ein Graustufen‑PNG‑Bild unterstützt keinen Alpha‑Kanal
# Ein TrueColor‑PNG‑Bild unterstützt keinen Alpha‑Kanal
# Ein IndexedColor‑PNG‑Bild unterstützt keinen Alpha‑Kanal
# Ein GrayscaleWithAlpha PNG-Bild unterstützt den Alphakanal
# Ein TruecolorWithAlpha PNG-Bild unterstützt den Alphakanal

The example shows how to remove any object from the image using Graphics Path with Content Aware fill algorithm.

from aspose.imaging import Image, Figure, GraphicsPath, RectangleF
from aspose.imaging.shapes import EllipseShape
from aspose.imaging.watermark import WatermarkRemover
from aspose.imaging.watermark.options import ContentAwareFillWatermarkOptions
from aspose.imaging.fileformats.png import PngImage
import aspose.pycore import as_of

image_file_path = "ball.png"; 
with Image.load(image_file_path) as image:
	pngImage = as_of(image, PngImage)
	mask = GraphicsPath()
	firstFigure = Figure()
	firstFigure.add_shape(EllipseShape(RectangleF(350, 170, 570 - 350, 400 - 170)))
	mask.add_figure(firstFigure)

	options = ContentAwareFillWatermarkOptions(mask)
	options.max_painting_attempts = 4
	with WatermarkRemover.paint_over(pngImage, options) as result:
		result.save(outputPath)

The example shows how to remove any object from the image using Graphics Path with Telea algorithm.

from aspose.imaging import Image, Figure, GraphicsPath, RectangleF
from aspose.imaging.shapes import EllipseShape
from aspose.imaging.watermark import WatermarkRemover
from aspose.imaging.watermark.options import TeleaWatermarkOptions
from aspose.imaging.fileformats.png import PngImage
import aspose.pycore import as_of

image_file_path = "ball.png"; 
with Image.load(image_file_path) as image:
	pngImage = as_of(image, PngImage)
	mask = GraphicsPath()
	firstFigure = Figure()
	firstFigure.add_shape(EllipseShape(RectangleF(350, 170, 570 - 350, 400 - 170)))
	mask.add_figure(firstFigure);
	options = TeleaWatermarkOptions(mask)
	with WatermarkRemover.paint_over(pngImage, options) as result:
		result.save(outputPath)