Classe OdgImage

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	Description
OdgImage(stream_container)	Conçu pour une intégration transparente dans les solutions logicielles, le constructeur OdgImage initialise une nouvelle instance en utilisant un conteneur de flux. Cette méthode assure une gestion efficace des données d’image ODG dans les environnements logiciels, optimisant l’utilisation des ressources et facilitant des flux de travail de traitement d’image rationalisés.
OdgImage(stream_container, options)	Démarrez une nouvelle création de l’objet de classe OdgImage avec l’initialisation d’une nouvelle instance. Exploitez le potentiel d’un conteneur de flux couplé aux paramètres d’options de chargement, en conservant un constructeur polyvalent pour charger les images de manière fluide. Ce constructeur permet une gestion efficace des images, offrant des configurations de chargement personnalisables pour une adaptabilité et des performances accrues dans divers scénarios.

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ère le nombre de bits par pixel de l’image. Cette propriété fournit un aperçu du niveau de détail et de la profondeur de couleur représentés dans l’image, aidant à diverses tâches de traitement d’image et optimisations.
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.
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ère la page par défaut associée à l’image, offrant un accès essentiel à la page principale de la collection d’images. Cette propriété simplifie la navigation et la manipulation des données d’image, améliorant l’efficacité des flux de travail de développement logiciel.
libéré	bool	r	Obtient une valeur indiquant si cette instance est libérée.
exif_data	ExifData	r/w	Obtient ou définit l’instance Exif.
file_format	FileFormat	r	Obtient une valeur du format de fichier
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’objet.
height_f	float	r	Obtient la hauteur de l’objet, en pouces.
interrupt_monitor	InterruptMonitor	r/w	Obtient ou définit le moniteur d’interruption.
is_cached	bool	r	Obtient une valeur booléenne indiquant si les données de l’objet sont actuellement en cache, éliminant ainsi le besoin de lecture des données. Cette propriété sert d’indicateur d’optimisation, améliorant les performances en minimisant les opérations d’accès redondantes aux données.
metadata	OdMetadata	r	Récupère les métadonnées spécifiques aux fichiers OpenDocument. Cette propriété permet d’accéder à des informations essentielles intégrées dans les fichiers OD, facilitant diverses opérations telles que l’extraction, la modification ou l’analyse des métadonnées.
page_count	int	r	Récupère le nombre total de pages dans l’image. Cette propriété est essentielle pour les applications gérant des images multipages, leur permettant de déterminer avec précision le nombre de pages disponibles pour le traitement ou l’affichage.
pages	Image[]	r	En récupérant la collection de pages, cette propriété permet d’accéder à l’ensemble des pages associées à une image. En accédant à cette propriété, les développeurs peuvent itérer à travers les pages individuelles, récupérer des pages spécifiques selon leur index, ou effectuer des opérations par lots sur l’ensemble de la collection.
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.
records	OdObject[]	r	Récupère les enregistrements OpenDocument stockés dans l’image. Cette propriété accorde l’accès à des éléments de données structurées spécifiques intégrés dans les fichiers OpenDocument, facilitant la récupération ou la manipulation d’informations pertinentes pour un traitement ultérieur ou une analyse.
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’objet.
width_f	float	r	Obtient la largeur de l’objet, en pouces.
xmp_data	XmpPacketWrapper	r/w	Obtient ou définit les données Xmp.

Methods

Name	Description
cache_data()	Met en cache les données et garantit qu’aucun chargement de données supplémentaire ne sera effectué depuis le support sous-jacent DataStreamSupporter.data_stream_container.
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)	Définit la palette d’image.
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: OdgImage(stream_container)

 OdgImage(stream_container) 

Conçu pour une intégration transparente dans les solutions logicielles, le constructeur OdgImage
initialise une nouvelle instance en utilisant un conteneur de flux. Cette méthode
assure une gestion efficace des données d’image ODG dans les environnements logiciels, optimisant
l’utilisation des ressources et facilitant des flux de travail de traitement d’image rationalisés.

Parameters:

Paramètre	Type	Description
stream_container	StreamContainer	Le conteneur de flux.

Constructor: OdgImage(stream_container, options)

 OdgImage(stream_container, options) 

Démarrez une nouvelle création de l’objet de classe OdgImage avec
l’initialisation d’une nouvelle instance. Exploitez le potentiel d’un conteneur de flux couplé
aux paramètres d’options de chargement, en conservant un constructeur polyvalent pour charger
les images de manière fluide. Ce constructeur permet une gestion efficace des images, offrant des configurations de chargement personnalisables
pour une adaptabilité et des performances accrues dans divers scénarios.

Parameters:

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

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.

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) 

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) 

Définit la palette d’image.

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 resteront inchangés. Notez que les index inchangés peuvent provoquer un plantage de l’image lors du chargement si certains index n’ont pas d entrées correspondantes 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

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:
	# Tournez, retournez et enregistrez dans le fichier de sortie.
	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)