Figure.psconvert

Ici vous aurez des explications sur la commande et ses différents paramètres.

Figure.psconvert(\*, crop=None, gs_option=None, dpi=None,prefix=None,
gs_path=None, resize=None, bb_style=None, fmt=None,
anti_aliasing=None, verbose=None, \**kwargs)

Utilité :

Convertir des fichiers [E]PS en d’autres formats.

Convertit un ou plusieurs fichiers PostScript en d’autres formats (BMP, EPS, JPEG, PDF, PNG, PPM, TIFF) en utilisant Ghostscript.

Si aucun fichier d’entrée n’est donné, convertira la figure active actuelle (voir pygmt.Figure). Dans ce cas, un nom de sortie doit être donné en utilisant le paramètre prefix.

Paramètres :

crop (str ou bool) - Ajuste la BoundingBox et HiResBoundingBox au minimum requis par le contenu de l’image. Par défaut, c’est True. Ajoutez +u pour supprimer d’abord les horodatages produits par GMT. Ajoutez +r pour arrondir le HighResBoundingBox au lieu d’utiliser la fonction ceil. Cela va à l’encontre de la loi Adobe, mais peut être utile lors de la création d’images très petites où la différence d’un pixel peut être importante. Si verbose est utilisé, nous indiquons également les dimensions de l’illustration finale.

gs_path (str) - Chemin complet vers l’exécutable Ghostscript.

gs_option (str) - Spécifie une option personnalisée unique qui sera transmise à Ghostscript telle quelle.

dpi (int) - Définit la résolution en points par pouce (dpi) pour les images raster. Par défaut, c’est 720 pour les fichiers PDF et 300 pour les autres formats.

prefix (str) - Force le nom du fichier de sortie. Par défaut, les noms de sortie sont construits en utilisant les noms des fichiers d’entrée comme base, auxquels est ajoutée une extension appropriée. Utilisez cette option pour fournir un nom différent, mais sans extension. L’extension est toujours déterminée automatiquement.

resize (str) - [+mmargins][+s[m]width[/height]][+Sscale]. Ajuste la BoundingBox et HiResBoundingBox en effectuant un redimensionnement et/ou en ajoutant des marges. Ajoutez +m pour spécifier des marges supplémentaires pour étendre la zone de délimitation. Fournissez une, deux ou quatre marges (pour les côtés individuels); ajoutez l’unité [par défaut est déterminée par PROJ_LENGTH_UNIT]. Ajoutez +swidth pour redimensionner l’image de sortie exactement à la largeur spécifiée. L’unité par défaut est définie par PROJ_LENGTH_UNIT, mais vous pouvez ajouter une nouvelle unité et/ou imposer une largeur et une hauteur différentes (Note: Cela peut changer le rapport d’aspect de l’image). Ce qui se passe ici, c’est que Ghostscript effectuera le travail de réinterpolation et l’image finale conservera la résolution DPI définie par dpi. Ajoutez +sm pour définir une taille maximale et la nouvelle largeur n’est imposée que si la largeur de la figure d’origine la dépasse. Ajoutez /height pour imposer également une hauteur maximale en plus de la largeur. Alternativement, ajoutez +Sscale pour mettre à l’échelle l’image par un facteur constant.

bb_style (str) - Définit une couleur de remplissage optionnelle pour la BoundingBox, un fondu ou le dessin du contour de la BoundingBox. Ajoutez +ffade pour estomper l’ensemble du graphique vers le noir (100%) [pas d’estompage, 0]. Ajoutez +gpaint pour peindre la BoundingBox derrière l’illustration et ajoutez +p[pen] pour dessiner le contour de la BoundingBox (ajoutez un stylo ou acceptez le stylo par défaut de 0.25p, noir). Note: Si à la fois +g et +f sont utilisés, nous utilisons paint comme couleur de fondu au lieu du noir. Ajoutez +i pour imposer des niveaux de gris en utilisant des profils ICC.

anti_aliasing (str) - [g|p|t][1|2|4]. Définit les options d’anti-aliasing pour les graphiques ou le texte. Ajoutez la taille de la boîte de sous-échantillonnage (1, 2 ou 4) [Par défaut, c’est « 4 »]. [Par défaut, il n’y a pas d’anti-aliasing (identique à bits = 1).]

fmt (str) - Définit le format de sortie, où b signifie BMP, e signifie EPS, E signifie EPS avec la commande PageSize, f signifie PDF, F signifie PDF multi-pages, j signifie JPEG, g signifie PNG, G signifie PNG transparent (les régions non modifiées sont transparentes), m signifie PPM et t signifie TIFF [Par défaut, c’est JPEG]. Pour b|j|g|t, ajoutez éventuellement +m pour obtenir une image en niveaux de gris. Le format EPS peut être combiné avec n’importe lequel des autres formats. Par exemple, ef crée à la fois un fichier EPS et un fichier PDF. L’utilisation de F crée un fichier PDF multi-pages à partir de la liste des fichiers PS ou PDF d’entrée. Cela nécessite le paramètre prefix.

verbose (bool ou str) - Sélectionne le niveau de verbosité [Par défaut, c’est w], qui module les messages écrits dans stderr. Choisissez parmi 7 niveaux de verbosité :

q - Silencieux, aucun message d’erreur fatal n’est produit.

e - Messages d’erreur uniquement.

w - Avertissements.

t - Temps d’exécution (rapports de durée d’exécution pour les algorithmes gourmands en temps).

i - Messages informatifs (identique à verbose=True).

c - Avertissements de compatibilité.

d - Messages de débogage.