CmxImage Klasse

Summary: The API for Corel Metafile Exchange (CMX) vector image format with metadata
descriptions support is a comprehensive solution for developers working
with CMX files. This API allows for the seamless loading of CMX images,
extracting metadata such as bits per pixel, object dimensions, and more.
With additional functionalities like resizing, rotating, setting
palettes, and converting to other formats, this API empowers developers
to efficiently manipulate and customize CMX vector images to meet their
specific application requirements.

Module: aspose.imaging.fileformats.cmx

Full Name: aspose.imaging.fileformats.cmx.CmxImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, IMultipageImage, ICmxImage, VectorMultipageImage

Constructors

Name	Beschreibung
CmxImage(stream_container, load_options)	Beginnen Sie, mit der CmxImage Klasse nahtlos zu arbeiten, indem Sie eine neue Instanz mit den Parametern streamContainer und loadOptions initialisieren. Ideal für Entwickler die eine bequeme Möglichkeit suchen, CMX-Bilder aus verschiedenen Datenquellen zu laden, während sie den Ladevorgang nach Bedarf anpassen.

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	Rufen Sie die Bit‑Tiefe des Bildes mühelos über diese benutzerfreundliche Eigenschaft ab. Ideal für Entwickler, die den Detailgrad oder die Farbtiefe ihrer Bilder bestimmen möchten, um eine genaue Verarbeitung und Manipulation sicherzustellen.
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.
cmx_page	CmxPage	r	Rufen Sie die CMX‑Seite des Bildes mühelos über diese intuitive Eigenschaft ab. Ideal für Entwickler, die schnellen Zugriff auf einzelne Seiten innerhalb von CMX‑Bildern benötigen, um eine effiziente Navigation und Verwaltung zu gewährleisten.
container	Image	r	Liest den Image Container.
data_stream_container	StreamContainer	r	Liest den Datenstrom des Objekts.
default_page	Image	r	Rufen Sie die Standardseite des Bildes mühelos über diese intuitive Eigenschaft ab. Ideal für Entwickler, die schnellen Zugriff auf die Hauptseite ihres Bildes benötigen, um eine effiziente Navigation und Verwaltung zu gewährleisten.
freigegeben	bool	r	Liest einen Wert, der angibt, ob diese Instanz freigegeben ist.
document	CmxDocument	r	Rufen Sie das CMX‑Dokument mühelos über diese intuitive Eigenschaft ab. Ideal für Entwickler, die CMX‑Bilder zugreifen oder ändern möchten, um Flexibilität und Effizienz in ihren Anwendungen zu gewährleisten.
exif_data	ExifData	r/w	Liest oder setzt die Exif‑Instanz.
file_format	FileFormat	r	Rufen Sie das Dateiformat des Bildes mühelos über diese benutzerfreundliche Eigenschaft ab. Ideal für Entwickler, die das Format ihrer Bilder dynamisch bestimmen möchten, um Kompatibilität und eine genaue Verarbeitung in ihren Anwendungen sicherzustellen.
has_background_color	bool	r/w	Liest oder setzt einen Wert, der angibt, ob das Bild eine Hintergrundfarbe hat.
height	int	r	Liest die Bildhöhe.
height_f	float	r	Ermitteln Sie die Höhe des Objekts, gemessen in Zoll, mühelos über diese benutzerfreundliche Eigenschaft. Ideal für Entwickler, die präzise Dimensionierungsinformationen für ein effektives Layout und die Präsentation in ihren Anwendungen benötigen.
interrupt_monitor	InterruptMonitor	r/w	Liest oder setzt den Interrupt-Monitor.
is_cached	bool	r	Bestimmen Sie, ob die Daten des Objekts derzeit im Cache sind, wodurch das Lesen von Daten entfällt. Ideal für Entwickler, die die Leistung optimieren möchten, indem sie zwischengespeicherte Daten effizient nutzen, um einen schnelleren Zugriff auf Objektinformationen zu gewährleisten.
metadata	ImageMetadata	r	Gibt die Metadaten des Bildes zurück.
page_count	int	r	Rufen Sie die Gesamtseitenzahl des Bildes über diese intuitive Eigenschaft ab. Ideal für Entwickler, die mehrseitige Bilder dynamisch verwalten möchten, um eine effiziente Navigation und Manipulation des Bildinhalts zu gewährleisten.
pages	Image[]	r	Rufen Sie die Seiten des Bildes nahtlos über diese intuitive Eigenschaft ab. Ideal für Entwickler, die auf einzelne Seiten innerhalb mehrseitiger Bilder zugreifen und diese manipulieren möchten, um eine effiziente Navigation und Verarbeitung zu gewährleisten.
palette	IColorPalette	r/w	Liest oder setzt die Farbpalette. Die Farbpalette wird nicht verwendet, wenn Pixel direkt dargestellt werden.
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	Liest die Bildbreite.
width_f	float	r	Rufen Sie die Breite des Objekts in Zoll über diese intuitive Eigenschaft ab. Ideal für Entwickler, die präzise Messungen von Objekten in ihren Anwendungen benötigen, um ein genaues Layout und eine korrekte Präsentation zu gewährleisten.
xmp_data	XmpPacketWrapper	r/w	Liest oder setzt XMP-Daten.

Methods

Name	Beschreibung
cache_data()	Cache die Daten, um zusätzliches Laden aus der zugrunde liegenden Quelle zu verhindern DataStreamSupporter.data_stream_container mit dieser praktischen Methode. Ideal für Entwickler, die die Leistung optimieren möchten indem sie Daten vorab laden, um einen schnelleren Zugriff und einen reibungsloseren Betrieb in ihren Anwendungen zu gewährleisten.
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)	Passen Sie die Farbpalette des Bildes mit dieser intuitiven Methode an. Ideal für Entwickler, die spezifische Farbschemata oder Anpassungen dynamisch anwenden möchten, um eine präzise Kontrolle über das visuelle Erscheinungsbild ihrer Bilder zu gewährleisten.
try_set_metadata(metadata)	Versucht, eine metadata-Instanz zu setzen, falls diese Image‑Instanz unterstützt und eine IImageMetadataFormat‑Instanz implementiert.

Constructor: CmxImage(stream_container, load_options)

 CmxImage(stream_container, load_options) 

Beginnen Sie, mit der CmxImage Klasse nahtlos zu arbeiten, indem Sie
eine neue Instanz mit den Parametern streamContainer und loadOptions initialisieren. Ideal für Entwickler
die eine bequeme Möglichkeit suchen, CMX-Bilder aus verschiedenen Datenquellen zu laden, während
sie den Ladevorgang nach Bedarf anpassen.

Parameters:

Parameter	Typ	Beschreibung
stream_container	StreamContainer	Der Stream-Container.
load_options	LoadOptions	Die Ladeoptionen.

Property: pages

Rufen Sie die Seiten des Bildes nahtlos über diese intuitive Eigenschaft ab.
Ideal für Entwickler, die auf einzelne Seiten
innerhalb mehrseitiger Bilder zugreifen und diese manipulieren möchten, um eine effiziente Navigation und Verarbeitung zu gewährleisten.

See also:

Example # 1: The following example shows how to cache all pages of a CMX image.

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.

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) 

Passen Sie die Farbpalette des Bildes mit dieser intuitiven Methode an. Ideal für
Entwickler, die spezifische Farbschemata oder Anpassungen dynamisch anwenden möchten,
um eine präzise Kontrolle über das visuelle Erscheinungsbild ihrer Bilder zu gewährleisten.

Parameters:

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

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

The following example shows how to cache all pages of a CMX image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.cmx import CmxImage
from os.path import join

dir_: str = "c:\\temp"
# Laden Sie ein Bild aus einer CMX-Datei.
with aspycore.as_of(Image.load(join(dir_, "sample.cmx")), CmxImage) as image:
	# Dieser Aufruf cached nur die Standardseite.
	image.cache_data()
	# Cache alle Seiten, sodass kein zusätzliches Laden von Daten aus dem zugrunde liegenden Datenstrom durchgeführt wird.
	for page in image.pages:
		page.cache_data()