Travailler avec un document dans PostScript | C++

Créer un document PS

Aspose.Page pour C++ propose deux constructeurs afin de créer la classe PsDocument. L’extrait de code suivant crée un document PS d’une page :

    // The path to the documents directory.
    System::String dir = RunExamples::GetDataDir_WorkingWithDocument();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dir + u"document.ps", System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ outPsStream});
        // ------------------------------------------
        
        try
        {
            //Create save options
            System::SharedPtr<PsSaveOptions> options = System::MakeObject<PsSaveOptions>();
            //If you want to aassign page size other than A4, set page size in options
            options->set_PageSize(PageConstants::GetSize(PageConstants::SIZE_A4(), PageConstants::ORIENTATION_PORTRAIT()));
            //If you want to aassign page margins other empty, set page margins in options
            options->set_Margins(PageConstants::GetMargins(PageConstants::MARGINS_ZERO()));
            //If you plan to use fonts that located in non system folders, set additional fonts folders in options
            options->set_AdditionalFontsFolders(System::MakeArray<System::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
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, multiPaged);
            
            //Close current page
            document->ClosePage();
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

Si le document PS prévoit d’être multipage, définissez la variable multiPaged sur true.

Un autre constructeur permet de créer un objet PsDocument avec un nombre défini de pages :

//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();
}
    // The path to the documents directory.
    System::String dir = RunExamples::GetDataDir_WorkingWithDocument();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dir + u"document.ps", System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ outPsStream});
        // ------------------------------------------
        
        try
        {
            //Create save options
            System::SharedPtr<PsSaveOptions> options = System::MakeObject<PsSaveOptions>();
            
            // Create new multipaged PS Document with 2 pages. These two pages are not created. It must be added by AddPage() method.
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, 2);
            
            //Adding pages and it's content

            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

Voir travailler avec un document PS dans Java.

Regardons la classe PsSaveOptions qui encapsule les options possibles aidant à créer le bon document PostScript.

• SaveFormat spécifie un format de sortie des documents. Peut être PS ou EPS. Dans la bibliothèque Aspose.Page, les différences entre ces deux formats se reflètent uniquement dans les commentaires PostScript et une extension de fichier. Conformément aux spécifications des fichiers EPS, les fichiers EPS doivent également comporter une seule page. Le format PS est utilisé par défaut.

• PageSize spécifie la taille des pages du document PS. Cependant, nous pouvons attribuer des tailles de page différentes pour chaque page si cela est nécessaire. La taille de la page peut être obtenue à partir de la classe PageConstants comme dans l’exemple suivant :

    options->set_PageSize(PageConstants::GetSize(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 .

    options->set_Margins(PageConstants::GetMargins(PageConstants::MARGINS_SMALL())); // 20 points for each margin

Les marges par défaut sont “ZÉRO” (0, 0, 0, 0).

• BackGroundColor spécifie une couleur d’arrière-plan de la page. Peut être attribué comme :

    options->set_BackgroundColor(Color::FromArgb(211, 8, 48));

ou:

    options->set_BackgroundColor(System::Drawing::Color::get_Yellow());

La valeur par défaut est “null”, ce qui signifie aucun arrière-plan.

• EmbedFonts contrôle le comportement de PsDocument lors de son enregistrement dans le fichier. Si “false”, les polices utilisées ne seront pas écrites dans le fichier PS. Dans ce cas, l’interpréteur PostScript générera une erreur si la police utilisée est introuvable dans les dossiers système sur l’hôte cible.

• EmbedFontsAs contrôle la manière dont les polices seront intégrées dans le fichier PS. À l’heure actuelle, les formats de police TrueType et Type3 fonctionnent de deux manières. La valeur peut être définie à l’aide de la classe FontConstants comme suit :

    options->set_EmbedFontsAs(FontsConstants::EMBED_FONTS_TYPE3);

La valeur par défaut est « TrueType ».

• JpegQualityLevel spécifie un niveau de compression/qualité des images dans le document PS résultant. Plus la qualité est requise, moins la compression sera importante et vice versa. La qualité minimale est de 0 et la qualité maximale de 100. La valeur par défaut est de 75.

• AdditionalFontsFolder spécifie les emplacements où trouver les polices. Les dossiers de polices système sont toujours inclus par défaut.

• Debug permet de générer 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.