Lavorare con i documenti in PostScript | .NET

Crea documento PS

Aspose.Page per .NET offre due costruttori per creare la classe PsDocument. Il seguente frammento di codice crea un documento PS di una pagina:

//Create output stream for PostScript document
using (Stream outPsStream = new FileStream(dir + "document.ps", FileMode.Create))
{
    //Create save options
    PsSaveOptions options = new PsSaveOptions();
    //If you want to assign page size other than A4, set page size in options
    options.PageSize = PageConstants.GetSize(PageConstants.SIZE_A4, PageConstants.ORIENTATION_PORTRAIT);
    //If you want to assign page margins other than empty, set page margins in options
    options.Margins = PageConstants.GetMargins(PageConstants.MARGINS_ZERO);
    //If you plan to use fonts that are located in non system folders, set additional fonts folders in options
    options.AdditionalFontsFolders = new string[] { dir };

    //Set variable that indicates if resulting PostScript document will be multipaged
    bool multiPaged = false;

    // Create new multipaged PS Document with one page opened
    PsDocument document = new PsDocument(outPsStream, options, multiPaged);

    //Close current page
    document.ClosePage();
    //Save the document
    document.Save();
}

Se si prevede che il documento PS sia multipagina, impostare la variabile multiPaged su true.

Un altro costruttore consente di creare un oggetto PsDocument con un numero definito di pagine:

//Create output stream for PostScript document
using (Stream outPsStream = new FileStream(dir + "document.ps", FileMode.Create))
{
    //Create save options
    PsSaveOptions options = new PsSaveOptions();
    
    // Create new multipaged PS Document with 2 pages. These two pages are not created. It must be added by AddPage() method.
    PsDocument document = new PsDocument(outPsStream, options, 2);
    
    //Adding pages and it's content
    
    //Save the document
    document.Save();
}

Vedi Lavorare con i documenti PS in Java.

Diamo un’occhiata alla classe PsSaveOptions che incapsula le possibili opzioni che aiutano a creare il documento PostScript corretto.

• SaveFormat specifica un formato di output per i documenti. Può essere PS o EPS. Nella libreria Aspose.Page, le differenze tra questi due formati si riflettono solo nei commenti PostScript e nell’estensione del file. Inoltre, in conformità con le specifiche dei file EPS, i file EPS devono essere composti da una sola pagina. Il formato PS è utilizzato per impostazione predefinita.

• PageSize specifica la dimensione delle pagine nel documento PS. Tuttavia, è possibile assegnare dimensioni di pagina diverse per ogni pagina, se necessario. La dimensione della pagina può essere ottenuta dalla classe PageConstants come nell’esempio seguente:

options.PageSize = PageConstants.GetSize(PageConstants.SIZE_International, PageConstants.ORIENTATION_PORTRAIT);

Il formato di pagina predefinito è “A4” con orientamento “Verticale”.

• Margini specifica i campi vuoti tra i margini della pagina e i bordi sinistro, superiore, destro e inferiore del contenuto della pagina. Può essere ottenuto dalla classe PageConstants.

options.Margins = PageConstants.GetMargins(PageConstants.MARGINS_SMALL); // 20 points for each margin

I margini predefiniti sono “ZERO” (0, 0, 0, 0).

• BackGroundColor specifica il colore di sfondo della pagina. Può essere assegnato come:

options.BackgroundColor = Color.FromArgb(211, 8, 48);

O:

options.BackgroundColor = Color.Yellow;

Per Linux, macOS e altri sistemi operativi non Windows, offriamo l’utilizzo del nostro pacchetto Nuget Aspose.Page.Drawing. Utilizza il backend Aspose.Drawing invece della libreria di sistema System.Drawing.

Quindi, importate lo spazio dei nomi Aspose.Page.Drawing invece di quello System.Drawing. Nei frammenti di codice sopra, verrà utilizzato Aspose.Page.Drawing.Color invece di System.Drawing.Color. I nostri esempi di codice su GitHub contengono tutte le sostituzioni necessarie.

Il valore predefinito è “null”, che significa nessuno sfondo.

• EmbedFonts controlla il comportamento di PsDocument durante il salvataggio nel file. Se impostato su “false”, i font utilizzati non verranno scritti nel file PS. In questo caso, l’interprete PostScript genererà un errore se il font utilizzato non viene trovato nelle cartelle di sistema dell’host di destinazione.

• EmbedFontsAs controlla il modo in cui i font verranno incorporati nel file PS. Al momento sono disponibili due metodi: i formati TrueType e Type3. Il valore può essere impostato tramite la classe FontConstants come segue:

options.EmbedFontsAs = FontsConstants.EMBED_FONTS_TYPE3

Il valore predefinito è “TrueType”.

• JpegQualityLevel specifica un livello di compressione/qualità delle immagini nel documento PS risultante. Maggiore è la qualità richiesta, minore sarà la compressione e viceversa. La qualità minima è 0 e quella massima è 100. Il valore predefinito è 75.

• AdditionalFontsFolder specifica le posizioni in cui trovare i font. Le cartelle di sistema dei font sono sempre incluse per impostazione predefinita.

• Debug consente di inviare informazioni di debug alla console. Il valore predefinito è false.

È possibile scaricare esempi e file di dati da GitHub.