OdgImage Klasse

Summary: Manipulate OpenDocument Graphic (ODG) vector image file format with our API, widely
used by OpenOffice and LibreOffice Draw applications for storing drawing elements in
a vector format. Seamlessly parse documents, access pages, resize and rotate images,
ensuring efficient processing and customization of ODG files to meet your
specific requirements.

Module: aspose.imaging.fileformats.opendocument

Full Name: aspose.imaging.fileformats.opendocument.OdgImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, IMultipageImage, OdImage

Constructors

Name	Beschreibung
OdgImage(stream_container)	Entwickelt für nahtlose Integration in Softwarelösungen, initialisiert der OdgImage Konstruktor eine neue Instanz unter Verwendung eines Stream-Containers. Diese Methode gewährleistet eine effiziente Handhabung von ODG-Bilddaten in Softwareumgebungen, optimiert die Ressourcennutzung und ermöglicht optimierte Bildverarbeitungs-Workflows.
OdgImage(stream_container, options)	Starten Sie die Erstellung eines neuen OdgImage Klassenobjekts mit dem Beginn einer frischen Instanz. Nutzen Sie das Potenzial eines Stream-Containers in Kombination mit Ladeoptionen, um einen vielseitigen Konstruktor zu erhalten, der Bilder nahtlos lädt. Dieser Konstruktor ermöglicht eine effiziente Bildverarbeitung und bietet anpassbare Ladekonfigurationen für verbesserte Anpassungsfähigkeit und Leistung in verschiedenen Szenarien.

Properties

Name	Type	Access	Beschreibung
auto_adjust_palette	bool	r/w	Liest oder setzt einen Wert, der angibt, ob die automatische Anpassung der Palette erfolgt.
background_color	Color	r/w	Liest oder setzt einen Wert für die Hintergrundfarbe.
bits_per_pixel	int	r	Gibt die Anzahl der Bits pro Pixel für das Bild zurück. Diese Eigenschaft liefert Einblick in das Detailniveau und die Farbtiefe des Bildes und unterstützt verschiedene Bildverarbeitungsaufgaben und Optimierungen.
bounds	Rectangle	r	Liest die Objektgrenzen.
buffer_size_hint	int	r/w	Liest oder setzt den Hinweis zur Puffergröße, der die maximal zulässige Größe für alle internen Puffer definiert.
container	Image	r	Liest den Image Container.
data_stream_container	StreamContainer	r	Liest den Datenstrom des Objekts.
default_page	Image	r	Gibt die Standardseite zurück, die dem Bild zugeordnet ist, und bietet essentiellen Zugriff auf die Hauptseite innerhalb der Bildsammlung. Diese Eigenschaft vereinfacht die Navigation und Manipulation von Bilddaten und erhöht die Effizienz von Softwareentwicklungs- Workflows.
freigegeben	bool	r	Liest einen Wert, der angibt, ob diese Instanz freigegeben ist.
exif_data	ExifData	r/w	Liest oder setzt die Exif‑Instanz.
file_format	FileFormat	r	Gibt einen Wert des Dateiformats zurück
has_background_color	bool	r/w	Liest oder setzt einen Wert, der angibt, ob das Bild eine Hintergrundfarbe hat.
height	int	r	Liefert die Objekt­höhe.
height_f	float	r	Liefert die Objekthöhe in Zoll.
interrupt_monitor	InterruptMonitor	r/w	Liest oder setzt den Interrupt-Monitor.
is_cached	bool	r	Ermittelt einen booleschen Wert, der angibt, ob die Daten des Objekts derzeit zwischengespeichert sind, wodurch ein erneutes Lesen der Daten entfällt. Diese Eigenschaft dient als Optimierungsindikator und verbessert die Leistung, indem redundante Datenzugriffs- operationen minimiert werden.
metadata	OdMetadata	r	Gibt Metadaten zurück, die spezifisch für OpenDocument-Dateien sind. Diese Eigenschaft ermöglicht Zugriff auf wesentliche Informationen, die in OD-Dateien eingebettet sind, und unterstützt verschiedene Vorgänge wie Extraktion, Modifikation oder Analyse von Metadaten.
page_count	int	r	Gibt die Gesamtzahl der Seiten im Bild zurück. Diese Eigenschaft ist für Anwendungen, die mehrseitige Bilder verwalten, unverzichtbar, da sie die genaue Bestimmung der verfügbaren Seiten für Verarbeitung oder Anzeige ermöglicht.
pages	Image[]	r	Durch das Abrufen der Seitensammlung ermöglicht diese Eigenschaft den Zugriff auf die Gesamtheit der mit einem Bild verbundenen Seiten. Durch den Zugriff auf diese Eigenschaft können Entwickler durch einzelne Seiten iterieren, bestimmte Seiten anhand ihres Index abrufen oder Batch-Operationen auf die gesamte Sammlung ausführen.
palette	IColorPalette	r/w	Liest oder setzt die Farbpalette. Die Farbpalette wird nicht verwendet, wenn Pixel direkt dargestellt werden.
records	OdObject[]	r	Gibt die im Bild gespeicherten OpenDocument-Datensätze zurück. Diese Eigenschaft gewährt Zugriff auf spezifische strukturierte Datenelemente, die in OpenDocument-Dateien eingebettet sind, und erleichtert das Abrufen oder die Manipulation relevanter Informationen für weitere Verarbeitung oder Analyse.
size	Size	r	Liest die Objektgröße.
size_f	SizeF	r	Liefert die Objektgröße in Zoll.
use_palette	bool	r	Liest einen Wert, der angibt, ob die Bildpalette verwendet wird.
width	int	r	Liefert die Objekt­breite.
width_f	float	r	Liefert die Objektbreite in Zoll.
xmp_data	XmpPacketWrapper	r/w	Liest oder setzt XMP-Daten.

Methods

Name	Beschreibung
cache_data()	Zwischenspeichert die Daten und stellt sicher, dass keine zusätzlichen Datenladungen vom zugrunde liegenden DataStreamSupporter.data_stream_container durchgeführt werden.
can_load(file_path)	Bestimmt, ob das Bild vom angegebenen Dateipfad geladen werden kann.
can_load(file_path, load_options)	Bestimmt, ob das Bild vom angegebenen Dateipfad geladen werden kann und optional die angegebenen Öffnungsoptionen verwendet.
can_load(stream)	Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann.
can_load(stream, load_options)	Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann und optional die angegebenen loadOptions verwendet.
can_load_stream(stream)	Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann.
can_load_stream_with_options(stream, load_options)	Bestimmt, ob das Bild vom angegebenen Stream geladen werden kann und optional die angegebenen loadOptions verwendet.
can_load_with_options(file_path, load_options)	Bestimmt, ob das Bild vom angegebenen Dateipfad geladen werden kann und optional die angegebenen Öffnungsoptionen verwendet.
can_save(options)	Bestimmt, ob das Bild im angegebenen Dateiformat, das durch die übergebenen Speicheroptionen repräsentiert wird, gespeichert werden kann.
create(files)	Erstellt das mehrseitige Bild, das die angegebenen Dateien enthält.
create(files, throw_exception_on_load_error)	Erstellt das mehrseitige Bild, das die angegebenen Dateien enthält.
create(image_options, width, height)	Erstellt ein neues Bild mit den angegebenen Erstellungsoptionen.
create(image_options, width, height, pixels)	Erstellt eine RasterImage Instanz aus dem bereitgestellten Pixelarray. Validiert, dass die angegebene Breite und Höhe den Abmessungen der Pixeldaten entsprechen. Diese Methode kann nur verwendet werden, wenn die Bibliothek im lizenzierten Modus ist.
create(images)	Erstellt ein neues Bild, das die angegebenen Bilder als Seiten verwendet
create(images, dispose_images)	Erstellt ein neues Bild, wobei die angegebenen Bilder als Seiten verwendet werden.
create(multipage_create_options)	Erstellt die angegebenen Mehrseiten‑Erstellungsoptionen.
create_from_files(files)	Erstellt das Mehrseiten‑Bild, das die angegebenen Dateien als Lazy‑Loading‑Seiten enthält.
create_from_files(files, throw_exception_on_load_error)	Erstellt das Mehrseiten‑Bild, das die angegebenen Dateien als Lazy‑Loading‑Seiten enthält.
create_from_images(images)	Erstellt ein neues Bild, das die angegebenen Bilder als Seiten verwendet
create_from_images(images, dispose_images)	Erstellt ein neues Bild, wobei die angegebenen Bilder als Seiten verwendet werden.
crop(left_shift, right_shift, top_shift, bottom_shift)	Bild mit Verschiebungen zuschneiden.
crop(rectangle)	Schneidet das angegebene Rechteck zu.
get_default_options(args)	Liefert die Standard-Bildeinstellungen.
get_embedded_images()	Liefert die eingebetteten Bilder.
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_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_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.
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_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.
remove_background()	Entfernt den Hintergrund.
remove_background(settings)	Entfernt den Hintergrund.
remove_metadata()	Entfernt Metadaten.
resize(new_width, new_height)	Skaliert das Bild. Der Standardwert ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.
resize(new_width, new_height, resize_type)	Skaliert das Bild.
resize(new_width, new_height, settings)	Skaliert das Bild.
resize_by_settings(new_width, new_height, settings)	Skaliert das Bild.
resize_by_type(new_width, new_height, resize_type)	Skaliert das Bild.
resize_height_proportionally(new_height)	Skaliert die Höhe proportional. Der Standard ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.
resize_height_proportionally(new_height, resize_type)	Skaliert die Höhe proportional.
resize_height_proportionally(new_height, settings)	Skaliert die Höhe proportional.
resize_height_proportionally_settings(new_height, settings)	Skaliert die Höhe proportional.
resize_width_proportionally(new_width)	Skaliert die Breite proportional. Der Standard ResizeType.NEAREST_NEIGHBOUR_RESAMPLE wird verwendet.
resize_width_proportionally(new_width, resize_type)	Skaliert die Breite proportional.
resize_width_proportionally(new_width, settings)	Skaliert die Breite proportional.
resize_width_proportionally_settings(new_width, settings)	Skaliert die Breite proportional.
rotate(angle)	Bild um das Zentrum drehen.
rotate_flip(rotate_flip_type)	Dreht, spiegelt oder dreht und spiegelt das Bild.
save()	Speichert die Bilddaten in den zugrunde liegenden Stream.
save(file_path)	Speichert das Bild am angegebenen Dateipfad.
save(file_path, options)	Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.
save(file_path, options, bounds_rectangle)	Speichert die Daten des Objekts am angegebenen Speicherort im angegebenen Dateiformat gemäß den Speicheroptionen.
save(file_path, over_write)	Speichert die Daten des Objekts am angegebenen Speicherort.
save(stream)	Speichert die Daten.
save(stream, options_base)	Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.
save(stream, options_base, bounds_rectangle)	Speichert die Bilddaten in den angegebenen Stream im angegebenen Dateiformat gemäß den Speicheroptionen.
save_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_palette(palette, update_colors)	Setzt die Bildpalette.
try_set_metadata(metadata)	Versucht, eine metadata-Instanz zu setzen, falls diese Image‑Instanz unterstützt und eine IImageMetadataFormat‑Instanz implementiert.

Constructor: OdgImage(stream_container)

 OdgImage(stream_container) 

Entwickelt für nahtlose Integration in Softwarelösungen, initialisiert der OdgImage
Konstruktor eine neue Instanz unter Verwendung eines Stream-Containers. Diese Methode
gewährleistet eine effiziente Handhabung von ODG-Bilddaten in Softwareumgebungen, optimiert
die Ressourcennutzung und ermöglicht optimierte Bildverarbeitungs-Workflows.

Parameters:

Parameter	Typ	Beschreibung
stream_container	StreamContainer	Der Stream-Container.

Constructor: OdgImage(stream_container, options)

 OdgImage(stream_container, options) 

Starten Sie die Erstellung eines neuen OdgImage Klassenobjekts mit
dem Beginn einer frischen Instanz. Nutzen Sie das Potenzial eines Stream-Containers in Kombination
mit Ladeoptionen, um einen vielseitigen Konstruktor zu erhalten, der Bilder nahtlos lädt. Dieser Konstruktor ermöglicht eine effiziente Bildverarbeitung und bietet anpassbare
Ladekonfigurationen für verbesserte Anpassungsfähigkeit und Leistung in verschiedenen Szenarien.

Parameters:

Parameter	Typ	Beschreibung
stream_container	StreamContainer	Der Stream.
options	LoadOptions	Die Ladeoptionen

Method: can_load(file_path) [static]

 can_load(file_path) 

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

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad.

Returns

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

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_load(stream) [static]

 can_load(stream) 

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

Parameters:

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

Returns

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

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

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

Parameters:

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

Returns

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

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

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

Parameters:

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

Returns

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

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

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

Method: can_save(options)

 can_save(options) 

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

Parameters:

Parameter	Typ	Beschreibung
options	ImageOptionsBase	Die zu verwendenden Speicheroptionen.

Returns

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

Method: create(files) [static]

 create(files) 

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

Parameters:

Parameter	Typ	Beschreibung
Dateien	string[]	Die Dateien.

Returns

Typ	Beschreibung
Image	Das mehrseitige Bild

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

Typ	Beschreibung
Image	Das mehrseitige Bild

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

 create(image_options, width, height) 

Erstellt ein neues Bild mit den angegebenen Erstellungsoptionen.

Parameters:

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

Returns

Typ	Beschreibung
Image	Das neu erstellte Bild.

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

 create(image_options, width, height, pixels) 

Erstellt eine RasterImage Instanz aus dem bereitgestellten Pixelarray.

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

Parameters:

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

Returns

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

Method: create(images) [static]

 create(images) 

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

Parameters:

Parameter	Typ	Beschreibung
images	Image[]	Die Bilder.

Returns

Typ	Beschreibung
Image	Das Bild als IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

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

Parameters:

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

Returns

Typ	Beschreibung
Image	Das Bild als IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Erstellt die angegebenen Mehrseiten‑Erstellungsoptionen.

Parameters:

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

Returns

Typ	Beschreibung
Image	Das mehrseitige Bild

Method: create_from_files(files) [static]

 create_from_files(files) 

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

Parameters:

Parameter	Typ	Beschreibung
Dateien	string[]	Die Dateien.

Returns

Typ	Beschreibung
Image	Das mehrseitige Bild

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

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

Parameters:

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

Returns

Typ	Beschreibung
Image	Das mehrseitige Bild

Method: create_from_images(images) [static]

 create_from_images(images) 

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

Parameters:

Parameter	Typ	Beschreibung
images	Image[]	Die Bilder.

Returns

Typ	Beschreibung
Image	Das Bild als IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

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

Parameters:

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

Returns

Typ	Beschreibung
Image	Das Bild als IMultipageImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Bild mit Verschiebungen zuschneiden.

Parameters:

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

Method: crop(rectangle)

 crop(rectangle) 

Schneidet das angegebene Rechteck zu.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das Rechteck.

Method: get_default_options(args)

 get_default_options(args) 

Liefert die Standard-Bildeinstellungen.

Parameters:

Parameter	Typ	Beschreibung
args	System.Object	Die Argumente.

Returns

Typ	Beschreibung
ImageOptionsBase	Die Standard-Bildeinstellungen.

Method: get_embedded_images()

 get_embedded_images() 

Liefert die eingebetteten Bilder.

Returns

Typ	Beschreibung
EmbeddedImage[]	Array von Bildern

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Liefert das Dateiformat.

Parameters:

Parameter	Typ	Beschreibung
file_path	string	Der Dateipfad.

Returns

Typ	Beschreibung
FileFormat	Das ermittelte Dateiformat.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Liefert das Dateiformat.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream.

Returns

Typ	Beschreibung
FileFormat	Das ermittelte Dateiformat.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Liefert das Dateiformat.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der Stream.

Returns

Typ	Beschreibung
FileFormat	Das ermittelte Dateiformat.

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

 get_fitting_rectangle(rectangle, pixels, width, height) 

Liefert das Rechteck, das zum aktuellen Bild passt.

Parameters:

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

Returns

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

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

 get_fitting_rectangle(rectangle, width, height) 

Liefert das Rechteck, das zum aktuellen Bild passt.

Parameters:

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

Returns

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

Method: get_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

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

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

 get_proportional_height(width, height, new_width) 

Liefert eine proportionale Höhe.

Parameters:

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

Returns

Typ	Beschreibung
int	Die proportionale Höhe.

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

 get_proportional_width(width, height, new_height) 

Liefert eine proportionale Breite.

Parameters:

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

Returns

Typ	Beschreibung
int	Die proportionale Breite.

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

Konvertiert zu aps.

Parameters:

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

Returns

Typ	Beschreibung
_io.BufferedRandom	Der serialisierte Stream

Method: load(file_path) [static]

 load(file_path) 

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

Parameters:

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

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

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

Parameters:

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

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load(stream) [static]

 load(stream) 

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

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

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

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

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load_stream(stream) [static]

 load_stream(stream) 

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

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

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

Lädt ein neues Bild aus dem angegebenen Stream.

Parameters:

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

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

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

Parameters:

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

Returns

Typ	Beschreibung
Image	Das geladene Bild.

Method: remove_background(settings)

 remove_background(settings) 

Entfernt den Hintergrund.

Parameters:

Parameter	Typ	Beschreibung
settings	RemoveBackgroundSettings	Die Einstellungen.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

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

Parameters:

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

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Skaliert das Bild.

Parameters:

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

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Skaliert das Bild.

Parameters:

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

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Skaliert das Bild.

Parameters:

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

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

Skaliert das Bild.

Parameters:

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

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

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

Parameters:

Parameter	Typ	Beschreibung
new_height	int	Die neue Höhe.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Skaliert die Höhe proportional.

Parameters:

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

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Skaliert die Höhe proportional.

Parameters:

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

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

Skaliert die Höhe proportional.

Parameters:

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

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

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

Parameters:

Parameter	Typ	Beschreibung
new_width	int	Die neue Breite.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Skaliert die Breite proportional.

Parameters:

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

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Skaliert die Breite proportional.

Parameters:

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

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

Skaliert die Breite proportional.

Parameters:

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

Method: rotate(angle)

 rotate(angle) 

Bild um das Zentrum drehen.

Parameters:

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

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Dreht, spiegelt oder dreht und spiegelt das Bild.

Parameters:

Parameter	Typ	Beschreibung
rotate_flip_type	RotateFlipType	Typ der Dreh- und Spiegelung.

See also:

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

Method: save(file_path)

 save(file_path) 

Speichert das Bild am angegebenen Dateipfad.

Parameters:

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

Method: save(file_path, options)

 save(file_path, options) 

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

Parameters:

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

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

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

Parameters:

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

Method: save(file_path, over_write)

 save(file_path, over_write) 

Speichert die Daten des Objekts am angegebenen Speicherort.

Parameters:

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

Method: save(stream)

 save(stream) 

Speichert die Daten.

Parameters:

Parameter	Typ	Beschreibung
Stream	_io.BufferedRandom	Der 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:

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

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_to_stream(stream)

 save_to_stream(stream) 

Speichert die Daten des Objekts in den angegebenen Stream.

Parameters:

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

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

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

Parameters:

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

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

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

Parameters:

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

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

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

Parameters:

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

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

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

Parameters:

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

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Setzt die Bildpalette.

Parameters:

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

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

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

Parameters:

Parameter	Typ	Beschreibung
metadata	IImageMetadataFormat	Die Metadaten.

Returns

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

Examples

This example loads a ODG 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.opendocument import OdImage
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.odg")), OdImage) as image:
		image.rotate_flip(rotate_flip_type)
		image.save(join(dir_, "sample." + rotate_flip_type + ".png"), PngOptions())

The following example shows how to export a FODG (Flat XML ODF Template) image to PDF format.

from os.path import join
import aspose.pycore as aspycore
from aspose.imaging import Image, Color, SizeF
from aspose.imaging.fileformats.tiff import TiffImage
from aspose.imaging.imageoptions import OdgRasterizationOptions, PdfOptions

dir_: str = "c:\\aspose.imaging\\issues\\net\\3635"
input_file_name: str = join(dir_, "VariousObjectsMultiPage.fodg")
output_file_name: str = input_file_name + ".pdf"
with Image.load(input_file_name) as image:
	rasterization_options = OdgRasterizationOptions()
	rasterization_options.background_color = Color.white
	rasterization_options.page_size = aspycore.cast(SizeF, image.size)
	save_options = PdfOptions()
	save_options.vector_rasterization_options = rasterization_options
	image.save(output_file_name, save_options)