Travailler avec un documentdans PS | Python
Créer un document PS
Aspose.Page pour Python via .NET comprend deux constructeurs pour créer la classe PsDocument. L’extrait de code suivant explique la création d’un document PS d’une page :
1# The path to the documents directory.
2dir = Util.get_data_dir_working_with_document()
3
4# Create an output stream for a PostScript document
5with open(dir + "document.ps", "wb") as out_ps_stream:
6 # Create save options
7 options = PsSaveOptions()
8 # If you want to aassign a page size other than A4, set the page size in options
9 options.page_size = PageConstants.get_size(PageConstants.SIZE_A4, PageConstants.ORIENTATION_PORTRAIT)
10 # If you want to aassign page margins other empty, set the page margins in options
11 options.margins = PageConstants.get_margins(PageConstants.MARGINS_ZERO)
12 # If you plan to use fonts that located in non system folders, set additional fonts folders in options
13 options.additional_fonts_folders = [ dir ]
14
15 # Set a variable that indicates if resulting PostScript document will be multipaged
16 multi_paged = False
17
18 # Create a new multipaged PS Document with one page opened
19 document = PsDocument(out_ps_stream, options, multi_paged)
20
21 # Close the current page
22 document.close_page()
23 # Save the document
24 document.save()
Si vous souhaitez que le document PS soit multipage, définissez la variable multiPaged sur true.
L’autre constructeur permet de créer un objet PsDocument avec un nombre défini de pages :
1with open(dir + "document.ps", "wb") as out_ps_stream:
2# Create save options
3options = PsSaveOptions()
4# If you want to assign the page size other than A4, set the page size in options
5options.page_size = PageConstants.get_size(PageConstants.SIZE_A4, PageConstants.ORIENTATION_PORTRAIT)
6# If you want to aassign page margins other empty, set the page margins in options
7options.margins = PageConstants.get_margins(PageConstants.MARGINS_ZERO)
8# If you plan to use fonts that located in non system folders, set additional fonts folders in options
9options.additional_fonts_folders = [ dir ]
10
11# Create a new multipaged PS Document with one page opened
12document = PsDocument(out_ps_stream, options, 2)
13
14# Close the current page
15document.close_page()
16# Save the document
17document.save()
Jetons un coup d’œil à la classe PsSaveOptions qui encapsule les options possibles aidant à créer le bon document PostScript.
Le paramètre SaveFormat détermine le format de sortie des documents, qui peut être PS ou EPS. Dans la bibliothèque Aspose.Page, les distinctions entre ces deux formats se reflètent principalement dans les commentaires PostScript et l’extension de fichier. De plus, selon la spécification du fichier EPS, les fichiers EPS sont destinés à être d’une seule page. Par défaut, le format PS est utilisé.
Le paramètre page_size spécifie la taille des pages du document PS. Cependant, il est possible d’attribuer des tailles de page différentes pour chaque page si nécessaire.
La taille de la page peut être obtenue à partir de la classe PageConstants, comme le montre l’exemple suivant :
1options.page_size = PageConstants.get_size(PageConstants.SIZE_International, PageConstants.ORIENTATION_PORTRAIT);
Le format de page par défaut est « A4 » en orientation « Portrait ».
- marges spécifie les champs vides entre les limites de la page et les bords gauche, haut, droit et inférieur du contenu de la page. Il peut être obtenu à partir de la classe PageConstants.
1options.margins = PageConstants.get_margins(PageConstants.MARGINS_SMALL)); // 20 points for each margin
Les marges par défaut sont “ZÉRO” (0, 0, 0, 0).
- back_ground_color spécifie une couleur d’arrière-plan de la page. Peut être attribué comme :
1options.back_ground_color = aspose.pydrawing.Color(211, 8, 48);
ou:
1options.back_ground_color = aspose.pydrawing.Color.YELLOW;
La valeur par défaut est “null”, ce qui signifie aucun arrière-plan.
Le paramètre embed_fonts détermine le format de sortie des documents, qui peut être PS ou EPS. Dans la bibliothèque Aspose.Page, les distinctions entre ces deux formats se reflètent principalement dans les commentaires PostScript et l’extension de fichier. De plus, selon la spécification du fichier EPS, les fichiers EPS sont destinés à être d’une seule page. Par défaut, le format PS est utilisé.
Le paramètre embed_fonts_as spécifie la taille des pages du document PS. Cependant, il est possible d’attribuer des tailles de page différentes pour chaque page si nécessaire. La valeur peut être définie à l’aide de la classe FontConstants comme suit :
1options.embed_fonts_as = FontsConstants.EMBED_FONTS_TYPE3;
La valeur par défaut est « TrueType ».
Le paramètre jpeg_quality_level détermine le niveau de compression et la qualité des images dans le document PS résultant. Une qualité supérieure nécessite moins de compression, et vice versa. La qualité va de 0 à 100, 0 représentant la qualité minimale et 100 représentant la qualité maximale. Le paramètre par défaut est 75.
Le paramètre additional_fonts_folder spécifie les emplacements où les polices peuvent être trouvées. Par défaut, les dossiers de polices système sont toujours inclus.
debug permet la sortie des informations de débogage sur la console. La valeur par défaut est fausse.
Vous pouvez télécharger des exemples et des fichiers de données à partir de GitHub.