Classe CmxImage

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	Description
CmxImage(stream_container, load_options)	Commencez à travailler avec la classe CmxImage de manière fluide en initialisant une nouvelle instance avec les paramètres streamContainer et loadOptions. Idéal pour les développeurs cherchant un moyen pratique de charger des images CMX à partir de diverses sources de données tout en personnalisant le processus de chargement selon les besoins.

Properties

Name	Type	Access	Description
auto_adjust_palette	bool	r/w	Obtient ou définit une valeur indiquant si la palette d’ajustement automatique est activée.
background_color	Color	r/w	Obtient ou définit une valeur pour la couleur d’arrière-plan.
bits_per_pixel	int	r	Récupérez la profondeur de couleur de l’image sans effort grâce à cette propriété conviviale. Idéal pour les développeurs souhaitant déterminer le niveau de détail ou la profondeur de couleur présent dans leurs images, garantissant un traitement et une manipulation précis.
bounds	Rectangle	r	Obtient les limites de l’objet.
buffer_size_hint	int	r/w	Obtient ou définit l’indice de taille du tampon, qui correspond à la taille maximale autorisée pour tous les tampons internes.
cmx_page	CmxPage	r	Récupérez sans effort la page CMX de l’image grâce à cette propriété intuitive. Idéal pour les développeurs recherchant un accès rapide aux pages individuelles des images CMX, assurant une navigation et une gestion efficaces.
container	Image	r	Obtient le conteneur Image.
data_stream_container	StreamContainer	r	Obtient le flux de données de l’objet.
default_page	Image	r	Récupérez sans effort la page par défaut de l’image grâce à cette propriété intuitive. Idéal pour les développeurs recherchant un accès rapide à la page principale de leur image, assurant une navigation et une gestion efficaces.
libéré	bool	r	Obtient une valeur indiquant si cette instance est libérée.
document	CmxDocument	r	Récupérez le document CMX sans effort grâce à cette propriété intuitive. Idéal pour les développeurs souhaitant accéder ou modifier des images CMX, garantissant flexibilité et efficacité dans leurs applications.
exif_data	ExifData	r/w	Obtient ou définit l’instance Exif.
file_format	FileFormat	r	Récupérez le format de fichier de l’image sans effort grâce à cette propriété conviviale. Idéal pour les développeurs cherchant à déterminer dynamiquement le format de leurs images, assurant compatibilité et traitement précis dans leurs applications.
has_background_color	bool	r/w	Obtient ou définit une valeur indiquant si l’image possède une couleur d’arrière-plan.
height	int	r	Obtient la hauteur de l’image.
height_f	float	r	Obtenez sans effort la hauteur de l’objet, mesurée en pouces, grâce à cette propriété conviviale. Idéal pour les développeurs recherchant des informations dimensionnelles précises pour une mise en page et une présentation efficaces dans leurs applications.
interrupt_monitor	InterruptMonitor	r/w	Obtient ou définit le moniteur d’interruption.
is_cached	bool	r	Déterminez si les données de l’objet sont actuellement en cache, éliminant le besoin de lecture des données. Idéal pour les développeurs cherchant à optimiser les performances en exploitant efficacement les données en cache, garantissant un accès plus rapide aux informations de l’objet.
metadata	ImageMetadata	r	Obtient les métadonnées de l’image.
page_count	int	r	Récupérez le nombre total de pages de l’image grâce à cette propriété intuitive. Idéal pour les développeurs souhaitant gérer dynamiquement les images multipages, assurant une navigation et une manipulation efficaces du contenu de l’image.
pages	Image[]	r	Récupérez les pages de l’image de manière fluide grâce à cette propriété intuitive. Idéal pour les développeurs souhaitant accéder et manipuler les pages individuelles des images multipages, assurant une navigation et un traitement efficaces.
palette	IColorPalette	r/w	Obtient ou définit la palette de couleurs. La palette de couleurs n’est pas utilisée lorsque les pixels sont représentés directement.
size	Size	r	Obtient la taille de l’objet.
size_f	SizeF	r	Obtient la taille de l’objet, en pouces.
use_palette	bool	r	Obtient une valeur indiquant si la palette de l’image est utilisée.
width	int	r	Obtient la largeur de l’image.
width_f	float	r	Récupérez la largeur de l’objet en pouces grâce à cette propriété intuitive. Idéal pour les développeurs recherchant des mesures précises des objets dans leurs applications, assurant une mise en page et une présentation exactes.
xmp_data	XmpPacketWrapper	r/w	Obtient ou définit les données Xmp.

Methods

Name	Description
cache_data()	Mettez en cache les données pour éviter un chargement supplémentaire depuis la source sous-jacente DataStreamSupporter.data_stream_container avec cette méthode pratique. Idéal pour les développeurs cherchant à optimiser les performances en préchargeant les données, garantissant un accès plus rapide et un fonctionnement plus fluide dans leurs applications.
can_load(file_path)	Détermine si l’image peut être chargée depuis le chemin de fichier spécifié.
can_load(file_path, load_options)	Détermine si l’image peut être chargée depuis le chemin de fichier spécifié et éventuellement en utilisant les options d’ouverture spécifiées.
can_load(stream)	Détermine si l’image peut être chargée depuis le flux spécifié.
can_load(stream, load_options)	Détermine si l’image peut être chargée depuis le flux spécifié et éventuellement en utilisant les loadOptions spécifiés.
can_load_stream(stream)	Détermine si l’image peut être chargée depuis le flux spécifié.
can_load_stream_with_options(stream, load_options)	Détermine si l’image peut être chargée depuis le flux spécifié et éventuellement en utilisant les loadOptions spécifiés.
can_load_with_options(file_path, load_options)	Détermine si l’image peut être chargée depuis le chemin de fichier spécifié et éventuellement en utilisant les options d’ouverture spécifiées.
can_save(options)	Détermine si l’image peut être enregistrée au format de fichier spécifié représenté par les options d’enregistrement fournies.
create(files)	Crée l’image multipage contenant les fichiers spécifiés.
create(files, throw_exception_on_load_error)	Crée l’image multipage contenant les fichiers spécifiés.
create(image_options, width, height)	Crée une nouvelle image en utilisant les options de création spécifiées.
create(image_options, width, height, pixels)	Crée une instance de RasterImage à partir du tableau de pixels fourni. Vérifie que la largeur et la hauteur spécifiées correspondent aux dimensions des données de pixels. Cette méthode ne peut être utilisée que lorsque la bibliothèque est en mode Licensed.
create(images)	Crée une nouvelle image en utilisant les images spécifiées comme pages
create(images, dispose_images)	Crée une nouvelle image à partir des images spécifiées en tant que pages.
create(multipage_create_options)	Crée les options de création multipage spécifiées.
create_from_files(files)	Crée l’image multipage contenant les fichiers spécifiés en tant que pages à chargement différé.
create_from_files(files, throw_exception_on_load_error)	Crée l’image multipage contenant les fichiers spécifiés en tant que pages à chargement différé.
create_from_images(images)	Crée une nouvelle image en utilisant les images spécifiées comme pages
create_from_images(images, dispose_images)	Crée une nouvelle image à partir des images spécifiées en tant que pages.
crop(left_shift, right_shift, top_shift, bottom_shift)	Recadrer l’image avec des déplacements.
crop(rectangle)	Recadre le rectangle spécifié.
get_default_options(args)	Obtient les options d’image par défaut.
get_embedded_images()	Obtient les images intégrées.
get_file_format(file_path)	Obtient le format de fichier.
get_file_format(stream)	Obtient le format de fichier.
get_file_format_of_stream(stream)	Obtient le format de fichier.
get_fitting_rectangle(rectangle, pixels, width, height)	Obtient le rectangle qui correspond à l’image actuelle.
get_fitting_rectangle(rectangle, width, height)	Obtient le rectangle qui correspond à l’image actuelle.
get_original_options()	Obtient les options basées sur les paramètres du fichier original. Cela peut être utile pour conserver la profondeur de couleur et d’autres paramètres de l’image originale inchangés. Par exemple, si nous chargeons une image PNG noir-et-blanc avec 1 bit par pixel puis l’enregistrons en utilisant la méthode DataStreamSupporter.save(file_path), une image PNG de sortie avec 8 bits par pixel sera produite. Pour éviter cela et enregistrer l’image PNG avec 1 bit par pixel, utilisez cette méthode pour obtenir les options d’enregistrement correspondantes et les transmettre à la méthode Image.save(file_path, options) en tant que deuxième paramètre.
get_proportional_height(width, height, new_width)	Obtient une hauteur proportionnelle.
get_proportional_width(width, height, new_height)	Obtient une largeur proportionnelle.
get_serialized_stream(image_options, clipping_rectangle, page_number)	Convertit en aps.
load(file_path)	Charge une nouvelle image depuis le chemin de fichier ou l’URL spécifié. Si filePath est un chemin de fichier, la méthode ouvre simplement le fichier. Si filePath est une URL, la méthode télécharge le fichier, le stocke temporairement, puis l’ouvre.
load(file_path, load_options)	Charge une nouvelle image depuis le chemin de fichier ou l’URL spécifié. Si filePath est un chemin de fichier, la méthode ouvre simplement le fichier. Si filePath est une URL, la méthode télécharge le fichier, le stocke temporairement, puis l’ouvre.
load(stream)	Charge une nouvelle image depuis le flux spécifié.
load(stream, load_options)	Charge une nouvelle image depuis le flux spécifié.
load_stream(stream)	Charge une nouvelle image depuis le flux spécifié.
load_stream_with_options(stream, load_options)	Charge une nouvelle image depuis le flux spécifié.
load_with_options(file_path, load_options)	Charge une nouvelle image depuis le chemin de fichier ou l’URL spécifié. Si filePath est un chemin de fichier, la méthode ouvre simplement le fichier. Si filePath est une URL, la méthode télécharge le fichier, le stocke temporairement, puis l’ouvre.
remove_background()	Supprime l’arrière-plan.
remove_background(settings)	Supprime l’arrière-plan.
remove_metadata()	Supprime les métadonnées.
resize(new_width, new_height)	Redimensionne l’image. Le paramètre par défaut ResizeType.NEAREST_NEIGHBOUR_RESAMPLE est utilisé.
resize(new_width, new_height, resize_type)	Redimensionne l’image.
resize(new_width, new_height, settings)	Redimensionne l’image.
resize_by_settings(new_width, new_height, settings)	Redimensionne l’image.
resize_by_type(new_width, new_height, resize_type)	Redimensionne l’image.
resize_height_proportionally(new_height)	Redimensionne la hauteur proportionnellement. Le défaut ResizeType.NEAREST_NEIGHBOUR_RESAMPLE est utilisé.
resize_height_proportionally(new_height, resize_type)	Redimensionne la hauteur proportionnellement.
resize_height_proportionally(new_height, settings)	Redimensionne la hauteur proportionnellement.
resize_height_proportionally_settings(new_height, settings)	Redimensionne la hauteur proportionnellement.
resize_width_proportionally(new_width)	Redimensionne la largeur proportionnellement. Le défaut ResizeType.NEAREST_NEIGHBOUR_RESAMPLE est utilisé.
resize_width_proportionally(new_width, resize_type)	Redimensionne la largeur proportionnellement.
resize_width_proportionally(new_width, settings)	Redimensionne la largeur proportionnellement.
resize_width_proportionally_settings(new_width, settings)	Redimensionne la largeur proportionnellement.
rotate(angle)	Faire pivoter l’image autour du centre.
rotate_flip(rotate_flip_type)	Fait pivoter, retourner, ou pivoter et retourner l’image.
save()	Enregistre les données de l’image dans le flux sous-jacent.
save(file_path)	Enregistre l’image à l’emplacement de fichier spécifié.
save(file_path, options)	Enregistre les données de l’objet à l’emplacement de fichier spécifié dans le format de fichier indiqué selon les options d’enregistrement.
save(file_path, options, bounds_rectangle)	Enregistre les données de l’objet à l’emplacement de fichier spécifié dans le format de fichier indiqué selon les options d’enregistrement.
save(file_path, over_write)	Enregistre les données de l’objet à l’emplacement de fichier spécifié.
save(stream)	Enregistre les données.
save(stream, options_base)	Enregistre les données de l’image dans le flux spécifié dans le format de fichier indiqué selon les options d’enregistrement.
save(stream, options_base, bounds_rectangle)	Enregistre les données de l’image dans le flux spécifié dans le format de fichier indiqué selon les options d’enregistrement.
save_to_stream(stream)	Enregistre les données de l’objet dans le flux spécifié.
save_to_stream_with_options(stream, options_base)	Enregistre les données de l’image dans le flux spécifié dans le format de fichier indiqué selon les options d’enregistrement.
save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)	Enregistre les données de l’image dans le flux spécifié dans le format de fichier indiqué selon les options d’enregistrement.
save_with_options(file_path, options)	Enregistre les données de l’objet à l’emplacement de fichier spécifié dans le format de fichier indiqué selon les options d’enregistrement.
save_with_options_rect(file_path, options, bounds_rectangle)	Enregistre les données de l’objet à l’emplacement de fichier spécifié dans le format de fichier indiqué selon les options d’enregistrement.
set_palette(palette, update_colors)	Personnalisez la palette de couleurs de l’image avec cette méthode intuitive. Idéal pour les développeurs souhaitant appliquer dynamiquement des schémas de couleurs ou des ajustements spécifiques, assurant un contrôle précis de l’apparence visuelle de leurs images.
try_set_metadata(metadata)	Essaie de définir une instance metadata, si cette instance Image prend en charge et implémente l’instance IImageMetadataFormat.

Constructor: CmxImage(stream_container, load_options)

 CmxImage(stream_container, load_options) 

Commencez à travailler avec la classe CmxImage de manière fluide en initialisant
une nouvelle instance avec les paramètres streamContainer et loadOptions. Idéal pour les développeurs
cherchant un moyen pratique de charger des images CMX à partir de diverses sources de données tout en
personnalisant le processus de chargement selon les besoins.

Parameters:

Paramètre	Type	Description
stream_container	StreamContainer	Le conteneur de flux.
load_options	LoadOptions	Les options de chargement.

Property: pages

Récupérez les pages de l’image de manière fluide grâce à cette propriété intuitive.
Idéal pour les développeurs souhaitant accéder et manipuler les pages individuelles
des images multipages, assurant une navigation et un traitement efficaces.

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) 

Détermine si l’image peut être chargée depuis le chemin de fichier spécifié.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier.

Returns

Type	Description
bool	true si l’image peut être chargée depuis le fichier spécifié ; sinon, false.

Method: can_load(file_path, load_options) [static]

 can_load(file_path, load_options) 

Détermine si l’image peut être chargée depuis le chemin de fichier spécifié et éventuellement en utilisant les options d’ouverture spécifiées.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier.
load_options	LoadOptions	Les options de chargement.

Returns

Type	Description
bool	true si l’image peut être chargée depuis le fichier spécifié ; sinon, false.

Method: can_load(stream) [static]

 can_load(stream) 

Détermine si l’image peut être chargée depuis le flux spécifié.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux à charger.

Returns

Type	Description
bool	true si l’image peut être chargée depuis le flux spécifié ; sinon, false.

Method: can_load(stream, load_options) [static]

 can_load(stream, load_options) 

Détermine si l’image peut être chargée depuis le flux spécifié et éventuellement en utilisant les loadOptions spécifiés.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux à charger.
load_options	LoadOptions	Les options de chargement.

Returns

Type	Description
bool	true si l’image peut être chargée depuis le flux spécifié ; sinon, false.

Method: can_load_stream(stream) [static]

 can_load_stream(stream) 

Détermine si l’image peut être chargée depuis le flux spécifié.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux à charger.

Returns

Type	Description
bool	true si l’image peut être chargée depuis le flux spécifié ; sinon, false.

Method: can_load_stream_with_options(stream, load_options) [static]

 can_load_stream_with_options(stream, load_options) 

Détermine si l’image peut être chargée depuis le flux spécifié et éventuellement en utilisant les loadOptions spécifiés.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux à charger.
load_options	LoadOptions	Les options de chargement.

Returns

Type	Description
bool	true si l’image peut être chargée depuis le flux spécifié ; sinon, false.

Method: can_load_with_options(file_path, load_options) [static]

 can_load_with_options(file_path, load_options) 

Détermine si l’image peut être chargée depuis le chemin de fichier spécifié et éventuellement en utilisant les options d’ouverture spécifiées.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier.
load_options	LoadOptions	Les options de chargement.

Returns

Type	Description
bool	true si l’image peut être chargée depuis le fichier spécifié ; sinon, false.

Method: can_save(options)

 can_save(options) 

Détermine si l’image peut être enregistrée au format de fichier spécifié représenté par les options d’enregistrement fournies.

Parameters:

Paramètre	Type	Description
options	ImageOptionsBase	Les options d’enregistrement à utiliser.

Returns

Type	Description
bool	true si l’image peut être enregistrée au format de fichier spécifié représenté par les options d’enregistrement fournies ; sinon, false.

Method: create(files) [static]

 create(files) 

Crée l’image multipage contenant les fichiers spécifiés.

Parameters:

Paramètre	Type	Description
files	string[]	Les fichiers.

Returns

Type	Description
Image	L’image multipage

Method: create(files, throw_exception_on_load_error) [static]

 create(files, throw_exception_on_load_error) 

Crée l’image multipage contenant les fichiers spécifiés.

Parameters:

Paramètre	Type	Description
files	string[]	Les fichiers.
throw_exception_on_load_error	bool	si défini sur true [lancer une exception lors du chargement].

Returns

Type	Description
Image	L’image multipage

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

 create(image_options, width, height) 

Crée une nouvelle image en utilisant les options de création spécifiées.

Parameters:

Paramètre	Type	Description
image_options	ImageOptionsBase	Les options d’image.
width	int	La largeur.
height	int	La hauteur.

Returns

Type	Description
Image	L’image nouvellement créée.

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

 create(image_options, width, height, pixels) 

Crée une instance de RasterImage à partir du tableau de pixels fourni.

Vérifie que la largeur et la hauteur spécifiées correspondent aux dimensions des données de pixels.
Cette méthode ne peut être utilisée que lorsque la bibliothèque est en mode Licensed.

Parameters:

Paramètre	Type	Description
image_options	ImageOptionsBase	Les options utilisées pour créer le RasterImage.
width	int	La largeur du RasterImage.
height	int	La hauteur du RasterImage.
pixels	int[]	Le tableau des valeurs de pixels utilisé pour remplir l’image.

Returns

Type	Description
Image	Une RasterImage remplie avec les données de pixels fournies.

Method: create(images) [static]

 create(images) 

Crée une nouvelle image en utilisant les images spécifiées comme pages

Parameters:

Paramètre	Type	Description
images	Image[]	Les images.

Returns

Type	Description
Image	L’Image en tant que IMultipageImage

Method: create(images, dispose_images) [static]

 create(images, dispose_images) 

Crée une nouvelle image à partir des images spécifiées en tant que pages.

Parameters:

Paramètre	Type	Description
images	Image[]	Les images.
dispose_images	bool	si défini sur true [supprimer les images].

Returns

Type	Description
Image	L’Image en tant que IMultipageImage

Method: create(multipage_create_options) [static]

 create(multipage_create_options) 

Crée les options de création multipage spécifiées.

Parameters:

Paramètre	Type	Description
multipage_create_options	MultipageCreateOptions	Les options de création multipage.

Returns

Type	Description
Image	L’image multipage

Method: create_from_files(files) [static]

 create_from_files(files) 

Crée l’image multipage contenant les fichiers spécifiés en tant que pages à chargement différé.

Parameters:

Paramètre	Type	Description
files	string[]	Les fichiers.

Returns

Type	Description
Image	L’image multipage

Method: create_from_files(files, throw_exception_on_load_error) [static]

 create_from_files(files, throw_exception_on_load_error) 

Crée l’image multipage contenant les fichiers spécifiés en tant que pages à chargement différé.

Parameters:

Paramètre	Type	Description
files	string[]	Les fichiers.
throw_exception_on_load_error	bool	si défini sur true lancer une exception en cas d’erreur de chargement.

Returns

Type	Description
Image	L’image multipage

Method: create_from_images(images) [static]

 create_from_images(images) 

Crée une nouvelle image en utilisant les images spécifiées comme pages

Parameters:

Paramètre	Type	Description
images	Image[]	Les images.

Returns

Type	Description
Image	L’Image en tant que IMultipageImage

Method: create_from_images(images, dispose_images) [static]

 create_from_images(images, dispose_images) 

Crée une nouvelle image à partir des images spécifiées en tant que pages.

Parameters:

Paramètre	Type	Description
images	Image[]	Les images.
dispose_images	bool	si défini sur true [supprimer les images].

Returns

Type	Description
Image	L’Image en tant que IMultipageImage

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

 crop(left_shift, right_shift, top_shift, bottom_shift) 

Recadrer l’image avec des déplacements.

Parameters:

Paramètre	Type	Description
left_shift	int	Le décalage à gauche.
right_shift	int	Le décalage à droite.
top_shift	int	Le décalage supérieur.
bottom_shift	int	Le décalage inférieur.

Method: crop(rectangle)

 crop(rectangle) 

Recadre le rectangle spécifié.

Parameters:

Paramètre	Type	Description
rectangle	Rectangle	Le rectangle.

Method: get_default_options(args)

 get_default_options(args) 

Obtient les options d’image par défaut.

Parameters:

Paramètre	Type	Description
args	System.Object	Les arguments.

Returns

Type	Description
ImageOptionsBase	Les options d’image par défaut.

Method: get_embedded_images()

 get_embedded_images() 

Obtient les images intégrées.

Returns

Type	Description
EmbeddedImage[]	Tableau d’images

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Obtient le format de fichier.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier.

Returns

Type	Description
FileFormat	Le format de fichier déterminé.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Obtient le format de fichier.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux.

Returns

Type	Description
FileFormat	Le format de fichier déterminé.

Method: get_file_format_of_stream(stream) [static]

 get_file_format_of_stream(stream) 

Obtient le format de fichier.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux.

Returns

Type	Description
FileFormat	Le format de fichier déterminé.

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

 get_fitting_rectangle(rectangle, pixels, width, height) 

Obtient le rectangle qui correspond à l’image actuelle.

Parameters:

Paramètre	Type	Description
rectangle	Rectangle	Le rectangle pour obtenir le rectangle d’ajustement.
pixels	int[]	Les pixels ARGB 32 bits.
width	int	La largeur de l’objet.
height	int	La hauteur de l’objet.

Returns

Type	Description
Rectangle	Le rectangle d’ajustement ou une exception si aucun rectangle d’ajustement ne peut être trouvé.

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

 get_fitting_rectangle(rectangle, width, height) 

Obtient le rectangle qui correspond à l’image actuelle.

Parameters:

Paramètre	Type	Description
rectangle	Rectangle	Le rectangle pour obtenir le rectangle d’ajustement.
width	int	La largeur de l’objet.
height	int	La hauteur de l’objet.

Returns

Type	Description
Rectangle	Le rectangle d’ajustement ou une exception si aucun rectangle d’ajustement ne peut être trouvé.

Method: get_original_options()

 get_original_options() 

Obtient les options basées sur les paramètres du fichier original.
Cela peut être utile pour conserver la profondeur de couleur et d’autres paramètres de l’image originale inchangés.
Par exemple, si nous chargeons une image PNG noir-et-blanc avec 1 bit par pixel puis l’enregistrons en utilisant la
méthode DataStreamSupporter.save(file_path), une image PNG de sortie avec 8 bits par pixel sera produite.
Pour éviter cela et enregistrer l’image PNG avec 1 bit par pixel, utilisez cette méthode pour obtenir les options d’enregistrement correspondantes et les transmettre
à la méthode Image.save(file_path, options) en tant que deuxième paramètre.

Returns

Type	Description
ImageOptionsBase	Les options basées sur les paramètres du fichier original.

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

 get_proportional_height(width, height, new_width) 

Obtient une hauteur proportionnelle.

Parameters:

Paramètre	Type	Description
width	int	La largeur.
height	int	La hauteur.
new_width	int	La nouvelle largeur.

Returns

Type	Description
int	La hauteur proportionnelle.

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

 get_proportional_width(width, height, new_height) 

Obtient une largeur proportionnelle.

Parameters:

Paramètre	Type	Description
width	int	La largeur.
height	int	La hauteur.
new_height	int	La nouvelle hauteur.

Returns

Type	Description
int	La largeur proportionnelle.

Method: get_serialized_stream(image_options, clipping_rectangle, page_number)

 get_serialized_stream(image_options, clipping_rectangle, page_number) 

Convertit en aps.

Parameters:

Paramètre	Type	Description
image_options	ImageOptionsBase	Les options d’image.
clipping_rectangle	Rectangle	Le rectangle de découpage.
page_number	int[]	Le numéro de page.

Returns

Type	Description
_io.BufferedRandom	Le flux sérialisé

Method: load(file_path) [static]

 load(file_path) 

Charge une nouvelle image depuis le chemin de fichier ou l’URL spécifié.
Si filePath est un chemin de fichier, la méthode ouvre simplement le fichier.
Si filePath est une URL, la méthode télécharge le fichier, le stocke temporairement, puis l’ouvre.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier ou l’URL depuis lequel charger l’image.

Returns

Type	Description
Image	L’image chargée.

Method: load(file_path, load_options) [static]

 load(file_path, load_options) 

Charge une nouvelle image depuis le chemin de fichier ou l’URL spécifié.
Si filePath est un chemin de fichier, la méthode ouvre simplement le fichier.
Si filePath est une URL, la méthode télécharge le fichier, le stocke temporairement, puis l’ouvre.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier ou l’URL depuis lequel charger l’image.
load_options	LoadOptions	Les options de chargement.

Returns

Type	Description
Image	L’image chargée.

Method: load(stream) [static]

 load(stream) 

Charge une nouvelle image depuis le flux spécifié.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux depuis lequel charger l’image.

Returns

Type	Description
Image	L’image chargée.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

Charge une nouvelle image depuis le flux spécifié.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux depuis lequel charger l’image.
load_options	LoadOptions	Les options de chargement.

Returns

Type	Description
Image	L’image chargée.

Method: load_stream(stream) [static]

 load_stream(stream) 

Charge une nouvelle image depuis le flux spécifié.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux depuis lequel charger l’image.

Returns

Type	Description
Image	L’image chargée.

Method: load_stream_with_options(stream, load_options) [static]

 load_stream_with_options(stream, load_options) 

Charge une nouvelle image depuis le flux spécifié.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux depuis lequel charger l’image.
load_options	LoadOptions	Les options de chargement.

Returns

Type	Description
Image	L’image chargée.

Method: load_with_options(file_path, load_options) [static]

 load_with_options(file_path, load_options) 

Charge une nouvelle image depuis le chemin de fichier ou l’URL spécifié.
Si filePath est un chemin de fichier, la méthode ouvre simplement le fichier.
Si filePath est une URL, la méthode télécharge le fichier, le stocke temporairement, puis l’ouvre.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier ou l’URL depuis lequel charger l’image.
load_options	LoadOptions	Les options de chargement.

Returns

Type	Description
Image	L’image chargée.

Method: remove_background(settings)

 remove_background(settings) 

Supprime l’arrière-plan.

Parameters:

Paramètre	Type	Description
settings	RemoveBackgroundSettings	Les paramètres.

Method: resize(new_width, new_height)

 resize(new_width, new_height) 

Redimensionne l’image. Le paramètre par défaut ResizeType.NEAREST_NEIGHBOUR_RESAMPLE est utilisé.

Parameters:

Paramètre	Type	Description
new_width	int	La nouvelle largeur.
new_height	int	La nouvelle hauteur.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Redimensionne l’image.

Parameters:

Paramètre	Type	Description
new_width	int	La nouvelle largeur.
new_height	int	La nouvelle hauteur.
resize_type	ResizeType	Le type de redimensionnement.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Redimensionne l’image.

Parameters:

Paramètre	Type	Description
new_width	int	La nouvelle largeur.
new_height	int	La nouvelle hauteur.
settings	ImageResizeSettings	Les paramètres de redimensionnement.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Redimensionne l’image.

Parameters:

Paramètre	Type	Description
new_width	int	La nouvelle largeur.
new_height	int	La nouvelle hauteur.
settings	ImageResizeSettings	Les paramètres de redimensionnement.

Method: resize_by_type(new_width, new_height, resize_type)

 resize_by_type(new_width, new_height, resize_type) 

Redimensionne l’image.

Parameters:

Paramètre	Type	Description
new_width	int	La nouvelle largeur.
new_height	int	La nouvelle hauteur.
resize_type	ResizeType	Le type de redimensionnement.

Method: resize_height_proportionally(new_height)

 resize_height_proportionally(new_height) 

Redimensionne la hauteur proportionnellement. Le défaut ResizeType.NEAREST_NEIGHBOUR_RESAMPLE est utilisé.

Parameters:

Paramètre	Type	Description
new_height	int	La nouvelle hauteur.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Redimensionne la hauteur proportionnellement.

Parameters:

Paramètre	Type	Description
new_height	int	La nouvelle hauteur.
resize_type	ResizeType	Type de redimensionnement.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Redimensionne la hauteur proportionnellement.

Parameters:

Paramètre	Type	Description
new_height	int	La nouvelle hauteur.
settings	ImageResizeSettings	Les paramètres de redimensionnement de l’image.

Method: resize_height_proportionally_settings(new_height, settings)

 resize_height_proportionally_settings(new_height, settings) 

Redimensionne la hauteur proportionnellement.

Parameters:

Paramètre	Type	Description
new_height	int	La nouvelle hauteur.
settings	ImageResizeSettings	Les paramètres de redimensionnement de l’image.

Method: resize_width_proportionally(new_width)

 resize_width_proportionally(new_width) 

Redimensionne la largeur proportionnellement. Le défaut ResizeType.NEAREST_NEIGHBOUR_RESAMPLE est utilisé.

Parameters:

Paramètre	Type	Description
new_width	int	La nouvelle largeur.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Redimensionne la largeur proportionnellement.

Parameters:

Paramètre	Type	Description
new_width	int	La nouvelle largeur.
resize_type	ResizeType	Type de redimensionnement.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Redimensionne la largeur proportionnellement.

Parameters:

Paramètre	Type	Description
new_width	int	La nouvelle largeur.
settings	ImageResizeSettings	Les paramètres de redimensionnement de l’image.

Method: resize_width_proportionally_settings(new_width, settings)

 resize_width_proportionally_settings(new_width, settings) 

Redimensionne la largeur proportionnellement.

Parameters:

Paramètre	Type	Description
new_width	int	La nouvelle largeur.
settings	ImageResizeSettings	Les paramètres de redimensionnement de l’image.

Method: rotate(angle)

 rotate(angle) 

Faire pivoter l’image autour du centre.

Parameters:

Paramètre	Type	Description
angle	float	L’angle de rotation en degrés. Les valeurs positives feront pivoter dans le sens horaire.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Fait pivoter, retourner, ou pivoter et retourner l’image.

Parameters:

Paramètre	Type	Description
rotate_flip_type	RotateFlipType	Type de la rotation et du retournement.

Method: save(file_path)

 save(file_path) 

Enregistre l’image à l’emplacement de fichier spécifié.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier où enregistrer l’image.

Method: save(file_path, options)

 save(file_path, options) 

Enregistre les données de l’objet à l’emplacement de fichier spécifié dans le format de fichier indiqué selon les options d’enregistrement.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier.
options	ImageOptionsBase	Les options.

Method: save(file_path, options, bounds_rectangle)

 save(file_path, options, bounds_rectangle) 

Enregistre les données de l’objet à l’emplacement de fichier spécifié dans le format de fichier indiqué selon les options d’enregistrement.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier.
options	ImageOptionsBase	Les options.
bounds_rectangle	Rectangle	Le rectangle des limites de l’image de destination. Définissez le rectangle vide pour utiliser les limites de la source.

Method: save(file_path, over_write)

 save(file_path, over_write) 

Enregistre les données de l’objet à l’emplacement de fichier spécifié.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier où enregistrer les données de l’objet.
over_write	bool	si défini sur true écrase le contenu du fichier, sinon une addition sera effectuée.

Method: save(stream)

 save(stream) 

Enregistre les données.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux où enregistrer les données.

Method: save(stream, options_base)

 save(stream, options_base) 

Enregistre les données de l’image dans le flux spécifié dans le format de fichier indiqué selon les options d’enregistrement.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux où enregistrer les données de l’image.
options_base	ImageOptionsBase	Les options d’enregistrement.

Method: save(stream, options_base, bounds_rectangle)

 save(stream, options_base, bounds_rectangle) 

Enregistre les données de l’image dans le flux spécifié dans le format de fichier indiqué selon les options d’enregistrement.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux où enregistrer les données de l’image.
options_base	ImageOptionsBase	Les options d’enregistrement.
bounds_rectangle	Rectangle	Le rectangle des limites de l’image de destination. Définissez le rectangle vide pour utiliser les limites source.

Method: save_to_stream(stream)

 save_to_stream(stream) 

Enregistre les données de l’objet dans le flux spécifié.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux où enregistrer les données de l’objet.

Method: save_to_stream_with_options(stream, options_base)

 save_to_stream_with_options(stream, options_base) 

Enregistre les données de l’image dans le flux spécifié dans le format de fichier indiqué selon les options d’enregistrement.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux où enregistrer les données de l’image.
options_base	ImageOptionsBase	Les options d’enregistrement.

Method: save_to_stream_with_options_rect(stream, options_base, bounds_rectangle)

 save_to_stream_with_options_rect(stream, options_base, bounds_rectangle) 

Enregistre les données de l’image dans le flux spécifié dans le format de fichier indiqué selon les options d’enregistrement.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux où enregistrer les données de l’image.
options_base	ImageOptionsBase	Les options d’enregistrement.
bounds_rectangle	Rectangle	Le rectangle des limites de l’image de destination. Définissez le rectangle vide pour utiliser les limites source.

Method: save_with_options(file_path, options)

 save_with_options(file_path, options) 

Enregistre les données de l’objet à l’emplacement de fichier spécifié dans le format de fichier indiqué selon les options d’enregistrement.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier.
options	ImageOptionsBase	Les options.

Method: save_with_options_rect(file_path, options, bounds_rectangle)

 save_with_options_rect(file_path, options, bounds_rectangle) 

Enregistre les données de l’objet à l’emplacement de fichier spécifié dans le format de fichier indiqué selon les options d’enregistrement.

Parameters:

Paramètre	Type	Description
file_path	string	Le chemin du fichier.
options	ImageOptionsBase	Les options.
bounds_rectangle	Rectangle	Le rectangle des limites de l’image de destination. Définissez le rectangle vide pour utiliser les limites de la source.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Personnalisez la palette de couleurs de l’image avec cette méthode intuitive. Idéal pour
les développeurs souhaitant appliquer dynamiquement des schémas de couleurs ou des ajustements spécifiques,
assurant un contrôle précis de l’apparence visuelle de leurs images.

Parameters:

Paramètre	Type	Description
palette	IColorPalette	La palette à définir.
update_colors	bool	si défini sur true les couleurs seront mises à jour selon la nouvelle palette ; sinon les index de couleur restent inchangés. Notez que les index inchangés peuvent provoquer un plantage de l’image lors du chargement si certains index n’ont aucune entrée correspondante dans la palette.

Method: try_set_metadata(metadata)

 try_set_metadata(metadata) 

Essaie de définir une instance metadata, si cette instance Image prend en charge et implémente l’instance IImageMetadataFormat.

Parameters:

Paramètre	Type	Description
metadata	IImageMetadataFormat	Les métadonnées.

Returns

Type	Description
bool	Vrai si metadata n’est pas nul et que l’instance IMetadataContainer prend en charge et/ou implémente l’instance IImageMetadataFormat ; sinon, faux.

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"
# Chargez une image à partir d'un fichier CMX.
with aspycore.as_of(Image.load(join(dir_, "sample.cmx")), CmxImage) as image:
	# Cet appel met en cache uniquement la page par défaut.
	image.cache_data()
	# Mettez en cache toutes les pages afin qu'aucun chargement de données supplémentaire ne soit effectué depuis le flux de données sous-jacent.
	for page in image.pages:
		page.cache_data()