Classe SvgImage

Summary: Manipulate Scalar Vector Graphics (SVG) image files with our API, utilizing
the power of XML-based text format for seamless customization and scalability.
Easily load SVG images, rasterize vector elements, and convert to other formats,
while controlling compression levels to optimize file size and quality for your projects.

Module: aspose.imaging.fileformats.svg

Full Name: aspose.imaging.fileformats.svg.SvgImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IObjectWithSizeF, VectorImage

Constructors

Name	Description
SvgImage(path)	Instancie un nouvel objet de la classe SvgImage , en utilisant le chemin spécifié pour localiser et charger l’image. Ce constructeur facilite la création d’instances d’images SVG à partir de fichiers externes, permettant une intégration fluide dans les systèmes logiciels et les flux de travail.
SvgImage(stream)	Crée une nouvelle instance de la classe SvgImage , en chargeant l’image depuis le flux fourni. Ce constructeur permet le chargement direct d’images SVG depuis des flux, améliorant la flexibilité et l’efficacité dans la gestion des ressources d’image au sein des applications logicielles.
SvgImage(svg_options, width, height)	Crée une nouvelle instance de la classe SvgImage avec des options SVG spécifiées, la largeur et la hauteur de l’image. Ce constructeur permet aux développeurs d’initialiser des images SVG avec des options et des dimensions personnalisées, offrant une flexibilité dans la gestion du contenu et de la mise en page SVG.
SvgImage(width, height)	Instancie un nouvel objet SvgImage avec la largeur et la hauteur spécifiées. Ce constructeur permet aux développeurs de créer des images SVG avec des dimensions prédéfinies, facilitant un contrôle précis de la taille de l’image lors de l’initialisation.

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. Il est important de noter que ce paramètre ne s’applique pas aux images vectorielles, car elles ne sont pas mesurées en pixels. Cette propriété fournit des informations cruciales sur la profondeur de couleur de l’image, aidant aux tâches de traitement et de manipulation.
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.
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	Récupère le format de fichier de l’image, fournissant des métadonnées essentielles pour le traitement et les vérifications de compatibilité. Cette propriété est indispensable pour déterminer les stratégies de décodage et d’encodage appropriées afin de gérer les données d’image efficacement sur différents systèmes et 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	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	Récupère une valeur booléenne indiquant si les données de l’objet sont actuellement en cache, éliminant ainsi le besoin d’opérations de lecture supplémentaires. Cette propriété donne un aperçu de l’état actuel du cache, optimisant la récupération et le traitement des données pour améliorer les performances et l’efficacité.
metadata	ImageMetadata	r	Obtient les métadonnées de l’image.
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	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()	Mise en cache des données et garantie qu’aucun chargement supplémentaire de données ne proviendra du DataStreamSupporter.data_stream_container sous-jacent. Cette optimisation améliore les performances en éliminant les opérations redondantes de récupération de données, particulièrement bénéfique dans les scénarios nécessitant un accès fréquent aux données d’image.
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.
create_from_stream(stream)	Initialise une nouvelle instance de la classe SvgImage.
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 la section SVG.
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)	Redimensionner l’image pour qu’elle corresponde aux dimensions spécifiées tout en préservant son aspect ratio. Cette méthode offre un moyen pratique d’ajuster la taille de l’image sans déformer ses proportions, garantissant un affichage ou un stockage optimal selon les dimensions souhaitées.
resize(new_width, new_height, settings)	Redimensionne l’image avec des options étendues.
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)	Applique une palette spécifiée à l’image, permettant la personnalisation des schémas de couleur à des fins esthétiques ou fonctionnelles. Cette méthode offre une flexibilité dans la gestion des palettes de couleurs pour répondre à diverses exigences de conception ou d’application.
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: SvgImage(path)

 SvgImage(path) 

Instancie un nouvel objet de la classe SvgImage , en utilisant le
chemin spécifié pour localiser et charger l’image. Ce constructeur facilite la
création d’instances d’images SVG à partir de fichiers externes, permettant une intégration fluide
dans les systèmes logiciels et les flux de travail.

Parameters:

Paramètre	Type	Description
chemin	string	Le chemin depuis lequel charger l’image et initialiser les données de pixels et de palette.

Constructor: SvgImage(stream)

 SvgImage(stream) 

Crée une nouvelle instance de la classe SvgImage , en chargeant l’image
depuis le flux fourni. Ce constructeur permet le chargement direct d’images SVG
depuis des flux, améliorant la flexibilité et l’efficacité dans la gestion des ressources d’image
au sein des applications logicielles.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux depuis lequel charger l’image et initialiser les données de pixels et de palette.

See also:

Example # 1: This example shows how to load an SVG image from a file stream and rasterize …

Constructor: SvgImage(svg_options, width, height)

 SvgImage(svg_options, width, height) 

Crée une nouvelle instance de la classe SvgImage avec des options SVG spécifiées, la largeur et la hauteur de l’image. Ce constructeur permet
aux développeurs d’initialiser des images SVG avec des options et des dimensions personnalisées,
offrant une flexibilité dans la gestion du contenu et de la mise en page SVG.

Parameters:

Paramètre	Type	Description
svg_options	SvgOptions	Les options SVG.
width	int	Largeur de l’image.
height	int	Hauteur de l’image.

Constructor: SvgImage(width, height)

 SvgImage(width, height) 

Instancie un nouvel objet SvgImage avec la largeur et la hauteur spécifiées. Ce constructeur permet aux développeurs de créer des images SVG avec des dimensions prédéfinies,
facilitant un contrôle précis de la taille de l’image lors de
l’initialisation.

Parameters:

Paramètre	Type	Description
width	int	La largeur de l’image.
height	int	La hauteur de l’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: create_from_stream(stream) [static]

 create_from_stream(stream) 

Initialise une nouvelle instance de la classe SvgImage.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom	Le flux depuis lequel charger l’image et initialiser les données de pixels et de palette.

Returns

Type	Description
SvgImage

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 la section SVG.

Parameters:

Paramètre	Type	Description
flux	_io.BufferedRandom

Returns

Type	Description
Image

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) 

Redimensionner l’image pour qu’elle corresponde aux dimensions spécifiées tout en préservant son aspect
ratio. Cette méthode offre un moyen pratique d’ajuster la taille de l’image
sans déformer ses proportions, garantissant un affichage ou un stockage optimal
selon les dimensions souhaitées.

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 avec des options étendues.

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) 

Applique une palette spécifiée à l’image, permettant la personnalisation des schémas de couleur
à des fins esthétiques ou fonctionnelles. Cette méthode offre une flexibilité
dans la gestion des palettes de couleurs pour répondre à diverses exigences de conception ou d’application.

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

This example shows how to load an SVG image from a file stream and rasterize it to PNG.

import aspose.pycore as aspycore
from os.path import join
from aspose.imaging.fileformats.svg import SvgImage
from aspose.imaging.imageoptions import PngOptions, SvgRasterizationOptions

dir_: str = "c:\\temp"
# Chargez une image SVG à partir d'un flux de fichier.
with open(join(dir_, "test.svg"), "rb") as stream:
	with SvgImage(stream) as svg_image:
		# Afin de rasteriser le SVG, nous devons spécifier les options de rasterisation.
		rasterization_options = SvgRasterizationOptions()
		save_options = PngOptions()
		save_options.vector_rasterization_options = rasterization_options
		svg_image.save(join(dir_, "test.output.png"), save_options)

The following example shows how to convert compressed images (.emz,.wmz, *.svgz) to a raster format

from aspose.imaging import Image, Color
from aspose.imaging.imageoptions import PngOptions, VectorRasterizationOptions
from os.path import join
from aspose.pycore import as_of

files = ["example.emz", "example.wmz", "example.svgz"]
base_folder: str = join("D:", "Compressed")
for file in files:
	input_file: str = join(base_folder, file)
	out_file: str = input_file + ".png"
	with Image.load(input_file) as image:
		vector_rasterization_options = aspycore.as_of(image.get_default_options([Color.white, image.width, image.height]), VectorRasterizationOptions)
		obj_init = PngOptions()
		obj_init.vector_rasterization_options = vector_rasterization_options
		image.save(out_file, obj_init)

The following example shows how to convert a svgz images to svg fromat

import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import SvgRasterizationOptions, SvgOptions
from os.path import join

file: str = "example.svgz"
base_folder: str = join("D:", "Compressed")
input_file: str = join(base_folder, file)
out_file: str = input_file + ".svg"
with Image.load(input_file) as image:
	obj_init = SvgRasterizationOptions()
	obj_init.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = SvgOptions()
	obj_init2.vector_rasterization_options = obj_init
	image.save(out_file, obj_init2)

The following example shows how to convert a svg images to svgz format

from os.path import join as path_combine
import aspose.pycore as aspycore
from aspose.imaging import Image, SizeF
from aspose.imaging.imageoptions import SvgRasterizationOptions, SvgOptions

file = "juanmontoya_lingerie.svg"
base_folder = path_combine("D:", "Compressed")
input_file = path_combine(base_folder, file)
out_file = input_file + ".svgz"
with Image.load(input_file) as image:
	vector_rasterization_options = SvgRasterizationOptions()
	vector_rasterization_options.page_size = aspycore.cast(SizeF, image.size)
	obj_init2 = SvgOptions()
	obj_init2.vector_rasterization_options = vector_rasterization_options
	obj_init2.compress = True
	image.save(out_file, obj_init2)