BmpImage-Klasse

Summary: You can effortlessly handle Bitmap (BMP) and Device Independent Bitmap
(DIB) files, facilitating efficient manipulation and processing of raster
images. Performing various operations on images, this API streamlines the
workflow, offering developers a reliable toolkit for working with BMP and
DIB formats in their software applications.

Module: aspose.imaging.fileformats.bmp

Full Name: aspose.imaging.fileformats.bmp.BmpImage

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

Constructors

NameBeschreibung
BmpImage(path)Beginnen Sie, die BmpImage-Klasse mühelos zu verwenden, indem Sie diesen Konstruktor nutzen, der
eine neue Instanz initialisiert. Perfekt für Entwickler, die schnell loslegen und
mit BmpImage Objekte schnell und effizient arbeiten möchten.
BmpImage(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)Erstellen Sie mühelos eine neue Instanz der BmpImage Klasse mit diesem Konstruktor,
unter Verwendung der angegebenen Parameter wie Pfad, bitsPerPixel und Kompression. Ideal für Entwickler,
die BmpImage-Objekte schnell und effizient initialisieren möchten, mit präziser Kontrolle
über Bildeigenschaften.
BmpImage(raster_image)Erstellen Sie mühelos eine neue Instanz der BmpImage Klasse
indem Sie sie mit einem RasterImage-Objekt initialisieren. Perfekt für Entwickler, die
vorhandene Rasterbilder nahtlos in das BmpImage-Format konvertieren möchten, um
Kompatibilität und einfache Integration in ihre Projekte zu gewährleisten.
BmpImage(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)Beginnen Sie, mit der BmpImage Klasse nahtlos zu arbeiten, indem Sie eine neue Instanz
mit einem rasterImage und angegebenen Parametern wie bitsPerPixel und Kompression erstellen.
Perfekt für Entwickler, die eine unkomplizierte Methode zum Umgang mit BmpImage-Objekten suchen,
um Flexibilität und Effizienz in ihren Projekten zu gewährleisten.
BmpImage(stream)Beginnen Sie, die BmpImage Klasse mühelos zu verwenden, indem Sie eine neue Instanz
mit diesem Konstruktor initialisieren und einen Stream als Eingabe verwenden. Perfekt für Entwickler, die
eine bequeme Möglichkeit suchen, mit BmpImage-Objekten aus verschiedenen Datenquellen zu arbeiten,
um Flexibilität und einfache Integration zu gewährleisten.
BmpImage(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)Beginnen Sie, mit der BmpImage Klasse nahtlos zu arbeiten, indem Sie
eine neue Instanz mit einem Stream erstellen und dabei angegebene Parameter wie bitsPerPixel
und Kompression verwenden. Perfekt für Entwickler, die eine unkomplizierte Methode zum Umgang mit
BmpImage-Objekten suchen, um Flexibilität und Effizienz in ihren Projekten zu gewährleisten.
BmpImage(width, height)Beginnen Sie, die BmpImage Klasse mühelos zu verwenden, indem Sie eine neue Instanz
mit angegebenen Breiten- und Höhenparametern erstellen. Ideal für Entwickler, die
eine bequeme Möglichkeit suchen, BmpImage-Objekte mit benutzerdefinierten Abmessungen zu erzeugen, um
Flexibilität und einfache Integration in ihre Projekte zu gewährleisten.
BmpImage(width, height, bits_per_pixel, palette)Beginnen Sie, die BmpImage Klasse nahtlos zu verwenden, indem Sie eine neue Instanz
mit Parametern wie Breite, Höhe, Farbtiefe und Palette initialisieren. Perfekt für
Entwickler, die eine unkomplizierte Methode suchen, BmpImage-Objekte mit
benutzerdefinierten Abmessungen und Farbkonfigurationen zu erstellen, um Flexibilität und Effizienz in ihren Projekten zu gewährleisten.
BmpImage(width, height, bits_per_pixel, palette, compression, horizontal_resolution, vertical_resolution)Erstellen Sie mühelos eine neue Instanz der BmpImage Klasse mit diesem Konstruktor,
indem Sie Parameter wie Breite, Höhe, bitsPerPixel und Palette angeben. Perfekt für Entwickler,
die eine bequeme Möglichkeit suchen, BmpImage-Objekte mit benutzerdefinierten Abmessungen
und Farbkonfigurationen zu erzeugen, um Flexibilität und einfache Integration in ihre Projekte zu gewährleisten.

Properties

NameTypeAccessBeschreibung
auto_adjust_paletteboolr/wLiest oder setzt einen Wert, der angibt, ob die automatische Anpassung der Palette erfolgt.
background_colorColorr/wLiest oder setzt einen Wert für die Hintergrundfarbe.
bitmap_info_headerBitmapInfoHeaderrGreifen Sie schnell auf wesentliche Details Ihres Bitmap-Bildes zu mit dieser einfachen Funktion.
Perfekt für Entwickler, die Header-Informationen für ihre Bilder abrufen müssen.
bits_per_pixelintrGreifen Sie bequem auf die Anzahl der Bits pro Pixel des Bildes zu, indem Sie diese Eigenschaft verwenden.
Perfekt für Entwickler, die schnelle Informationen über Bildqualität und -tiefe benötigen.
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.
compressionBitmapCompressionrRufen Sie den für das Bild verwendeten Kompressionstyp mühelos mit dieser Eigenschaft ab.
Perfekt für Entwickler, die schnell Informationen über die Bildkompression benötigen.
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_formatFileFormatrRufen Sie den Dateiformatwert einfach mit dieser benutzerfreundlichen Eigenschaft ab.
Ideal für Entwickler, die schnellen Zugriff auf Informationen zum Dateiformat suchen.
has_alphaboolrGibt einen Wert zurück, der angibt, ob diese Instanz Alpha enthält.
has_background_colorboolr/wLiest oder setzt einen Wert, der angibt, ob das Bild eine Hintergrundfarbe hat.
has_transparent_colorboolr/wLiest oder setzt einen Wert, der angibt, ob diese RasterImage Instanz eine transparente Farbe hat.
heightintrRufen Sie die Höhe des Bildes mühelos mit dieser Eigenschaft ab. Ideal für Entwickler
die schnellen Zugriff auf Informationen zu Bildabmessungen benötigen.
horizontal_resolutionfloatr/wDiese Eigenschaft ermöglicht es Ihnen, die horizontale Auflösung,
gemessen in Pixel pro Zoll, des RasterImage Objekts einfach zu erhalten oder festzulegen. Ideal für
Entwickler, die eine präzise Kontrolle über die Bildauflösung für ihre Anwendungen benötigen.
image_opacityfloatrLiest die Opazität dieses Bildes.
interrupt_monitorInterruptMonitorr/wLiest oder setzt den Interrupt-Monitor.
is_cachedboolrLiest einen Wert, der angibt, ob Bilddaten derzeit zwischengespeichert sind.
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_formatPixelDataFormatrErhalten Sie das Format Ihrer Rohdaten einfach mit dieser benutzerfreundlichen Funktion.
Perfekt für Entwickler, die schnell auf wichtige Informationen über ihr Datenformat zugreifen möchten.
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_sizeintrGreifen Sie schnell auf die Größe jeder Rohzeile in Bytes mit dieser unkomplizierten Eigenschaft zu.
Ideal für Entwickler, die Rohbilddaten effizient verarbeiten müssen.
sizeSizerLiest die Objektgröße.
transparent_colorColorr/wLiest die transparente Bildfarbe.
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/wRufen Sie die vertikale Auflösung einfach ab oder setzen Sie sie, gemessen in Pixel pro Zoll, dieses RasterImage Objekt mit dieser Eigenschaft. Perfekt für Entwickler, die eine präzise Kontrolle über die Bildauflösung in ihren Anwendungen benötigen.
widthintrGreifen Sie einfach auf die Breite des Bildes mit dieser Eigenschaft zu. Ideal für Entwickler
die schnelle Informationen zu den Bildabmessungen suchen.
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_params(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)Beginnen Sie einfach mit der Verwendung der BmpImage-Klasse über diesen Konstruktor, der den Prozess der Initialisierung einer neuen Instanz vereinfacht
Ideal für Entwickler, die nach einer schnellen und effizienten Möglichkeit suchen, BmpImage Objekte in ihre Projekte zu integrieren.
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 BmpImage Klasse.
create_from_image_with_params(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)Initialisiert eine neue Instanz der BmpImage Klasse.
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 BmpImage Klasse.
create_from_stream_with_params(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)Initialisiert eine neue Instanz der BmpImage Klasse.
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)Rufen Sie die Standardoptionen mühelos mit dieser unkomplizierten Methode ab.
Ideal für Entwickler, die schnellen Zugriff auf Standard-Bildeinstellungen oder -Konfigurationen suchen.
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()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)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 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)Passen Sie die Auflösung Ihres RasterImage mühelos mit dieser
benutzerfreundlichen Methode an. Perfekt für Entwickler, die eine präzise Kontrolle über
die Bildauflösung in ihren Anwendungen suchen.
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: BmpImage(path)

 BmpImage(path) 

Beginnen Sie, die BmpImage-Klasse mühelos zu verwenden, indem Sie diesen Konstruktor nutzen, der
eine neue Instanz initialisiert. Perfekt für Entwickler, die schnell loslegen und
mit BmpImage Objekte schnell und effizient arbeiten möchten.

Parameters:

ParameterTypBeschreibung
PfadstringDer Pfad, von dem das Bild geladen und mit dem Pixel‑ und Palettendaten initialisiert werden soll.

See also:

Example # 1: The example shows how to load a BmpImage from a file.

Constructor: BmpImage(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)

 BmpImage(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) 

Erstellen Sie mühelos eine neue Instanz der BmpImage Klasse mit diesem Konstruktor,
unter Verwendung der angegebenen Parameter wie Pfad, bitsPerPixel und Kompression. Ideal für Entwickler,
die BmpImage-Objekte schnell und effizient initialisieren möchten, mit präziser Kontrolle
über Bildeigenschaften.

Parameters:

ParameterTypBeschreibung
PfadstringDer Pfad, von dem das Bild geladen und mit dem Pixel‑ und Palettendaten initialisiert werden soll.
bits_per_pixelintDie Bits pro Pixel.
compressionBitmapCompressionDie zu verwendende Kompression.
horizontal_resolutionfloatDie horizontale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.
vertical_resolutionfloatDie vertikale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.

See also:

Example # 1: The example shows how to load a BmpImage from a file with the specified bit d…

Constructor: BmpImage(raster_image)

 BmpImage(raster_image) 

Erstellen Sie mühelos eine neue Instanz der BmpImage Klasse
indem Sie sie mit einem RasterImage-Objekt initialisieren. Perfekt für Entwickler, die
vorhandene Rasterbilder nahtlos in das BmpImage-Format konvertieren möchten, um
Kompatibilität und einfache Integration in ihre Projekte zu gewährleisten.

Parameters:

ParameterTypBeschreibung
raster_imageRasterImageDas Bild, mit dem Pixel‑ und Palettendaten initialisiert werden sollen.

See also:

Example # 1: The example shows how to load a BmpImage from another instance of RasterImage.

Constructor: BmpImage(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)

 BmpImage(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) 

Beginnen Sie, mit der BmpImage Klasse nahtlos zu arbeiten, indem Sie eine neue Instanz
mit einem rasterImage und angegebenen Parametern wie bitsPerPixel und Kompression erstellen.
Perfekt für Entwickler, die eine unkomplizierte Methode zum Umgang mit BmpImage-Objekten suchen,
um Flexibilität und Effizienz in ihren Projekten zu gewährleisten.

Parameters:

ParameterTypBeschreibung
raster_imageRasterImageDas Bild, mit dem Pixel‑ und Palettendaten initialisiert werden sollen.
bits_per_pixelintDie Bits pro Pixel.
compressionBitmapCompressionDie zu verwendende Kompression.
horizontal_resolutionfloatDie horizontale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.
vertical_resolutionfloatDie vertikale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.

See also:

Example # 1: The example shows how to load a BmpImage from another instance of RasterImage…

Constructor: BmpImage(stream)

 BmpImage(stream) 

Beginnen Sie, die BmpImage Klasse mühelos zu verwenden, indem Sie eine neue Instanz
mit diesem Konstruktor initialisieren und einen Stream als Eingabe verwenden. Perfekt für Entwickler, die
eine bequeme Möglichkeit suchen, mit BmpImage-Objekten aus verschiedenen Datenquellen zu arbeiten,
um Flexibilität und einfache Integration zu gewährleisten.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, von dem das Bild geladen und mit dem Pixel‑ und Palettendaten initialisiert werden soll.

See also:

Example # 1: The example shows how to load a BmpImage from a file stream.

Constructor: BmpImage(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution)

 BmpImage(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) 

Beginnen Sie, mit der BmpImage Klasse nahtlos zu arbeiten, indem Sie
eine neue Instanz mit einem Stream erstellen und dabei angegebene Parameter wie bitsPerPixel
und Kompression verwenden. Perfekt für Entwickler, die eine unkomplizierte Methode zum Umgang mit
BmpImage-Objekten suchen, um Flexibilität und Effizienz in ihren Projekten zu gewährleisten.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, von dem das Bild geladen und mit dem Pixel‑ und Palettendaten initialisiert werden soll.
bits_per_pixelintDie Bits pro Pixel.
compressionBitmapCompressionDie zu verwendende Kompression.
horizontal_resolutionfloatDie horizontale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.
vertical_resolutionfloatDie vertikale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.

See also:

Example # 1: The example shows how to load a BmpImage from a file stream with the specifie…

Constructor: BmpImage(width, height)

 BmpImage(width, height) 

Beginnen Sie, die BmpImage Klasse mühelos zu verwenden, indem Sie eine neue Instanz
mit angegebenen Breiten- und Höhenparametern erstellen. Ideal für Entwickler, die
eine bequeme Möglichkeit suchen, BmpImage-Objekte mit benutzerdefinierten Abmessungen zu erzeugen, um
Flexibilität und einfache Integration in ihre Projekte zu gewährleisten.

Parameters:

ParameterTypBeschreibung
widthintDie Bildbreite.
heightintDie Bildhöhe.

See also:

Example # 1: The following example shows how to set a palette to a BMP image to reduce its…

Example # 2: The example shows how to create a BmpImage of the specified size.

Constructor: BmpImage(width, height, bits_per_pixel, palette)

 BmpImage(width, height, bits_per_pixel, palette) 

Beginnen Sie, die BmpImage Klasse nahtlos zu verwenden, indem Sie eine neue Instanz
mit Parametern wie Breite, Höhe, Farbtiefe und Palette initialisieren. Perfekt für
Entwickler, die eine unkomplizierte Methode suchen, BmpImage-Objekte mit
benutzerdefinierten Abmessungen und Farbkonfigurationen zu erstellen, um Flexibilität und Effizienz in ihren Projekten zu gewährleisten.

Parameters:

ParameterTypBeschreibung
widthintDie Bildbreite.
heightintDie Bildhöhe.
bits_per_pixelintDie Bits pro Pixel.
paletteIColorPaletteDie Farbpalette.

See also:

Example # 1: The example shows how to create a BmpImage of the specified size with the spe…

Constructor: BmpImage(width, height, bits_per_pixel, palette, compression, horizontal_resolution, vertical_resolution)

 BmpImage(width, height, bits_per_pixel, palette, compression, horizontal_resolution, vertical_resolution) 

Erstellen Sie mühelos eine neue Instanz der BmpImage Klasse mit diesem Konstruktor,
indem Sie Parameter wie Breite, Höhe, bitsPerPixel und Palette angeben. Perfekt für Entwickler,
die eine bequeme Möglichkeit suchen, BmpImage-Objekte mit benutzerdefinierten Abmessungen
und Farbkonfigurationen zu erzeugen, um Flexibilität und einfache Integration in ihre Projekte zu gewährleisten.

Parameters:

ParameterTypBeschreibung
widthintDie Bildbreite.
heightintDie Bildhöhe.
bits_per_pixelintDie Bits pro Pixel.
paletteIColorPaletteDie Farbpalette.
compressionBitmapCompressionDie zu verwendende Kompression.
horizontal_resolutionfloatDie horizontale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.
vertical_resolutionfloatDie vertikale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.

See also:

Example # 1: The example shows how to create a BmpImage using various options.

Property: bitmap_info_header

Greifen Sie schnell auf wesentliche Details Ihres Bitmap-Bildes zu mit dieser einfachen Funktion.
Perfekt für Entwickler, die Header-Informationen für ihre Bilder abrufen müssen.

See also:

Example # 1: The following example gets the information from the BMP header and prints it …

Property: bits_per_pixel

Greifen Sie bequem auf die Anzahl der Bits pro Pixel des Bildes zu, indem Sie diese Eigenschaft verwenden.
Perfekt für Entwickler, die schnelle Informationen über Bildqualität und -tiefe benötigen.

See also:

Example # 1: The following example gets the general information about the image including …

Example # 2: The following example shows how the bitmap compression affects the output ima…

Property: compression

Rufen Sie den für das Bild verwendeten Kompressionstyp mühelos mit dieser Eigenschaft ab.
Perfekt für Entwickler, die schnell Informationen über die Bildkompression benötigen.

See also:

Example # 1: The following example gets the general information about the image including …

Example # 2: The following example shows how the bitmap compression affects the output ima…

Property: file_format

Rufen Sie den Dateiformatwert einfach mit dieser benutzerfreundlichen Eigenschaft ab.
Ideal für Entwickler, die schnellen Zugriff auf Informationen zum Dateiformat suchen.

See also:

Example # 1: The following example shows how to extract information about raw data format …

Property: height

Rufen Sie die Höhe des Bildes mühelos mit dieser Eigenschaft ab. Ideal für Entwickler
die schnellen Zugriff auf Informationen zu Bildabmessungen benötigen.

See also:

Example # 1: The following example gets the general information about the image including …

Example # 2: The following example shows how the bitmap compression affects the output ima…

Property: horizontal_resolution

Diese Eigenschaft ermöglicht es Ihnen, die horizontale Auflösung,
gemessen in Pixel pro Zoll, des RasterImage Objekts einfach zu erhalten oder festzulegen. Ideal für
Entwickler, die eine präzise Kontrolle über die Bildauflösung für ihre Anwendungen benötigen.

See also:

Example # 1: The following example gets the general information about the image including …

Example # 2: The following example shows how to set horizontal/vertical resolution of a BM…

Property: raw_data_format

Erhalten Sie das Format Ihrer Rohdaten einfach mit dieser benutzerfreundlichen Funktion.
Perfekt für Entwickler, die schnell auf wichtige Informationen über ihr Datenformat zugreifen möchten.

See also:

Example # 1: The following example gets the general information about the image including …

Example # 2: The following example shows how to extract information about raw data format …

Property: raw_line_size

Greifen Sie schnell auf die Größe jeder Rohzeile in Bytes mit dieser unkomplizierten Eigenschaft zu.
Ideal für Entwickler, die Rohbilddaten effizient verarbeiten müssen.

See also:

Example # 1: The following example gets the general information about the image including …

Example # 2: The following example shows how the bitmap compression affects the output ima…

Property: vertical_resolution

Rufen Sie die vertikale Auflösung einfach ab oder setzen Sie sie, gemessen in Pixel pro Zoll, dieses RasterImage Objekt mit dieser Eigenschaft. Perfekt für Entwickler, die eine präzise Kontrolle über die Bildauflösung in ihren Anwendungen benötigen.

See also:

Example # 1: The following example gets the general information about the image including …

Example # 2: The following example shows how to set horizontal/vertical resolution of a BM…

Property: width

Greifen Sie einfach auf die Breite des Bildes mit dieser Eigenschaft zu. Ideal für Entwickler
die schnelle Informationen zu den Bildabmessungen suchen.

See also:

Example # 1: The following example gets the general information about the image including …

Example # 2: The following example shows how the bitmap compression affects the output ima…

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_params(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) [static]

 create_from_file_with_params(path, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) 

Beginnen Sie einfach mit der Verwendung der BmpImage-Klasse über diesen Konstruktor, der den Prozess der Initialisierung einer neuen Instanz vereinfacht
Ideal für Entwickler, die nach einer schnellen und effizienten Möglichkeit suchen, BmpImage Objekte in ihre Projekte zu integrieren.

Parameters:

ParameterTypBeschreibung
PfadstringDer Pfad, von dem das Bild geladen und mit dem Pixel‑ und Palettendaten initialisiert werden soll.
bits_per_pixelintDie Bits pro Pixel.
compressionBitmapCompressionDie zu verwendende Kompression.
horizontal_resolutionfloatDie horizontale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.
vertical_resolutionfloatDie vertikale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.

Returns

TypBeschreibung
BmpImage

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 BmpImage Klasse.

Parameters:

ParameterTypBeschreibung
raster_imageRasterImageDas Bild, mit dem Pixel‑ und Palettendaten initialisiert werden sollen.

Returns

TypBeschreibung
BmpImage

Method: create_from_image_with_params(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) [static]

 create_from_image_with_params(raster_image, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) 

Initialisiert eine neue Instanz der BmpImage Klasse.

Parameters:

ParameterTypBeschreibung
raster_imageRasterImageDas Bild, mit dem Pixel‑ und Palettendaten initialisiert werden sollen.
bits_per_pixelintDie Bits pro Pixel.
compressionBitmapCompressionDie zu verwendende Kompression.
horizontal_resolutionfloatDie horizontale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.
vertical_resolutionfloatDie vertikale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.

Returns

TypBeschreibung
BmpImage

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 BmpImage Klasse.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, von dem das Bild geladen und mit dem Pixel‑ und Palettendaten initialisiert werden soll.

Returns

TypBeschreibung
BmpImage

Method: create_from_stream_with_params(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) [static]

 create_from_stream_with_params(stream, bits_per_pixel, compression, horizontal_resolution, vertical_resolution) 

Initialisiert eine neue Instanz der BmpImage Klasse.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, von dem das Bild geladen und mit dem Pixel‑ und Palettendaten initialisiert werden soll.
bits_per_pixelintDie Bits pro Pixel.
compressionBitmapCompressionDie zu verwendende Kompression.
horizontal_resolutionfloatDie horizontale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.
vertical_resolutionfloatDie vertikale Auflösung. Hinweis: Aufgrund der Rundung kann die resultierende Auflösung leicht von der übergebenen abweichen.

Returns

TypBeschreibung
BmpImage

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) 

Rufen Sie die Standardoptionen mühelos mit dieser unkomplizierten Methode ab.
Ideal für Entwickler, die schnellen Zugriff auf Standard-Bildeinstellungen oder -Konfigurationen suchen.

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) 

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

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) 

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(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) 

Passen Sie die Auflösung Ihres RasterImage mühelos mit dieser
benutzerfreundlichen Methode an. Perfekt für Entwickler, die eine präzise Kontrolle über
die Bildauflösung in ihren Anwendungen suchen.

Parameters:

ParameterTypBeschreibung
dpi_xfloatDie horizontale Auflösung in Punkten pro Zoll des RasterImage.
dpi_yfloatDie vertikale Auflösung in Punkten pro Zoll des RasterImage.

See also:

Example # 1: The following example gets the general information about the image including …

Example # 2: The following example shows how to set horizontal/vertical resolution of a BM…

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

The following example shows how to create a BMP image of the specified size.

from aspose.imaging import Color
from aspose.imaging.fileformats.bmp import BmpImage
from os.path import join as path_join

directory = "c:\\temp\\"

# Erstelle ein BMP‑Bild mit 100 x 100 px.
with BmpImage(100, 100) as bmpImage:
	# Füllen Sie das Bild mit einem einfachen linearen Rot-Schwarz-Verlauf.
	width = bmpImage.width
	height = bmpImage.height
	for y in range(height):
		for x in range(width):
			hue = (255 * x) // width
			bmpImage.set_pixel(x, y, Color.from_argb(255, hue, 0, 0))

	with open(path_join(directory, "output.bmp"), "w+b") as stream:
		bmpImage.save(stream)

The following example gets the general information about the image including pixel format, image size, resolution, compression etc.


from aspose.pycore import as_of
from aspose.imaging import Image
from aspose.imaging.fileformats.bmp import BmpImage
from os.path import join as path_join


with Image.load(r"c:\temp\sample.bmp") as image:
	bmpImage = as_of(image, BmpImage)    

	print("The pixel format:", bmpImage.raw_data_format)
	print("The raw line size in bytes:", bmpImage.raw_line_size)
	print("The bitmap compression:", bmpImage.compression)
	print("The bitmap width", bmpImage.width)
	print("The bitmap height", bmpImage.height)
	print("The number of bits per pixel", bmpImage.bits_per_pixel)

	hres = bmpImage.horizontal_resolution
	vres = bmpImage.vertical_resolution
	print("The horizontal resolution, in pixels per inch:", hres)
	print("The vertical resolution, in pixels per inch:", vres)

	if hres != 96.0 or vres != 96.0:
		# Sie können in Erwägung ziehen, die SetResolution-Methode zu verwenden, um beide Auflösungswerte in einem einzigen Aufruf zu aktualisieren.
		print("Set resolution values to 96 dpi")
		bmpImage.set_resolution(96.0, 96.0)
		print("The horizontal resolution, in pixels per inch: {0}", bmpImage.horizontal_resolution);
		print("The vertical resolution, in pixels per inch: {0}", bmpImage.vertical_resolution);

	#Die Ausgabe könnte folgendermaßen aussehen:
	#Das Pixel-Format: Rgb24Bpp, verwendete Kanäle: 8,8,8
	#Die Rohzeilengröße in Bytes: 1500
	#Die Bitmap-Kompression: Rgb
	#Die Bitmap-Breite: 500
	#Die Bitmap-Höhe: 375
	#Die Anzahl der Bits pro Pixel: 24
	#Die horizontale Auflösung, in Pixel pro Zoll: 0
	#Die vertikale Auflösung, in Pixel pro Zoll: 0
	#Setze Auflösungswerte auf 96 dpi
	#Die horizontale Auflösung, in Pixel pro Zoll: 96.012
	#Die vertikale Auflösung, in Pixel pro Zoll: 96.012

The following example shows how to set a palette to a BMP image to reduce its output size.


from aspose.pycore import as_of
from aspose.imaging import Point, Color, Graphics, ColorPaletteHelper
from aspose.imaging.brushes import LinearGradientBrush
from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.imageoptions import BmpOptions
from os.path import join as path_join

# Erstelle ein BMP‑Bild mit 100 x 100 px.
with BmpImage(100, 100) as bmpImage:
	# Der lineare Farbverlauf von der linken oberen zur rechten unteren Ecke des Bildes.
	brush = LinearGradientBrush(Point(0, 0), Point(bmpImage.width, bmpImage.height),
								Color.red,
								Color.green)
	# Fülle das gesamte Bild mit dem linearen Farbverlaufs‑Pinsel.
	gr = Graphics(bmpImage)
	gr.fill_rectangle(brush, bmpImage.bounds)
	# Erhalte die nächstgelegene 8‑Bit-Farbpalette, die so viele Pixel wie möglich abdeckt, sodass ein palettiertes Bild
	# fast visuell nicht von einem BMP ohne Palette zu unterscheiden ist.
	palette = ColorPaletteHelper.get_close_image_palette(bmpImage, 256)
	# Eine 8‑Bit-Palette enthält höchstens 256 Farben.
	saveOptions = BmpOptions()
	saveOptions.palette = palette
	saveOptions.bits_per_pixel = 8
	
	with stream_ext.create_memory_stream() as stream:
		bmpImage.save(stream, saveOptions)
		print(f"The size of image with palette is {stream.tell()} bytes.")
		stream.seek(0)
		bmpImage.save(stream)
		print(f"The size of image without palette is {stream.tell()} bytes.")

# Die Ausgabe sieht folgendermaßen aus:
# Die Größe des Bildes mit Palette beträgt 11078 Byte.
# Die Größe des Bildes ohne Palette beträgt 40054 Byte.

The example shows how to load a BmpImage from a file.

from aspose.imaging.fileformats.bmp import BmpImage
import os

directory = r"c:\temp"

# Lade ein BMP-Bild aus einer Datei.
# Die Quellpixel werden bei Bedarf in das 32‑bpp-Format konvertiert.
with BmpImage(os.path.join(directory, "sample.bmp")) as bmp_image:
	# Führen Sie einige Bildverarbeitungen durch.
	# Speichere in eine andere BMP-Datei.
	bmp_image.save(os.path.join(directory, "sample.output.32bpp.bmp"))

The example shows how to load a BmpImage from a file with the specified bit depth and resolution.

from aspose.imaging.fileformats.bmp import BmpImage, BitmapCompression
import os

directory = r"c:\temp"

# Lade ein BMP-Bild aus einer Datei.
# Die Quellpixel werden bei Bedarf in das 24‑bpp-Format konvertiert.
# Die Auflösung wird auf 96 dpi gesetzt.
with BmpImage(os.path.join(directory, "sample.bmp"), 24, BitmapCompression.RGB, 96.0, 96.0) as bmp_image:
	# Führen Sie einige Bildverarbeitungen durch.
	# Speichere in eine andere BMP-Datei.
	bmp_image.save(os.path.join(directory, "sample.output.24bpp.96dpi.bmp"))

The example shows how to load a BmpImage from a file stream.

from aspose.imaging.fileformats.bmp import BmpImage
import os

directory = r"c:\temp"

# Lade ein BMP-Bild aus einem Dateistream.
# Die Quellpixel werden bei Bedarf in das 32‑bpp-Format konvertiert.
with open(os.path.join(directory, "sample.bmp"), "rb+") as stream:
	with BmpImage(stream) as bmp_image:
		# Führen Sie einige Bildverarbeitungen durch.
		# Speichere in eine andere BMP-Datei.
		bmp_image.save(os.path.join(directory, "sample.output.32bpp.bmp"))

The example shows how to load a BmpImage from a file stream with the specified bit depth and resolution.

from aspose.imaging.fileformats.bmp import BmpImage, BitmapCompression
import os

directory = r"c:\temp"

# Lade ein BMP-Bild aus einem Dateistream.
# Die Quellpixel werden bei Bedarf in das 24‑bpp-Format konvertiert.
# Die Auflösung wird auf 96 dpi gesetzt.
with open(os.path.join(directory, "sample.bmp"), "rb") as stream:
	with BmpImage(stream, 24, BitmapCompression.RGB, 96.0, 96.0) as bmp_image:
		# Führen Sie einige Bildverarbeitungen durch.
		# Speichere in eine andere BMP-Datei.
		bmp_image.save(os.path.join(directory, "sample.output.24bpp.96dpi.bmp"))

The example shows how to load a BmpImage from another instance of RasterImage.

from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.sources import StreamSource
from aspose.imaging import Image, RasterImage, Graphics, Color
from aspose.imaging.brushes import SolidBrush
import os
import aspose.pycore as aspycore

directory = r"c:\temp"

# Erstelle ein neues PNG-Bild.
with PngOptions() as create_options:
	create_options.source = StreamSource()
	with aspycore.as_of(Image.create(create_options, 100, 100), RasterImage) as raster_image:
		# Füllen Sie das gesamte PNG-Bild mit Rot.
		gr = Graphics(raster_image)
		brush = SolidBrush(Color.red)
		gr.fill_rectangle(brush, raster_image.bounds)

		# Erstelle ein BMP-Bild basierend auf dem PNG-Bild.
		# Die Quellpixel werden bei Bedarf in das 32‑bpp-Format konvertiert.
		with BmpImage(raster_image) as bmp_image:
			# In BMP-Datei speichern
			bmp_image.save(os.path.join(directory, "output.32bpp.bmp"))

The example shows how to load a BmpImage from another instance of RasterImage with the specified bit depth and compression.


from aspose.imaging.fileformats.bmp import BmpImage, BitmapCompression
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.sources import StreamSource
from aspose.imaging import Image, RasterImage, Graphics, Color
from aspose.imaging.brushes import SolidBrush
import os
import aspose.pycore as aspycore

directory = r"c:\temp"

# Erstelle ein neues PNG-Bild.
with PngOptions() as create_options:
	create_options.source = StreamSource()
	with aspycore.as_of(Image.create(create_options, 100, 100), RasterImage) as raster_image:
		# Füllen Sie das gesamte PNG-Bild mit Rot.
		gr = Graphics(raster_image)
		brush = SolidBrush(Color.red)
		gr.fill_rectangle(brush, raster_image.bounds)

		# Erstelle ein BMP-Bild basierend auf dem PNG-Bild.
		# Die Quellpixel werden bei Bedarf in das 24‑bpp-Format konvertiert.
		# Die Auflösung wird auf 96 dpi gesetzt.
		with BmpImage(raster_image, 24, BitmapCompression.RGB, 96.0, 96.0) as bmp_image:
			# In BMP-Datei speichern
			bmp_image.save(os.path.join(directory, "output.24bpp.96dpi.bmp"))

The example shows how to create a BmpImage of the specified size.

from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging import Graphics, Color
from aspose.imaging.brushes import SolidBrush
import os

directory = r"c:\temp"

# Erstellen Sie ein 32‑bpp BMP‑Bild mit 100 × 100 px.
with BmpImage(100, 100) as bmp_image:
	# Füllen Sie das gesamte Bild mit Rot.
	Graphics gr = Graphics(bmp_image)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, bmp_image.bounds)
	# In BMP-Datei speichern
	bmp_image.save(os.path.join(directory, "output.bmp"))

The example shows how to create a BmpImage of the specified size with the specified palette.

from aspose.imaging.fileformats.bmp import BmpImage
from aspose.imaging import Graphics, Color, ColorPalette, Rectangle
from aspose.imaging.brushes import SolidBrush
import os

directory = r"c:\temp"

paletterColors = [Color.red, Color.green]

# Erstelle eine monochrome Palette, die nur rote und grüne Farben enthält.
palette = ColorPalette.create_with_colors(paletterColors)

# Erstelle ein monochromes 1‑bpp BMP-Bild mit 100 × 100 px.
with BmpImage(100, 100, 1, palette) as bmp_image:
	gr = Graphics(bmp_image)

	# Fülle die obere Bildhälfte mit Rot.
	redBrush = SolidBrush(Color.red)
	gr.fill_rectangle(redBrush, Rectangle(0, 0, bmp_image.width, bmp_image.height // 2))

	# Fülle die untere Bildhälfte mit Grün.
	greenBrush = SolidBrush(Color.green)
	gr.fill_rectangle(greenBrush, Rectangle(0, bmp_image.height // 2, bmp_image.width, bmp_image.height // 2))

	# In BMP speichern
	bmp_image.save(os.path.join(directory, "output.monochrome.bmp"))

The example shows how to create a BmpImage using various options.

from aspose.imaging.fileformats.bmp import BmpImage, BitmapCompression
from aspose.imaging import Graphics, Color, ColorPalette, Rectangle
from aspose.imaging.brushes import SolidBrush
import os

directory = r"c:\temp"

paletterColors = [Color.red, Color.green]

# Erstelle eine monochrome Palette, die nur rote und grüne Farben enthält.
palette = ColorPalette.create_with_colors(paletterColors)

# Erstelle ein monochromes 1‑bpp BMP-Bild mit 100 × 100 px.
with BmpImage(100, 100, 1, palette, BitmapCompression.RGB, 96.0, 96.0) as bmp_image:
	gr = Graphics(bmp_image)

	# Fülle die obere Bildhälfte mit Rot.
	redBrush = SolidBrush(Color.red)
	gr.fill_rectangle(redBrush, Rectangle(0, 0, bmp_image.width, bmp_image.height // 2))

	# Fülle die untere Bildhälfte mit Grün.
	greenBrush = SolidBrush(Color.green)
	gr.fill_rectangle(greenBrush, Rectangle(0, bmp_image.height // 2, bmp_image.width, bmp_image.height // 2))

	# In BMP speichern
	bmp_image.save(os.path.join(directory, "output.monochrome.96dpi.bmp"))

The following example shows how to extract information about raw data format and alpha channel from a BMP image.

from aspose.imaging.fileformats.bmp import BmpImage

# Erstellen Sie ein 32‑bpp BMP‑Bild mit 100 × 100 px.
with BmpImage(100, 100, 32, None) as bmp_image:
	print("FileFormat={0}, RawDataFormat={1}, HasAlpha={2}".format(bmp_image.file_format.name, bmp_image.raw_data_format, bmp_image.has_alpha))


# Erstellen Sie ein 24‑bpp BMP‑Bild mit 100 × 100 px.
with BmpImage(100, 100, 24, None) as bmp_image:
	print("FileFormat={0}, RawDataFormat={1}, HasAlpha={2}".format(bmp_image.file_format.name, bmp_image.raw_data_format, bmp_image.has_alpha))

# Im Allgemeinen unterstützt BMP keinen Alpha‑Kanal, sodass die Ausgabe folgendermaßen aussieht:
# FileFormat = BMP, RawDataFormat = Rgb32Bpp, verwendete Kanäle: 8,8,8,8, HasAlpha = False
# FileFormat = BMP, RawDataFormat = Rgb24Bpp, verwendete Kanäle: 8,8,8, HasAlpha = False

The following example shows how the bitmap compression affects the output image size.


from aspose.imaging import Color, ColorPalette, Graphics
from aspose.imaging.brushes import SolidBrush
from aspose.imaging.fileformats.bmp import BmpImage, BitmapCompression
from aspose.imaging.extensions import StreamExtensions as strm_ext

compressions = (BitmapCompression.RGB, BitmapCompression.RLE8)

paletterColors = (Color.red, Color.green)

# Erstelle eine monochrome Palette, die nur rote und grüne Farben enthält.
palette = ColorPalette.create_with_colors(paletterColors)

for compression in compressions:
	# Erstelle ein 8‑bpp BMP-Bild mit 100 × 100 px.
	with BmpImage(100, 100, 8, palette, compression, 0.0, 0.0) as bmp_image:
		gr = Graphics(bmp_image)
		# Füllen Sie das gesamte Bild mit Rot.
		red_brush = SolidBrush(Color.red)
		gr.fill_rectangle(red_brush, bmp_image.bounds)
		# Speichere das Bild in einen Memory-Stream, um die Ausgabegröße zu erhalten.
		with strm_ext.create_memory_stream() as stream:
			bmp_image.save(stream)
			print("---------------------------------------------")
			print("The compression =", bmp_image.compression.name)
			print("The number of bits per pixel =", bmp_image.bits_per_pixel)
			print(f"The image dimensions = {bmp_image.width} x {bmp_image.height}")
			print("The raw line size =", bmp_image.raw_line_size)
			print("The output size in bytes =", stream.tell())

# Die Ausgabe sieht folgendermaßen aus:
# ---------------------------------------------
# Die Kompression = RGB
# Die Anzahl der Bits pro Pixel = 8
# Die Bildabmessungen =100 × 100
# Die rohe Zeilengröße = 100
# Die Ausgabengröße in Bytes = 1178
# ---------------------------------------------
# Die Kompression = RLE8
# Die Anzahl der Bits pro Pixel = 8
# Die Bildabmessungen =100 × 100
# Die rohe Zeilengröße = 100
# Die Ausgabengröße in Bytes = 856

The following example shows how to set horizontal/vertical resolution of a BMP image.


import os
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.bmp import BmpImage

directory = r"c:\temp"

with Image.load(os.path.join(directory, "sample.bmp")) as image:
	bmp_image = aspycore.as_of(image, BmpImage)
	# Erhalte die horizontale und vertikale Auflösung des BmpImage
	horizontal_resolution = bmp_image.horizontal_resolution
	vertical_resolution = bmp_image.vertical_resolution
	print("The horizontal resolution, in pixels per inch:", horizontal_resolution)
	print("The vertical resolution, in pixels per inch:", vertical_resolution)

	if (horizontal_resolution != 96.0 || vertical_resolution != 96.0)
	{
		# Verwende die set_resolution-Methode, um beide Auflösungswerte in einem einzigen Aufruf zu aktualisieren.
		print("Set resolution values to 96 dpi")
		bmp_image.set_resolution(96.0, 96.0)
		print("The horizontal resolution, in pixels per inch:", bmp_image.horizontal_resolution);
		print("The vertical resolution, in pixels per inch:", bmp_image.vertical_resolution);
	}

	# Die Ausgabe könnte folgendermaßen aussehen:
	# Die horizontale Auflösung, in Pixel pro Zoll: 0
	# Die vertikale Auflösung, in Pixel pro Zoll: 0
	# Setze Auflösungswerte auf 96 dpi
	# Die horizontale Auflösung, in Pixel pro Zoll: 96.0
	# Die vertikale Auflösung, in Pixel pro Zoll: 96.0

The following example gets the information from the BMP header and prints it to the console.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.bmp import BmpImage

with Image.load(r"c:\temp\sample.bmp") as image:
	bmp_image = aspycore.as_of(image, BmpImage)
	header = bmp_image.bitmap_info_header

	print("The number of palette colors that are required for displaying the bitmap:", header.bitmap_colors_important)
	print("The number of palette colors used in the bitmap:", header.bitmap_colors_used)
	print("The bitmap compression:", header.bitmap_compression)
	print("The bitmap height:", header.bitmap_height)
	print("The bitmap width:", header.bitmap_width)
	print("The bitmap raw data size in bytes:", header.bitmap_image_size)
	print("The number of planes:", header.bitmap_planes)
	print("The horizontal resolution of the bitmap, in pixels-per-meter:", header.bitmap_x_pels_per_meter)
	print("The vertical resolution of the bitmap, in pixels-per-meter:", header.bitmap_y_pels_per_meter)
	print("The number of bits per pixel:", header.bits_per_pixel)
	print("The extra bits masks:", header.extra_bit_masks)
	print("The header size in bytes:", header.header_size)

#Die Ausgabe könnte folgendermaßen aussehen:
#Die Anzahl der Palettenfarben, die für die Anzeige des Bitmaps erforderlich sind: 0
#Die Anzahl der im Bitmap verwendeten Palettenfarben: 0
#Die Bitmap-Kompression: 0
#Die Bitmap-Höhe: 375
#Die Bitmap-Breite: 500
#Die rohe Datenmenge des Bitmaps in Bytes: 562500
#Die Anzahl der Ebenen: 1
#Die horizontale Auflösung des Bitmaps, in Pixel pro Meter: 0
#Die vertikale Auflösung des Bitmaps, in Pixel pro Meter: 0
#Die Anzahl der Bits pro Pixel: 24
#Die zusätzlichen Bitmasken: 
#Die Header-Größe in Bytes: 40

Compress BMP image using DXT1 compression algorithm.

#cxFor:aspose.imaging.imageoptions.BmpOptions.compression

from aspose.imaging import Image
from aspose.imaging.imageoptions import BmpOptions
from aspose.imaging.fileformats.bmp import BitmapCompression

with Image.load("Tiger.bmp") as image:
	bmp_options = BmpOptions()
	bmp_options.compression = BitmapCompression.DXT1
	image.save("CompressedTiger.bmp", bmp_options)

Decompress BMP image which was previously compressed using DXT1 compression algorithm.


from aspose.imaging import Image
from aspose.imaging.imageoptions import BmpOptions

with Image.load("CompressedTiger.bmp") as image:
	image.save("DecompressedTiger.bmp", BmpOptions())