Classe GifImage

Summary: The API for Graphical Interchange Format (GIF) image file provides
developers with versatile tools for processing compressed raster images and
animated GIFs. Offering features like XMP metadata handling, color palette
settings, background and transparent color control, opacity settings, resize,
crop, filter application, gamma corrections, contrast adjustment, grayscale
transformation, and conversion to other formats. This API empowers seamless
manipulation and enhancement of GIF images for a wide range of applications.

Module: aspose.imaging.fileformats.gif

Full Name: aspose.imaging.fileformats.gif.GifImage

Inheritance: IObjectWithBounds, IMetadataContainer, IHasExifData, IHasMetadata, IHasXmpData, IRasterImageArgb32PixelLoader, IRasterImageRawDataLoader, IMultipageImage, IMultipageImageExt, RasterCachedMultipageImage

Constructors

NameDescription
GifImage(first_frame)Créer des images GIF devient sans effort avec le GifImage
constructeur. Avec simplement le paramètre firstFrame, il vous plonge dans un monde de communication visuelle dynamique
.
GifImage(first_frame, global_palette)Initiez un nouvel objet GifImage avec les paramètres spécifiés pour la
première image et la palette globale. Commencez à gérer les images GIF rapidement, en garantissant
une représentation précise grâce à des paramètres personnalisables pour des résultats optimaux.
GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)Commencez sans effort avec le constructeur GifImage. Avec cette
méthode simple, vous pouvez vous lancer dans la création de GIF animés facilement. Il suffit de fournir le
firstFrame, globalPalette, paletteColorResolution, aspectRatio, et d’autres
paramètres, et vous serez prêt à donner vie à vos visuels.

Properties

NameTypeAccessDescription
active_frameGifFrameBlockr/wGérez et manipulez les cadres avec cette propriété, permettant une navigation fluide et
la modification du cadre actif dans l’image GIF.
auto_adjust_paletteboolr/wObtient ou définit une valeur indiquant si la palette d’ajustement automatique est activée.
background_colorColorr/wGérez la couleur d’arrière-plan de l’image GIF avec cette propriété. Vous pouvez définir ou
récupérer la couleur d’arrière-plan pour assurer la cohérence et améliorer l’attrait visuel.
background_color_indexSystem.Byter/wContrôlez l’index de la couleur d’arrière-plan de l’image GIF à l’aide de cette propriété. Définissez ou
récupérez l’index pour maintenir la cohérence ou obtenir les effets visuels souhaités.
bits_per_pixelintrObtient le nombre de bits par pixel de l’image.
blocksIGifBlock[]rAccédez aux blocs GIF de manière fluide avec cette propriété, facilitant la récupération et la manipulation faciles des structures de données sous-jacentes de l’image.
boundsRectanglerObtient les limites de l’objet.
buffer_size_hintintr/wObtient ou définit l’indice de taille du tampon, qui correspond à la taille maximale autorisée pour tous les tampons internes.
containerImagerObtient le conteneur Image.
data_stream_containerStreamContainerrObtient le flux de données de l’objet.
libéréboolrObtient une valeur indiquant si cette instance est libérée.
exif_dataExifDatar/wObtient ou définit l’instance Exif.
file_formatFileFormatrRécupérez le format de fichier sans effort avec cette propriété. C’est votre source de référence
pour identifier le format de vos fichiers. Intégrée de manière fluide à votre flux de travail,
elle fournit des informations essentielles sans aucune contrainte.
has_alphaboolrObtient une valeur indiquant si cette instance possède un canal alpha.
has_background_colorboolr/wCette propriété détermine si l’image GIF contient une couleur d’arrière-plan. Si
vrai, cela indique que l’image inclut une couleur d’arrière-plan.
has_trailerboolr/wGérez la présence d’un trailer dans vos fichiers GIF avec cette propriété. Que vous
ayez besoin de vérifier si un trailer existe ou de définir sa présence, cette propriété simplifie le
processus. Gardez vos fichiers GIF structurés et conformes grâce à cette fonctionnalité intuitive.
has_transparent_colorboolr/wDéterminez si le cadre actif de l’image GIF inclut une couleur transparente.
Cette propriété offre un moyen pratique de vérifier la transparence dans l’image.
heightintrObtient la hauteur de l’image.
horizontal_resolutionfloatr/wObtient ou définit la résolution horizontale, en pixels par pouce, de ce RasterImage.
image_opacityfloatrRécupérez l’opacité du cadre actif dans l’image, offrant un aperçu de
son niveau de transparence. Cette propriété est particulièrement utile pour comprendre le
degré de transparence ou d’opacité du cadre actif dans l’image.
interrupt_monitorInterruptMonitorr/wObtient ou définit le moniteur d’interruption.
is_cachedboolrObtient une valeur indiquant si les données de l’image sont actuellement en cache.
is_interlacedboolrDétermine si l’image est entrelacée, affectant son affichage lors du chargement. Cette
propriété offre un aperçu du comportement de rendu de l’image, essentiel pour
optimiser les stratégies de chargement et améliorer l’expérience de visualisation globale.
is_palette_sortedboolr/wContrôlez le tri de la palette dans vos images GIF à l’aide de cette propriété. Que vous ayez besoin de vérifier si la palette est triée ou de définir le comportement de tri, cette
propriété offre un moyen simple de gérer l’organisation de la palette dans vos
fichiers GIF.
is_raw_data_availableboolrObtient une valeur indiquant si le chargement de données brutes est pris en charge.
loops_countintr/wRécupérez le nombre de boucles facilement avec cette propriété. Si votre image GIF inclut des informations de boucle, cette propriété vous donne un accès rapide au nombre de boucles, vous permettant de gérer sans effort le comportement de bouclage dans vos fichiers GIF.
metadataImageMetadatarObtient ou définit les données XMP à partir de la trame.
page_countintrRécupérez le nombre total de pages contenues dans l’image avec cette
propriété simple. Idéal pour évaluer rapidement l’étendue du contenu de l’image.
pagesImage[]rAccédez aux pages de l’image grâce à cette propriété pratique,
permettant une navigation fluide et la manipulation des pages individuelles selon les besoins.
paletteIColorPaletter/wObtient ou définit la palette de couleurs. La palette de couleurs n’est pas utilisée lorsque les pixels sont représentés directement.
palette_color_resolution_bitsSystem.Byter/wGérez la résolution des couleurs de la palette de vos images GIF avec cette propriété. Ajustez
le nombre de bits utilisés pour représenter les couleurs dans la palette, offrant un contrôle précis
sur la profondeur des couleurs et la qualité de l’image.
pixel_aspect_ratioSystem.Byter/wGérez le rapport d’aspect des pixels de l’image GIF avec cette propriété. Définissez ou récupérez
le rapport d’aspect pour assurer un rendu précis et maintenir la fidélité visuelle.
premultiply_componentsboolr/wObtient ou définit une valeur indiquant si les composants de l’image doivent être prémultipliés.
raw_custom_color_converterIColorConverterr/wObtient ou définit le convertisseur de couleur personnalisé
raw_data_formatPixelDataFormatrObtient le format des données brutes.
raw_data_settingsRawDataSettingsrObtient les paramètres actuels des données brutes. Notez qu’en utilisant ces paramètres, les données se chargent sans conversion.
raw_fallback_indexintr/wObtient ou définit l’index de secours à utiliser lorsque l’index de la palette est hors limites
raw_indexed_color_converterIIndexedColorConverterr/wObtient ou définit le convertisseur de couleur indexée
raw_line_sizeintrObtient la taille de la ligne brute en octets.
sizeSizerObtient la taille de l’objet.
transparent_colorColorr/wRécupérez la couleur transparente de la trame active dans l’image GIF. Cette propriété
vous permet d’accéder à la couleur spécifique qui a été désignée comme transparente
dans la trame actuellement active.
update_xmp_databoolr/wObtient ou définit une valeur indiquant s’il faut mettre à jour les métadonnées XMP.
use_paletteboolrObtient une valeur indiquant si la palette de l’image est utilisée.
use_raw_databoolr/wObtient ou définit une valeur indiquant s’il faut utiliser le chargement de données brutes lorsque le chargement de données brutes est disponible.
vertical_resolutionfloatr/wObtient ou définit la résolution verticale, en pixels par pouce, de ce RasterImage.
widthintrObtient la largeur de l’image.
xmp_dataXmpPacketWrapperr/wObtient ou définit les données Xmp.

Methods

NameDescription
add_block(block)Ajouter un nouveau bloc GIF vous permet d’inclure des données supplémentaires dans l’image.
Cette méthode vous permet d’ajouter des blocs personnalisés à l’image GIF, qui peuvent
contenir différents types d’informations.
add_page(page)Intégrez une nouvelle page de manière fluide dans l’image existante, en enrichissant son contenu
et en élargissant sa portée. Cette méthode augmente les collections d’images avec du contenu supplémentaire, favorisant la créativité et la flexibilité dans la gestion et la composition d’images.
adjust_brightness(brightness)Ajuste la luminosité de l’image selon le paramètre spécifié
brightness. Cette méthode modifie la luminosité de
l’ensemble de l’image de manière uniforme, augmentant ou réduisant la luminance globale pour obtenir
l’effet souhaité.
adjust_contrast(contrast)Ajuste le contraste de l’image, en augmentant ou réduisant la différence de
luminosité entre les pixels. Cette méthode modifie la gamme tonale globale de l’image,
rendant les zones sombres plus sombres et les zones claires plus claires pour améliorer la clarté visuelle
et les détails.
adjust_gamma(gamma)Améliorez la qualité de l’image en appliquant une correction gamma. Cette méthode ajuste le gamma de couleur
de l’image pour obtenir une clarté visuelle optimale. Elle modifie la valeur gamma
de chaque pixel, ce qui entraîne une meilleure restitution des couleurs et une apparence globale de l’image améliorée.
adjust_gamma(gamma_red, gamma_green, gamma_blue)La correction gamma d’une image applique un ajustement non linéaire aux valeurs des pixels,
augmentant ou réduisant la luminosité en fonction des coefficients spécifiés pour les canaux rouge,
vert et bleu. Cette méthode aide à affiner la balance des couleurs et la
luminance de l’image, améliorant son apparence globale et sa qualité visuelle.
analyze_percentage_digital_signature(password)Calcule le pourcentage de similarité entre les données extraites et le mot de passe original.
auto_brightness_contrast()Effectue une normalisation automatique adaptative de la luminosité et du contraste pour l’image entière.
auto_rotate()Fait pivoter automatiquement l’image en fonction des données d’orientation extraites des métadonnées Exif
. Cette méthode garantit que les images sont affichées dans la bonne orientation,
améliorant l’expérience utilisateur et éliminant le besoin d’ajustements manuels. En
analysant les informations Exif, l’image est pivotée en conséquence, offrant une expérience de visualisation fluide
sur différentes plateformes et appareils. Ce processus de rotation automatisé
simplifie la gestion des images et améliore l’utilisabilité globale, surtout lorsqu’
on traite de gros lots d’images avec des orientations variées.
binarize_bradley(brightness_difference)La binarisation d’une image à l’aide de l’algorithme de seuillage adaptatif de Bradley avec
le seuillage d’image intégrale est une méthode pour convertir une image en niveaux de gris en une
image binaire. Cet algorithme calcule un seuil local pour chaque pixel en fonction de
l’intensité moyenne des pixels environnants dans une fenêtre spécifiée. En
ajustant de manière adaptative le seuil selon les intensités locales des pixels, la méthode de Bradley
est efficace pour gérer les variations d’éclairage et de contraste à travers l’image.
binarize_bradley(brightness_difference, window_size)Binarisation d’une image à l’aide de l’algorithme de seuillage adaptatif de Bradley utilisant le seuillage d’image intégrale
binarize_fixed(threshold)La binarisation d’une image avec un seuil prédéfini convertit une image en niveaux de gris ou couleur
en une image binaire, où chaque pixel est classé comme noir ou blanc
en fonction de si sa valeur d’intensité dépasse un seuil spécifié.
binarize_otsu()La binarisation d’une image avec le seuillage d’Otsu est une méthode utilisée pour déterminer automatiquement
la valeur de seuil optimale pour convertir une image en niveaux de gris en une
image binaire. L’algorithme de seuillage d’Otsu calcule le seuil qui
minimise la variance intra-classe des intensités des pixels dans les deux classes résultantes
(premier plan et arrière-plan). Cette technique est particulièrement utile lorsque
la valeur de seuil optimale est inconnue et doit être déterminée de manière adaptative en
fonction de l’histogramme de l’image.
blend(origin, overlay, overlay_alpha)Mélange cette instance d’image avec l’image overlay.
blend(origin, overlay, overlay_area, overlay_alpha)Mélange cette instance d’image avec l’image overlay.
cache_data()Met en cache les données privées.
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.
clear_blocks()Effacer tous les blocs GIF supprime toutes les données existantes stockées dans l’image.
Cette opération réinitialise efficacement l’image à un état vide, en supprimant tout
bloc ajouté précédemment. Utilisez cette méthode lorsque vous devez repartir à zéro avec une
base propre pour créer ou modifier une image GIF.
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)Recadrez l’image en utilisant une zone rectangulaire spécifiée. Cette opération supprime la partie extérieure
de l’image, ne laissant que la région sélectionnée définie par le rectangle.
dither(dithering_method, bits_count)Effectue un tramage sur l’image actuelle.
dither(dithering_method, bits_count, custom_palette)Appliquer le tramage à l’image actuelle. Ce processus améliore la qualité de l’image en
réduisant les bandes de couleur et en améliorant les transitions de couleur, ce qui donne une apparence plus fluide
.
embed_digital_signature(password)Intégrez une signature numérique basée sur le mot de passe fourni dans chaque page de l’image.
filter(rectangle, options)Appliquer un filtre spécifique à la zone désignée de l’image, améliorant sa qualité visuelle
ou modifiant son apparence selon les besoins. Cette méthode traite sélectivement
les pixels à l’intérieur du rectangle défini, permettant d’effectuer des ajustements ciblés
tout en préservant l’intégrité des données de l’image environnante.
get_argb_32_pixel(x, y)Obtient un pixel ARGB 32 bits d’une image.
get_default_argb_32_pixels(rectangle)Obtient le tableau de pixels ARGB 32 bits par défaut.
get_default_options(args)Obtient les options par défaut.
get_default_pixels(rectangle, partial_pixel_loader)Obtient le tableau de pixels par défaut en utilisant le chargeur de pixels partiel.
get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)Obtient le tableau de données brutes par défaut en utilisant le chargeur de pixels partiel.
get_default_raw_data(rectangle, raw_data_settings)Obtient le tableau de données brutes par défaut.
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_modify_date(use_default)Obtient la date et l’heure de la dernière modification de l’image ressource.
get_original_options()Récupérer les options basées sur les paramètres d’origine du fichier, essentielles pour maintenir la fidélité
et la cohérence dans le traitement et la manipulation d’images. Cette méthode permet une intégration fluide
des paramètres spécifiques au fichier dans les opérations ultérieures, garantissant
une restitution précise et le respect des caractéristiques inhérentes de l’image.
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 le
DataStreamSupporter.save(file_path) méthode, l’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 Image.save(file_path, options) méthode en tant que deuxième paramètre.
get_pixel(x, y)Obtient un pixel d’image.
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.
get_skew_angle()Obtient l’angle d’inclinaison.
Cette méthode s’applique aux documents texte numérisés, pour déterminer l’angle d’inclinaison lors du scan.
grayscale()La transformation d’une image en sa représentation en niveaux de gris convertit l’image couleur
en une version en niveaux de gris en supprimant les informations de couleur tout en préservant
la luminance. Ce processus simplifie l’image en nuances de gris, la rendant adaptée
à diverses applications telles que l’impression, le traitement de documents et l’analyse en niveaux de gris.
insert_block(index, block)Insérer un nouveau bloc GIF vous permet d’ajouter des données personnalisées à une position spécifique
dans l’image. Cette méthode vous permet de placer des blocs personnalisés à l’emplacement souhaité
dans l’image GIF, offrant une flexibilité dans l’organisation et la structuration des
données de l’image.
is_digital_signed(password, percentage_threshold)Effectue une vérification rapide pour déterminer si l’image est signée numériquement, en utilisant le mot de passe fourni et le seuil.
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_argb_32_pixels(rectangle)Charge des pixels ARGB 32 bits.
load_argb_64_pixels(rectangle)Charge des pixels ARGB 64 bits.
load_cmyk_32_pixels(rectangle)Charge des pixels au format CMYK.
load_cmyk_pixels(rectangle)Charge des pixels au format CMYK.
Cette méthode est obsolète. Veuillez plutôt utiliser la méthode RasterImage.load_cmyk_32_pixels(rectangle).
load_partial_argb_32_pixels(rectangle, partial_pixel_loader)Charge partiellement des pixels ARGB 32 bits (par blocs).
load_partial_argb_64_pixels(rectangle, partial_pixel_loader)Charge partiellement des pixels ARGB 64 bits par paquets.
load_partial_pixels(desired_rectangle, pixel_loader)Charge partiellement des pixels par paquets.
load_pixels(rectangle)Charge des pixels.
load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)Charge des données brutes.
load_raw_data(rectangle, raw_data_settings, raw_data_loader)Charge des données brutes.
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.
normalize_angle()Normalise l’angle.
Cette méthode s’applique aux documents texte numérisés pour éliminer la distorsion de la numérisation.
Cette méthode utilise les méthodes RasterImage.get_skew_angle() et RasterImage.rotate(angle).
normalize_angle(resize_proportionally, background_color)Normalise l’angle.
Cette méthode s’applique aux documents texte numérisés pour éliminer la distorsion de la numérisation.
Cette méthode utilise les méthodes RasterImage.get_skew_angle() et RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color).
normalize_histogram()Normalise l’histogramme de l’image — ajuste les valeurs des pixels pour utiliser toute la plage disponible.
order_blocks()Ordonner les blocs GIF conformément à la spécification GIF garantit une mise en page GIF correcte et la conformité au standard. Ce processus consiste à disposer les
blocs dans la séquence correcte définie par la spécification. De plus, il
peut impliquer la suppression de certaines instances de GifGraphicsControlBlock qui
ne sont pas nécessaires pour la mise en page finale. En respectant la spécification GIF, l’image résultante sera correctement structurée et compatible avec les applications de visualisation GIF.
read_argb_32_scan_line(scan_line_index)Lit la ligne de numérisation complète à l’index de ligne de numérisation spécifié.
read_scan_line(scan_line_index)Lit la ligne de numérisation complète à l’index de ligne de numérisation spécifié.
remove_block(block)Supprimer un bloc GIF élimine des données spécifiques de l’image, offrant la possibilité de
nettoyer ou modifier la structure de l’image. Cette méthode vous permet de retirer les blocs indésirables
ou inutiles, optimisant l’image GIF pour un stockage efficace. Utilisez cette
fonctionnalité pour éliminer les informations obsolètes de l’image tout en préservant
son intégrité et sa qualité.
remove_metadata()Supprime les métadonnées de cette instance d’image en définissant la valeur de IHasXmpData.xmp_data à None.
replace_argb(old_color_argb, old_color_diff, new_color_argb)Remplace une couleur par une autre avec une différence autorisée et préserve la valeur alpha originale pour conserver des bords lisses.
replace_color(old_color, old_color_diff, new_color)Remplace une couleur par une autre avec une différence autorisée et préserve la valeur alpha originale pour conserver des bords lisses.
replace_color(old_color_argb, old_color_diff, new_color_argb)Remplace une couleur par une autre avec une différence autorisée et préserve la valeur alpha originale pour conserver des bords lisses.
replace_non_transparent_colors(new_color)Remplace toutes les couleurs non transparentes par une nouvelle couleur et préserve la valeur alpha originale pour conserver des bords lisses.
Note : si vous l’utilisez sur des images sans transparence, toutes les couleurs seront remplacées par une seule.
replace_non_transparent_colors(new_color_argb)Remplace toutes les couleurs non transparentes par une nouvelle couleur et préserve la valeur alpha originale pour conserver des bords lisses.
Note : si vous l’utilisez sur des images sans transparence, toutes les couleurs seront remplacées par une seule.
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 cette instance de Image.
resize(new_width, new_height, settings)Redimensionne cette instance de 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_full_frame(new_width, new_height, resize_type)Redimensionnement de l’image en tenant compte de toutes les trames de chaque page dans un
GIF, évitant ainsi l’apparition d’éventuels artefacts. Cette méthode est essentielle
pour maintenir l’intégrité et la qualité de l’image, notamment lors du traitement de
GIF animés ou de séquences de trames.
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 largeur proportionnellement.
resize_height_proportionally(new_height, settings)Redimensionne la hauteur proportionnellement.
resize_height_proportionally_settings(new_height, settings)Redimensionne la hauteur proportionnellement.
resize_proportional(new_width, new_height, resize_type)Le redimensionnement proportionnel conserve le rapport d’aspect de l’image tout en ajustant sa
taille, garantissant que l’image ne semble pas étirée ou déformée. Cette méthode
redimensionne l’image proportionnellement, en mettant à l’échelle à la fois la largeur et la hauteur par le même facteur.
Le redimensionnement proportionnel ajustera chaque trame selon le ratio de newWidth/width et newHeight/height.
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(angle, resize_proportionally, background_color)Cette méthode fait pivoter l’image autour de son point central. En spécifiant l’angle de rotation, vous pouvez faire pivoter l’image dans le sens horaire ou antihoraire pour obtenir l’orientation souhaitée. Cette rotation aide à ajuster la présentation ou l’alignement de l’image sans en déformer le contenu.
rotate_flip(rotate_flip_type)Effectuer une rotation, un retournement ou les deux sur la trame active uniquement. Cette opération
applique les transformations uniquement à la trame actuellement active de l’image,
préservant l’intégrité des autres trames de la séquence.
rotate_flip_all(rotate_flip)Fait pivoter le retournement complet.
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 de l’objet dans le flux spécifié.
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_argb_32_pixels(rectangle, pixels)Enregistre les pixels ARGB 32 bits.
save_cmyk_32_pixels(rectangle, pixels)Enregistre les pixels.
save_cmyk_pixels(rectangle, pixels)Enregistre les pixels.
Cette méthode est obsolète. Veuillez utiliser de manière plus efficace la méthode RasterImage.save_cmyk_32_pixels(rectangle, pixels).
save_pixels(rectangle, pixels)Enregistre les pixels internes principaux.
save_raw_data(data, data_offset, rectangle, raw_data_settings)Enregistre les données brutes.
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_argb_32_pixel(x, y, argb_32_color)Définit un pixel d’image 32 bits ARGB pour la position spécifiée.
set_frame_time(time)Ajuste la durée de chaque trame en millisecondes, assurant un timing cohérent
tout au long de la séquence d’images. Cette méthode définit uniformément le temps d’affichage pour
chaque trame, permettant un contrôle précis de la vitesse d’animation.
Modifier cette valeur réinitialisera le délai pour toutes les trames.
set_palette(palette, update_colors)Définit la palette d’image.
set_pixel(x, y, color)Définit un pixel d’image pour la position spécifiée.
set_resolution(dpi_x, dpi_y)Définit la résolution pour ce RasterImage.
try_set_metadata(metadata)Essaie de définir une instance metadata, si cette instance Image prend en charge et implémente l’instance IImageMetadataFormat.
write_argb_32_scan_line(scan_line_index, argb_32_pixels)Écrit la ligne de numérisation complète à l’index de ligne de numérisation spécifié.
write_scan_line(scan_line_index, pixels)Écrit la ligne de numérisation complète à l’index de ligne de numérisation spécifié.

Constructor: GifImage(first_frame)

 GifImage(first_frame) 

Créer des images GIF devient sans effort avec le GifImage
constructeur. Avec simplement le paramètre firstFrame, il vous plonge dans un monde de communication visuelle dynamique
.

Parameters:

ParamètreTypeDescription
first_frameGifFrameBlockLa première trame avec laquelle initialiser l’image GIF.

See also:

Example # 1: This example shows how to create a GIF image and save it to a file.

Example # 2: The following example shows how to compose an animated GIF image from individ…

Constructor: GifImage(first_frame, global_palette)

 GifImage(first_frame, global_palette) 

Initiez un nouvel objet GifImage avec les paramètres spécifiés pour la
première image et la palette globale. Commencez à gérer les images GIF rapidement, en garantissant
une représentation précise grâce à des paramètres personnalisables pour des résultats optimaux.

Parameters:

ParamètreTypeDescription
first_frameGifFrameBlockLa première trame avec laquelle initialiser l’image GIF.
global_paletteIColorPaletteLa palette globale à utiliser. Notez que si firstFrame et globalPalette sont tous deux nuls, alors la palette globale par défaut est utilisée.

See also:

Example # 1: This example shows how to create a GIF image with a custom palette and save i…

Constructor: GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer)

 GifImage(first_frame, global_palette, is_palette_sorted, palette_color_resolution, palette_background_color_index, aspect_ratio, has_trailer) 

Commencez sans effort avec le constructeur GifImage. Avec cette
méthode simple, vous pouvez vous lancer dans la création de GIF animés facilement. Il suffit de fournir le
firstFrame, globalPalette, paletteColorResolution, aspectRatio, et d’autres
paramètres, et vous serez prêt à donner vie à vos visuels.

Parameters:

ParamètreTypeDescription
first_frameGifFrameBlockLa première trame avec laquelle initialiser l’image GIF.
global_paletteIColorPaletteLa palette globale à utiliser. Notez que si firstFrame et globalPalette sont tous deux nuls, alors la palette globale par défaut est utilisée.
is_palette_sortedboolsi réglé sur true la palette est triée. Notez que le paramètre est utilisé lorsque globalPalette n’est pas nul.
palette_color_resolutionSystem.ByteLa résolution des couleurs de la palette. Notez que le paramètre est utilisé lorsque globalPalette n’est pas nul.
palette_background_color_indexSystem.ByteL’index de couleur d’arrière-plan de la palette.
aspect_ratioSystem.ByteLe rapport d’aspect.
has_trailerboolsi réglé sur true l’image GIF possède une bande-annonce sinon aucune bande-annonce n’est écrite à la fin du flux.

Property: active_frame

Gérez et manipulez les cadres avec cette propriété, permettant une navigation fluide et
la modification du cadre actif dans l’image GIF.

See also:

Example # 1: The following example shows how to remove all blocks from a GIF image.

Method: add_block(block)

 add_block(block) 

Ajouter un nouveau bloc GIF vous permet d’inclure des données supplémentaires dans l’image.
Cette méthode vous permet d’ajouter des blocs personnalisés à l’image GIF, qui peuvent
contenir différents types d’informations.

Parameters:

ParamètreTypeDescription
blockIGifBlockLe bloc GIF à ajouter.

See also:

Example # 1: The following example shows how to compose an animated GIF image from individ…

Method: add_page(page)

 add_page(page) 

Intégrez une nouvelle page de manière fluide dans l’image existante, en enrichissant son contenu
et en élargissant sa portée. Cette méthode augmente les collections d’images avec du contenu supplémentaire, favorisant la créativité et la flexibilité dans la gestion et la composition d’images.

Parameters:

ParamètreTypeDescription
pageRasterImageLa page à ajouter.

See also:

Example # 1: Create multipage GIF image using single page raster images.

Method: adjust_brightness(brightness)

 adjust_brightness(brightness) 

Ajuste la luminosité de l’image selon le paramètre spécifié
brightness. Cette méthode modifie la luminosité de
l’ensemble de l’image de manière uniforme, augmentant ou réduisant la luminance globale pour obtenir
l’effet souhaité.

Parameters:

ParamètreTypeDescription
luminositéintValeur de luminosité.

See also:

Example # 1: The following example performs brightness correction of a GIF image.

Method: adjust_contrast(contrast)

 adjust_contrast(contrast) 

Ajuste le contraste de l’image, en augmentant ou réduisant la différence de
luminosité entre les pixels. Cette méthode modifie la gamme tonale globale de l’image,
rendant les zones sombres plus sombres et les zones claires plus claires pour améliorer la clarté visuelle
et les détails.

Parameters:

ParamètreTypeDescription
contrastefloatValeur de contraste (dans la plage [-100 ; 100])

See also:

Example # 1: The following example performs contrast correction of a GIF image.

Method: adjust_gamma(gamma)

 adjust_gamma(gamma) 

Améliorez la qualité de l’image en appliquant une correction gamma. Cette méthode ajuste le gamma de couleur
de l’image pour obtenir une clarté visuelle optimale. Elle modifie la valeur gamma
de chaque pixel, ce qui entraîne une meilleure restitution des couleurs et une apparence globale de l’image améliorée.

Parameters:

ParamètreTypeDescription
gammafloatCoefficient gamma pour les canaux rouge, vert et bleu

See also:

Example # 1: The following example performs gamma-correction of a GIF image.

Method: adjust_gamma(gamma_red, gamma_green, gamma_blue)

 adjust_gamma(gamma_red, gamma_green, gamma_blue) 

La correction gamma d’une image applique un ajustement non linéaire aux valeurs des pixels,
augmentant ou réduisant la luminosité en fonction des coefficients spécifiés pour les canaux rouge,
vert et bleu. Cette méthode aide à affiner la balance des couleurs et la
luminance de l’image, améliorant son apparence globale et sa qualité visuelle.

Parameters:

ParamètreTypeDescription
gamma_redfloatCoefficient gamma pour le canal rouge
gamma_greenfloatCoefficient gamma pour le canal vert
gamma_bluefloatCoefficient gamma pour le canal bleu

See also:

Example # 1: The following example performs gamma-correction of a GIF image applying diffe…

Method: analyze_percentage_digital_signature(password)

 analyze_percentage_digital_signature(password) 

Calcule le pourcentage de similarité entre les données extraites et le mot de passe original.

Parameters:

ParamètreTypeDescription
mot de passestringLe mot de passe utilisé pour extraire les données intégrées.

Returns

TypeDescription
intLa valeur de pourcentage de similarité.

Method: binarize_bradley(brightness_difference)

 binarize_bradley(brightness_difference) 

La binarisation d’une image à l’aide de l’algorithme de seuillage adaptatif de Bradley avec
le seuillage d’image intégrale est une méthode pour convertir une image en niveaux de gris en une
image binaire. Cet algorithme calcule un seuil local pour chaque pixel en fonction de
l’intensité moyenne des pixels environnants dans une fenêtre spécifiée. En
ajustant de manière adaptative le seuil selon les intensités locales des pixels, la méthode de Bradley
est efficace pour gérer les variations d’éclairage et de contraste à travers l’image.

Parameters:

ParamètreTypeDescription
brightness_differencefloatLa différence de luminosité entre le pixel et la moyenne d’une fenêtre de s × s pixels centrée autour de ce pixel.

Method: binarize_bradley(brightness_difference, window_size)

 binarize_bradley(brightness_difference, window_size) 

Binarisation d’une image à l’aide de l’algorithme de seuillage adaptatif de Bradley utilisant le seuillage d’image intégrale

Parameters:

ParamètreTypeDescription
brightness_differencefloatLa différence de luminosité entre le pixel et la moyenne d’une fenêtre de pixels de s x s
centrée autour de ce pixel.
window_sizeintLa taille de la fenêtre de pixels de s x s centrée autour de ce pixel

Method: binarize_fixed(threshold)

 binarize_fixed(threshold) 

La binarisation d’une image avec un seuil prédéfini convertit une image en niveaux de gris ou couleur
en une image binaire, où chaque pixel est classé comme noir ou blanc
en fonction de si sa valeur d’intensité dépasse un seuil spécifié.

Parameters:

ParamètreTypeDescription
seuilSystem.ByteValeur du seuil. Si la valeur de gris correspondante d’un pixel est supérieure au seuil, une valeur de 255 lui sera attribuée, sinon 0.

See also:

Example # 1: The following example binarizes a GIF image with the predefined threshold. Bi…

Method: blend(origin, overlay, overlay_alpha)

 blend(origin, overlay, overlay_alpha) 

Mélange cette instance d’image avec l’image overlay.

Parameters:

ParamètreTypeDescription
originPointL’origine du mélange de l’image d’arrière-plan.
overlayRasterImageL’image de superposition.
overlay_alphaSystem.ByteL’alpha de superposition.

Method: blend(origin, overlay, overlay_area, overlay_alpha)

 blend(origin, overlay, overlay_area, overlay_alpha) 

Mélange cette instance d’image avec l’image overlay.

Parameters:

ParamètreTypeDescription
originPointL’origine du mélange de l’image d’arrière-plan.
overlayRasterImageL’image de superposition.
overlay_areaRectangleLa zone de superposition.
overlay_alphaSystem.ByteL’alpha de superposition.

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ètreTypeDescription
file_pathstringLe chemin du fichier.

Returns

TypeDescription
booltrue 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ètreTypeDescription
file_pathstringLe chemin du fichier.
load_optionsLoadOptionsLes options de chargement.

Returns

TypeDescription
booltrue 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ètreTypeDescription
flux_io.BufferedRandomLe flux à charger.

Returns

TypeDescription
booltrue 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ètreTypeDescription
flux_io.BufferedRandomLe flux à charger.
load_optionsLoadOptionsLes options de chargement.

Returns

TypeDescription
booltrue 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ètreTypeDescription
flux_io.BufferedRandomLe flux à charger.

Returns

TypeDescription
booltrue 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ètreTypeDescription
flux_io.BufferedRandomLe flux à charger.
load_optionsLoadOptionsLes options de chargement.

Returns

TypeDescription
booltrue 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ètreTypeDescription
file_pathstringLe chemin du fichier.
load_optionsLoadOptionsLes options de chargement.

Returns

TypeDescription
booltrue 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ètreTypeDescription
optionsImageOptionsBaseLes options d’enregistrement à utiliser.

Returns

TypeDescription
booltrue 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ètreTypeDescription
filesstring[]Les fichiers.

Returns

TypeDescription
ImageL’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ètreTypeDescription
filesstring[]Les fichiers.
throw_exception_on_load_errorboolsi défini sur true [lancer une exception lors du chargement].

Returns

TypeDescription
ImageL’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ètreTypeDescription
image_optionsImageOptionsBaseLes options d’image.
widthintLa largeur.
heightintLa hauteur.

Returns

TypeDescription
ImageL’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ètreTypeDescription
image_optionsImageOptionsBaseLes options utilisées pour créer le RasterImage.
widthintLa largeur du RasterImage.
heightintLa hauteur du RasterImage.
pixelsint[]Le tableau des valeurs de pixels utilisé pour remplir l’image.

Returns

TypeDescription
ImageUne 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ètreTypeDescription
imagesImage[]Les images.

Returns

TypeDescription
ImageL’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ètreTypeDescription
imagesImage[]Les images.
dispose_imagesboolsi défini sur true [supprimer les images].

Returns

TypeDescription
ImageL’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ètreTypeDescription
multipage_create_optionsMultipageCreateOptionsLes options de création multipage.

Returns

TypeDescription
ImageL’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ètreTypeDescription
filesstring[]Les fichiers.

Returns

TypeDescription
ImageL’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ètreTypeDescription
filesstring[]Les fichiers.
throw_exception_on_load_errorboolsi défini sur true lancer une exception en cas d’erreur de chargement.

Returns

TypeDescription
ImageL’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ètreTypeDescription
imagesImage[]Les images.

Returns

TypeDescription
ImageL’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ètreTypeDescription
imagesImage[]Les images.
dispose_imagesboolsi défini sur true [supprimer les images].

Returns

TypeDescription
ImageL’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ètreTypeDescription
left_shiftintLe décalage à gauche.
right_shiftintLe décalage à droite.
top_shiftintLe décalage supérieur.
bottom_shiftintLe décalage inférieur.

Method: crop(rectangle)

 crop(rectangle) 

Recadrez l’image en utilisant une zone rectangulaire spécifiée. Cette opération supprime la partie extérieure
de l’image, ne laissant que la région sélectionnée définie par le rectangle.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle.

See also:

Example # 1: The following example crops a GIF image. The cropping area is be specified vi…

Method: dither(dithering_method, bits_count)

 dither(dithering_method, bits_count) 

Effectue un tramage sur l’image actuelle.

Parameters:

ParamètreTypeDescription
dithering_methodDitheringMethodLa méthode de tramage.
bits_countintLe nombre final de bits pour le dithering.

Method: dither(dithering_method, bits_count, custom_palette)

 dither(dithering_method, bits_count, custom_palette) 

Appliquer le tramage à l’image actuelle. Ce processus améliore la qualité de l’image en
réduisant les bandes de couleur et en améliorant les transitions de couleur, ce qui donne une apparence plus fluide
.

Parameters:

ParamètreTypeDescription
dithering_methodDitheringMethodLa méthode de tramage.
bits_countintLe nombre final de bits pour le dithering.
custom_paletteIColorPaletteLa palette personnalisée pour le dithering.

Method: embed_digital_signature(password)

 embed_digital_signature(password) 

Intégrez une signature numérique basée sur le mot de passe fourni dans chaque page de l’image.

Parameters:

ParamètreTypeDescription
mot de passestringLe mot de passe utilisé pour générer les données de signature numérique.

Method: filter(rectangle, options)

 filter(rectangle, options) 

Appliquer un filtre spécifique à la zone désignée de l’image, améliorant sa qualité visuelle
ou modifiant son apparence selon les besoins. Cette méthode traite sélectivement
les pixels à l’intérieur du rectangle défini, permettant d’effectuer des ajustements ciblés
tout en préservant l’intégrité des données de l’image environnante.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle.
optionsFilterOptionsBaseLes options.

Method: get_argb_32_pixel(x, y)

 get_argb_32_pixel(x, y) 

Obtient un pixel ARGB 32 bits d’une image.

Parameters:

ParamètreTypeDescription
xintL’emplacement x du pixel.
yintL’emplacement y du pixel.

Returns

TypeDescription
intLe pixel ARGB 32 bits pour l’emplacement spécifié.

Method: get_default_argb_32_pixels(rectangle)

 get_default_argb_32_pixels(rectangle) 

Obtient le tableau de pixels ARGB 32 bits par défaut.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle pour obtenir les pixels.

Returns

TypeDescription
int[]Le tableau de pixels par défaut.

Method: get_default_options(args)

 get_default_options(args) 

Obtient les options par défaut.

Parameters:

ParamètreTypeDescription
argsSystem.ObjectLes arguments.

Returns

TypeDescription
ImageOptionsBaseOptions par défaut

Method: get_default_pixels(rectangle, partial_pixel_loader)

 get_default_pixels(rectangle, partial_pixel_loader) 

Obtient le tableau de pixels par défaut en utilisant le chargeur de pixels partiel.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle pour obtenir les pixels.
partial_pixel_loaderIPartialArgb32PixelLoaderLe chargeur partiel de pixels.

Method: get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings)

 get_default_raw_data(rectangle, partial_raw_data_loader, raw_data_settings) 

Obtient le tableau de données brutes par défaut en utilisant le chargeur de pixels partiel.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle pour obtenir les pixels.
partial_raw_data_loaderIPartialRawDataLoaderLe chargeur partiel de données brutes.
raw_data_settingsRawDataSettingsLes paramètres des données brutes.

Method: get_default_raw_data(rectangle, raw_data_settings)

 get_default_raw_data(rectangle, raw_data_settings) 

Obtient le tableau de données brutes par défaut.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle pour obtenir les données brutes.
raw_data_settingsRawDataSettingsLes paramètres des données brutes.

Returns

TypeDescription
System.ByteLe tableau de données brutes par défaut.

Method: get_file_format(file_path) [static]

 get_file_format(file_path) 

Obtient le format de fichier.

Parameters:

ParamètreTypeDescription
file_pathstringLe chemin du fichier.

Returns

TypeDescription
FileFormatLe format de fichier déterminé.

Method: get_file_format(stream) [static]

 get_file_format(stream) 

Obtient le format de fichier.

Parameters:

ParamètreTypeDescription
flux_io.BufferedRandomLe flux.

Returns

TypeDescription
FileFormatLe 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ètreTypeDescription
flux_io.BufferedRandomLe flux.

Returns

TypeDescription
FileFormatLe 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ètreTypeDescription
rectangleRectangleLe rectangle pour obtenir le rectangle d’ajustement.
pixelsint[]Les pixels ARGB 32 bits.
widthintLa largeur de l’objet.
heightintLa hauteur de l’objet.

Returns

TypeDescription
RectangleLe 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ètreTypeDescription
rectangleRectangleLe rectangle pour obtenir le rectangle d’ajustement.
widthintLa largeur de l’objet.
heightintLa hauteur de l’objet.

Returns

TypeDescription
RectangleLe rectangle d’ajustement ou une exception si aucun rectangle d’ajustement ne peut être trouvé.

Method: get_modify_date(use_default)

 get_modify_date(use_default) 

Obtient la date et l’heure de la dernière modification de l’image ressource.

Parameters:

ParamètreTypeDescription
use_defaultboolsi défini sur true utilise les informations de FileInfo comme valeur par défaut.

Returns

TypeDescription
System.DateTimeLa date et l’heure de la dernière modification de l’image de la ressource.

Method: get_original_options()

 get_original_options() 

Récupérer les options basées sur les paramètres d’origine du fichier, essentielles pour maintenir la fidélité
et la cohérence dans le traitement et la manipulation d’images. Cette méthode permet une intégration fluide
des paramètres spécifiques au fichier dans les opérations ultérieures, garantissant
une restitution précise et le respect des caractéristiques inhérentes de l’image.
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 le
DataStreamSupporter.save(file_path) méthode, l’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 Image.save(file_path, options) méthode en tant que deuxième paramètre.

Returns

TypeDescription
ImageOptionsBaseLes options basées sur les paramètres du fichier original.

Method: get_pixel(x, y)

 get_pixel(x, y) 

Obtient un pixel d’image.

Parameters:

ParamètreTypeDescription
xintL’emplacement x du pixel.
yintL’emplacement y du pixel.

Returns

TypeDescription
ColorLa couleur du pixel pour l’emplacement spécifié.

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

 get_proportional_height(width, height, new_width) 

Obtient une hauteur proportionnelle.

Parameters:

ParamètreTypeDescription
widthintLa largeur.
heightintLa hauteur.
new_widthintLa nouvelle largeur.

Returns

TypeDescription
intLa hauteur proportionnelle.

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

 get_proportional_width(width, height, new_height) 

Obtient une largeur proportionnelle.

Parameters:

ParamètreTypeDescription
widthintLa largeur.
heightintLa hauteur.
new_heightintLa nouvelle hauteur.

Returns

TypeDescription
intLa 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ètreTypeDescription
image_optionsImageOptionsBaseLes options d’image.
clipping_rectangleRectangleLe rectangle de découpage.
page_numberint[]Le numéro de page.

Returns

TypeDescription
_io.BufferedRandomLe flux sérialisé

Method: get_skew_angle()

 get_skew_angle() 

Obtient l’angle d’inclinaison.
Cette méthode s’applique aux documents texte numérisés, pour déterminer l’angle d’inclinaison lors du scan.

Returns

TypeDescription
floatL’angle d’inclinaison, en degrés.

Method: insert_block(index, block)

 insert_block(index, block) 

Insérer un nouveau bloc GIF vous permet d’ajouter des données personnalisées à une position spécifique
dans l’image. Cette méthode vous permet de placer des blocs personnalisés à l’emplacement souhaité
dans l’image GIF, offrant une flexibilité dans l’organisation et la structuration des
données de l’image.

Parameters:

ParamètreTypeDescription
indexintL’élément indexé à zéro, à l’endroit où le bloc sera inséré.
blockIGifBlockLe bloc GIF à ajouter.

Method: is_digital_signed(password, percentage_threshold)

 is_digital_signed(password, percentage_threshold) 

Effectue une vérification rapide pour déterminer si l’image est signée numériquement, en utilisant le mot de passe fourni et le seuil.

Parameters:

ParamètreTypeDescription
mot de passestringLe mot de passe pour vérifier la signature.
percentage_thresholdintLe seuil (en pourcentage)[0-100] qui détermine si l’image est considérée comme signée.
Si non spécifié, un seuil par défaut (75) sera appliqué.

Returns

TypeDescription
boolVrai si l’image est signée, sinon faux.

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ètreTypeDescription
file_pathstringLe chemin du fichier ou l’URL depuis lequel charger l’image.

Returns

TypeDescription
ImageL’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ètreTypeDescription
file_pathstringLe chemin du fichier ou l’URL depuis lequel charger l’image.
load_optionsLoadOptionsLes options de chargement.

Returns

TypeDescription
ImageL’image chargée.

Method: load(stream) [static]

 load(stream) 

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

Parameters:

ParamètreTypeDescription
flux_io.BufferedRandomLe flux depuis lequel charger l’image.

Returns

TypeDescription
ImageL’image chargée.

Method: load(stream, load_options) [static]

 load(stream, load_options) 

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

Parameters:

ParamètreTypeDescription
flux_io.BufferedRandomLe flux depuis lequel charger l’image.
load_optionsLoadOptionsLes options de chargement.

Returns

TypeDescription
ImageL’image chargée.

Method: load_argb_32_pixels(rectangle)

 load_argb_32_pixels(rectangle) 

Charge des pixels ARGB 32 bits.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle depuis lequel charger les pixels.

Returns

TypeDescription
int[]Le tableau de pixels ARGB 32 bits chargé.

Method: load_argb_64_pixels(rectangle)

 load_argb_64_pixels(rectangle) 

Charge des pixels ARGB 64 bits.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle depuis lequel charger les pixels.

Returns

TypeDescription
int[]Le tableau de pixels ARGB 64 bits chargé.

Method: load_cmyk_32_pixels(rectangle)

 load_cmyk_32_pixels(rectangle) 

Charge des pixels au format CMYK.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle depuis lequel charger les pixels.

Returns

TypeDescription
int[]Les pixels CMYK chargés présentés sous forme de valeurs entières 32 bits.

Method: load_cmyk_pixels(rectangle)

 load_cmyk_pixels(rectangle) 

Charge des pixels au format CMYK.
Cette méthode est obsolète. Veuillez plutôt utiliser la méthode RasterImage.load_cmyk_32_pixels(rectangle).

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle depuis lequel charger les pixels.

Returns

TypeDescription
CmykColor[]Le tableau de pixels CMYK chargé.

Method: load_partial_argb_32_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_32_pixels(rectangle, partial_pixel_loader) 

Charge partiellement des pixels ARGB 32 bits (par blocs).

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle depuis lequel charger les pixels.
partial_pixel_loaderIPartialArgb32PixelLoaderLe chargeur partiel de pixels.

Method: load_partial_argb_64_pixels(rectangle, partial_pixel_loader)

 load_partial_argb_64_pixels(rectangle, partial_pixel_loader) 

Charge partiellement des pixels ARGB 64 bits par paquets.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle souhaité.
partial_pixel_loaderIPartialArgb64PixelLoaderLe chargeur de pixels ARGB 64 bits.

Method: load_partial_pixels(desired_rectangle, pixel_loader)

 load_partial_pixels(desired_rectangle, pixel_loader) 

Charge partiellement des pixels par paquets.

Parameters:

ParamètreTypeDescription
desired_rectangleRectangleLe rectangle souhaité.
pixel_loaderIPartialPixelLoaderLe chargeur de pixels.

Method: load_pixels(rectangle)

 load_pixels(rectangle) 

Charge des pixels.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle depuis lequel charger les pixels.

Returns

TypeDescription
Color[]Le tableau de pixels chargé.

Method: load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, dest_image_bounds, raw_data_settings, raw_data_loader) 

Charge des données brutes.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle depuis lequel charger les données brutes.
dest_image_boundsRectangleLes limites de l’image de destination.
raw_data_settingsRawDataSettingsLes paramètres des données brutes à utiliser pour les données chargées. Notez que si les données ne sont pas dans le format spécifié, une conversion des données sera effectuée.
raw_data_loaderIPartialRawDataLoaderLe chargeur de données brutes.

Method: load_raw_data(rectangle, raw_data_settings, raw_data_loader)

 load_raw_data(rectangle, raw_data_settings, raw_data_loader) 

Charge des données brutes.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle depuis lequel charger les données brutes.
raw_data_settingsRawDataSettingsLes paramètres des données brutes à utiliser pour les données chargées. Notez que si les données ne sont pas dans le format spécifié, une conversion des données sera effectuée.
raw_data_loaderIPartialRawDataLoaderLe chargeur de données brutes.

Method: load_stream(stream) [static]

 load_stream(stream) 

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

Parameters:

ParamètreTypeDescription
flux_io.BufferedRandomLe flux depuis lequel charger l’image.

Returns

TypeDescription
ImageL’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ètreTypeDescription
flux_io.BufferedRandomLe flux depuis lequel charger l’image.
load_optionsLoadOptionsLes options de chargement.

Returns

TypeDescription
ImageL’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ètreTypeDescription
file_pathstringLe chemin du fichier ou l’URL depuis lequel charger l’image.
load_optionsLoadOptionsLes options de chargement.

Returns

TypeDescription
ImageL’image chargée.

Method: normalize_angle(resize_proportionally, background_color)

 normalize_angle(resize_proportionally, background_color) 

Normalise l’angle.
Cette méthode s’applique aux documents texte numérisés pour éliminer la distorsion de la numérisation.
Cette méthode utilise les méthodes RasterImage.get_skew_angle() et RasterCachedMultipageImage.rotate(angle, resize_proportionally, background_color).

Parameters:

ParamètreTypeDescription
resize_proportionallyboolsi défini sur true votre taille d’image sera modifiée selon les projections du rectangle tourné (points d’angle); sinon les dimensions restent inchangées et seul le contenu interne de l’image est tourné.
background_colorColorCouleur de l’arrière-plan.

Method: read_argb_32_scan_line(scan_line_index)

 read_argb_32_scan_line(scan_line_index) 

Lit la ligne de numérisation complète à l’index de ligne de numérisation spécifié.

Parameters:

ParamètreTypeDescription
scan_line_indexintIndice basé sur zéro de la ligne de numérisation.

Returns

TypeDescription
int[]Le tableau des valeurs de couleur ARGB 32 bits de la ligne de numérisation.

Method: read_scan_line(scan_line_index)

 read_scan_line(scan_line_index) 

Lit la ligne de numérisation complète à l’index de ligne de numérisation spécifié.

Parameters:

ParamètreTypeDescription
scan_line_indexintIndice basé sur zéro de la ligne de numérisation.

Returns

TypeDescription
Color[]Le tableau des valeurs de couleur des pixels de la ligne de numérisation.

Method: remove_block(block)

 remove_block(block) 

Supprimer un bloc GIF élimine des données spécifiques de l’image, offrant la possibilité de
nettoyer ou modifier la structure de l’image. Cette méthode vous permet de retirer les blocs indésirables
ou inutiles, optimisant l’image GIF pour un stockage efficace. Utilisez cette
fonctionnalité pour éliminer les informations obsolètes de l’image tout en préservant
son intégrité et sa qualité.

Parameters:

ParamètreTypeDescription
blockIGifBlockLe bloc à supprimer.

Method: replace_argb(old_color_argb, old_color_diff, new_color_argb)

 replace_argb(old_color_argb, old_color_diff, new_color_argb) 

Remplace une couleur par une autre avec une différence autorisée et préserve la valeur alpha originale pour conserver des bords lisses.

Parameters:

ParamètreTypeDescription
old_color_argbintValeur ARGB de l’ancienne couleur à remplacer.
old_color_diffSystem.ByteDifférence autorisée dans l’ancienne couleur pour pouvoir élargir la teinte de couleur remplacée.
new_color_argbintNouvelle valeur ARGB de couleur pour remplacer l’ancienne couleur.

Method: replace_color(old_color, old_color_diff, new_color)

 replace_color(old_color, old_color_diff, new_color) 

Remplace une couleur par une autre avec une différence autorisée et préserve la valeur alpha originale pour conserver des bords lisses.

Parameters:

ParamètreTypeDescription
old_colorColor
old_color_diffSystem.ByteDifférence autorisée dans l’ancienne couleur pour pouvoir élargir la teinte de couleur remplacée.
new_colorColor

Method: replace_color(old_color_argb, old_color_diff, new_color_argb)

 replace_color(old_color_argb, old_color_diff, new_color_argb) 

Remplace une couleur par une autre avec une différence autorisée et préserve la valeur alpha originale pour conserver des bords lisses.

Parameters:

ParamètreTypeDescription
old_color_argbintValeur ARGB de l’ancienne couleur à remplacer.
old_color_diffSystem.ByteDifférence autorisée dans l’ancienne couleur pour pouvoir élargir la teinte de couleur remplacée.
new_color_argbintNouvelle valeur ARGB de couleur pour remplacer l’ancienne couleur.

Method: replace_non_transparent_colors(new_color)

 replace_non_transparent_colors(new_color) 

Remplace toutes les couleurs non transparentes par une nouvelle couleur et préserve la valeur alpha originale pour conserver des bords lisses.
Note : si vous l’utilisez sur des images sans transparence, toutes les couleurs seront remplacées par une seule.

Parameters:

ParamètreTypeDescription
new_colorColor

Method: replace_non_transparent_colors(new_color_argb)

 replace_non_transparent_colors(new_color_argb) 

Remplace toutes les couleurs non transparentes par une nouvelle couleur et préserve la valeur alpha originale pour conserver des bords lisses.
Note : si vous l’utilisez sur des images sans transparence, toutes les couleurs seront remplacées par une seule.

Parameters:

ParamètreTypeDescription
new_color_argbintNouvelle valeur ARGB de couleur pour remplacer les couleurs non transparentes.

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ètreTypeDescription
new_widthintLa nouvelle largeur.
new_heightintLa nouvelle hauteur.

Method: resize(new_width, new_height, resize_type)

 resize(new_width, new_height, resize_type) 

Redimensionne cette instance de Image.

Parameters:

ParamètreTypeDescription
new_widthintLa nouvelle largeur.
new_heightintLa nouvelle hauteur.
resize_typeResizeTypeLe type de redimensionnement.

Method: resize(new_width, new_height, settings)

 resize(new_width, new_height, settings) 

Redimensionne cette instance de Image.

Parameters:

ParamètreTypeDescription
new_widthintLa nouvelle largeur.
new_heightintLa nouvelle hauteur.
settingsImageResizeSettingsLes paramètres.

Method: resize_by_settings(new_width, new_height, settings)

 resize_by_settings(new_width, new_height, settings) 

Redimensionne l’image.

Parameters:

ParamètreTypeDescription
new_widthintLa nouvelle largeur.
new_heightintLa nouvelle hauteur.
settingsImageResizeSettingsLes 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ètreTypeDescription
new_widthintLa nouvelle largeur.
new_heightintLa nouvelle hauteur.
resize_typeResizeTypeLe type de redimensionnement.

Method: resize_full_frame(new_width, new_height, resize_type)

 resize_full_frame(new_width, new_height, resize_type) 

Redimensionnement de l’image en tenant compte de toutes les trames de chaque page dans un
GIF, évitant ainsi l’apparition d’éventuels artefacts. Cette méthode est essentielle
pour maintenir l’intégrité et la qualité de l’image, notamment lors du traitement de
GIF animés ou de séquences de trames.

Parameters:

ParamètreTypeDescription
new_widthintLa nouvelle largeur.
new_heightintLa nouvelle hauteur.
resize_typeResizeTypeLe 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ètreTypeDescription
new_heightintLa nouvelle hauteur.

Method: resize_height_proportionally(new_height, resize_type)

 resize_height_proportionally(new_height, resize_type) 

Redimensionne la largeur proportionnellement.

Parameters:

ParamètreTypeDescription
new_heightintLa nouvelle hauteur.
resize_typeResizeTypeType de redimensionnement.

Method: resize_height_proportionally(new_height, settings)

 resize_height_proportionally(new_height, settings) 

Redimensionne la hauteur proportionnellement.

Parameters:

ParamètreTypeDescription
new_heightintLa nouvelle hauteur.
settingsImageResizeSettingsLes 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ètreTypeDescription
new_heightintLa nouvelle hauteur.
settingsImageResizeSettingsLes paramètres de redimensionnement de l’image.

Method: resize_proportional(new_width, new_height, resize_type)

 resize_proportional(new_width, new_height, resize_type) 

Le redimensionnement proportionnel conserve le rapport d’aspect de l’image tout en ajustant sa
taille, garantissant que l’image ne semble pas étirée ou déformée. Cette méthode
redimensionne l’image proportionnellement, en mettant à l’échelle à la fois la largeur et la hauteur par le même facteur.
Le redimensionnement proportionnel ajustera chaque trame selon le ratio de newWidth/width et newHeight/height.

Parameters:

ParamètreTypeDescription
new_widthintLa nouvelle largeur.
new_heightintLa nouvelle hauteur.
resize_typeResizeTypeLe type de redimensionnement.

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ètreTypeDescription
new_widthintLa nouvelle largeur.

Method: resize_width_proportionally(new_width, resize_type)

 resize_width_proportionally(new_width, resize_type) 

Redimensionne la largeur proportionnellement.

Parameters:

ParamètreTypeDescription
new_widthintLa nouvelle largeur.
resize_typeResizeTypeType de redimensionnement.

Method: resize_width_proportionally(new_width, settings)

 resize_width_proportionally(new_width, settings) 

Redimensionne la largeur proportionnellement.

Parameters:

ParamètreTypeDescription
new_widthintLa nouvelle largeur.
settingsImageResizeSettingsLes 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ètreTypeDescription
new_widthintLa nouvelle largeur.
settingsImageResizeSettingsLes paramètres de redimensionnement de l’image.

Method: rotate(angle)

 rotate(angle) 

Faire pivoter l’image autour du centre.

Parameters:

ParamètreTypeDescription
anglefloatL’angle de rotation en degrés. Les valeurs positives feront pivoter dans le sens horaire.

Method: rotate(angle, resize_proportionally, background_color)

 rotate(angle, resize_proportionally, background_color) 

Cette méthode fait pivoter l’image autour de son point central. En spécifiant l’angle de rotation, vous pouvez faire pivoter l’image dans le sens horaire ou antihoraire pour obtenir l’orientation souhaitée. Cette rotation aide à ajuster la présentation ou l’alignement de l’image sans en déformer le contenu.

Parameters:

ParamètreTypeDescription
anglefloatL’angle de rotation en degrés. Les valeurs positives feront pivoter dans le sens horaire.
resize_proportionallyboolsi défini sur true la taille de votre image sera modifiée
selon les projections du rectangle tourné (points d’angle) dans les autres
cas, les dimensions restent inchangées et seuls
internal le contenu de l’image est tourné.
background_colorColorCouleur de l’arrière-plan.

Method: rotate_flip(rotate_flip_type)

 rotate_flip(rotate_flip_type) 

Effectuer une rotation, un retournement ou les deux sur la trame active uniquement. Cette opération
applique les transformations uniquement à la trame actuellement active de l’image,
préservant l’intégrité des autres trames de la séquence.

Parameters:

ParamètreTypeDescription
rotate_flip_typeRotateFlipTypeLe type de retournement de rotation.

See also:

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

Method: rotate_flip_all(rotate_flip)

 rotate_flip_all(rotate_flip) 

Fait pivoter le retournement complet.

Parameters:

ParamètreTypeDescription
rotate_flipRotateFlipTypeLe retournement de rotation.

Method: save(file_path)

 save(file_path) 

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

Parameters:

ParamètreTypeDescription
file_pathstringLe 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ètreTypeDescription
file_pathstringLe chemin du fichier.
optionsImageOptionsBaseLes 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ètreTypeDescription
file_pathstringLe chemin du fichier.
optionsImageOptionsBaseLes options.
bounds_rectangleRectangleLe 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ètreTypeDescription
file_pathstringLe chemin du fichier où enregistrer les données de l’objet.
over_writeboolsi défini sur true écrase le contenu du fichier, sinon une addition sera effectuée.

Method: save(stream)

 save(stream) 

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

Parameters:

ParamètreTypeDescription
flux_io.BufferedRandomLe flux où enregistrer les données de l’objet.

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ètreTypeDescription
flux_io.BufferedRandomLe flux où enregistrer les données de l’image.
options_baseImageOptionsBaseLes 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ètreTypeDescription
flux_io.BufferedRandomLe flux où enregistrer les données de l’image.
options_baseImageOptionsBaseLes options d’enregistrement.
bounds_rectangleRectangleLe rectangle des limites de l’image de destination. Définissez le rectangle vide pour utiliser les limites source.

Method: save_argb_32_pixels(rectangle, pixels)

 save_argb_32_pixels(rectangle, pixels) 

Enregistre les pixels ARGB 32 bits.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle où enregistrer les pixels.
pixelsint[]Le tableau de pixels ARGB 32 bits.

Method: save_cmyk_32_pixels(rectangle, pixels)

 save_cmyk_32_pixels(rectangle, pixels) 

Enregistre les pixels.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle où enregistrer les pixels.
pixelsint[]Les pixels CMYK présentés sous forme de valeurs entières 32 bits.

Method: save_cmyk_pixels(rectangle, pixels)

 save_cmyk_pixels(rectangle, pixels) 

Enregistre les pixels.
Cette méthode est obsolète. Veuillez utiliser de manière plus efficace la méthode RasterImage.save_cmyk_32_pixels(rectangle, pixels).

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle où enregistrer les pixels.
pixelsCmykColor[]Le tableau de pixels CMYK.

Method: save_pixels(rectangle, pixels)

 save_pixels(rectangle, pixels) 

Enregistre les pixels internes principaux.

Parameters:

ParamètreTypeDescription
rectangleRectangleLe rectangle.
pixelsColor[]Les pixels.

Method: save_raw_data(data, data_offset, rectangle, raw_data_settings)

 save_raw_data(data, data_offset, rectangle, raw_data_settings) 

Enregistre les données brutes.

Parameters:

ParamètreTypeDescription
donnéesSystem.ByteLes données brutes.
data_offsetintLe décalage de départ des données brutes.
rectangleRectangleLe rectangle des données brutes.
raw_data_settingsRawDataSettingsLes paramètres des données brutes dans lesquelles les données se trouvent.

Method: save_to_stream(stream)

 save_to_stream(stream) 

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

Parameters:

ParamètreTypeDescription
flux_io.BufferedRandomLe 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ètreTypeDescription
flux_io.BufferedRandomLe flux où enregistrer les données de l’image.
options_baseImageOptionsBaseLes 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ètreTypeDescription
flux_io.BufferedRandomLe flux où enregistrer les données de l’image.
options_baseImageOptionsBaseLes options d’enregistrement.
bounds_rectangleRectangleLe 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ètreTypeDescription
file_pathstringLe chemin du fichier.
optionsImageOptionsBaseLes 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ètreTypeDescription
file_pathstringLe chemin du fichier.
optionsImageOptionsBaseLes options.
bounds_rectangleRectangleLe rectangle des limites de l’image de destination. Définissez le rectangle vide pour utiliser les limites de la source.

Method: set_argb_32_pixel(x, y, argb_32_color)

 set_argb_32_pixel(x, y, argb_32_color) 

Définit un pixel d’image 32 bits ARGB pour la position spécifiée.

Parameters:

ParamètreTypeDescription
xintL’emplacement x du pixel.
yintL’emplacement y du pixel.
argb_32_colorintLe pixel ARGB 32 bits pour la position spécifiée.

Method: set_frame_time(time)

 set_frame_time(time) 

Ajuste la durée de chaque trame en millisecondes, assurant un timing cohérent
tout au long de la séquence d’images. Cette méthode définit uniformément le temps d’affichage pour
chaque trame, permettant un contrôle précis de la vitesse d’animation.
Modifier cette valeur réinitialisera le délai pour toutes les trames.

Parameters:

ParamètreTypeDescription
tempsintLe temps de durée de la trame en millisecondes.

Method: set_palette(palette, update_colors)

 set_palette(palette, update_colors) 

Définit la palette d’image.

Parameters:

ParamètreTypeDescription
paletteIColorPaletteLa palette à définir.
update_colorsboolsi 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: set_pixel(x, y, color)

 set_pixel(x, y, color) 

Définit un pixel d’image pour la position spécifiée.

Parameters:

ParamètreTypeDescription
xintL’emplacement x du pixel.
yintL’emplacement y du pixel.
colorColorLa couleur du pixel pour la position spécifiée.

Method: set_resolution(dpi_x, dpi_y)

 set_resolution(dpi_x, dpi_y) 

Définit la résolution pour ce RasterImage.

Parameters:

ParamètreTypeDescription
dpi_xfloatLa résolution horizontale, en points par pouce, du RasterImage.
dpi_yfloatLa résolution verticale, en points par pouce, du RasterImage.

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ètreTypeDescription
metadataIImageMetadataFormatLes métadonnées.

Returns

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

Method: write_argb_32_scan_line(scan_line_index, argb_32_pixels)

 write_argb_32_scan_line(scan_line_index, argb_32_pixels) 

Écrit la ligne de numérisation complète à l’index de ligne de numérisation spécifié.

Parameters:

ParamètreTypeDescription
scan_line_indexintIndice basé sur zéro de la ligne de numérisation.
argb_32_pixelsint[]Le tableau de couleurs ARGB 32 bits à écrire.

Method: write_scan_line(scan_line_index, pixels)

 write_scan_line(scan_line_index, pixels) 

Écrit la ligne de numérisation complète à l’index de ligne de numérisation spécifié.

Parameters:

ParamètreTypeDescription
scan_line_indexintIndice basé sur zéro de la ligne de numérisation.
pixelsColor[]Le tableau de couleurs de pixels à écrire.

Examples

This example shows how to create a GIF image and save it to a file.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color


# Créer un bloc de trame GIF de 100x100 px.
with GifFrameBlock(100, 100) as firstBlock:
	# Remplir tout le bloc en rouge.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	with GifImage(firstBlock) as gifImage:
		gifImage.save("output.gif")

This example shows how to create a GIF image with a custom palette and save it to a file.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color, ColorPaletteHelper


# Créer un bloc de trame GIF de 100x100 px.
with GifFrameBlock(100, 100) as firstBlock:
	# Remplir tout le bloc en rouge.
	gr = Graphics(firstBlock)
	brush = SolidBrush(Color.red)
	gr.fill_rectangle(brush, firstBlock.bounds)

	# Utiliser une palette 4 bits pour réduire la taille de l'image. La qualité peut se détériorer.
	palette = ColorPaletteHelper.create_4_bit()

	with GifImage(firstBlock, palette) as gifImage:
		gifImage.save("output.gif")

The following example shows how to compose an animated GIF image from individual GIF blocks.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 
from aspose.imaging.brushes import SolidBrush
from aspose.imaging import Graphics, Color

# Créez une image GIF de 100 x 100 px.
# Le premier bloc est entièrement noir par défaut.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		# Le premier cercle est rouge
		brush1 = SolidBrush(Color.red)

		# Le deuxième cercle est noir
		brush2 = SolidBrush(Color.black)

		# Augmentez progressivement l'angle de la forme d'arc rouge.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush1, block.bounds, 0, angle)
			gifImage.add_block(block)
		
		# Augmentez progressivement l'angle de l'arc noir et effacez l'arc rouge.
		for angle in range(10, 361, 10):
			block = GifFrameBlock(100, 100)
			gr = Graphics(block)
			gr.fill_pie(brush2, block.bounds, 0, angle)
			gr.fill_pie(brush1, block.bounds, angle, 360 - angle)
			gifImage.add_block(block)

		gifImage.save("animated_radar.gif")

The following example shows how to remove all blocks from a GIF image.

from aspose.imaging.fileformats.gif.blocks import GifFrameBlock
from aspose.imaging.fileformats.gif import GifImage 

# Créez une image GIF de 100 x 100 px.
# Le premier bloc est entièrement noir par défaut.
with GifFrameBlock(100, 100) as firstBlock:
	with GifImage(firstBlock) as gifImage:
		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

		print("Clear all the blocks")
		gifImage.clear_blocks()

		if gifImage.active_frame is not None:
			print(f"Active frame size: {gifImage.active_frame.size}")
		else:
			print("Active frame is not set")

# La sortie ressemble à ceci :
# Taille de la trame active : { Width = 100, Height = 100}
# Effacer tous les blocs
# La trame active n'est pas définie

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

The following example crops a GIF image. The cropping area is be specified via aspose.imaging.Rectangle.

import aspose.pycore as aspycore
from aspose.imaging import Image, Rectangle
from aspose.imaging.imageoptions import PngOptions
from aspose.imaging.fileformats.gif import GifImage
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Recadrez l'image. La zone de recadrage est la zone centrale rectangulaire de l'image.
	area = Rectangle(gif_image.width // 4, gif_image.height // 4, gif_image.width // 2,
					 gif_image.height // 2)
	gif_image.crop(area)
	# Enregistrez l'image recadrée au format PNG
	gif_image.save(join(dir_, "sample.Crop.png"), PngOptions())

The following example binarizes a GIF image with the predefined threshold. Binarized images contain only 2 colors - black and white.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	djvu_image = aspycore.as_of(image, GifImage)
	# Binarisez l’image avec une valeur de seuil de 127.
	# Si la valeur de gris correspondante d’un pixel est supérieure à 127, une valeur de 255 lui sera attribuée, sinon 0.
	djvu_image.binarize_fixed(127)
	djvu_image.save(join(dir_, "sample.BinarizeFixed.png"), PngOptions())

The following example performs gamma-correction of a GIF image.

import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_: str = "c:\\temp\\"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Définissez le coefficient gamma pour les canaux rouge, vert et bleu.
	gif_image.adjust_gamma(2.5)
	gif_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs gamma-correction of a GIF image applying different coefficients for color components.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Définissez des coefficients gamma individuels pour les canaux rouge, vert et bleu.
	gif_image.adjust_gamma(1.5, 2.5, 3.5)
	gif_image.save(join(dir_, "sample.AdjustGamma.png"), PngOptions())

The following example performs brightness correction of a GIF image.


import aspose.pycore as aspycore
from aspose.imaging import Image
from aspose.imaging.fileformats.gif import GifImage
from aspose.imaging.imageoptions import PngOptions
from os.path import join

dir_ = "c:\\temp"
with Image.load(join(dir_, "sample.gif")) as image:
	gif_image = aspycore.as_of(image, GifImage)
	# Définissez la valeur de luminosité. Les valeurs acceptées de luminosité sont dans la plage [-255, 255].
	gif_image.adjust_brightness(50)
	gif_image.save(join(dir_, "sample.AdjustBrightness.png"), PngOptions())

The following example performs contrast correction of a GIF image.



import aspose.pycore as aspycore

from aspose.imaging import Image

from aspose.imaging.fileformats.gif import GifImage

from aspose.imaging.imageoptions import PngOptions

from os.path import join



dir_ = "c:\\temp"

with Image.load(join(dir_, "sample.gif")) as image:

	gif_image = aspycore.as_of(image, GifImage)

	# Définissez la valeur de contraste. Les valeurs acceptées de contraste sont dans la plage [-100f, 100f].

	gif_image.adjust_contrast(50.0)

	gif_image.save(join(dir_, "sample.AdjustContrast.png"), PngOptions())



# ExEnd

Create multipage GIF image using single page raster images.

from aspose.imaging import Image, RasterImage
from aspose.pycore import as_of
from os import listdir
from os.path import isfile, join

def load_frames(directory):
	for f in listdir(directory):
		full_path = join(directory, f)
		if isfile(full_path):
			yield as_of(Image.load(file_path), RasterImage)


# Charger les trames
frames = list(load_frames("Animation frames"))
# Créer une image GIF en utilisant la première trame
with GifImage(GifFrameBlock(frames[0])) as image:
	# Ajouter des trames à l'image GIF en utilisant la méthode AddPage
	for index in range(1, len(frames)):
		image.add_page(frames[index])

	# Enregistrer l'image GIF
	image.save("Multipage.gif")
	
for it in frames:
	with it as _:
		# libérer les images
		pass

Export of part of animation from GIF image based on time interval.

from aspose.imaging import Image
from aspose.imaging.imageoptions import GifOptions, MultiPageOptions, MultiPageMode, TimeInterval

with Image.load("Animation.gif") as image:
	obj_init = MultiPageOptions()
	obj_init.mode = MultiPageMode.TIME_INTERVAL
	obj_init.time_interval = TimeInterval(0, 400)
	options = GifOptions()
	options.full_frame = True
	options.multi_page_options = obj_init
	image.save("PartOfAnimation.gif", options)