DicomImage-Klasse

Summary: This Class implements Digital Imaging and Communications in Medicine
(DICOM) raster image format support and offers a comprehensive solution for
processing DICOM images with precision and flexibility. You can seamlessly
manipulate image pages, including operations to get, add, or remove pages, and
control the default and active pages. With capabilities to work with alpha channels,
embed XMP metadata, resize, rotate, crop, binarize, adjust, apply filters,
and convert to other raster formats. This API empowers developers to handle
DICOM images effectively while meeting diverse application requirements in
medical imaging contexts.

Module: aspose.imaging.fileformats.dicom

Full Name: aspose.imaging.fileformats.dicom.DicomImage

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

Constructors

NameBeschreibung
DicomImage(dicom_options, width, height)Initialisieren Sie mühelos eine neue Instanz der DicomImage-Klasse mit diesem
Konstruktor, wobei die dicomOptions-Parameter verwendet werden. Perfekt für Entwickler, die nach
einer schnellen und effizienten Einarbeitung in DicomImage Objekte in ihren Projekten suchen.
DicomImage(stream)Erstellen Sie eine neue Instanz der DicomImage-Klasse, indem Sie einen Stream‑Parameter
in diesem Konstruktor verwenden. Perfekt für Entwickler, die nach einer schlanken Methode suchen, um DicomImage Objekte aus bestehenden Datenströmen in ihren Projekten zu initialisieren.
DicomImage(stream, load_options)Starten Sie eine neue Instanz der DicomImage-Klasse reibungslos, indem Sie einen Stream‑ und
loadOptions‑Parameter in diesem Konstruktor einsetzen. Ideal für Entwickler, die eifrig sind, um schnell und effektiv mit DicomImage Objekten in ihren Projekten zu arbeiten.

Properties

NameTypeAccessBeschreibung
active_pageDicomPager/wVerwalten Sie die aktive Seite des Bildes mit dieser intuitiven Eigenschaft. Ideal für Entwickler,
die dynamisch zwischen Seiten in mehrseitigen Bildern wechseln möchten und dabei eine effiziente
Navigation und Verarbeitung sicherstellen.
active_page_indexintrRufen Sie den Index der aktiven Seite mühelos mit dieser intuitiven Eigenschaft ab.
Ideal für Entwickler, die schnellen Zugriff auf den aktuellen Seitenindex in mehrseitigen
Bildern benötigen und dabei eine effiziente Navigation und Verarbeitung sicherstellen.
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.
bits_per_pixelintrLiest die Bit‑Pro‑Pixel‑Anzahl des Bildes.
boundsRectanglerLiest die Objektgrenzen.
buffer_size_hintintr/wLiest oder setzt den Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.
containerImagerLiest den Image Container.
data_stream_containerStreamContainerrLiest den Datenstrom des Objekts.
dicom_pagesDicomPage[]rGreifen Sie mit dieser intuitiven Eigenschaft auf die Seiten des Bildes zu. Ideal für Entwickler
die mit einzelnen Seiten des Bildes interagieren möchten und dabei nahtlose
Navigation und Manipulation gewährleisten.
freigegebenboolrLiest einen Wert, der angibt, ob diese Instanz freigegeben ist.
exif_dataExifDatar/wLiest oder setzt die Exif‑Instanz.
file_formatFileFormatrRufen Sie den Dateiformatwert mühelos mit dieser intuitiven Eigenschaft ab. Ideal für
Entwickler, die schnellen Zugriff auf das Format der Bilddatei benötigen und dabei eine effiziente
Handhabung und Verarbeitung basierend auf dem Dateityp gewährleisten.
file_infoDicomImageInforRufen Sie wertvolle Header-Informationen aus der DICOM-Datei mühelos mit dieser
intuitiven Eigenschaft ab. Ideal für Entwickler, die schnellen Zugriff auf wesentliche Details
innerhalb der DICOM-Datei benötigen und dabei eine effiziente Datenextraktion und Analyse gewährleisten.
has_alphaboolrErmitteln Sie mühelos, ob das Bild einen Alpha-Kanal besitzt, mit dieser intuitiven
Eigenschaft. Ideal für Entwickler, die feststellen möchten, ob das Bild Transparenzinformationen enthält, und dabei eine präzise Handhabung von Alpha-Kanal-Daten in Bildverarbeitungsaufgaben gewährleisten.
has_background_colorboolr/wLiest oder setzt einen Wert, der angibt, ob das Bild eine Hintergrundfarbe hat.
has_transparent_colorboolr/wLiest einen Wert, der angibt, ob das Bild eine transparente Farbe hat.
heightintrLiest die Bildhöhe.
horizontal_resolutionfloatr/wLiest oder setzt die horizontale Auflösung in Pixel pro Zoll dieses RasterImage.
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.
metadataImageMetadatarLiest oder setzt XMP-Daten aus dem Frame.
page_countintrRufen Sie die Gesamtseitenzahl des Bildes mit dieser intuitiven Eigenschaft ab. Ideal für
Entwickler, die schnellen Zugriff auf die Anzahl der Seiten in einem Bild benötigen und dabei eine effiziente Navigation und Verwaltung gewährleisten.
pagesImage[]rGreifen Sie mit dieser intuitiven Eigenschaft auf die Seiten des Bildes zu. Ideal für Entwickler
die mit einzelnen Seiten des Bildes interagieren möchten und dabei nahtlose Navigation
und Manipulation gewährleisten.
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_formatPixelDataFormatrLiest das Rohdatenformat.
raw_data_settingsRawDataSettingsrLiest die aktuellen Rohdateneinstellungen. Hinweis: Beim Verwenden dieser Einstellungen werden die Daten ohne Konvertierung geladen.
raw_fallback_indexintr/wLiest oder setzt den Rückfallindex, der verwendet wird, wenn der Palettenindex außerhalb des gültigen Bereichs liegt
raw_indexed_color_converterIIndexedColorConverterr/wLiest oder setzt den indizierten Farbkonverter
raw_line_sizeintrLiest die Rohzeilengröße in Bytes.
sizeSizerLiest die Objektgröße.
transparent_colorColorr/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/wLiest oder setzt die vertikale Auflösung in Pixel pro Zoll dieses RasterImage.
widthintrLiest die Bildbreite.
xmp_dataXmpPacketWrapperr/wLiest oder setzt XMP-Daten.

Methods

NameBeschreibung
add_page()Fügen Sie mit dieser einfachen Methode eine neue Seite am Ende der Seitenliste des Bildes hinzu.
Ideal für Entwickler, die mehrseitige Bilder dynamisch erweitern möchten, um eine nahtlose
Integration und Organisation des Bildinhalts zu gewährleisten.
add_page(page)Erweitern Sie Ihre Bildsammlung, indem Sie mit dieser intuitiven Methode eine neue Seite hinzufügen.
Ideal für Entwickler, die mehrseitige Bilder dynamisch ergänzen möchten,
um eine nahtlose Erweiterung und Organisation des Bildinhalts zu gewährleisten.
adjust_brightness(brightness)Verbessern Sie die Bildluminanz durch die Anpassung der Helligkeit, einer
parametrisierten Methode, die Entwicklern ermöglicht, die Leuchtkraft von Bildern fein abzustimmen.
Diese benutzerfreundliche Funktion befähigt Entwickler, die Bild
Helligkeit nahtlos zu manipulieren und bietet Flexibilität sowie Kontrolle über die visuelle Ästhetik.
adjust_contrast(contrast)Verbessern Sie den Kontrast von Image mit dieser benutzerfreundlichen Methode,
die die Unterschiede zwischen hellen und dunklen Bereichen anpasst. Verbessern Sie die visuelle Klarheit und
Definition mühelos und bieten Entwicklern eine intuitive Kontrolle über
den Bildkontrast für eine optimale Darstellung.
adjust_gamma(gamma)Verbessern Sie die Bildqualität und passen Sie sie mit Gamma-Korrektur an, einer leistungsstarken Technik
zur Feinabstimmung des visuellen Erscheinungsbildes. Perfekt für Entwickler, die die Bild
Darstellung optimieren, den Farbton ausgleichen und eine konsistente Wiedergabe über verschiedene
Geräte und Umgebungen hinweg sicherstellen möchten.
adjust_gamma(gamma_red, gamma_green, gamma_blue)Erreichen Sie präzise Farbkorrekturen, indem Sie Gamma-Korrektur unabhängig
von den roten, grünen und blauen Komponenten eines Bildes anwenden. Diese Methode gewährleistet eine genaue
Farbbalance und optimale visuelle Ausgabe und richtet sich an Entwickler, die eine feinkörnige
Kontrolle über die Bilddarstellung und Farbgenauigkeit wünschen.
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)Binarisieren Sie Bilder mit Bradleys adaptivem Schwellenwertalgorithmus und nutzen Sie dabei die Integralbild-
Schwellenwertbestimmung für verbesserte Leistung. Ideal für Entwickler, die
Bilder automatisch anhand lokaler Helligkeitsvariationen segmentieren möchten, um
eine genaue Objekterkennung und -extraktion bei unterschiedlichen Lichtbedingungen sicherzustellen.
binarize_fixed(threshold)Konvertieren Sie das Bild einfach in ein Binärformat mithilfe eines vordefinierten Schwellenwerts
mit dieser unkomplizierten Methode. Ideal für Entwickler, die Bildverarbeitungsaufgaben vereinfachen möchten, indem sie das Bild anhand festgelegter Intensitätsstufen in Vorder- und Hintergrundkomponenten
segmentieren.
binarize_otsu()Wenden Sie die Otsu-Schwellenwertbestimmung an, um das Bild zu binarisieren, wobei der optimale
Schwellenwert automatisch basierend auf dem Histogramm des Bildes ermittelt wird. Perfekt für Entwickler, die
eine zuverlässige Methode suchen, um Bilder in Vorder- und Hintergrundbereiche zu segmentieren, mit
minimalem manuellem Eingriff.
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()Diese Methode cached Daten effizient, optimiert die Leistung und gewährleistet schnellen Zugriff
bei Bedarf. Ideal für Entwickler, die die Geschwindigkeit und Effizienz ihrer
Anwendungen durch intelligentes Datenmanagement verbessern möchten.
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_files(files)Erstellt das Mehrseiten‑Bild, das die angegebenen Dateien als Lazy‑Loading‑Seiten enthält.
create_from_files(files, throw_exception_on_load_error)Erstellt das Mehrseiten‑Bild, das die angegebenen Dateien als Lazy‑Loading‑Seiten enthält.
create_from_images(images)Erstellt ein neues Bild, das die angegebenen Bilder als Seiten verwendet
create_from_images(images, dispose_images)Erstellt ein neues Bild, wobei die angegebenen Bilder als Seiten verwendet werden.
crop(left_shift, right_shift, top_shift, bottom_shift)Passen Sie den Beschnittbereich des Bildes an, indem Sie Verschiebungen mit dieser vielseitigen Methode anwenden.
Perfekt für Entwickler, die eine präzise Kontrolle über den Beschnittvorgang benötigen, um sicherzustellen,
dass wichtige Details erhalten bleiben, während unnötige Elemente entfernt werden.
crop(rectangle)Beschneiden Sie das Bild, um unerwünschte Bereiche zu entfernen und sich auf wesentliche Inhalte zu konzentrieren, mit dieser
einfachen Methode. Ideal für Entwickler, die die visuelle Zusammensetzung von
Bildern anpassen möchten, um sicherzustellen, dass sie die gewünschte Botschaft effektiv vermitteln.
dither(dithering_method, bits_count)Führt Dithering auf dem aktuellen Bild aus.
dither(dithering_method, bits_count, custom_palette)Verbessern Sie das aktuelle Bild, indem Sie Dithering‑Effekte mit dieser unkomplizierten
Methode anwenden. Perfekt für Entwickler, die Textur und Tiefe zu Bildern hinzufügen möchten,
um deren visuelle Qualität und Gesamteindruck zu verbessern.
embed_digital_signature(password)Betten Sie eine digitale Signatur, basierend auf dem angegebenen Passwort, in jede Seite des Bildes ein.
filter(rectangle, options)Verbessern Sie mühelos bestimmte Bereiche Ihres Bildes, indem Sie Filter auf festgelegte
Rechtecke anwenden. Diese Methode bietet Entwicklern eine präzise Kontrolle über
die Bildmanipulation, sodass zielgerichtete Anpassungen vorgenommen werden können, um gewünschte
visuelle Effekte mit Leichtigkeit zu erzielen.
get_argb_32_pixel(x, y)Liefert ein 32‑Bit‑ARGB‑Pixel‑Bild.
get_default_argb_32_pixels(rectangle)Liefert das Standard‑32‑Bit‑ARGB‑Pixel‑Array.
get_default_options(args)Liefert die Standardoptionen.
get_default_pixels(rectangle, partial_pixel_loader)Liefert das Standard‑Pixel‑Array mittels teilweisem Pixel‑Lader.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)Liefert das Standard‑Rohdaten‑Array mittels teilweisem Pixel‑Lader.
get_default_raw_data(rectangle, raw_data_settings)Liefert das Standard‑Rohdaten‑Array.
get_file_format(file_path)Liefert das Dateiformat.
get_file_format(stream)Liefert das Dateiformat.
get_file_format_of_stream(stream)Liefert das Dateiformat.
get_fitting_rectangle(rectangle, pixels, width, height)Liefert das Rechteck, das zum aktuellen Bild passt.
get_fitting_rectangle(rectangle, width, height)Liefert das Rechteck, das zum aktuellen Bild passt.
get_modify_date(use_default)Liefert Datum und Uhrzeit, zu der das Ressourcen‑Bild zuletzt geändert wurde.
get_original_options()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()Transformieren Sie Bilder mühelos in ihre Graustufen‑Darstellung, wodurch die visuelle
Analyse und Verarbeitung vereinfacht wird. Perfekt für Entwickler, die die Bildklarheit verbessern,
die Komplexität reduzieren und effiziente graustufenbasierte Algorithmen
für vielfältige Anwendungen ermöglichen.
insert_page(page_index)Fügen Sie mit dieser intuitiven
Methode eine neue Seite in die Seitenliste des Bildes an einem angegebenen Index ein. Ideal für Entwickler, die eine präzise Kontrolle über die Anordnung der Seiten in
Mehrseitenbildern benötigen, um eine nahtlose Organisation und Anpassung des Bildinhalts zu gewährleisten.
is_digital_signed(password, percentage_threshold)Führt eine schnelle Prüfung durch, um festzustellen, ob das Bild digital signiert ist, wobei das bereitgestellte Passwort und der Schwellenwert verwendet werden.
load(file_path)Lädt ein neues Bild vom angegebenen Dateipfad oder URL.
Wenn filePath ein Dateipfad ist, öffnet die Methode einfach die Datei.
Wenn filePath eine URL ist, lädt die Methode die Datei herunter, speichert sie temporär und öffnet sie.
load(file_path, load_options)Lädt ein neues Bild vom angegebenen Dateipfad oder URL.
Wenn filePath ein Dateipfad ist, öffnet die Methode einfach die Datei.
Wenn filePath eine URL ist, lädt die Methode die Datei herunter, speichert sie temporär und öffnet sie.
load(stream)Lädt ein neues Bild aus dem angegebenen Stream.
load(stream, load_options)Lädt ein neues Bild aus dem angegebenen Stream.
load_argb_32_pixels(rectangle)Lädt 32‑Bit‑ARGB‑Pixel.
load_argb_64_pixels(rectangle)Lädt 64‑Bit‑ARGB‑Pixel.
load_cmyk_32_pixels(rectangle)Lädt Pixel im CMYK‑Format.
load_cmyk_pixels(rectangle)Lädt Pixel im CMYK‑Format.
Diese Methode ist veraltet. Bitte verwenden Sie die effektivere Methode RasterImage.load_cmyk_32_pixels(rectangle).
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)Lädt 32‑Bit‑ARGB‑Pixel teilweise (nach Blöcken).
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)Lädt 64‑Bit‑ARGB‑Pixel teilweise nach Paketen.
load_partial_pixels(desired_rectangle, pixel_loader)Lädt Pixel teilweise nach Paketen.
load_pixels(rectangle)Lädt Pixel.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)Lädt Rohdaten.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)Lädt Rohdaten.
load_stream(stream)Lädt ein neues Bild aus dem angegebenen Stream.
load_stream_with_options(stream, load_options)Lädt ein neues Bild aus dem angegebenen Stream.
load_with_options(file_path, load_options)Lädt ein neues Bild vom angegebenen Dateipfad oder URL.
Wenn filePath ein Dateipfad ist, öffnet die Methode einfach die Datei.
Wenn filePath eine URL ist, lädt die Methode die Datei herunter, speichert sie temporär und öffnet sie.
normalize_angle()Normalisiert den Winkel.
Diese Methode ist auf gescannte Textdokumente anwendbar, um die schiefe Aufnahme zu korrigieren.
Diese Methode verwendet die Methoden RasterImage.get_skew_angle() und RasterImage.rotate(angle).
normalize_angle(resize_proportionally, background_color)Normalisiert den Winkel.
Diese Methode ist auf gescannte Textdokumente anwendbar, um die schiefe Aufnahme zu korrigieren.
Diese Methode verwendet die Methoden RasterImage.get_skew_angle() und RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()Normalisiert das Bildhistogramm — passt die Pixelwerte an, um den gesamten verfügbaren Bereich zu nutzen.
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.
remove_page(page_index)Entfernen Sie die Seite am angegebenen Index aus der Seitenliste mit dieser praktischen Methode.
Ideal für Entwickler, die eine präzise Kontrolle über die Verwaltung von Mehrseitenbildern benötigen,
um eine nahtlose Organisation und Anpassung des Bildinhalts zu gewährleisten.
replace_argb(old_color_argb, old_color_diff, new_color_argb)Ersetzt eine Farbe durch eine andere mit zulässiger Differenz und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.
replace_color(old_color, old_color_diff, new_color)Ersetzt eine Farbe durch eine andere mit zulässiger Differenz und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.
replace_color(old_color_argb, old_color_diff, new_color_argb)Ersetzt eine Farbe durch eine andere mit zulässiger Differenz und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.
replace_non_transparent_colors(new_color)Ersetzt alle nicht‑transparenten Farben durch eine neue Farbe und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.
Hinweis: Wenn Sie dies bei Bildern ohne Transparenz verwenden, werden alle Farben durch eine einzige ersetzt.
replace_non_transparent_colors(new_color_argb)Ersetzt alle nicht‑transparenten Farben durch eine neue Farbe und bewahrt den ursprünglichen Alphawert, um glatte Kanten zu erhalten.
Hinweis: Wenn Sie dies bei Bildern ohne Transparenz verwenden, werden alle Farben durch eine einzige ersetzt.
resize(new_width, new_height)Skaliert das Bild. Der Standardwert ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.
resize(new_width, new_height, resize_type)Skaliert das Bild unter Beibehaltung des Seitenverhältnisses mit dieser praktischen Methode. Ideal
für Entwickler, die die Bildabmessungen proportional anpassen möchten, um
Konsistenz zu gewährleisten und die Proportionen des Originalinhalts zu erhalten.
Die proportionale Skalierung ändert jedes Frame gemäß dem Verhältnis von newWidth/width und newHeight/height.
resize(new_width, new_height, settings)Passen Sie die Größe Ihres Bildes mit dieser einfachen Skalierungsmethode an. Egal, ob Sie
verkleinern oder vergrößern müssen, diese Funktion stellt sicher, dass Ihre Skalierungsanforderungen effizient und genau erfüllt werden, was sie perfekt für Entwickler macht, die schnelle und einfache Bildgrößenanpassungen suchen.
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)Passen Sie die Höhe des Bildes an, während Sie das Seitenverhältnis beibehalten, mit dieser
benutzerfreundlichen Methode. Perfekt für Entwickler, die Bilder dynamisch skalieren möchten
und dabei ihre Proportionen erhalten, um optimale Anzeige und Benutzerfreundlichkeit
in ihren Anwendungen sicherzustellen.
resize_height_proportionally(new_height, settings)Skaliert die Höhe proportional.
resize_height_proportionally_settings(new_height, settings)Skaliert die Höhe proportional.
resize_proportional(new_width, new_height, resize_type)Skaliert das Bild unter Beibehaltung des Seitenverhältnisses mit dieser praktischen Methode. Ideal
für Entwickler, die die Bildabmessungen proportional anpassen möchten, um
Konsistenz zu gewährleisten und die Proportionen des Originalinhalts zu erhalten.
Die proportionale Skalierung ändert jedes Frame gemäß dem Verhältnis von newWidth/width und newHeight/height.
resize_width_proportionally(new_width)Skaliert die Breite proportional. Der Standard ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.
resize_width_proportionally(new_width, resize_type)Passen Sie die Breite des Bildes an, während Sie das Seitenverhältnis beibehalten, mit dieser praktischen
Methode. Ideal für Entwickler, die Bilder proportional skalieren möchten, um
konsistente und optisch ansprechende Ergebnisse über verschiedene Anzeigeumgebungen hinweg sicherzustellen.
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)Drehen Sie das Bild um sein Zentrum mit dieser praktischen Methode. Ideal für Entwickler
die Bildausrichtung dynamisch anpassen möchten, um optimale Darstellung und
Ausrichtung in ihren Anwendungen sicherzustellen.
rotate_flip(rotate_flip_type)Manipulieren Sie einfach den aktiven Frame, indem Sie ihn drehen, spiegeln oder beide Aktionen
gleichzeitig mit dieser unkomplizierten Methode ausführen. Ideal für Entwickler, die
die Ausrichtung bestimmter Frames innerhalb ihrer Bildsequenzen dynamisch anpassen müssen,
um optimale Darstellung und Ausrichtung sicherzustellen.
rotate_flip_all(rotate_flip)Dreht das gesamte Flip.
save()Speichert die Bilddaten in den zugrunde liegenden Stream.
save(file_path)Speichert das Bild am angegebenen Dateipfad.
save(file_path, options)Bewahren Sie die Daten des Objekts, indem Sie sie in die festgelegte Datei (Indexer + Dateiname)
speichern, zusammen mit dem angegebenen Dateiformat und Optionen. Ideal für Entwickler, die
Daten sicher in verschiedenen Formaten speichern möchten, während sie Flexibilität und Kontrolle über
die Speicherparameter beibehalten.
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.
save(stream, options_base)Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.
save(stream, options_base, bounds_rectangle)Speichern Sie Ihre Bilddaten einfach in einen angegebenen Stream im gewünschten Dateiformat
mit dieser praktischen Methode. Egal, ob Sie mit JPEG, PNG oder einem anderen Format arbeiten,
stellt diese Funktion sicher, dass Ihre Bilddaten effizient und genau gespeichert werden,
was sie ideal für Entwickler macht, die ihre Dateispeicherungsprozesse optimieren möchten.
save_all(file_path, options)Bewahren Sie die Daten des Objekts, indem Sie sie in die festgelegte Datei (Indexer + Dateiname)
speichern, zusammen mit dem angegebenen Dateiformat und Optionen. Ideal für Entwickler, die
Daten sicher in verschiedenen Formaten speichern möchten, während sie Flexibilität und Kontrolle über
die Speicherparameter beibehalten.
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 dieses RasterImage präzise mit dieser
unkomplizierten Methode an. Ideal für Entwickler, die die Bildauflösung an
spezifische Anforderungen anpassen möchten, um optimale Anzeigequalität und Dateigrößenverwaltung zu gewährleisten.
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: DicomImage(dicom_options, width, height)

 DicomImage(dicom_options, width, height) 

Initialisieren Sie mühelos eine neue Instanz der DicomImage-Klasse mit diesem
Konstruktor, wobei die dicomOptions-Parameter verwendet werden. Perfekt für Entwickler, die nach
einer schnellen und effizienten Einarbeitung in DicomImage Objekte in ihren Projekten suchen.

Parameters:

ParameterTypBeschreibung
dicom_optionsDicomOptionsDie DICOM‑Optionen.
widthintDie Breite.
heightintDie Höhe.

Constructor: DicomImage(stream)

 DicomImage(stream) 

Erstellen Sie eine neue Instanz der DicomImage-Klasse, indem Sie einen Stream‑Parameter
in diesem Konstruktor verwenden. Perfekt für Entwickler, die nach einer schlanken Methode suchen, um DicomImage Objekte aus bestehenden Datenströmen in ihren Projekten zu initialisieren.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream.

See also:

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

Constructor: DicomImage(stream, load_options)

 DicomImage(stream, load_options) 

Starten Sie eine neue Instanz der DicomImage-Klasse reibungslos, indem Sie einen Stream‑ und
loadOptions‑Parameter in diesem Konstruktor einsetzen. Ideal für Entwickler, die eifrig sind, um schnell und effektiv mit DicomImage Objekten in ihren Projekten zu arbeiten.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream.
load_optionsLoadOptionsDie Ladeoptionen.

See also:

Example # 1: This example shows how to load a DICOM image from a file stream to stay withi…

Method: add_page()

 add_page() 

Fügen Sie mit dieser einfachen Methode eine neue Seite am Ende der Seitenliste des Bildes hinzu.
Ideal für Entwickler, die mehrseitige Bilder dynamisch erweitern möchten, um eine nahtlose
Integration und Organisation des Bildinhalts zu gewährleisten.

Returns

TypBeschreibung
DicomPageDie neu erstellte DicomPage.

Method: add_page(page)

 add_page(page) 

Erweitern Sie Ihre Bildsammlung, indem Sie mit dieser intuitiven Methode eine neue Seite hinzufügen.
Ideal für Entwickler, die mehrseitige Bilder dynamisch ergänzen möchten,
um eine nahtlose Erweiterung und Organisation des Bildinhalts zu gewährleisten.

Parameters:

ParameterTypBeschreibung
pageRasterImageDie hinzuzufügende Seite.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Verbessern Sie die Bildluminanz durch die Anpassung der Helligkeit, einer
parametrisierten Methode, die Entwicklern ermöglicht, die Leuchtkraft von Bildern fein abzustimmen.
Diese benutzerfreundliche Funktion befähigt Entwickler, die Bild
Helligkeit nahtlos zu manipulieren und bietet Flexibilität sowie Kontrolle über die visuelle Ästhetik.

Parameters:

ParameterTypBeschreibung
HelligkeitintHelligkeitswert.

See also:

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

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Verbessern Sie den Kontrast von Image mit dieser benutzerfreundlichen Methode,
die die Unterschiede zwischen hellen und dunklen Bereichen anpasst. Verbessern Sie die visuelle Klarheit und
Definition mühelos und bieten Entwicklern eine intuitive Kontrolle über
den Bildkontrast für eine optimale Darstellung.

Parameters:

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

See also:

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

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Verbessern Sie die Bildqualität und passen Sie sie mit Gamma-Korrektur an, einer leistungsstarken Technik
zur Feinabstimmung des visuellen Erscheinungsbildes. Perfekt für Entwickler, die die Bild
Darstellung optimieren, den Farbton ausgleichen und eine konsistente Wiedergabe über verschiedene
Geräte und Umgebungen hinweg sicherstellen möchten.

Parameters:

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

See also:

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

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

Erreichen Sie präzise Farbkorrekturen, indem Sie Gamma-Korrektur unabhängig
von den roten, grünen und blauen Komponenten eines Bildes anwenden. Diese Methode gewährleistet eine genaue
Farbbalance und optimale visuelle Ausgabe und richtet sich an Entwickler, die eine feinkörnige
Kontrolle über die Bilddarstellung und Farbgenauigkeit wünschen.

Parameters:

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

See also:

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

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 x s Fensters von Pixeln
das um dieses Pixel zentriert ist.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

Binarisieren Sie Bilder mit Bradleys adaptivem Schwellenwertalgorithmus und nutzen Sie dabei die Integralbild-
Schwellenwertbestimmung für verbesserte Leistung. Ideal für Entwickler, die
Bilder automatisch anhand lokaler Helligkeitsvariationen segmentieren möchten, um
eine genaue Objekterkennung und -extraktion bei unterschiedlichen Lichtbedingungen sicherzustellen.

Parameters:

ParameterTypBeschreibung
brightness_differencefloatDer Helligkeitsunterschied zwischen dem Pixel und dem Durchschnitt eines s x 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.

See also:

Example # 1: The following example binarizes a DICOM image with Bradley’s adaptive thresho…

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

Konvertieren Sie das Bild einfach in ein Binärformat mithilfe eines vordefinierten Schwellenwerts
mit dieser unkomplizierten Methode. Ideal für Entwickler, die Bildverarbeitungsaufgaben vereinfachen möchten, indem sie das Bild anhand festgelegter Intensitätsstufen in Vorder- und Hintergrundkomponenten
segmentieren.

Parameters:

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

See also:

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

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_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_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: crop(left_shift, right_shift, top_shift, bottom_shift)

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Passen Sie den Beschnittbereich des Bildes an, indem Sie Verschiebungen mit dieser vielseitigen Methode anwenden.
Perfekt für Entwickler, die eine präzise Kontrolle über den Beschnittvorgang benötigen, um sicherzustellen,
dass wichtige Details erhalten bleiben, während unnötige Elemente entfernt werden.

Parameters:

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

See also:

Example # 1: The following example crops a DICOM image. The cropping area is specified via…

Method: crop(rectangle)

 crop(rectangle) 

Beschneiden Sie das Bild, um unerwünschte Bereiche zu entfernen und sich auf wesentliche Inhalte zu konzentrieren, mit dieser
einfachen Methode. Ideal für Entwickler, die die visuelle Zusammensetzung von
Bildern anpassen möchten, um sicherzustellen, dass sie die gewünschte Botschaft effektiv vermitteln.

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck.

See also:

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

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) 

Verbessern Sie das aktuelle Bild, indem Sie Dithering‑Effekte mit dieser unkomplizierten
Methode anwenden. Perfekt für Entwickler, die Textur und Tiefe zu Bildern hinzufügen möchten,
um deren visuelle Qualität und Gesamteindruck zu verbessern.

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) 

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

Parameters:

ParameterTypBeschreibung
PasswortstringDas Passwort, das zum Erzeugen digitaler Signaturdaten verwendet wird

Method: filter(rectangle, options)

 filter(rectangle, options) 

Verbessern Sie mühelos bestimmte Bereiche Ihres Bildes, indem Sie Filter auf festgelegte
Rechtecke anwenden. Diese Methode bietet Entwicklern eine präzise Kontrolle über
die Bildmanipulation, sodass zielgerichtete Anpassungen vorgenommen werden können, um gewünschte
visuelle Effekte mit Leichtigkeit zu erzielen.

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck.
optionsFilterOptionsBaseDie Optionen.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

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

Parameters:

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

Returns

TypBeschreibung
intDas 32‑Bit‑ARGB‑Pixel für die angegebene Position.

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

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

Parameters:

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

Returns

TypBeschreibung
int[]Das Standard‑Pixel‑Array.

Method: get_default_options(args)

 get_default_options(args) 

Liefert die Standardoptionen.

Parameters:

ParameterTypBeschreibung
argsSystem.ObjectDie Argumente.

Returns

TypBeschreibung
ImageOptionsBaseStandardoptionen

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

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

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, für das die Pixel abgerufen werden.
partial_pixel_loaderIPartialArgb32PixelLoaderDer partielle Pixel‑Lader.

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) 

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

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas Rechteck, für das die Pixel abgerufen werden.
partial_raw_data_loaderIPartialRawDataLoaderDer partielle Rohdaten‑Lader.
raw_data_settingsRawDataSettingsDie Rohdaten‑Einstellungen.

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

Liefert das Standard‑Rohdaten‑Array.

Parameters:

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

Returns

TypBeschreibung
System.ByteDas Standard‑Rohdaten‑Array.

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Liefert das Dateiformat.

Parameters:

ParameterTypBeschreibung
file_pathstringDer Dateipfad.

Returns

TypBeschreibung
FileFormatDas ermittelte Dateiformat.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Liefert das Dateiformat.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream.

Returns

TypBeschreibung
FileFormatDas ermittelte Dateiformat.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Liefert das Dateiformat.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream.

Returns

TypBeschreibung
FileFormatDas ermittelte Dateiformat.

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

 get_fitting_rectangle(rectangle, pixels, width, height) 

Liefert das Rechteck, das zum aktuellen Bild passt.

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, width, height) 

Liefert das Rechteck, das zum aktuellen Bild passt.

Parameters:

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

Returns

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

Method: get_modify_date(use_default)

 get_modify_date(use_default) 

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: insert_page(page_index)

 insert_page(page_index) 

Fügen Sie mit dieser intuitiven
Methode eine neue Seite in die Seitenliste des Bildes an einem angegebenen Index ein. Ideal für Entwickler, die eine präzise Kontrolle über die Anordnung der Seiten in
Mehrseitenbildern benötigen, um eine nahtlose Organisation und Anpassung des Bildinhalts zu gewährleisten.

Parameters:

ParameterTypBeschreibung
page_indexintIndex der Seite.

Returns

TypBeschreibung
DicomPageDie neu erstellte DicomPage.

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 schiefe Aufnahme zu korrigieren.
Diese Methode verwendet die Methoden RasterImage.get_skew_angle() und RasterCachedMultipageImage.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: remove_page(page_index)

 remove_page(page_index) 

Entfernen Sie die Seite am angegebenen Index aus der Seitenliste mit dieser praktischen Methode.
Ideal für Entwickler, die eine präzise Kontrolle über die Verwaltung von Mehrseitenbildern benötigen,
um eine nahtlose Organisation und Anpassung des Bildinhalts zu gewährleisten.

Parameters:

ParameterTypBeschreibung
page_indexintIndex der Seite.

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_colorColor
old_color_diffSystem.ByteErlaubte Differenz im alten Farbwert, um den ersetzten Farbton zu erweitern.
new_colorColor

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

Parameters:

ParameterTypBeschreibung
new_colorColor

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 dies 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 unter Beibehaltung des Seitenverhältnisses mit dieser praktischen Methode. Ideal
für Entwickler, die die Bildabmessungen proportional anpassen möchten, um
Konsistenz zu gewährleisten und die Proportionen des Originalinhalts zu erhalten.
Die proportionale Skalierung ändert jedes Frame gemäß dem Verhältnis von newWidth/width und newHeight/height.

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) 

Passen Sie die Größe Ihres Bildes mit dieser einfachen Skalierungsmethode an. Egal, ob Sie
verkleinern oder vergrößern müssen, diese Funktion stellt sicher, dass Ihre Skalierungsanforderungen effizient und genau erfüllt werden, was sie perfekt für Entwickler macht, die schnelle und einfache Bildgrößenanpassungen suchen.

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) 

Passen Sie die Höhe des Bildes an, während Sie das Seitenverhältnis beibehalten, mit dieser
benutzerfreundlichen Methode. Perfekt für Entwickler, die Bilder dynamisch skalieren möchten
und dabei ihre Proportionen erhalten, um optimale Anzeige und Benutzerfreundlichkeit
in ihren Anwendungen sicherzustellen.

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_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

Skaliert das Bild unter Beibehaltung des Seitenverhältnisses mit dieser praktischen Methode. Ideal
für Entwickler, die die Bildabmessungen proportional anpassen möchten, um
Konsistenz zu gewährleisten und die Proportionen des Originalinhalts zu erhalten.
Die proportionale Skalierung ändert jedes Frame gemäß dem Verhältnis von newWidth/width und newHeight/height.

Parameters:

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

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

ParameterTypBeschreibung
new_widthintDie neue Breite.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Passen Sie die Breite des Bildes an, während Sie das Seitenverhältnis beibehalten, mit dieser praktischen
Methode. Ideal für Entwickler, die Bilder proportional skalieren möchten, um
konsistente und optisch ansprechende Ergebnisse über verschiedene Anzeigeumgebungen hinweg sicherzustellen.

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) 

Drehen Sie das Bild um sein Zentrum mit dieser praktischen Methode. Ideal für Entwickler
die Bildausrichtung dynamisch anpassen möchten, um optimale Darstellung und
Ausrichtung in ihren Anwendungen sicherzustellen.

Parameters:

ParameterTypBeschreibung
anglefloatDer Rotationswinkel in Grad. Positive Werte drehen im Uhrzeigersinn.
resize_proportionallyboolwenn auf true gesetzt, wird die Bildgröße geändert
entsprechend den Projektionen des gedrehten Rechtecks (Eckpunkte) im anderen
Fall bleiben die Abmessungen unverändert und nur
internal Bildinhalte werden gedreht.
background_colorColorFarbe des Hintergrunds.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Manipulieren Sie einfach den aktiven Frame, indem Sie ihn drehen, spiegeln oder beide Aktionen
gleichzeitig mit dieser unkomplizierten Methode ausführen. Ideal für Entwickler, die
die Ausrichtung bestimmter Frames innerhalb ihrer Bildsequenzen dynamisch anpassen müssen,
um optimale Darstellung und Ausrichtung sicherzustellen.

Parameters:

ParameterTypBeschreibung
rotate_flip_typeRotateFlipTypeDer Rotations-Flip-Typ.

See also:

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

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip) 

Dreht das gesamte Flip.

Parameters:

ParameterTypBeschreibung
rotate_flipRotateFlipTypeDer Rotations-Flip.

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) 

Bewahren Sie die Daten des Objekts, indem Sie sie in die festgelegte Datei (Indexer + Dateiname)
speichern, zusammen mit dem angegebenen Dateiformat und Optionen. Ideal für Entwickler, die
Daten sicher in verschiedenen Formaten speichern möchten, während sie Flexibilität und Kontrolle über
die Speicherparameter beibehalten.

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.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, in dem Daten gespeichert werden.

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) 

Speichern Sie Ihre Bilddaten einfach in einen angegebenen Stream im gewünschten Dateiformat
mit dieser praktischen Methode. Egal, ob Sie mit JPEG, PNG oder einem anderen Format arbeiten,
stellt diese Funktion sicher, dass Ihre Bilddaten effizient und genau gespeichert werden,
was sie ideal für Entwickler macht, die ihre Dateispeicherungsprozesse optimieren möchten.

Parameters:

ParameterTypBeschreibung
Stream_io.BufferedRandomDer Stream, in dem die Bilddaten gespeichert werden.
options_baseImageOptionsBaseDie Speicheroptionen.
bounds_rectangleRectangleDas Zielrechteck der Bildgrenzen. Setzen Sie das leere Rechteck, um Quellgrenzen zu verwenden.

See also:

Example # 1: The following example loads a DICOM image from a file, then saves the image t…

Method: save_all(file_path, options)

 save_all(file_path, options) 

Bewahren Sie die Daten des Objekts, indem Sie sie in die festgelegte Datei (Indexer + Dateiname)
speichern, zusammen mit dem angegebenen Dateiformat und Optionen. Ideal für Entwickler, die
Daten sicher in verschiedenen Formaten speichern möchten, während sie Flexibilität und Kontrolle über
die Speicherparameter beibehalten.

Parameters:

ParameterTypBeschreibung
file_pathstringDer Dateipfad.
optionsImageOptionsBaseDie Optionen.

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 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 dieses RasterImage präzise mit dieser
unkomplizierten Methode an. Ideal für Entwickler, die die Bildauflösung an
spezifische Anforderungen anpassen möchten, um optimale Anzeigequalität und Dateigrößenverwaltung zu gewährleisten.

Parameters:

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

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

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

Parameters:

ParameterTypBeschreibung
metadataIImageMetadataFormatDie Metadaten.

Returns

TypBeschreibung
boolWahr, wenn metadata nicht null ist und die Instanz von IMetadataContainer
unterstützt und/oder eine Instanz von IImageMetadataFormat implementiert; andernfalls falsch.

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

Schreibt die gesamte Scanzeile in den angegebenen Scanzeilen‑Index.

Parameters:

ParameterTypBeschreibung
scan_line_indexintNullbasierter Index der Scan-Zeile.
argb_32_pixelsint[]Das 32‑Bit‑ARGB‑Farben‑Array zum Schreiben.

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

Schreibt die gesamte Scanzeile in den angegebenen Scanzeilen‑Index.

Parameters:

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

Examples

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

from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp"
# Laden Sie ein DICOM‑Bild aus einem Dateistream.
with open(join(dir_, "sample.dicom"), "rb") as stream:
	with DicomImage(stream) as dicom_image:
		# Speichern Sie jede Seite als einzelnes PNG‑Bild.
		for dicom_page in dicom_image.dicom_pages:
			# Generieren Sie einen Dateinamen basierend auf dem Seitenindex.
			file_name = "sample.{0}.png".format(dicom_page.index)
			# Eine DICOM‑Seite ist ein Rasterbild, daher sind alle zulässigen Operationen mit einem Rasterbild auf eine DICOM‑Seite anwendbar.
			dicom_page.save(join(dir_, file_name), PngOptions())

This example shows how to load a DICOM image from a file stream to stay within the specified memory limit.

from aspose.imaging import LoadOptions, Image
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.dicom import DicomImage
from os.path import join as path_join


dir_: str = "c:\\temp"
# Laden Sie ein DICOM‑Bild aus einem Dateistream.
with open(path_join(dir_, "multiframe.dicom"), "rb") as stream:
	# Die maximal zulässige Größe für alle internen Puffer beträgt 256 KB.
	load_options = LoadOptions()
	load_options.buffer_size_hint = 256 * 1024
	with DicomImage(stream, load_options) as dicom_image:
		# Speichern Sie jede Seite als einzelnes PNG‑Bild.
		for dicom_page in dicom_image.dicom_pages:
			# Generieren Sie einen Dateinamen basierend auf dem Seitenindex.
			file_name = "multiframe.{0}.png".format(dicom_page.index)
			# Eine DICOM‑Seite ist ein Rasterbild, daher sind alle zulässigen Operationen mit einem Rasterbild auf eine DICOM‑Seite anwendbar.
			dicom_page.save(path_join(dir_, file_name), PngOptions())

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


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

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

The following example loads a DICOM image from a file, then saves the image to a PNG file stream.


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

dir_: str = "c:\\temp"
with aspycore.as_of(Image.load(join(dir_, "sample.dicom")), DicomImage) as image:
	save_options = PngOptions()
	bounds = Rectangle(0, 0, image.width // 2, image.height // 2)
	with open(join(dir_, "output.png"), "wb") as output_stream:
		# Speichern Sie das obere linke Viertel des Bildes in einen Dateistream.
		image.save(output_stream, save_options, bounds)

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


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


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

The following example crops a DICOM image. The cropping area is specified via Left, Top, Right, Bottom margins.

from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = r"c:\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Erneut zuschneiden. Setzen Sie einen Rand von 10 % der Bildgröße.
	horizontal_margin = dicom_image.width // 10
	vertical_margin = dicom_image.height // 10
	dicom_image.crop(horizontal_margin, horizontal_margin, vertical_margin, vertical_margin)
	# Speichern Sie das zugeschnittene Bild als PNG.
	dicom_image.save(join(dir_, "sample.Crop.png"), PngOptions())

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

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.dicom import DicomImage
from os.path import join

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

The following example binarizes a DICOM image with Bradley’s adaptive thresholding algorithm with the specified window size. Binarized images contain only 2 colors - black and white.


from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Binarisieren Sie das Bild mit einem Helligkeitsunterschied von 5. Die Helligkeit ist die Differenz zwischen einem Pixel und dem Durchschnitt eines 10 × 10‑Fensters von Pixeln, das um diesen Pixel zentriert ist.
	dicom_image.binarize_bradley(5, 10)
	dicom_image.save(join(dir_, "sample.BinarizeBradley5_10x10.png"), PngOptions())

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

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join


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

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


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

The following example performs brightness correction of a DICOM image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

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

The following example performs contrast correction of a DICOM image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import DicomImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.dicom")) as image:
	dicom_image = aspycore.as_of(image, DicomImage)
	# Setzen Sie den Kontrastwert. Die zulässigen Kontrastwerte liegen im Bereich [-100f, 100f].
	dicom_image.adjust_contrast(50.0)
	dicom_image.save(join(dir_, "sample.AdjustContrast.png"), PngOptions())

Use JPEG compression in DICOM image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.imageoptions import JpegOptions, DicomOptions
from aspose.imaging.fileformats.jpeg import JpegCompressionMode, SampleRoundingMode
from aspose.imaging.imageoptions import DicomOptions
from aspose.imaging.fileformats.dicom import Compression, ColorType, CompressionType

with Image.load("original.jpg") as input_image:
	obj_init = JpegOptions()
	obj_init.compression_type = JpegCompressionMode.BASELINE
	obj_init.sample_rounding_mode = SampleRoundingMode.TRUNCATE
	obj_init.quality = 50
	obj_init2 = Compression()
	obj_init2.type = CompressionType.JPEG
	obj_init2.jpeg = obj_init
	options = DicomOptions()
	options.color_type = ColorType.RGB_24_BIT
	options.compression = obj_init2
	input_image.save("original_JPEG.dcm", options)

Use JPEG 2000 compression in DICOM image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.imageoptions import Jpeg2000Options, DicomOptions
from aspose.imaging.fileformats.jpeg2000 import Jpeg2000Codec, Compression, CompressionType, ColorType

with Image.load("original.jpg") as input_image:
	obj_init = Jpeg2000Options()
	obj_init.codec = Jpeg2000Codec.JP2
	obj_init.irreversible = False
	obj_init2 = Compression()
	obj_init2.type_ = CompressionType.JPEG2000
	obj_init2.jpeg2000 = obj_init
	options = DicomOptions()
	options.color_type = ColorType.RGB_24_BIT
	options.compression = obj_init2
	input_image.save("original_JPEG2000.dcm", options)

Use RLE compression in DICOM image.


from aspose.imaging import Image
from aspose.imaging.fileformats.dicom import Compression, CompressionType, ColorType
from aspose.imaging.imageoptions import DicomOptions

with Image.load("original.jpg") as input_image:
	compr = Compression()
	compr.type_ = CompressionType.RLE
	options = DicomOptions()
	options.color_type = ColorType.RGB_24_BIT
	options.compression = compr
	input_image.save("original_RLE.dcm", options)

Change the color type in DICOM compression.


from aspose.imaging import Image
from aspose.imaging.imageoptions import DicomOptions
from aspose.imaging.fileformats.dicom import ColorType

with Image.load("original.jpg") as inputImage:
	options = DicomOptions()
	options.color_type = ColorType.GRAYSCALE_8_BIT
	inputImage.save("original_8Bit.dcm", options)